Skip to Content
GuidesChannelsSlack

Slack setup

Connect your agent to Slack with your own Slack app. Cohort gives you a ready-made app manifest, so setup is mostly copy and paste: create the app from the manifest, install it, and paste two tokens and your member ID into Cohort. It takes about five minutes.

You’ll need: permission to create and install apps in your Slack workspace, and your Slack member ID (so your agent knows it’s you).

Step 1: Start the wizard

  1. In Cohort, go to Settings → Channels and click Connect on Slack.
  2. Choose which agent the Slack app is for. The wizard shows a manifest for that agent.
  3. Click Copy to copy the manifest.

Step 2: Create the Slack app from the manifest

  1. Go to api.slack.com/apps  and click Create New App.
  2. Choose From an app manifest, pick your Slack workspace, and paste the manifest.
  3. Review and create the app.

Step 3: Install the app and copy the bot token

  1. In the app’s settings, open Install App and install it to your workspace.
  2. Copy the Bot User OAuth Token. It starts with xoxb-.

Step 4: Generate an app-level token

  1. Open Basic Information and scroll to App-Level Tokens.
  2. Generate a token with the connections:write scope.
  3. Copy it. It starts with xapp-.

Step 5: Connect in Cohort

  1. Paste the Bot User OAuth Token and the App-Level Token into the wizard.
  2. Enter Your Slack member ID, such as U12345678. In Slack, open your profile, click the ⋯ menu, and choose Copy member ID.
  3. Click Connect. Cohort checks both tokens with Slack before saving them.

Then message your agent in Slack, in a direct message or by @mentioning it in a channel it has been added to.

Troubleshooting

The agent doesn’t reply.

  • Make sure the member ID is yours: your agent answers only you.
  • For channel messages, invite the app to the channel and @mention it.
  • Give it a few seconds for the first message.

“Paste a Bot User OAuth Token that starts with xoxb-.” You pasted a different token. Copy the one under Install App.

“Paste an App-Level Token that starts with xapp-.” Generate an app-level token under Basic Information → App-Level Tokens with the connections:write scope.

Start over. Disconnect Slack in Settings → Channels, then run the wizard again.

Last updated on
iMessageTelegram