Skip to main content

​
Overview

The Slack integration allows Tembo to send notifications, receive commands, and stream session updates to your Slack workspace. On the SaaS platform this is pre-configured — on self-hosted you need to create your own Slack app and point it at your instance.

​
Step 1: Create a Slack App

  1. Go to api.slack.com/apps and click Create New App
  2. Choose From scratch
  3. Fill in:
FieldValue
App Namee.g. Tembo (self-hosted)
WorkspaceSelect your workspace
  1. Click Create App

​
Step 2: Configure OAuth & Permissions

  1. In the left sidebar, go to OAuth & Permissions
  2. Under Redirect URLs, add: 
    http://<your-instance-ip>/api/oauth/slack/callback
  3. Under Bot Token Scopes, add the following scopes:
    • app_mentions:read
    • channels:history
    • channels:join
    • channels:read
    • chat:write
    • emoji:read
    • files:read
    • files:write
    • groups:history
    • groups:read
    • im:history
    • im:read
    • im:write
    • mpim:history
    • mpim:read
    • reactions:read
    • reactions:write
    • team:read
    • users:read
    • users:read.email
  4. Under User Token Scopes, add the following scopes:
    • channels:history
    • im:history
    • search:read.public
    • search:read.im
    • search:read.files
    • search:read.users
    • users:read
    • users:read.email

​
Step 3: Enable Event Subscriptions

  1. In the left sidebar, go to Event Subscriptions
  2. Toggle Enable Events to on
  3. Set the Request URL to: 
    http://<your-instance-ip>/api/webhook/slack
    Slack will send a verification challenge to this URL — it should respond with a 200 once your instance is running.
  4. Under Subscribe to bot events, add:
    • app_mention
    • message.channels
    • message.groups
    • message.im
    • message.mpim
    • reaction_added
    • team_join
  5. Click Save Changes

​
Step 4: Enable Interactivity

  1. In the left sidebar, go to Interactivity & Shortcuts
  2. Toggle Interactivity to on
  3. Set the Request URL to: 
    http://<your-instance-ip>/api/integration/slack/interaction
  4. Click Save Changes
This enables buttons, overflow menus, and modal forms (e.g. the feedback modal) to work in Slack messages from Tembo.

​
Step 5: Install the App to Your Workspace

  1. In the left sidebar, go to Install App
  2. Click Install to Workspace and authorize

​
Step 6: Configure Tembo

From the Slack app settings page under Basic Information, gather the following values:
  • App ID
  • Client ID
  • Client Secret
  • Signing Secret
Open /var/lib/tembo/config.json (via the VS Code server at http://<your-instance-ip>:8888 or via SSH) and add the following keys: 
{
  "slack.appId": "<your-slack-app-id>",
  "slack.clientId": "<your-slack-client-id>",
  "slack.clientSecret": "<your-slack-client-secret>",
  "slack.signingSecret": "<your-slack-signing-secret>"
}
KeyWhere to find it
slack.appIdBasic Information page, listed as App ID
slack.clientIdBasic Information page, listed as Client ID
slack.clientSecretBasic Information page, listed as Client Secret
slack.signingSecretBasic Information page, listed as Signing Secret
After saving, restart the API: 
sudo systemctl restart tembo-ts-api
Updating the config.json will also cause the instance API to restart automatically.

​
Step 7: Verify

  1. Go to your Tembo instance and navigate to Settings > Integrations
  2. Click Connect on the Slack integration
  3. Authorize the app in your workspace
  4. Try mentioning the bot in a channel or sending it a direct message

​
Need Help?

If you run into any issues, contact support@tembo.io.