Slack Connector

The Slack connector lets users interact with your deployed agent directly from Slack channels and direct messages. This connector requires manual webhook setup after deployment.

Prerequisites

You need a Slack App configured for your workspace:

1. Go to api.slack.com/apps and create a new app (or use an existing one)
2. Under OAuth & Permissions, add the required bot scopes:
   • app_mentions:read — Receive messages when the bot is mentioned
   • chat:write — Send messages back to users
   • channels:history — Read messages in public channels
   • im:history — Read direct messages
   • groups:history — Read messages in private channels (if needed)
3. Install the app to your workspace
4. Copy the Bot User OAuth Token (xoxb-...) and the Signing Secret (found under Basic Information)

Setup

Step 1: Create the Connector

1. Open your agent in Agent Studio
2. In the Connectors panel, click Add Connector
3. Select Slack as the provider
4. Enter a Connector Name (lowercase with underscores, e.g., production_slack_bot)
5. Fill in the connector parameters:
   • Signing Secret — The signing secret from your Slack App's Basic Information page
   • Bot Token — Your xoxb- bot token
6. Configure access:
   • Toggle Onboarding on to require approval for new users, or leave it off for open access
   • If onboarding is enabled, set an Onboarding Message
7. Use the Test button to validate your credentials

Step 2: Configure the Inbound Route

The inbound route filters which Slack messages reach your agent. All parameters are optional — leave them empty to accept all messages.

Step 3: Configure the Outbound Route

The outbound route controls where your agent sends responses.

• Enable use sender as receiver to reply in the same channel/thread that triggered the message (recommended)
• If disabled, specify a Channel ID as the explicit response target

Step 4: Save

Save the agent revision to persist the connector configuration.

Deploy and Webhook Setup

Slack requires manual webhook setup after deployment.

1. Click Deploy to publish the agent revision
2. The connector status will show Manual Setup — this is expected
3. Copy the Webhook URL provided by Fruxon
4. In your Slack App dashboard, go to Event Subscriptions
5. Enable events and paste the webhook URL as the Request URL
6. Subscribe to bot events:
   • message.channels — Messages in public channels
   • message.groups — Messages in private channels
   • message.im — Direct messages
   • app_mention — When someone mentions your bot
7. Save the Slack App event subscription settings
8. Once the webhook is verified, the connector status changes to Connected

How Users Interact

Once the connector is connected, Slack users can interact with your agent:

• Mention the bot — Type @YourBotName followed by a message in any channel the bot is added to
• Direct message — Send a message directly to the bot
• Thread replies — Continue a conversation in a Slack thread for multi-turn interactions

The agent processes each message and responds in the same channel or thread.

Viewing Conversations

All Slack conversations are tracked in your agent's Conversations tab:

• Filter by Slack provider to see only Slack conversations
• View full message history including user messages and agent responses
• Each message links back to its execution record for debugging

Next Steps

• Access Control — Manage who can interact with your agent
• Microsoft Teams Connector — Connect to another platform
• Conversations — Browse all conversations