Documentation
Slack

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, Select From scratch or From an app manifest. For this guide we'll select From 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 select app_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.

© 2024 ProteusAI. All rights reserved