ToShopドキュメントDiscord
Discord Bot を Agent に接続 —— ギルドスコープ、チャネルスコープ、マルチギルドのルーティング。
Discord は ToShop のもう 1 つのファーストクラスコネクションです。Bot を構成し、特定のギルドとチャネルにスコープすれば、チームが既に話している場所に Agent が現れます。
セットアップ
Discord アプリを作成
discord.com/developers へ → New Application → Bot → Bot トークンをコピー。
Message Content Intent を有効化
必須 —— これがないと Bot はメッセージ本文を見られません
同じページ: Bot → Privileged Gateway Intents → Message Content Intent。オンに切り替えます。
Bot をサーバーに招待
Developer Portal の OAuth2 リンクで Bot をあなたのサーバーに招待します。必要な最小権限: メッセージの読み取り、送信、履歴の読み取り。
ToShop にコネクションを追加
左サイドバーの 接続 タブ → Add Connection を開き、Discord を選択。プロンプトに従って Bot を接続してください。認証情報は OS のキーチェーンに保存されます。
Agent にルーティング
この Discord を処理する Agent を選びます。サーバーごとに異なる Agent にルーティングできます。
認証情報とポリシー
- Bot Token —— Discord Developer Portal から取得したトークン。OS のキーチェーンに保存されます。
- Guild ID —— この Bot がサービスする Discord サーバーの ID。
- Channel ID（任意） —— ギルド内の特定のチャネル 1 つに Bot を限定します。
- Allowed channels —— Bot がリッスンできるチャネル ID のリスト（単一の Channel ID の代替）。
- Group policy —— Allowlist（デフォルト —— リスト内のチャネルのみ）または Open（ギルド内の任意のチャネル）。
Discord で ID を見つける
開発者モードを有効化
ユーザー設定 → 詳細設定 → 開発者モード。
右クリックでコピー
任意のギルドまたはチャネルを右クリック → ID をコピー。
メッセージのルーティング
Bot に DM
紐づけた Agent との 1:1 会話。
チャネルでメンション
Agent はメンションに反応します。同じスレッド内の返信は会話のコンテキストを保ちます。
スラッシュコマンド
Agent ごとに設定すれば、ユーザーは構造化されたコマンドを素早くトリガーできます。
1 つの Agent に複数の Discord ギルド
1 つの Agent を複数の Discord ギルドに紐づけられます（例: チームのメインサーバー + 顧客サポートサーバー）。各ギルドは独自のチャネルコンテキストを保ちますが、すべてを同じ Agent が処理します。
どう接続を維持するか
ToShop は Discord のリアルタイムゲートウェイ経由で Bot をオンラインに保ちます。スラッシュコマンドの対話には Webhook が使われます。これらは自分で設定する必要はありません —— ToShop が最適な方式を選びます。
サーバー側の落とし穴
状態インジケータ
Telegram と同じセット: Connected、Standby、Degraded、Disconnected —— 左サイドバー 接続 タブの各コネクションカードに表示されます。
よくあるパターン
チーム Q&A Bot
#help で runbook、コードベース、または Shopify カタログに関する質問に答えます。
Ops ダッシュボードチャネル
ルーチン が #ops に日次サマリを投稿します。
承認ゲートチャネル
長時間タスクが人間の承認を求めるとき #approvals にピングします。
チャネルごとの Skill スコープ
#shop-ops は Shop Agent（Shopify のみ）にルーティング、#dev-ops は Dev Agent（GitHub + ターミナル）にルーティング。