> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mantle.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> Send and receive messages in Telegram chats and groups

Connect your Telegram bot and give your agents the ability to send messages, share media and documents, manage chats and
groups, and respond to user interactions through the Telegram Bot API.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Messaging" icon="paper-plane">
    Send, edit, delete, and forward messages in any chat or group your bot has access to.
  </Card>

  <Card title="Rich media sharing" icon="photo-film">
    Share photos, documents, locations, and polls directly through the bot.
  </Card>

  <Card title="Chat management" icon="users">
    View chat details, list administrators, check member counts, and create invite links.
  </Card>

  <Card title="Bot configuration" icon="robot">
    Manage bot commands, process updates, and handle callback queries from inline keyboards.
  </Card>
</CardGroup>

***

## Connect Telegram

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Telegram**.
  </Step>

  <Step title="Get your bot token">
    Open Telegram and message [@BotFather](https://t.me/BotFather). Send `/newbot` (or use an existing bot), then copy
    the **bot token** — it looks like `123456789:ABCdefGHIjklMNOpqrsTUVwxyz`.
  </Step>

  <Step title="Paste and connect">Paste the bot token into the connection form and click **Connect**.</Step>

  <Step title="Start using it">
    Add the bot to the Telegram group it needs, then open the Mantle agent and enable only the Telegram actions required
    for its job.
  </Step>
</Steps>

<Note>
  Telegram integrations use a **bot token** instead of OAuth. The bot can only interact with chats and groups where it
  has been explicitly added as a member.
</Note>

***

## Agent tools

### Messages

| Tool            | Description                                |
| --------------- | ------------------------------------------ |
| Send message    | Send a text message to a chat or group     |
| Edit message    | Edit an existing message sent by the bot   |
| Delete message  | Delete a message from a chat               |
| Forward message | Forward a message from one chat to another |

### Media and content

| Tool          | Description                       |
| ------------- | --------------------------------- |
| Send photo    | Send an image to a chat           |
| Send document | Send a file or document to a chat |
| Send location | Share a geographic location       |
| Send poll     | Create and send a poll in a chat  |

### Chats

| Tool                    | Description                                     |
| ----------------------- | ----------------------------------------------- |
| Get chat                | Retrieve details about a specific chat or group |
| Get chat administrators | List administrators of a group or channel       |
| Get chat history        | Retrieve recent messages from a chat            |
| Get chat member         | Look up a specific member's status in a chat    |
| Get chat members count  | Get the total number of members in a chat       |
| Create chat invite link | Generate an invite link for a group or channel  |

### Bot

| Tool                  | Description                                             |
| --------------------- | ------------------------------------------------------- |
| Get me                | Retrieve the bot's own profile information              |
| Get updates           | Fetch pending updates (messages, callbacks) for the bot |
| Answer callback query | Respond to an inline keyboard button press              |
| Set my commands       | Define the bot's command menu                           |

***

## Triggers

<Note>
  Triggers are not yet available for Telegram. When trigger support is added, you will be able to start agent tasks
  automatically based on incoming messages and bot events.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Send daily reports to a Telegram group">
    Set up an agent to compile a daily summary from your project management tool and post it to a Telegram group every
    morning.
  </Accordion>

  <Accordion title="Build a Q&A bot for your team">
    Have your agent monitor bot updates, interpret incoming questions, search your knowledge base, and reply with
    helpful answers directly in the chat.
  </Accordion>

  <Accordion title="Share alerts and notifications">
    Configure an agent to forward critical alerts — server downtime, new signups, payment events — as Telegram messages
    to a dedicated ops group.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Bot token is rejected">
    Make sure the token is copied exactly from BotFather, including the colon and all characters. Tokens look like
    `123456789:ABCdefGHIjklMNOpqrsTUVwxyz`. If the bot was deleted or regenerated, you need a fresh token.
  </Accordion>

  <Accordion title="Bot can't send messages to a group">
    The bot must be added as a member of the group. Open the group in Telegram, tap **Add Members**, and search for your
    bot's username. Also ensure the group's privacy settings allow bots to read messages if needed.
  </Accordion>

  <Accordion title="Messages are not being received">
    A Telegram bot can send its updates to only one connected service at a time. Disconnect other services using the
    same bot, then reconnect it to Mantle.
  </Accordion>

  <Accordion title="Bot can't delete messages in a group">
    The bot needs **admin privileges** in the group to delete other members' messages. It can always delete its own
    messages without admin rights.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>