RootCX
Docs
Pricing
RootCX/RootCXSource Available
Introduction
What is RootCX?Getting StartedHow it Works
Build
ApplicationAI AgentIntegrationDeploying
Platform
CoreAuthenticationRBACData APISecret VaultJob QueueScheduled Jobs (Crons)Audit LogReal-time LogsChannels
Developers
React SDKBackend & RPCManifest ReferenceREST APICLIClaude CodeSelf-Hosting
DocsPlatformChannels

Channels

Channels allow you to connect external messaging platforms to your AI Agents, transforming them into conversational assistants available wherever your users are.

Currently, Telegram is natively supported.

How It Works

When you connect a channel, the platform establishes a two-way integration with the messaging provider.

  1. Activate Provider: Supply the required credentials (e.g., Bot Token) to activate the channel.
  2. Link Identities: Users interacting with the bot must be linked to their RootCX identities, ensuring RBAC and accountability are enforced.
  3. Session Routing: Messages are mapped to agent sessions. The agent's context and conversation history are preserved.

Using Studio

You can manage Channels directly from the Channels tab in Studio:

  1. Activate: Select a provider such as Telegram and enter your Bot Token.
  2. Configure: Once active, the provider will automatically configure webhooks to point back to the Core.
Channels with Telegram connected

Connecting Telegram

Telegram bots are the easiest way to expose an agent to the public or an internal team.

  1. Message @BotFather on Telegram.
  2. Use the /newbot command to create a new bot and obtain the Bot Token.
  3. In the RootCX Studio Channels page, select Telegram and paste the token.
  4. The system will automatically register the webhook endpoint.

Bot Commands

Once activated, the bot registers these commands with Telegram:

Command Description
/start Greet the user. Also used to complete account linking (see below).
/newsession Clear the current session and start a fresh conversation.
/agent Switch to a different agent or list all available agents.

Account Linking

Users must link their Telegram identity to a RootCX account for the agent to process their messages with proper RBAC enforcement.

  1. A logged-in user requests a link token via POST /api/v1/channels/{channelId}/link (returns a token valid for 5 minutes).
  2. The user sends /start link_<token> to the bot on Telegram.
  3. The system validates the token and links the Telegram chat to the RootCX user.
  4. The bot confirms the link and the user can start chatting with agents.

Unlinked users receive a prompt to complete the linking process.

Messaging Features

  • Typing indicator: The bot shows a typing indicator while the agent processes a message.
  • Tool approval buttons: When an agent requires approval for a tool call, Telegram inline keyboard buttons are displayed for approve/reject.
  • Agent switching: The /agent command shows available agents and allows switching mid-conversation.
  • Message debouncing: Long messages (4096+ characters) are debounced to avoid split-message issues.

API Endpoints

Method Path Description
GET /api/v1/channels List all channels
POST /api/v1/channels Create a channel
POST /api/v1/channels/{channelId}/activate Activate a channel with credentials
POST /api/v1/channels/{channelId}/deactivate Deactivate a channel
DELETE /api/v1/channels/{channelId} Delete a channel
POST /api/v1/channels/{channelId}/link Create account link token (5-min TTL)
GET /api/v1/channels/{channelId}/identity Check if current user is linked
PreviousReal-time LogsNextReact SDK

On this page

How It Works
Using Studio
Connecting Telegram
API Endpoints