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

# Telegram

> Connect Telegram to your Atako agents — 6 read and 10 write actions.

Let your agents send, edit, pin and delete messages, photos, documents and polls from your Telegram bot, and read the chats it is a member of.

## Connection

* **Authentication**: API key (Bot token).

<Note>
  In Telegram, open @BotFather → /newbot (or /token for an existing bot) and copy the token (123456789:ABC-…). Use a bot dedicated to your agents: reading updates here consumes them. The bot can only write in chats it belongs to. To get a chat id, write to the bot (or add it to the group), then call get\_updates; a public channel can also be addressed as @username.

  See [Telegram's documentation](https://core.telegram.org/bots/features#botfather).
</Note>

## Read actions (6)

| Action | Description |
| - | - |
| `get_chat` | Get up-to-date information about a chat (title, type, description, pinned message…). |
| `get_chat_administrators` | List the administrators of a chat (other bots only with return\_bots). |
| `get_chat_member` | Get a member of a chat and their status (only guaranteed for other users when the bot is an admin). |
| `get_chat_member_count` | Get the number of members in a chat. |
| `get_me` | Get the bot's own profile (id, username, name) — also checks that the token works. |
| `get_updates` | Fetch incoming updates (messages, channel posts…) received by the bot. Passing offset = last update\_id + 1 confirms earlier updates, which are then dropped. Fails (409) if a webhook is set. |

## Write actions (10)

| Action | Description |
| - | - |
| `delete_message` | Delete a message — only possible within 48 hours of it being sent (bot's own messages, or any when admin). |
| `edit_message_text` | Replace the text of a message previously sent by the bot. |
| `forward_message` | Forward a message from one chat to another. |
| `pin_chat_message` | Pin a message in a chat (in groups/channels the bot needs the pin/edit admin right). |
| `send_chat_action` | Show a status such as "typing…" in a chat for up to 5 seconds (not supported in channels). |
| `send_document` | Send a file by https URL or Telegram file\_id, with an optional caption. |
| `send_message` | Send a text message (1-4096 characters) to a chat, optionally as a reply. |
| `send_photo` | Send a photo by https URL or Telegram file\_id (max 10 MB), with an optional caption. |
| `send_poll` | Send a poll (1-12 options) or a quiz (correct\_option\_ids required). |
| `set_message_reaction` | Set the bot's emoji reaction on a message (at most one; an empty list removes it). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.