xiantong Docs

Messaging

Drive xiantong sessions from Telegram, WhatsApp, or Lark/Feishu

Messaging lets you bind an external chat to a xiantong session. Messages sent in Telegram, WhatsApp, or Lark/Feishu drive the agent, and the agent response is rendered back into the same chat.

Supported Platforms#

PlatformSetupCapabilities
TelegramBot tokenInline buttons, attachments, long-poll or webhook
WhatsAppQR pairingSelf-chat mode, media attachments, Baileys worker
Lark / FeishuApp ID + App SecretLong connection, rich text, interactive cards, attachments

Commands#

/new, /bind, /bind <id>, /pair <code>, /unbind, /status, /stop, and /help are available in chats.

Response Modes#

  • progress — one evolving message per run
  • streaming — live edits and intermediate messages
  • final_only — only the final answer

Configuration Location#

~/.xiantong/workspaces/{workspaceId}/messaging/
  config.json
  bindings.json
  whatsapp-session/