ドキュメントに戻るインテグレーション

Telegram

1つのエージェントに紐づく独自のTelegramボットを、DMとグループで活用します。

最終更新日: 2026年5月27日 · 1 min read

Slackが選択肢にないとき — ワークスペースのSlackテナントの外にいるとき、Telegram上のグループとコラボしたいとき、チームのSlackとは別に軽量なモバイル向けDMチャネルが欲しいとき — Telegramが向いています。

ボットはあなたが用意します。各Telegramボットは、VM0ワークスペース内の1つのエージェントに紐づきます。個人用ボットとチーム用ボットを別々のエージェントにルーティングし、それぞれ異なるスキルセットを持たせる、といった構成もできます。

接続する

  1. Telegramで**@BotFather**と会話します。/newbotを実行し、ボットに名前を付け、BotFatherが渡すトークンをコピーします。
  2. VM0でZeroが使える場所を開き、Telegramを選びます。
  3. ボットトークンを貼り付け、どのエージェントにルーティングするかを選択します。
  4. (グループ利用の場合)BotFatherでボットのプライバシーモードを無効化します。/setprivacy → ボットを選択 → Disable。これをしないと、ボットは直接@メンションされたメッセージしか見えません。無効にすると、メンションやリプライ周辺のグループコンテキストを読めるようになります。
  5. Telegramを開き、ボットにメッセージを送ります。最初のメッセージでVM0上に連携セッションが開始されます。

TelegramでのZeroの使い方

主なパターンは2つです。

ボットにDMする。 Zeroとのプライベートチャットのように振る舞います。メッセージ、ファイル、写真をZeroがすべて受け取ります。各DMスレッドはVM0上のセッションにマッピングされます。

ボットをグループに追加する。 プライバシーモードを無効にすると、ボットはメンションとリプライ周辺のメッセージを読みます。@メンションするか、ボットのメッセージにリプライすることで会話を継続します。グループの他メンバーには、Zeroの推論内容は見えず、ボットが返した結果だけが見えます。

よくあるTelegramワークフロー

  • モバイルでの受信箱トリアージ。 電車の中でボットにDMする。「#csの未読Slackを要約して。」Zeroが数秒で返信します。
  • ベンダーやパートナーのグループ。 社外メンバーがいるグループにボットを追加します。社内Slackを露出させずに、スケジュール調整、リマインダー、翻訳を任せられます。
  • エージェントごとのボット。 リサーチ用ボットをリサーチエージェントに、個人用ボットを個人用エージェントに紐づけます。同じTelegramアプリ内で別のボット、別のエージェントとして動きます。

エージェントごとのルーティング

各ボットトークンは厳密に1つのエージェントに紐づきます。別のエージェントに答えさせたい場合は、BotFatherで2つ目のボットを作成して紐づけます。これは意図的な設計です。Telegramボットのアイデンティティは、そのサーフェスにおけるエージェントのアイデンティティそのものだからです。

ファイル対応

Telegramは写真、ボイスノート、ドキュメント、PDFに対応します。Zeroはそれらをすべてセッション入力として取り込みます。Zeroが生成した成果物の送信は、Telegramドキュメントまたは画像としてインラインで返されます。

よくある落とし穴

  • グループでボットが返信しない。 プライバシーモードがまだ有効です。BotFatherで/setprivacy → Disableを再実行し、ボットを一度グループから外して再追加してください。
  • 答えるエージェントが違う。 ボットトークンは1つのエージェントに紐づきます。変更するにはZeroが使える場所で紐づけを切り替えるか、別のボットを使います。
  • ボットトークンの漏えい。 BotFatherで/revokeを実行してローテーションし、VM0でトークンを更新します。旧トークンは即座に無効になります。

次に進むには

  • 繰り返し発生するモバイルワークフローをまとめるにはスキルを参照してください。
  • ボット経由でZeroが何をできて何をできないかは権限を参照してください。