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

# Telegram

> Set up and use the Telegram integration with Hyper AI

Auth type: API

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Telegram

1. Go to Settings → Apps in Hyper
2. Select Telegram → Connect New
3. Provide your Telegram Bot token

## Common capabilities

* Send and receive messages via Telegram bots
* Automate bot interactions and group management
* Trigger workflows from Telegram messages

## Use in Chat

Enable Telegram in the tool selector. Ask your agent to send messages or manage bot interactions.

## Use in Agents

Add Telegram to an agent's toolkits and select the connection. Mark sensitive actions as "requires approval."

## Use in Flows

Automate messaging, notifications, and bot workflows using Telegram action nodes.

## Troubleshooting

* Bot not responding: verify the bot token and that the bot is added to the target group
* Permission errors: check bot permissions in the Telegram group settings

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action           | Description                             |
| ---------------- | --------------------------------------- |
| Delete Webhook   | Remove webhook integration              |
| Get Webhook Info | Get current webhook status              |
| Send Document    | Send a document to a Telegram chat      |
| Send Message     | Send a text message to a Telegram chat  |
| Send Photo       | Send a photo to a Telegram chat         |
| Send Video       | Send a video to a Telegram chat         |
| Send Voice       | Send a voice message to a Telegram chat |
| Set Webhook      | Set webhook for the bot                 |