ToShopドキュメントTelegram
Telegram Bot を Agent に接続 —— DM、グループ、allowlist 制御、複数アカウント。
Telegram は ToShop の 2 つのファーストクラスコネクションの 1 つです。構成後、Bot にルーティングされたメッセージは、紐づけた Agent とのチャットとして処理されます —— 同じ Skill、同じ Memory、同じ承認ゲートを使います。
セットアップ
Bot トークンを取得
Telegram で @BotFather に話しかけて → /newbot → トークンをコピー。形式は 123456789:ABC-DEF...。
ToShop でコネクションを追加
左サイドバーの 接続 タブ → Add Connection を開き、Telegram を選択。プロンプトに従って Bot を接続してください —— 認証情報は OS のキーチェーンに保存されます。
誰が話しかけられるかを選ぶ
オープン（Bot に DM する誰でも）か、Telegram ユーザー ID の allowlist のどちらか。
認証情報とポリシー
- Bot Token —— BotFather から取得したトークン。OS のキーチェーンに保存されます。
- Allowed User IDs —— カンマ区切りの Telegram ユーザー ID、または誰でも許可する場合は
*。デフォルトはあなただけ。 - DM ポリシー —— Open（誰でも DM 可）または 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 にルーティングできます。
どう接続を維持するか
ToShop は Telegram があなたの環境で許す方式 —— プッシュ、リアルタイム接続、フォールバックのポーリング —— を使って Bot をオンラインに保ちます。多くのユーザーは特に意識する必要はありません。強制的に選びたい場合は、接続 タブから該当のコネクションの 詳細 設定で変更できます。
Bot で扱えるもの
テキストと音声
テキスト、画像、音声メモ（Agent に読み込ませる前に自動文字起こし）。
ファイル添付
.pdf、.txt、.csv、一般的な画像形式。
スラッシュコマンド
あなたが設定していれば、インラインメンションの /commands。
Markdown 返信
Telegram で Markdown フォーマットがレンダリングされます。
状態インジケータ
- Connected —— 接続済みで受信中。
- Standby —— 別のインスタンスがリースを保持（2 台目のデバイスです）。
- Degraded —— 受信中ですが、遅延やエラーがあります。
- Disconnected —— 構成ミス / トークン無効 —— 対処が必要。
よくあるパターン
モバイル側でのトリアージ
「直近の未読メール 10 件を要約して。」
出先での Shopify 運用
「SKU X の現在の在庫は？」/「注文 #1234 を返金」。
Routine の配信
Telegram Bot を routine とペアにすれば、日次サマリが DM に届きます。