Slack Integration

Slack Configuration: requires Slack Bot Token and App Token

Slack Setup and how to get App Token and Bot Token

1

Create a new Slack app at https://api.slack.com/apps

2

Choose "From a manifest"

3

Choose a workspace and Paste the App Manifest JSON below to the create an app

1. Edit the App Name, App Description, Bot Name, below before Pasting

2. Paste the JSON below to create an 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

Settings -> Basic Information -> App-Level Tokens

Generate an App-Level Token with connections:write scope. This is App Token

5

Features -> App Home -> Show Tabs -> Messages Tab: enable the Messages Tab Check,and Allow users to send Slash commands and messages from the messages tab

6

Settings -> Install app, install the app to your workspace. Get the Bot User OAuth Token. This is Bot Token

7

Add the app to any channels where you want the agent to operate (it'll only see messages in channels it's added to)

8

On the Frevana Agent team buit-in UI, Tap "Connect Chat Apps" button and Enter the Bot Token and App Token, Save and Done! 🎉

---

OR, if you choose "From scratch", use steps below

1

Create a new Slack app at https://api.slack.com/apps

2

Choose "From scratch"

3

Enable Socket Mode (Settings → Socket Mode → Enable)

4

Generate an App-Level Token with connections:write scope. This is App Token

5

Add Bot Token Scopes (OAuth & Permissions):

• 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

Subscribe to Bot Events (Event Subscriptions):

• app_mention

• message.channels

• message.groups

• message.im

6

Enable Direct Messages (App Home): Go to App Home in the left sidebar Under Show Tabs, enable the Messages Tab Check Allow users to send Slash commands and messages from the messages tab

7

Install the app to your workspace. Get the Bot User OAuth Token. This is Bot Token

8

Add the app to any channels where you want the agent to operate (it'll only see messages in channels it's added to)

9

On the Frevana Agent team buit-in UI, Tap "Connect Chat Apps" button and Enter the Bot Token and App Token, Save and Done 🎉