Connecting a channel

Connecting a messaging channel is a one-command flow you run from the chat platform itself. Type /claos connect, follow the link the bot returns, sign in, and the connection is live. This article walks the flow on each supported platform and what to do when it doesn't work.

The general pattern

It's the same shape on every platform:

1. In the chat platform, find the Claos bot (DM it, or @mention it in a channel where it's been invited).
2. Send /claos connect.
3. The bot replies with a sign-in link.
4. Click the link. You'll land on a Claos page asking you to confirm — sign in if you're not already, and pick the workspace you want this platform identity to point at.
5. Confirm. The bot edits its message to "Connected" and you're done.

From that point on, anything you say to the bot reaches your agents in the workspace you picked.

Per-platform notes

The shape is the same; the small details differ.

Slack

DM the Claos app directly (search "Claos" in your sidebar) and send /claos connect. You can also run the command in any channel where the Claos app has been added — admins need to invite the app to the channel first.

If you don't see the Claos app in Slack, your workspace admin hasn't installed it yet — they'll need to add the Claos Slack app to your Slack workspace from the App Directory.

Telegram

Find @ClaosBot (or the bot handle your workspace admin shared) and start a chat. Send /claos connect. Click the link in the bot's reply. The browser will ask which Claos workspace to link this Telegram handle to.

Discord

Invite the Claos bot to your server (admins do this once via the OAuth invite link in Settings → Channels), then DM the bot or @mention it in a channel where it's been added. Run /claos connect and follow the same sign-in flow.

WhatsApp

Save the Claos WhatsApp number your workspace admin shared, message it, and reply with /claos connect. WhatsApp doesn't have slash-command UI per se — just send the text. The bot replies with a sign-in URL.

Disconnecting

Open Settings → Channels in the web app and click Disconnect on the channel's card. Two things happen:

• The link between that platform identity and your workspace is removed. Future messages from that account no longer reach agents — the bot replies "not connected, run /claos connect to link."
• The bot stays in the workspace/server/group on the third-party side. Disconnect in Claos doesn't remove the bot from your Slack workspace or Discord server; an admin does that on the third-party app's side if they want a full removal.

When it doesn't work

A few common failure modes and what to try:

• "Not connected" after clicking the link. The sign-in window might have closed before the handshake finished. Re-run /claos connect and click the new link.
• /claos connect does nothing in a Slack channel. The Claos app probably hasn't been invited to that channel. Either DM the app directly or ask an admin to invite it.
• Connected, but the agent never replies. Make sure the workspace you linked has an agent enabled for chat — channels respect the same agent roster the web app does. If your workspace's agents are all paused, the bot has nothing to route to.
• Linked the wrong workspace. Open Settings → Channels in the workspace the bot is currently linked to, disconnect, then re-run /claos connect from the chat platform and pick the right workspace on the confirmation page.

Tips and gotchas

• One workspace per platform identity at a time. Your personal Slack handle can only point at one Claos workspace at a time. To switch, disconnect from the old workspace and reconnect from the new one.
• Each member connects separately. When your colleague wants to chat from Slack too, they run /claos connect from their own Slack account. Connecting yours doesn't connect theirs.
• Workspace-wide setup is admin-only. Inviting the Claos app to a Slack workspace, adding the bot to a Discord server, or sharing the WhatsApp number with the team — all admin-side steps. The per-user /claos connect is the part each member does for themselves.

Related

• What are messaging channels?
• Chatting with agents from a channel
• What are integrations?