Set up Slack
Connect your company’s Slack app with one configuration refresh token. Studio configures the app, then opens Slack’s Allow screen.
Open Connections, then Slack. The page says: Your company's Slack app. People tag it in Slack to reach their agents.
Configure Slack
Paste the Configuration refresh token (starts with xoxe-) from Your App Configuration Tokens in Slack, then press Configure. Studio creates the app from its manifest, sets the name, description and icon, and opens Slack’s installation screen. Slack’s Allow consent cannot be skipped.
After Allow, Studio saves and checks the connection. The page shows Connected and offers a test message. The rotated refresh token is stored securely for later display and workflow manifest updates; no bot-credential paste is needed. Studio answers Slack’s signed address verification during setup. After Allow, if verification is still missing, Studio retries it automatically using the saved app configuration. A verification warning means the connection is saved but Slack has not confirmed the receiving address yet; reload the page to check its status.
An unfinished setup offers Continue in Slack and Start over. Start over asks for confirmation, then clears the unfinished setup and its saved credentials; it never deletes the app in Slack. If Slack explicitly reports that the pending app no longer exists, Studio clears its setup automatically and explains how to configure again. Set it up by hand instead opens the manual steps below.
The same saved connection serves Slack workflow starts, Send Slack and approval messages. Existing credentials continue to work. Remove connection stops Studio using the connection; uninstall the app in Slack to remove it from the workspace too.
Where setup stands
The first block names the state. While it is Paused, or Paused by someone, press Resume Slack. The Pause Slack and Resume Slack choices sit on that block.
| What it says | What it means |
|---|---|
| Not connected | Paste a configuration refresh token and choose Configure. |
| Connected | Connected to the workspace as @ the app, once a check has named them. |
| Live | People can tag the app in Slack to reach their agents. |
| Paused | Paused, or Paused by the person who paused it. Resume Slack turns it back on. |
| Needs attention | The token check could not be read. Press Try again. Nothing was changed. |
| Example setup only | This example does not check a real Slack token or deliver messages. |
Manual setup: create your Slack app
Your company owns the app, so replies come from its own name and icon.
- Name. What people tag in Slack. 3 to 35 characters.
- Description. 1 to 140 characters.
- Icon. Default, Your brand logo, or a custom PNG uploaded for this app. PNG icons must be square, 512 to 2000 pixels and at most 4 MiB.
- Create in Slack fills in the app from the manifest. Review the permissions before installing. You can also copy the manifest.
Manual setup: connect it
Paste the two secrets from your Slack app. Studio checks them and fills in the workspace and app details itself.
- Bot token. Starts with xoxb-. In Slack: your app, OAuth and Permissions, Bot User OAuth Token.
- Signing secret. 32 letters and numbers. In Slack: your app, Basic Information, App Credentials.
- Press Connect. A saved secret is kept safe and is never shown again.
- Disconnect Slack removes the connection.
Try it
- Write a Test message and choose Send to (a channel id, #channel, or @person). Press Send test message.
- While Test mode is on, the page says: Test mode is on: messages are kept here, not posted. Turn off to send to the Slack target you chose.
- People can tag the app to reach their agents turns Slack on. Finish connecting first.
- Under Advanced, When it's not clear which workflow a message is for offers Ask more often, Balanced, and Ask less often. An AI check picks the most likely one. If it is not sure enough, the app asks the person to choose from a short list.