How do I configure the Slack capability?

To let your agent communicate on your slack server, you need to:

1. Create a Slack App and obtain a bot token and an App ID.
2. Enable the Slack capability in Abundly and paste in those two values.

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",
            "message.im",
            "message.mpim"
         ]
      },
      "org_deploy_enabled":false,
      "socket_mode_enabled":false,
      "token_rotation_enabled":false
   }
}

1. Visit api.slack.com/apps
2. Click "Create New App"
3. Choose "From a manifest"
4. Paste the above manifest
5. Replace YOUR_APP_NAME, YOUR_APP_DESCRIPTION, and YOUR_BOT_DISPLAY_NAME. You can use your agent name for these.
6. OPTIONAL: adjust the scopes and bot_events if you like.

• The scopes define what the agent can do in slack. Here is the full list of scopes.
• The bot_events define which types of events will cause the agent to be triggered. Without bot_events the agent can only send and not receive messages on slack. Here the full list of events.
• Tip: With the configuration above, your agent will only be triggered if at-mentioned. If you want the agent to be triggered for all slack messages in the channels that it is a member of, then add message.channels and message.groups to bot_events.
• NOTE: The request_url link will probably change in the future. If you notice that your agent no longer receives slack messages, check back on this page.

1. Click "Next" and "Create". Your app is now installed!
2. Copy the App ID.
3. Go to "Oauth & Permission" and press the installation button under "OAuth Tokens". After doing so you should see "Bot User OAuth Token". Copy that value as well.

Step 2. Configure the slack capability in Abundly

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

• token: this is the "Bot User OAuth Token" that you copied in the last step.
• appId: this is the "App ID" that you copied in the last step.

Done! You should now be able to interact with your agent on slack.