Skip to main content
Your agent can communicate with you and your team using Slack. It can search, read, respond, and post messages, depending on how you configure your Slack app. Each Slack-enabled agent will have its own identity on Slack, and therefore have its own Slack app ID and token which you need to configure.

​
How to enable

Go to Settings → Capabilities and enable Slack. Then enter a token and Slack app ID (see below for details on that).

​
Example use cases

  • “Post a daily standup summary to #engineering every morning”
  • “Whenever a new potential customer is mentioned on the #sales channel, do some research on how the customer fits our ideal customer profile, and add relevant information to the slack thread”
  • “Notify #alerts when you are unable to solve a support ticket”

​
How to connect to your Slack workspace

1

Create a Slack app

The easiest way to create a Slack app is to use a manifest file as a template.
  1. Visit api.slack.com/apps
  2. Click Create New App → From a manifest
  3. Select your workspace and paste the manifest template below
  4. Replace YOUR_APP_NAME, YOUR_APP_DESCRIPTION, and YOUR_BOT_DISPLAY_NAME with your own values
  5. Click Next and Create
Manifest template
{
  "display_information": {
    "name": "YOUR_APP_NAME",
    "description": "YOUR_APP_DESCRIPTION",
    "background_color": "#000000"
  },
  "features": {
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "bot_user": {
      "display_name": "YOUR_BOT_DISPLAY_NAME",
      "always_online": true
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:read",
        "chat:write",
        "groups:read",
        "im:read",
        "users:read",
        "channels:history",
        "groups:history",
        "im:history",
        "channels:join",
        "im:write",
        "mpim:history",
        "reactions:write",
        "reactions:read",
        "files:read",
        "files:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook",
      "bot_events": [
        "app_mention",
        "message.im",
        "message.mpim"
      ]
    },
    "org_deploy_enabled": false,
    "socket_mode_enabled": false,
    "token_rotation_enabled": false
  }
}
With the default configuration, your agent is triggered only when @-mentioned. To trigger the agent for all messages in channels it’s a member of, add message.channels and message.groups to bot_events.
2

Copy your credentials

After creating the app:
  1. Copy the App ID from the Basic Information page
  2. Go to OAuth & Permissions and click Install to Workspace
  3. Copy the Bot User OAuth Token that appears after installation
3

Configure in Abundly

Go to Settings → Capabilities, enable Slack, and paste in the bot token and app ID.
4

Invite to channels

In each Slack channel where you want the agent to work, type /invite @YourAgentName.

​
Customizing scopes and events

The manifest includes default scopes and events that work for most use cases. You can customize these in your Slack app settings:
SettingDescription
ScopesDefine what the agent can do in Slack. See the full list of scopes.
Bot eventsDefine which events trigger the agent. Without bot events, the agent can only send messages, not receive them. See the full list of events.

​
Troubleshooting

  1. Add the app in Slack — In Slack, go to Apps and click “Add apps” to add your app
  2. Check event subscriptions — In your Slack app settings, go to Event Subscriptions and ensure:
    • The Request URL is set to https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook
    • The “Enable Events” toggle is ON
  3. Verify bot events — You need app_mention and message.im at minimum
  4. Invite the agent — Type /invite @YourAgentName in the channel
By default, the agent only responds to direct @mentions. To respond to all messages in a channel, add message.channels and message.groups to your bot events in the Slack app settings, then reinstall the app.
Ensure your Slack app has these minimum scopes:
  • channels:read — To see public channels
  • groups:read — To see private channels
  • chat:write — To send messages
  • app_mentions:read — To receive mentions
If you’ve added new scopes, reinstall the app using the Install to Workspace button, then update the new bot token in Abundly.