Telegram

Telegram lets you chat with your agent and handle approvals from your phone. It connects to the same agent, conversations, and execution pipeline as the web app.

What you can do from Telegram

• Chat -- Send messages to your agent and get streamed responses, the same as web chat.
• Approve or reject trades -- When your agent proposes a trade in Suggest Only mode, Telegram shows an inline approval prompt. Tap to approve or reject without opening the web app.
• Approve or reject agent actions -- Non-trade approvals (like limit orders or leverage changes) also surface as inline buttons when the action supports Telegram-native approval.
• Answer agent questions -- When the agent asks a question with options, Telegram shows them as inline buttons. You can also reply with freeform text.
• Manage sessions -- Switch between conversations, start new ones, or view recent history.
• Check status -- View your agent's provider, model, and wallet configuration.

How to connect

There are two ways to link your Telegram account to Cabal:

From Telegram (bot-initiated)

1. Open the Cabal bot in Telegram.
2. Send /start.
3. The bot sends a link button. Tap it to open the web app and sign in.
4. Once signed in, your Telegram account is linked.

From the web app (web-initiated)

1. Go to Settings in the web app.
2. Open the Account tab, which shows your Telegram connection status.
3. Follow the link to the Cabal bot. The bot completes the link automatically using a code passed in the /start deep link.

After linking, send any message to the bot to start chatting.

Commands

Sessions and conversations

Telegram maintains one active conversation at a time. Your messages go to that conversation until you switch or start a new one.

• Use /new to clear the active session. Your next message starts a fresh conversation.
• Use /history to see your recent conversations and tap one to switch to it.
• Use /session to see which conversation is currently active.

The active conversation persists across messages. If you send a message and the bot has no active conversation set, it starts a new one.

Approvals

When your agent proposes a trade or action that requires approval:

1. The bot sends a message with the trade or action details.
2. Inline buttons appear: Approve and Reject (for trades), or Approve and Reject (for agent actions).
3. Tap one. The bot submits your decision to the orchestrator and updates the message with the result.

Some approvals require web review -- for example, actions whose surface capabilities do not include Telegram-native approval. In that case, the bot tells you to open the web app.

Trade approvals and agent action approvals are separate flows. Trade approvals use a reject:<tradeId> callback. Agent action approvals use an aa:a:<interactionId> or aa:r:<interactionId> callback.

What Telegram does not do

Telegram is a chat and approval surface. It does not provide:

• Agent configuration -- You cannot change your system prompt, control profile, guardrails, or bindings from Telegram. Use the web app.
• Activity or positions views -- There is no equivalent to the Activity timeline or Positions view. The bot shows text responses only.
• Notifications dashboard -- Telegram does not show your notification feed. Background run outputs and watch triggers appear in the web app.
• Settings management -- Provider setup, wallet management, API keys, and security settings are web-only.
• Multi-agent switching -- Telegram uses your default agent. You cannot switch agents from the bot.

Connection status

You can check whether Telegram is linked from the Account tab in Settings. The web app shows the linked Telegram username, chat ID, and when it was linked.

To unlink, use the Account tab in Settings. Unlinking removes the Telegram association but does not delete your conversations.

See also

• Authentication -- how Cabal identifies you across surfaces
• Guardrails -- how approvals work