How do I configure the Slack capability?

To let your agent communicate on your Slack server, you need to

Step 1: Create a Slack app

Here is a simple quick-start guide. For more comprehensive info, see api.slack.com/docs.

The easiest way to create a Slack app is to use a manifest file as a template. Copy the template below,

{
   "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"
         ]
      }
   },
   "settings":{
      "event_subscriptions":{
         "request_url":"https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook",
         "bot_events":[
            "app_mention"
         ]
      },
      "org_deploy_enabled":false,
      "socket_mode_enabled":false,
      "token_rotation_enabled":false
   }
}

Visit api.slack.com/apps
Click "Create New App"
Choose "From a manifest"
Paste the above manifest
Replace YOUR_APP_NAME, YOUR_APP_DESCRIPTION, and YOUR_BOT_DISPLAY_NAME with your own info.
Click "Next" and "Create". Your app is now installed!
Copy the App ID.
Go to "OAuth & Permissions" and press the installation button under "OAuth Tokens". After doing so you should see "Bot User OAuth Token". Copy that value as well.

Understanding bot_events (Optional Customization)

The manifest above configures your agent to only respond when @-mentioned in channels. This prevents the agent from interfering in all conversations.

app_mention - Agent responds when @-mentioned (✅ RECOMMENDED to prevent interference)

If you want different behavior, you can modify the bot_events section:

Add message.im - Agent responds to every direct message (1-on-1 conversations)
Add message.mpim - Agent responds to every message in multi-person DMs
Add message.channels and message.groups - Agent responds to ALL messages in channels it's a member of (⚠️ WARNING: This can cause the agent to interfere in conversations)

For more information:

The scopes define what the agent can do in Slack. See the full list of scopes.
The bot_events define which events trigger the agent. See the full list of events.

Step 2. Configure the Slack capability in Abundly

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

Step 3. Add the App in Slack

Before you can use your agent, you need to add it to your Slack workspace:

In Slack, look at the bottom of your left sidebar for the Apps section
Click Add apps
Search for your app by name (the YOUR_APP_NAME you used in the manifest)
Click to add it
This enables you to chat directly with your agent and use it in channels

Step 4. Invite the Agent to Channels

Your agent must be invited to any channels where you want it to respond:

In Slack, open each channel where you want the agent to work
Type /invite @AgentName (where AgentName is the name of your bot)
The agent can now receive and respond to @-mentions in these channels

Troubleshooting: If the manifest approach didn't work

If you created your Slack app manually (without using the manifest), you may need to configure these settings:

Event Subscriptions:

In Slack app settings, click "Event Subscriptions"
Set "Request URL" to: https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook
Ensure "Enable Events" is ON
Under "Subscribe to bot events", add app_mention

OAuth Scopes:

In Slack app settings, click "OAuth & Permissions"
Under "Bot Token Scopes", ensure these are present:
- 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 added new scopes, reinstall the app and update the Bot Token in Abundly