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.
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 ticketcreates a service thread,/thread helpgets 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
Connect Slack
1
Open the Slack integration
In the Thread Admin Panel, go to Integrations → Slack and click Connect.

2
Choose Connect with Slack

3
Sign in and pick the workspace
Sign in to Slack and select the workspace you want to connect.

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.

5
Check for the welcome message
You should now see a welcome message from the Thread app in Slack.

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