Slack - Tembo Docs

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

Go to api.slack.com/apps and click Create New App
Choose From scratch
Fill in:

Field	Value
App Name	e.g. `Tembo (self-hosted)`
Workspace	Select your workspace

Click Create App

Step 2: Configure OAuth & Permissions

In the left sidebar, go to OAuth & Permissions

Under Redirect URLs, add:

http://<your-instance-ip>/api/oauth/slack/callback

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
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

In the left sidebar, go to Event Subscriptions
Toggle Enable Events to on
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.
Under Subscribe to bot events, add:
- app_mention
- message.channels
- message.groups
- message.im
- message.mpim
- reaction_added
- team_join
Click Save Changes

Step 4: Enable Interactivity

In the left sidebar, go to Interactivity & Shortcuts
Toggle Interactivity to on

Set the Request URL to:

http://<your-instance-ip>/api/integration/slack/interaction

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

In the left sidebar, go to Install App
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>"
}

Key	Where to find it
`slack.appId`	Basic Information page, listed as App ID
`slack.clientId`	Basic Information page, listed as Client ID
`slack.clientSecret`	Basic Information page, listed as Client Secret
`slack.signingSecret`	Basic 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

Go to your Tembo instance and navigate to Settings > Integrations
Click Connect on the Slack integration
Authorize the app in your workspace
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.

​Overview

​Step 1: Create a Slack App

​Step 2: Configure OAuth & Permissions

​Step 3: Enable Event Subscriptions

​Step 4: Enable Interactivity

​Step 5: Install the App to Your Workspace

​Step 6: Configure Tembo

​Step 7: Verify

​Need Help?