Telegram setup

• Lightweight mobile access to ops agents — no Meta or Azure setup
• Developer and on-call bots for quick status checks
• Regional teams where Telegram is the primary messenger

• Telegram account and access to @BotFather
• HTTP API bot token from /newbot
• At least one deployed agent in your ViksaAI project

1. 1

   Create a bot with BotFather

   In Telegram, message @BotFather, send /newbot, and copy the HTTP API token (123456789:ABC…).

2. 2

   Connect in Channel Hub

   Volt → Channel Hub → Telegram. Paste the bot token. Click Validate (calls getMe) then Connect.

3. 3

   Webhook (automatic)

   On Connect, Viksa registers a secure webhook with Telegram. Your project URL:

   https://api.viksaai.com/v1/webhooks/telegram/{tenant_key}

   Viksa sets a secret token and validates X-Telegram-Bot-Api-Secret-Token on every request.

4. 4

   Grant access

   Use Allow all users (*) or per-user grants with the numeric Telegram user ID (not @username). Message @userinfobot on Telegram to look up your ID.

5. 5

   Test

   Send a plain text DM (e.g. "hello"). Commands like /start are ignored during the pilot — use normal text.

1. User sends a message on the channel.
2. The platform posts a webhook to volt-engine-service at /v1/webhooks/*.
3. Engine resolves account, org, and project from the global routing index (App ID, phone number ID, tenant key, etc.).
4. Access is checked via channel_grants_v1 and optional Viksa project membership.
5. The same Think→Act→Observe pipeline loads your project agent catalog and runs agents.
6. The reply is sent back through the channel API (Graph, Telegram Bot API, Bot Framework, etc.).

More help: Troubleshooting.