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

# Telegram

> Telegram is a cloud-based messaging app with a focus on security and speed

Telegram is a cloud-based messaging app with a focus on security and speed. Build bots to send messages, manage chats, and interact with users.

`telegram` · **18 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth telegram
run auth telegram --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run telegram          # common commands
run telegram --all    # every command
```

```ts theme={"theme":"github-dark"}
import { telegram } from "@boxd/run";
```

## Common tools

| Tool                      | What it does                                                                                                                                          |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get-chat-member`         | Get a chat member's status/role (including the bot itself) to preflight permissions and troubleshoot 403/empty-history issues.                        |
| `send-message`            | Send a text message to a Telegram chat using the Bot API. Bots must be members of target groups/channels with post rights.                            |
| `answer-callback-query`   | Use this method to send answers to callback queries sent from inline keyboards.                                                                       |
| `create-chat-invite-link` | Generate a new primary invite link for a chat; any previously generated primary link is revoked.                                                      |
| `delete-message`          | Delete a message, including service messages. Limitations: cannot delete messages older than 48 hours in groups, forwarded messages, or content in... |

<Accordion title="All 18 tools" icon="list">
  | Tool                      | What it does                                                                                                                                                                          |
  | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `answer-callback-query`   | Use this method to send answers to callback queries sent from inline keyboards.                                                                                                       |
  | `create-chat-invite-link` | Generate a new primary invite link for a chat; any previously generated primary link is revoked.                                                                                      |
  | `delete-message`          | Delete a message, including service messages. Limitations: cannot delete messages older than 48 hours in groups, forwarded messages, or content in...                                 |
  | `edit-message`            | Edit text messages sent by the bot. Only bot-authored messages can be edited; editing messages from other users will fail.                                                            |
  | `forward-message`         | Forward messages of any kind. Service messages can't be forwarded.                                                                                                                    |
  | `get-chat`                | Get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.).                                |
  | `get-chat-administrators` | Get a list of administrators in a chat. On success, returns an Array of ChatMember objects containing information about all chat administrators except other bots.                    |
  | `get-chat-history`        | Get chat history messages via the getUpdates polling method, filtered by chat\_id.                                                                                                    |
  | `get-chat-member`         | Get a chat member's status/role (including the bot itself) to preflight permissions and troubleshoot 403/empty-history issues.                                                        |
  | `get-chat-members-count`  | Get the number of members in a chat. The bot must be an administrator in the chat for this to work.                                                                                   |
  | `get-me`                  | Get basic information about the bot using the Bot API getMe method.                                                                                                                   |
  | `get-updates`             | Use this method to receive incoming updates using long polling.                                                                                                                       |
  | `send-document`           | Send general files (documents) to a Telegram chat using the Bot API.                                                                                                                  |
  | `send-location`           | Send point on the map location to a Telegram chat using the Bot API.                                                                                                                  |
  | `send-message`            | Send a text message to a Telegram chat using the Bot API. Bots must be members of target groups/channels with post rights.                                                            |
  | `send-photo`              | Send photos to a Telegram chat using the Bot API. Telegram compresses and re-encodes images; use TELEGRAM\_SEND\_DOCUMENT to preserve original resolution/format.                     |
  | `send-poll`               | Send a native poll to a Telegram chat using the Bot API.                                                                                                                              |
  | `set-my-commands`         | Use this method to change the list of the bot's commands. See [https://core.telegram.org/bots#commands](https://core.telegram.org/bots#commands) for more details about bot commands. |
</Accordion>

[Open Telegram in the console →](https://app.boxd.sh/integrations/detail/telegram)