CA
Docs home

Connect channels

Channels let people talk to an agent from the tools they already use. A channel connects one external bot or app to one Cloud Agents agent.

Start in the web workspace first. Once the agent behaves the way you expect, connect it to a channel.

Supported channels

ChannelGood for
TelegramFast personal or group bot access.
SlackWorkspace mentions, direct messages, and threaded team workflows.
Lark / FeishuTeam chat workflows in Lark or Feishu workspaces.
DiscordCommunity or server-based agent access.
MatrixOpen chat deployments and self-managed homeservers.

Setup pattern

Most channels follow the same shape:

  1. Create a bot or app in the external service.
  2. Copy the token or app secret.
  3. Open Settings -> Channels in Cloud Agents.
  4. Create a new channel and select the target agent.
  5. Paste the token or app secret.
  6. Save and test the channel.
  7. If Cloud Agents shows an inbound URL, paste it into the external service’s event or webhook settings.

Session behavior

By default, channels keep conversations separate by user, direct message, room, or thread where the provider supports it. Some channel settings let a group share one agent session. Use shared sessions only when everyone in the channel should see the same context.

Security habits

  • Create a dedicated bot for each agent or team workflow.
  • Grant only the message permissions the bot needs.
  • Keep tokens in channel settings, not in chat messages.
  • Pause or delete channels that are no longer used.
  • Test in a private room before inviting the bot to a large group.

Channel guides