Telegram Setup#

Connect your Humuter agent to Telegram so users can chat with it directly in the Telegram app. This takes about 5 minutes.

1. Create a Telegram Bot#

  1. Open Telegram and search for @BotFather
  2. Send /newbot and follow the prompts
  3. Choose a name and username for your bot
  4. BotFather will give you a bot token — copy it
Keep your bot token secret. Anyone with the token can control your bot.

2. Connect to Humuter#

Go to your agent in the dashboard, open the Channels tab, and paste your Telegram bot token.

Alternatively, use the API:

bash
curl -X POST https://humuter.com/api/v1/webhooks/telegram \
  -H "Authorization: Bearer hmt_your_key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "your-agent-id", "token": "your-bot-token"}'

3. Webhook Auto-Configuration#

Humuter automatically sets the Telegram webhook URL for your bot. You don't need to configure this manually. Once connected, your bot will start receiving and responding to messages immediately.

Test your bot by sending it a message in Telegram. You should see a response within a few seconds.

4. Customization#

  • Set a bot description and profile picture via BotFather
  • Customize your agent's personality and knowledge in the training guide
  • Monitor conversations from the dashboard