Connect Slack to Frevana

Connect your Slack workspace to Frevana so your agent can work in the channels and direct messages you choose. You will need a Slack Bot Token and App Token to complete the connection.

Keep both tokens private. Treat them like passwords and store them only in a secure location.

Set up Slack with an app manifest

Using an app manifest is the fastest way to configure the Slack permissions Frevana needs.

1. Go to Slack API: Your Apps and select Create New App.

2. Choose From a manifest.

   

3. Choose the workspace you want to connect. Before pasting the manifest below, update the App Name, App Description, and Bot Name values to suit your team. Then paste the manifest and create the app.

   {
     "display_information": {
       "name": "App Name",
       "description": "App Description",
       "background_color": "#6a7aab"
     },
     "features": {
       "bot_user": {
         "display_name": "Bot Name",
         "always_online": true
       }
     },
     "oauth_config": {
       "scopes": {
         "bot": [
           "users:read",
           "reactions:write",
           "app_mentions:read",
           "channels:history",
           "channels:read",
           "chat:write",
           "files:read",
           "files:write",
           "groups:history",
           "groups:read",
           "im:history",
           "im:read",
           "im:write"
         ]
       },
       "pkce_enabled": false
     },
     "settings": {
       "event_subscriptions": {
         "bot_events": [
           "app_mention",
           "message.channels",
           "message.groups",
           "message.im"
         ]
       },
       "interactivity": {
         "is_enabled": true
       },
       "org_deploy_enabled": false,
       "socket_mode_enabled": true,
       "token_rotation_enabled": false
     }
   }

4. Create an App Token:

   • Go to Settings > Basic Information > App-Level Tokens.
   • Select Generate Token and Scopes, then add the connections:write scope.
   • Copy the generated token. This is your App Token.

5. Enable direct messages for the app. Go to Features > App Home, then under Show Tabs, enable Messages Tab and allow users to send messages and slash commands from the Messages tab.

6. Install the app. Go to Settings > Install App, install it to your workspace, and copy the Bot User OAuth Token. This is your Bot Token.

7. Add the app to every channel where you want it to work. The app can access messages only in channels it has joined.

8. In Frevana, select Connect Chat Apps, enter your Bot Token and App Token, then select Save.

   

Set up Slack from scratch

Prefer to configure each setting yourself? Follow this path instead.

1. Go to Slack API: Your Apps, select Create New App, and choose From scratch.

   

2. Enable Socket Mode: go to Settings > Socket Mode and turn it on.

3. Create an App Token under Settings > Basic Information > App-Level Tokens. Add the connections:write scope, then copy the token.

4. Under Features > OAuth & Permissions, add these Bot Token Scopes:

   • app_mentions:read
   • reactions:write
   • channels:history
   • channels:read
   • chat:write
   • files:read
   • files:write
   • groups:history
   • groups:read
   • im:history
   • im:read
   • im:write
   • users:read

5. Under Features > Event Subscriptions, subscribe to these bot events:

   • app_mention
   • message.channels
   • message.groups
   • message.im

6. Enable direct messages. Under Features > App Home > Show Tabs, enable Messages Tab and allow users to send messages and slash commands from the Messages tab.

7. Install the app to your workspace and copy its Bot User OAuth Token. This is your Bot Token.

8. Add the app to the channels where you want it to operate, then connect it in Frevana with the Bot Token and App Token.