Slack

Connect your Idun agent to Slack so users can interact with it through direct messages and channel messages.

Connect your Idun agent to Slack so users can interact with it through direct messages or channel messages.

Prerequisites

• A running Idun agent (engine)
• A Slack workspace where you have permission to install apps
• Your engine must be publicly reachable (use ngrok for local development)

Setup

Manager UI

1. Open the integrations catalog

   Navigate to Integrations. The channel catalog shows WhatsApp, Discord, and Slack as active channels.

   
2. Create the Slack integration

   Click + on Slack and fill in the bot token and signing secret.

   Field	Value
   bot_token	Bot User OAuth Token from your Slack app (xoxb-...)
   signing_secret	Signing secret from your Slack app

3. Assign to an agent

   After saving, open the agent you want to connect and select the Slack integration from the Integrations field.

Config file

1. Create a Slack app

   1. Go to the Slack API Portal
   2. Click Create an App > From scratch
   3. Give it a name and select your workspace
2. Get your credentials

   1. Go to Basic Information > App Credentials > copy the Signing Secret
   2. Go to OAuth & Permissions > under Bot Token Scopes, add:
      • chat:write (send messages)
      • channels:read (view basic channel info)
   3. Click Install to Workspace > Allow
   4. Copy the Bot User OAuth Token (xoxb-...)
3. Configure the integration

   Add the Slack integration to your engine config:

   config.yaml

   integrations:
     - provider: "SLACK"
       enabled: true
       config:
         bot_token: "xoxb-..."
         signing_secret: "abc123..."
   

   Field	Description
   bot_token	Bot User OAuth Token from step 2 (xoxb-...)
   signing_secret	Signing secret from step 2 (used for HMAC-SHA256 request verification)

4. Enable event subscriptions

   1. Make sure your engine is running and publicly reachable
   2. In the Slack API Portal, go to Event Subscriptions > toggle ON
   3. Set Request URL to:

   https://<your-domain>/integrations/slack/webhook
   

   Slack sends a url_verification challenge. The engine handles this automatically. You should see a green Verified checkmark.

   4. Under Subscribe to bot events, add:
      • message.im (messages in direct conversations with the bot)
      • message.channels (messages in channels the bot is a member of)
   5. Click Save Changes

   If you see a yellow banner saying “You’ve changed the permission scopes. Please reinstall your app”, click the reinstall link. Events are not delivered until you reinstall.

5. Enable the messages tab

   1. Go to App Home in the sidebar
   2. Under Show Tabs, enable the Messages Tab
   3. Check “Allow users to send Slash commands and messages from the messages tab”
6. Invite the bot to a channel

   If you want the bot to respond in channels (not only DMs):

   • Go to the channel in Slack and type /invite @YourBotName
   • Or click the channel name > Integrations tab > Add an App
7. Test it

   1. Open Slack
   2. Send a direct message to your bot, or post in a channel it has been invited to
   3. Your agent processes the message and replies in the same conversation

How it works

1. User sends a message to the bot (DM or channel)
2. Slack POSTs the event to your engine’s webhook
3. Engine verifies the HMAC-SHA256 signature using the signing secret
4. Engine invokes the agent with the message text
5. Engine sends the agent’s reply back via the Slack Web API (chat.postMessage)

Session tracking: The Slack user ID is used as the session ID, so conversation context is maintained per user.

Bot messages ignored: The handler skips messages with a bot_id to avoid infinite loops.