Telegram

ElevenLabsエージェントをTelegramに接続

概要

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

機能

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

セットアップ

1

Telegramボットを作成

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

2

ElevenLabsで接続

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

3

トリガーを有効化

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

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

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

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

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

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

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

エージェントツール

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

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

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

動的変数

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

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

プロンプトやツール呼び出しでの参照方法については、動的変数を参照してください。

便利なリンク