ToShopドキュメントTelegram
Telegram Bot を Agent に接続 —— DM、グループ、allowlist 制御、複数アカウント。
Telegram は ToShop の 2 つのファーストクラスチャネルの 1 つです。構成後、Bot にルーティングされたメッセージは、紐づけた Agent とのチャットとして処理されます —— 同じ Skill、同じ Memory、同じ承認ゲートを使います。
セットアップ
Bot トークンを取得
Telegram で @BotFather に話しかけて → /newbot → トークンをコピー。形式は 123456789:ABC-DEF...。
ToShop でチャネルを追加
設定 → Channels → Add Telegram → トークンを貼り付け。
誰が話しかけられるかを選ぶ
オープン（Bot に DM する誰でも）か、Telegram ユーザー ID の allowlist のどちらか。
認証情報とポリシー
botToken—— BotFather から取得したトークン。OS のキーチェーンに保存されます。allowedUsers—— カンマ区切りの Telegram ユーザー ID、または誰でも許可する場合は *。デフォルトはあなただけ。dmPolicy—— open（誰でも）または allowlist（リスト内のユーザーのみ）。グループメッセージは常に明示的な @-mention が必要。
メッセージのルーティング
Bot に DM
紐づけた Agent との 1:1 会話（DM ポリシーに従う）。
グループでメンション
Agent は @-mention されたときだけ反応します。同じスレッドでの後続返信はコンテキストを保ちます。
返信
Telegram スレッド = タスクコンテキスト。同じスレッド内で返信すれば、同じ会話を続けます。
1 つの Agent に複数の Telegram アカウント
同じ Agent に複数の Telegram Bot を接続できます（例: 個人 DM 用に 1 つ、チームチャネル用に 1 つ）。各 Bot は別々の認証情報ですが、同じ Agent のチャットセッションに流れ込みます。
異なる Bot を異なる Agent に向けることもできます —— 1 つを Shop Agent に、もう 1 つを Personal Agent にルーティングできます。
トランスポートモード
最低遅延 —— Telegram がイベントを ToShop に直接プッシュします。
WebSocket フォールバック —— webhook が届かない環境向けのロングポール。
最後の手段のフォールバック —— 素の HTTP ロングポーリング。
ToShop は利用可能な最良のモードを自動的に選択します。設定 → Channels → [Telegram bot] → Transportでモードを強制できます。
Bot で扱えるもの
テキストと音声
テキスト、画像、音声メモ（Agent に読み込ませる前に自動文字起こし）。
ファイル添付
.pdf、.txt、.csv、一般的な画像形式。
スラッシュコマンド
あなたが設定していれば、インラインメンションの /commands。
Markdown 返信
Telegram で Markdown フォーマットがレンダリングされます。
状態インジケータ
ok—— 接続済みで受信中。standby—— 別のインスタンスがリースを保持（2 台目のデバイスです）。degraded—— 受信中ですが、遅延やエラーがあります。fatal—— 構成ミス / トークン無効 —— 対処が必要。
ネットワーク安全性
allowlist が巧妙に作られたリモートプロンプトから保護
Agent が Telegram トリガーのタスクで動作するとき、ネットワーク allowlist の下で動きます。これらのフローでは、明示的に allowlist に入れていない限り、プライベート IP への送信リクエストはブロックされます。
よくあるパターン
モバイル側でのトリアージ
「直近の未読メール 10 件を要約して。」
出先での Shopify 運用
「SKU X の現在の在庫は？」/「注文 #1234 を返金」。
Autopilot の配信
Telegram Bot を Autopilot タスクとペアにすれば、日次サマリが DM に届きます。