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.
- Activate Provider: Supply the required credentials (e.g., Bot Token) to activate the channel.
- Link Identities: Users interacting with the bot can be linked to their RootCX identities, ensuring RBAC and accountability are still enforced.
- Session Routing: Messages are mapped to agent sessions directly. The agent's context and conversation history are preserved.
Using Studio
You can manage Channels directly from the Channels tab in Studio:
- Activate: Select a provider such as Telegram and enter your Bot Token.
- Configure: Once active, the provider will automatically configure webhooks to point back to the Core.
Connecting Telegram
Telegram bots are the easiest way to expose an agent to the public or an internal team.
- Message @BotFather on Telegram.
- Use the
/newbotcommand to create a new bot and obtain the Bot Token. - In the RootCX Studio Channels page, select Telegram and paste the token.
- The system will automatically register the webhook endpoint:
/api/v1/channels/telegram/{channel_id}/webhook.
API Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/channels |
List all channels |
| POST | /api/v1/channels |
Create a channel |
| POST | /api/v1/channels/{channel_id}/activate |
Activate a channel with credentials |
| POST | /api/v1/channels/{channel_id}/deactivate |
Deactivate a channel |
| DELETE | /api/v1/channels/{channel_id} |
Delete a channel |