Skip to main content
Integrate your agent with Telegram for user interactions via bot.

​
Setup Steps

1

Create Telegram Bot

  1. Open Telegram
  2. Chat with @BotFather
  3. Send /newbot
  4. Follow prompts
  5. Copy bot token (save it)
2

Add Channel to Agent

  1. Agents > Select agent
  2. Settings > Channels
  3. Click Add Channel
  4. Choose Telegram
3

Enter Credentials

Paste bot token from @BotFather
4

Test

  1. Find your bot on Telegram
  2. Send /start
  3. Wait for response
  4. Verify it works
5

Deploy

Toggle Enabled. Bot now active.

​
Features

  • Individual chats - Direct messages with users
  • Group chats - Bot in group conversations
  • Mention support - Respond when mentioned in groups
  • Image/file - Share results with users
  • 4,096 char - Message size limit (auto-splits)

​
Commands

Telegrambot commands (optional): 
/start - Initialize bot
/help - Show available commands
/status - Check agent status
Configure in @BotFather.

​
Group Chat Usage

Add bot to Telegram group:
  1. Add bot to group (admin permission needed)
  2. Bot receives all messages
  3. Responds when mentioned: “@botname question”
  4. Or configure keyword responses

​
Webhook Configuration

Noorle automatically configures webhook to receive messages.
  • Webhook URL: Secure HTTPS endpoint
  • Updates pushed in real-time
  • ~100ms latency typical

​
Rate Limits

  • 30 messages/second per bot (Telegram limit)
  • Long messages auto-split
  • Each split counts as separate message

​
Message Types

​
Text

"What is 2+2?"
Agent responds: "2+2 equals 4"

​
With Images

Agent can send images in responses (if using Image capability).

​
With Files

Agent can share files (PDFs, docs, etc.).

​
Limitations

  • Can’t edit sent messages
  • Can’t delete messages
  • 4,096 character limit (splits automatically)
  • No reactions/emojis (text only)

​
Troubleshooting

​
Bot not responding

  • Check bot token is correct
  • Verify bot is enabled
  • Test agent in Console first
  • Check Activity log for errors

​
Messages delayed

  • Telegram server delay (rare)
  • Network latency
  • Agent processing slow
  • Check timeout settings

​
Bot offline

  • Verify webhook connected
  • Check agent is active
  • Restart agent if needed

​
Privacy & Security

  • All messages encrypted (Telegram -> Noorle -> Telegram)
  • User data not stored (unless agent stores it)
  • Bot token kept secret
  • Configure privacy mode in @BotFather

​
Cost

For current pricing details, see Pricing.

​
Next Steps