Integrations

Slack integration

Connect Slack to give Agents tools that send messages, read channels, and interact with a Slack workspace. These tools are available to Agents, not as Flow steps.

Before you begin

Create a Slack app, install it in your workspace, and copy its bot token from the OAuth & Permissions page.

Set up Slack integration

To connect Slack for use with Agent tools, follow these steps:

  1. In Runtype, go to Settings > Integrations.
  2. Find Slack, then click Configure.
  3. In Bot Token, enter the bot token from your Slack app.
  4. Optional: In Team ID, enter your Slack workspace’s team ID.
  5. Click Save. Runtype saves the credentials for the Slack integration.

After you save the credentials, configure the Slack tools on an Agent.

Available tools

The following tools are available when you configure an Agent with the Slack integration:

  • send_message: Send a message to a channel or user with Slack markdown or Block Kit blocks.
  • list_channels: List public channels in the workspace.
  • get_channel_history: Read message history from a channel.
  • get_thread_replies: Read replies in a thread.
  • add_reaction: Add an emoji reaction to a message.
  • get_user_info: Look up information about a Slack user.
  • prompt_user: Ask the user to choose from up to five labeled buttons.
  • select_from_list: Ask the user to choose one or more options from a dropdown.
  • send_rich_message: Send an informational message with Block Kit blocks without registering an interaction.

Add these tools in the Tools section of the Agent editor.

Use cases

Use Slack tools for tasks such as:

  • Notifications: Alert a team when important events happen.
  • Reports: Send daily or weekly summaries to channels.
  • Alerts: Notify a team about errors or anomalies.
  • Approvals: Use prompt_user to request human review of an Agent decision.

Format messages

Use Slack’s markdown syntax in the text parameter. The following snippet shows common formats:

Slack markdown
*Bold text*
_Italic text_
~Strikethrough~
`Code`
> Quote
<https://example.com|Link text>

Disconnect Slack

To remove the Slack connection, follow these steps:

  1. In Runtype, go to Settings > Integrations.
  2. Find Slack, then click Remove.

After you remove the credentials, Agents with Slack tools enabled cannot use them until you reconnect Slack.

Next steps

Continue with these guides: