Skip to main content

Slack Agent

Slack Agent lets you connect a dedicated Slack app identity to a flow. Each Slack Agent integration maps to one Slack app (bot identity), so you can create distinct identities (Sales, HR, Onboarding, etc.) and attach each to its own flow.

Navigate to https://api.slack.com/apps/ and create the Slack app from a manifest in the Slack console. This is the recommended and supported setup path for Slack Agent.

  1. Open the Slack Apps console and click Create New App.
  2. Choose From an app manifest.
  3. Select the workspace where you want to install the app.
  4. Paste the JSON below and create the app.
{
  "display_information": {
    "name": "BotDojo(Replace with your own name)",
    "background_color": "#131934"
  },
  "features": {
    "app_home": {
      "home_tab_enabled": false,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "bot_user": {
      "display_name": "BotDojo Agent(Replace with your own bot name)",
      "always_online": false
    }
  },
  "oauth_config": {
    "redirect_urls": [
      "https://app.botdojo.com/integrations/slack-agent/oauth_redirect"
    ],
    "scopes": {
      "bot": [
        "app_mentions:read",
        "chat:write",
        "channels:history",
        "groups:history",
        "im:history",
        "im:write"
      ],
      "user": [
        "users:read",
        "users:read.email"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://api.botdojo.com/integrations/slack-agent/webhooks/",
      "bot_events": [
        "app_mention",
        "message.im",
        "message.channels",
        "message.groups"
      ]
    },
    "org_deploy_enabled": false,
    "socket_mode_enabled": false,
    "token_rotation_enabled": false
  }
}

After creating the app from the manifest, open Basic Information and copy these values (you will enter them in BotDojo):

  • Client ID
  • Client Secret
  • Signing Secret

Connect the Slack app in BotDojo​

  1. In BotDojo, go to Account → Integrations.
  2. Select Slack Agent.
  3. Enter Agent Name, Client ID, Client Secret, and Signing Secret.
  4. Click Connect and complete the Slack OAuth flow (this installs the app into the workspace).

Attach the Slack Agent to a flow​

  1. Open the flow in the Flow Builder.
  2. On the Start Node, click Add Trigger → Integration Trigger.
  3. Choose Slack Agent and select the integration you just created.
  4. Pick Slack Agent Message as the trigger type.
  5. Configure options:
    • Message Source: DMs, Mentions, or Both.
    • Trigger on all messages in a bot thread: if enabled, the bot will respond to thread replies after the initial mention.
    • Auto-reply from End Node output: if enabled, the flow’s End Node output is posted back to Slack automatically.
  6. Click Apply Changes.

Behavior notes​

  • DM sessions: all DM messages with the bot share a single session (tied to the DM channel).
  • Channel mentions: a mention starts a session tied to that thread.
  • If Trigger on all messages in a bot thread is off, and a user mentions the bot inside an existing thread, the trigger includes thread_context (a concatenated view of user messages since the last bot message) so the flow can still respond with context.