Slack
Interact with your AI character right from within Slack.
Setting up Slack Integration
- Navigate to https://api.slack.com/apps (opens in a new tab)
- Click the
Create New App
button, SelectFrom scratch
orFrom an app manifest
. For this guide we'll selectFrom scratch
. - Enter the app name and the workspace where you intend to have the app installed, and click
Create App
. - Under Add features and functionality click on
Permissions
. - Scroll down to Scopes and add the following scopes under Bot Token Scopes
- app_mentions:read
- chat:write
- incoming-webhook
- reactions:read
- Scroll up to OAuth Tokens for Your Workspace and click
Install to Workspace
- After the successful installation you get your Bot User OAuth Token
- Copy the Bot User OAuth Token
- On ProteusAI go to
Integrations
->App Integrations
->Add App Integration
->Slack
- Paste the Bot User OAuth Token in the input field and submit.
- Hover over the newly-added Slack Integration icon to expose the
</>
button. - Click the
</>
button to expose the Slack webhook. - Copy the Slack webhook.
- Go back to the Slack Apps page, to Events Subscriptions
- Enable events and paste the Slack webhook you copied earlier. Ensure you replace <YOUR_BOT_TOKEN> with the Bot User OAuth Token from a few steps earlier.
- Slack will immediately attempt to verify the webhook.
- On the same page, click on Subscribe to bot events
- Click on the
Add Bot User Event
and selectapp_mention
- Click
Save Changes
Testing the Slack Integration
- Go to the Slack workspace for which you installed the Slack app
- You should now be able to see the installed app under the Apps section
- Go to the Slack channel for which you installed the Slack app and send a message, making sure to tag the Slack app.