Channels Overview

Channels connect Xagent to external chat platforms so users can interact with agents and tasks outside the web app. In the current implementation, channels are user-owned integrations.

How Channels Work

  1. Create a bot or app on the target platform.
  2. Add the credentials in Xagent.
  3. Activate the channel.
  4. Send messages from the external platform.
  5. Xagent creates or continues tasks for that conversation in the channel owner's workspace.

Channels are managed from the Channels page and the /api/channels endpoints.

GET    /api/channels          # list your channels
POST   /api/channels          # create a channel
PUT    /api/channels/{id}     # update a channel
DELETE /api/channels/{id}     # delete a channel

Supported Platforms

Typical use cases include personal assistant bots, internal team bots, and lightweight task intake from chat.

Shared Channel Concepts

FieldDescription
channel_typePlatform type, e.g. telegram or feishu.
channel_nameA readable display name.
configPlatform-specific configuration.
is_activeWhether the bot or app should currently be running.

Protected secrets

Sensitive fields inside config (such as bot tokens) are stored as protected channel secrets.

Next Steps