Carapace
All Guides
Communication

Telegram

Send and read messages via a Telegram bot

Telegram Setup Guide

Enables your agent to send and read messages via a Telegram bot.

Prerequisites

  • A Telegram account
  • The Telegram app (mobile or desktop)

Step 1: Create a Bot via @BotFather

  1. Open Telegram and search for @BotFather
  2. Send /newbot
  3. Follow the prompts:
    • Choose a display name for the bot
    • Choose a username (must end in bot, e.g., MyAgentBot)
  4. BotFather will respond with your bot token in the format: 
    123456789:ABCdefGHIjklMNOpqrsTUVwxyz
  5. Copy this token

Step 2: Connect in Carapace

  1. Go to Dashboard > Connections
  2. Find Telegram and click Connect
  3. Paste the bot token
  4. Click Save Credentials

Credential Fields Reference

FieldRequiredFormatDescription
bot_tokenYes{bot_id}:{alphanumeric_string}Token from @BotFather

Gotchas

Bot username must end in "bot": Telegram requires all bot usernames to end with bot (e.g., MyAgentBot, carapace_bot). This can't be changed after creation.

Users must start the conversation: Telegram bots cannot message users first. The user must send the bot a message (or add it to a group) before the bot can respond.

See Also