​

Connecting Lyzr Agents to Telegram: A Cookbook

​

Prerequisites

• A Lyzr Studio account with at least one agent created
• A Telegram account

​

How It Works

User Message → Telegram
                    ↓
             Lyzr Webhook receives it
                    ↓
             Agent runs inference
                    ↓
             Response sent back to user

​

Step 1: Create a Telegram Bot

1. Open Telegram and search for @BotFather
2. Send /newbot
3. Follow the prompts — choose a display name and a username (username must end in bot, e.g. my_lyzr_bot)
4. BotFather will reply with a bot token that looks like:
   123456789:ABCDefghIJKLmnopQRSTuvwxyz-1234567
   
5. Copy and save this token

💡 Keep your bot token private — anyone with it can control your bot.

​

Step 2: Create the Channel in Lyzr

1. Open the Agent Builder page in the Lyzr UI
2. Click the Channels button (top-right toolbar, left of Executions)
3. Click Configure next to Telegram
4. Fill in the form:

   Field	Value
   Bot Token	Paste the token from BotFather
   Default Agent	Select the agent you want to handle messages

5. Click Create Channel

​

Step 3: Test Your Bot

1. Open Telegram and search for your bot by username (e.g. @my_lyzr_bot)
2. Click Start or send /start
3. Send any message — your agent should reply within a few seconds

​

Linking Multiple Agents to a Channel

​

Via the Lyzr UI

1. Open Channels in the Agent Builder
2. Click Manage agents on your configured channel
3. Toggle agents on/off to link or unlink them
4. Each linked agent gets a name used with the /switch command

​

Via the API

curl -X POST "https://your-server.com/v3/channels/{channel_id}/agents" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "67e4d6983e456a9f92912044",
    "name": "Support Agent"
  }'

curl -X DELETE "https://your-server.com/v3/channels/{channel_id}/agents/{agent_id}" \
  -H "x-api-key: your-api-key"

The default agent cannot be removed. To change it, delete the channel and recreate it with a different default agent.

​

Bot Commands

/agents
→ Available agents (use /switch <name> to select one):
  • Support Agent — 67e4d6983e456a9f92912044
  • Sales Agent — 67e4d6673e456a9f9291203d

/switch Sales Agent
→ Switched to agent 'Sales Agent'. How can I help you?

​

Troubleshooting

​

Bot doesn’t respond to messages

• Confirm the webhook was registered by checking the Channels list in the Lyzr UI

​

Bot token invalid

• Ensure you copied the full token from BotFather, including the numeric prefix before the colon
• Send /token to BotFather to regenerate if needed