> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Telegram

## 概要

ElevenLabs AIエージェントをTelegramと連携し、ボットに送信されたメッセージに応答できます。このインテグレーションにより、エージェントはプライベートチャットやグループ内の受信メッセージを受け取り、チャット情報を検索し、返信を送信して、Telegram Bot API経由でメッセージにリアクションできます。

## 機能

| 機能           | サポート                                           |
| ------------ | ---------------------------------------------- |
| ゼロ保持モード（ZRM） | 非対応                                            |
| トリガー内の添付ファイル | 非対応 — 受信メッセージ内の写真、ファイル、その他のメディアはエージェントに転送されません |
| ツール内の添付ファイル  | 非対応 — ツールはテキストのみを処理します                         |

## セットアップ

#### Telegramボットを作成

Telegramを開き、[@BotFather](https://t.me/BotFather)との会話を開始します。`/newbot`を送信し、案内に従ってボットの名前とユーザー名を選択してください。BotFatherからボットトークンが返信されます。

#### ElevenLabsで接続

ElevenLabsのインテグレーション設定で、**接続**をクリックし、BotFatherのボットトークンを貼り付けます。

#### トリガーを有効化

接続後、**Telegram Message**トリガーを有効にし、受信メッセージを処理するエージェントを選択します。ElevenLabsがTelegramにWebhookを自動登録し、ボットがメッセージを受信できるようになります。

## グループでボットを使用する

ボットをグループの管理者にする必要はなく、Telegramの[プライバシーモード](https://core.telegram.org/bots/features#privacy-mode)を無効にする必要もありません。プライバシーモードが有効な場合（デフォルト）、Telegramはボットに明示的に宛てられたメッセージを配信します。このインテグレーションは、まさにそのようなメッセージを受信します。

* ボットのユーザー名に対する\*\*`@`メンション\*\*。例：`@my_bot what's the status?`。
* 同じやり取り内での後続ターンを含む、**ボット自身のメッセージへの返信**。

ボット宛てでないメッセージは、仕様により無視されます。また、他のボットからのメッセージや、編集・削除されたメッセージにも反応しません。

> **Note**
>
> Telegramでは、プライバシーモードや管理者ロールの変更は、変更**後**にボットが参加したグループにのみ適用されます。以前に[@BotFather](https://t.me/BotFather)でプライバシーモードを切り替えた場合、またはメンションを「修正」するためにボットをグループ管理者にした場合は、ボットをグループから削除して再度追加し、新しい設定を反映させてください。通常、メンションが機能し始めるのは管理者ロール自体ではなく、この操作によるものです。

グループおよびスーパーグループのチャットでは、エージェントの返信はトリガーとなったメッセージへの引用返信として送信されます。そのため、チャットが活発でも応答が質問に視覚的に紐付きます。プライベートな1対1チャットでは冗長になるため、引用返信は送信されません。

## エージェントツール

エージェントにTelegramツールを追加すると、次の組み込みツールを利用できます。

| ツール                         | 説明                                                                                                                                                                                                                                                       |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `telegram_get_chat`         | 現在のチャットに関するメタデータ（種類、タイトル、ユーザー名、説明など）を取得します。`chat_id`は現在の会話に紐付けられており、別のチャットに変更することはできません。                                                                                                                                                                 |
| `telegram_send_message`     | 現在のチャットにテキストメッセージを送信します。`chat_id`は固定され、モデルは`text`と任意の`parse_mode`（`HTML`、`Markdown`、`MarkdownV2`）を指定できます。                                                                                                                                                |
| `telegram_react_to_message` | Telegramのボットで許可された[リアクションセット](https://core.telegram.org/bots/api#reactiontypeemoji)から、単一の絵文字でトリガーメッセージにリアクションします。短い応答（`👍`、`🎉`、`❤`）のほうがテキスト返信より自然な場合に便利です。`chat_id`と`message_id`はいずれも発生元のターンに紐付けられます。新しいリアクションを設定すると、同じメッセージにボットが以前設定したリアクションが置き換えられます。 |

> **Info**
>
> 一部のチャットでは、Telegramの**利用可能なリアクション**設定により、使用できる絵文字が制限されています。リアクション呼び出しが拒否された場合は、エージェントにテキスト返信へ切り替えるよう指示してください。

## 動的変数

Telegramからエージェントを実行すると、プロンプトとツールで次の動的変数を使用できます。

| 変数                                    | 説明                                                  |
| ------------------------------------- | --------------------------------------------------- |
| `integration__telegram_chat_id`       | 会話が行われているTelegramチャットのID。                           |
| `integration__telegram_message_id`    | 現在のエージェントターンをトリガーしたユーザーメッセージのTelegram `message_id`。 |
| `integration__telegram_connection_id` | ElevenLabsインテグレーションの接続ID。                           |

プロンプトやツール呼び出しでの参照方法については、[動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)を参照してください。

## 便利なリンク

* [Telegram Bot APIドキュメント](https://core.telegram.org/bots/api)
* [プライバシーモード](https://core.telegram.org/bots/features#privacy-mode)
* [BotFather — ボットの作成と管理](https://t.me/BotFather)