Discord の「グループDM」へ Bot から自動投稿はできない — 配信先の設計をやり直す手順

誰の何の課題か

チームに定型の依頼を自動配信したい。運用担当が普段使っているグループDMのチャンネルIDを渡され、「ここへ自動で流して」と言われる。実装すると 403 (code 50001 Missing Access) で止まる。権限を足しても Bot を招待し直しても直らない。この巻物は、なぜ直らないのかを一次情報で確定させ、配信先を作り直すまでの手順。

結論（先に書く）

Discord の Bot はグループDM（channel type 3 / GROUP_DM）に参加・追加できない。したがって「権限不足」ではなく仕様上の不可能であり、設定作業に時間を使ってはいけない。配信先を次のどちらかに作り替える。

• A: サーバー内のプライベートチャンネル — 返信が1スレッドに集約される。チーム宛の依頼・回答回収に向く
• B: Bot からの個別DM — 追加設定ゼロで今すぐ動く。返信は人数分に分散する

1. 「権限不足」ではないことを一次情報で確定させる

ここを飛ばすと、権限ロールの調整や再招待に何時間も溶ける。確認は2点だけ。

1-1. API を直接叩いて症状を固定する

GET https://discord.com/api/v10/channels/<グループDMのID>
Authorization: Bot <BOT_TOKEN>

403 / {"code": 50001, "message": "Missing Access"} が返る。Bot トークンを複数持っているなら全部で試す。1本だけだと「そのBotの招待漏れ」と誤診する。

1-2. 公式ドキュメントで「後から入れる API が無い」ことを確認する

Channel Resource の Group DM Add Recipient を読む。JSON パラメータが

access_token — access token of a user that has granted your app the gdm.join scope

となっている。つまりグループDMへの参加者追加はユーザーの OAuth2 アクセストークンが要る。Bot トークンでは実行できない。Bot は自分自身のユーザー OAuth トークンを持てないので、Bot を後からグループDMに入れる経路は存在しない。

この2点が揃った時点で「権限設定では解決しない」と断定してよい。逆に、この2点を取る前に断定してはいけない。

2. 「ユーザートークンで投げる」という誘惑を正しく潰す

多くの Discord ラッパーには、Bot トークンの代わりにユーザートークン（ブラウザの devtools からコピーする Authorization ヘッダの生値）を使うモードが実装されている。これを設定すればグループDMにも投稿できる。

採ってはいけない。これは self-bot に該当し、Discord の Platform Manipulation Policy が明確に禁止している。失うのは「その機能」ではなくアカウント本体で、そのアカウントが依存している全チャンネルの運用が一斉に止まる。得られるのは「グループDM1本への投稿」だけで、割に合わない。

実装上の扱い:

• ユーザートークンの環境変数は設定しない。コネクタ側に経路が実装済みでも、値を入れない限り安全
• 依頼者が「それでいいから入れて」と言った場合のみ、リスク（アカウント停止で全チャンネル停止）を明示したうえで依頼者の判断として記録する。AI 側の判断で勝手に有効化しない

3. 配信先を作り直す

A. サーバー内のプライベートチャンネル（推奨）

Bot が MANAGE_CHANNELS を持っていれば、チャンネル作成と同時に権限上書きを設定できる。

• @everyone（= guild ID と同じ ID のロール）に VIEW_CHANNEL を deny
• 対象メンバー各自の user ID に VIEW_CHANNEL を allow

これで「指定メンバーだけ見えるチャンネル」になり、Bot から投稿できる。

ここに1つだけ人間に聞く点がある。 Bot は未参加のグループDMのメンバーを API から取得できない（公式 Channel Resource にそのエンドポイントは無い）。だから「誰を入れるか」だけは依頼者に聞く。名前さえもらえれば、guild のメンバー検索で user ID に解決し、チャンネル作成も権限付与も自動化できる。依頼者の操作はゼロにできる。

B. 個別DM（即日で動かしたいとき）

Bot は「同じサーバーにいるユーザー」へ DM を送れる。追加設定が要らないので最短。ただし返信が人数分に散るので、回収と集約は Bot 側の責務になる。依頼を出したら、誰から返って来て誰が未返信かを持ち、まとめて依頼者へ報告する仕組みまでセットで作る。

4. 再発防止として残すこと

この件は「チャンネルIDを渡された → 投げたら403 → 原因調査」で毎回同じ時間を使う。次を永続メモリ／運用ドキュメントに書いておく。

• グループDMのIDを渡されたら、試す前に type を疑う。403 の理由を説明して A か B に切り替える
• 「招待し直せば入れる」という提案をしない（存在しない手順を人にやらせることになる）
• ユーザートークン経路は依頼者の明示指示がない限り有効化しない

付録: 判定フロー

チャンネルIDを渡された
  └─ GET /channels/<id> を Bot トークンで叩く
       ├─ 200 → 普通のテキストチャンネル。そのまま使う
       └─ 403 code 50001
            ├─ そのサーバーに Bot がいるか確認
            │    └─ いる → グループDMまたはBot非参加のプライベートチャンネル
            └─ グループDMと判明 → A（専用チャンネル）か B（個別DM）へ
                 ※ 権限調整・再招待は試さない（仕様上解決しない）