> ## Documentation Index
> Fetch the complete documentation index at: https://oximy.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Connect Sidekick to your company's Slack workspace.

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](/docs/sidekick/use/slack-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.

<Steps>
  <Step title="Create a Slack app">
    In your Slack workspace, create a new Slack app.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Set scopes">
    Sidekick lists the bot token scopes the app needs. Add each one under OAuth & Permissions in your Slack app.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Enter your app's credentials">
    Back in Sidekick, enter your Slack app's team ID, bot token, and signing secret.
  </Step>

  <Step title="Install and test">
    Install the app in your Slack workspace, then mention Sidekick from a channel to confirm the connection works.
  </Step>
</Steps>

<Note>
  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.
</Note>

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

<CardGroup cols={2}>
  <Card title="Slack and Teams" icon="message-circle" href="/docs/sidekick/use/slack-teams">
    What using Sidekick from Slack looks like day to day.
  </Card>

  <Card title="Teams" icon="video" href="/docs/sidekick/admin/teams">
    Connect Microsoft Teams as a chat surface too.
  </Card>
</CardGroup>