Skip to main content
Open Settings → Sidekick → Chat Surfaces to connect Slack. Once connected, people can mention Sidekick from a channel or direct message and continue the same thread they’d otherwise work in from the app. See Slack and Teams for what that looks like day to day. There are two ways to connect: a managed one-click connect, or bringing your own Slack app.

​
Managed connect

Select Connect Slack and authorize the installation in your Slack workspace. This uses a Slack app Oximy already operates, so there’s nothing further to configure.

​
Bring your own Slack app

Use your own Slack app when you want the integration to run under an app your company controls.
1

Create a Slack app

In your Slack workspace, create a new Slack app.
2

Configure request URLs

Sidekick shows the request URLs to enter in your Slack app’s configuration, for events and for interactive components. Copy each one into the matching field in your Slack app.
3

Set scopes

Sidekick lists the bot token scopes the app needs. Add each one under OAuth & Permissions in your Slack app.
4

Set event subscriptions

Sidekick lists the events it needs to subscribe to, such as mentions and messages. Add each one under Event Subscriptions in your Slack app, using the request URL from the previous step.
5

Enter your app's credentials

Back in Sidekick, enter your Slack app’s team ID, bot token, and signing secret.
6

Install and test

Install the app in your Slack workspace, then mention Sidekick from a channel to confirm the connection works.
The bot token and signing secret are write-only. Once saved, Sidekick won’t display the value again; to change it, enter a new one.

​
Disconnect

Each Slack install can be disconnected on its own. Disconnecting stops Sidekick from responding in that Slack workspace; existing threads and their transcripts stay in Sidekick.

​
Where to go next

Slack and Teams

What using Sidekick from Slack looks like day to day.

Teams

Connect Microsoft Teams as a chat surface too.