Skip to main content
The Slack Companion App connects your service threads to your own Slack workspace. Route new threads to the channels you choose, see updates in-line as they happen, and act on a thread without leaving Slack.
This guide connects the Companion App to your own Slack workspace, for your service team. To deploy a Slack app to a customer’s workspace, that’s the Slack Service App, a different app for a different audience.
You can install either the Slack Companion App or the Slack Service App in a given Slack workspace, not both in the same workspace.

What you get

  • Custom Flows that route newly created threads to the channels you pick — useful for urgent incidents, or for sending new requests to the right team.
  • In-line updates, notes included, posted back to the originating channel so the team stays current without the channel turning noisy.
  • Actions: change status, priority, board or contact on a thread and it syncs straight to your ticketing system.
  • Time entries, added directly from Slack.
  • Assign To, for managers and dispatchers.
  • Slash commands: /thread ticket creates a service thread, /thread help gets help.
  • Ticket mention cards: when someone writes “Thread #123” in a channel, the app posts a live card for that ticket. To stop this, go to Integrations → Slack and turn off Ticket mention cards on the Companion App card. It’s on by default.

Before you start

Deploy using a generic Slack admin account, not your personal one. If a personal account is ever decommissioned or has its permissions reduced, the app stops working and needs redeploying.

Connect Slack

1

Open the Slack integration

In the Thread Admin Panel, go to Integrations → Slack and click Connect.
Slack tile on the Integrations page of the Thread Admin Panel with a Connect button
2

Choose Connect with Slack

Connect with Slack option in the Thread Admin Panel
3

Sign in and pick the workspace

Sign in to Slack and select the workspace you want to connect.
Slack sign-in screen with a workspace selector
4

Allow the requested permissions

Slack shows what access the Thread app will have. Click Allow. The full breakdown is in the Slack permissions guide.
Slack permission screen listing the access requested by the Thread app
5

Check for the welcome message

You should now see a welcome message from the Thread app in Slack.
Welcome message from the Thread app in a Slack workspace

Move from the legacy ChatGenie app

New Slack connections install the Thread app. If your workspace still runs the legacy ChatGenie Slack app, it keeps working until you move, and Thread posts New Slack Companion app available from Thread in your own Slack workspace as a reminder. You don’t need to uninstall anything first. Super Magic in Slack (beta) works only with the Thread app, so move before your team uses it.
1

Open the Slack integration

In the Thread Admin Panel, go to Integrations → Slack.
2

Click Reintegrate

Click Reintegrate, next to Disconnect.
3

Approve the app in Slack

A Slack admin approves the Thread app. Thread then migrates your workspace in place.
What happens when you reintegrate:
  • Nothing is lost. You keep the same Slack workspace, channels, flows and settings, and the integration keeps working throughout.
  • The legacy app is disconnected automatically. Its access is revoked, so it stops working right away. Slack may still list it as an inactive app under Manage apps. Removing that entry is optional.
  • Old cards stay, but their buttons stop working. Ticket cards the ChatGenie app already posted still show in your channels. Cards the Thread app posts work normally.
  • The workspace can’t change. Reintegrating into a different Slack workspace is blocked. To switch workspaces, click Disconnect first, then connect the new workspace.
  • A failed approval changes nothing. If the Slack approval is cancelled or fails, you land back on the Slack integration page with a message, and your current app keeps working.
Reintegrating doesn’t affect the Slack Service Apps you deploy to your customers’ workspaces. You can also use Reintegrate any time the Slack Companion App is connected, for example to pick up new permissions. It re-authorizes the app in place, without removing anything.

Replying so the customer sees it

By default a message you send in Slack is recorded as an internal note. To send it as an external note the customer can see, add !send to the end:
  • Internal note — Checking on this issue now.
  • External note — We're looking into this for you. !send

Next step

Set up which ticket updates post to a channel, then see how to use the Slack Companion App day to day.