Telegram

BotFather Setup

1. Open Telegram and search for @BotFather
2. Send /newbot and follow the prompts to create your bot
3. Copy the bot token provided by BotFather
4. Optionally, send /setdescription and /setabouttext to customize your bot's profile

Required Credentials

Webhook URL

https://bankmind.aihookd.site/api/v1/channels/telegram/webhook

Setting Up the Webhook

Register your webhook URL with Telegram using the Bot API. You can do this with a single cURL request:

curl -X POST "https://api.telegram.org/botYOUR_BOT_TOKEN/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://bankmind.aihookd.site/api/v1/channels/telegram/webhook",
    "secret_token": "YOUR_WEBHOOK_SECRET",
    "allowed_updates": ["message"]
  }'

You can also set the webhook from the Tavio dashboard under Channels > Telegram, which will make this API call for you.

Message Flow

1. Customer sends a message to your Telegram bot
2. Telegram forwards the message to your webhook URL
3. Tavio verifies the X-Telegram-Bot-Api-Secret-Token header
4. The message is processed through the AI pipeline
5. Response is sent back via the Telegram Bot API

Inbound Payload

{
  "update_id": 123456789,
  "message": {
    "message_id": 42,
    "from": {
      "id": 987654321,
      "first_name": "John",
      "username": "john_doe"
    },
    "chat": {
      "id": 987654321,
      "type": "private"
    },
    "date": 1700000000,
    "text": "What are your interest rates?"
  }
}