Contents
FANBOX と Discord の連携概要と最新情報
このセクションでは、現在提供されている連携機能の全体像と、2024 年以降に加わった主な改善点をまとめます。まずは「何ができるのか」を把握し、自分の運営スタイルに合うか判断しましょう。
リリース状況（執筆時点）
FANBOX の公式発表によれば、Discord 連携機能は 段階的にロールアウト が進んでおり、支援者数やプラン設定が一定基準を満たすクリエイター向けに提供されています。最新の対象条件や利用可能な UI は公式ヘルプ（2024 年版）で随時更新されているため、必ず確認してください。
主な機能とメリット
-
支援プランと Discord ロールの自動同期
支援者が特定プランに加入すると、あらかじめ設定したロールが即座に付与されます。手動でロールを管理する手間が省けます。 -
リアルタイムステータス表示
ダッシュボード上に「連携ステータス」アイコンが常時表示され、接続状態やエラーログを一目で確認できます。 -
権限設定の最小化
必要最低限の Discord 権限（Manage Roles と Read Messages）だけで動作するため、サーバー管理者に余計なリスクを与えません。
事前に確認すべき条件と準備
連携を有効にする前に、まずは自分の FANBOX アカウントが 「支援者数10名以上」かつ「有料プランが設定済み」 であることを確認します。ここでは、管理画面でのチェック方法と、条件を満たすための簡単なアプローチをご紹介します。
支援者数・プラン要件
支援者数が基準に達していない場合は、連携ボタンが非表示になります。そのため、まずは支援者を増やす施策（SNS での告知や限定コンテンツの提供）を実行しましょう。
管理画面でのチェック方法
- FANBOX にログインし、左メニューから 「プラン編集」 を選択します。
- 各プランの右側に表示される 「支援者数」 と 「有料/無料」 のステータスを確認します。
- 支援者数が10名以上であれば、画面上部に 「連携設定」タブ が自動的に表示されます。
この手順を踏むだけで、条件不足によるエラーを未然に防げます。
FANBOX 側で連携を有効化する手順
実際の連携設定は、FANBOX の管理画面から数クリックで完了します。ここでは、どこをクリックすれば良いか と 保存後に確認すべきポイント を具体的に示します。
連携設定メニューの見つけ方
まずは「プラン編集」ページの右上にある 「連携設定」タブ を探してください。タブが表示されていない場合は、前節で確認した条件が満たされているか再チェックしましょう。
設定手順とステータス確認
- 「連携設定」タブを開き、「Discord 連携」スイッチ を右へ移動させて オン にします。
- 表示された Bot 招待リンク をコピーし、次の章で Discord 側に貼り付けます。
- 画面下部の 「保存」ボタン を必ずクリックし、ステータスバーに 「接続中（✓）」 が表示されることを確認します。
ステータスが緑色になると、次は Discord 側で権限付与作業へ進めます。
Discord 側で Bot を招待し権限を付与する
Discord に Bot を追加する際に必要なのは OAuth2 認証フロー の基本的な流れと、最小限の権限設定です。専門用語が出てきても安心できるよう、シンプルに説明します。
OAuth2 フローの簡易説明
- FANBOX が生成した招待リンクをクリックすると、Discord の認証画面に遷移します。
- サーバー選択 → 権限一覧で「Manage Roles」と「Read Messages」にチェック → 承認 の順で操作します。
この手順だけで Bot が対象サーバーに追加され、ロール操作が可能になります。
必要な権限と設定上の注意点
| 権限 | 目的 | 設定時のポイント |
|---|---|---|
| Manage Roles | ロールの作成・付与・削除 | Bot のロールは、付与対象ロールより 上位 に配置する必要があります。 |
| Read Messages | テキストチャンネルの閲覧 | 通知やエラーメッセージを送信できるようにしますが、過剰な権限（Administrator）は避けましょう。 |
権限が不足すると FANBOX 側で 403 エラー が返りますので、必ずチェックしてください。
支援プランと Discord ロールの紐付け
支援者が加入したプランに応じて自動的にロールを付与するためには、FANBOX の管理画面で 「ロール紐付け」 を設定します。ここでは手順と失敗しやすいポイントを解説します。
紐付け画面の操作手順
- 「連携設定」タブ内の 「ロール紐付け」 セクションへ移動します。
- 対象プラン（例：プラチナサポーター）を選択し、Discord ロール名 を正確に入力します。大文字小文字は区別されますので注意が必要です。
- 必要なら 説明文やカラーコード を設定し、「保存」ボタン をクリックします。
この操作だけで、支援者がプランを選ぶと同時に指定ロールが付与されます。
実例：プラン別ロール対応表
| FANBOX プラン | 設定する Discord ロール名 |
|---|---|
| プラチナサポーター | Platinum |
| ゴールドサポーター | Gold |
| シルバーサポーター | Silver |
ロール名は Discord 側で作成したものと 完全一致 させることが成功の鍵です。
動作確認・よくあるエラーと対処法
設定完了後は必ずテストを行い、実際にロールが付与されるか確認しましょう。また、トラブル時にすぐ対応できるよう代表的なエラーコードとその対策もまとめています。
テスト手順のポイント
- 自分または別アカウントで 0円プラン（テスト用） に支援します。
- Discord サーバーを開き、設定したロールが付与されたか確認します。
- 支援キャンセルやプラン変更を行い、ロールが正しく更新されるか再度チェックします。
テストで問題なければ、本番環境でも同様に機能するはずです。
主なエラーコードと対策
| エラーコード | 発生シーン | 推奨対処法 |
|---|---|---|
| 401 (認証失敗) | Bot 招待時のトークン不正 | OAuth2 の招待リンクを再取得し、最新か確認する。 |
| 403 (権限不足) | ロール付与時 | Bot のロール位置を上位に移動し、Manage Roles が有効か再チェック。 |
| 404 (ロール未取得) | 紐付けロール名が不一致 | FANBOX 側のロール名入力を Discord と完全一致させる。 |
| 500 (内部エラー) | FANBOX のシステム障害 | 時間を置いて再試行し、公式ステータスページで障害情報を確認する。 |
ステータスモニタリングの活用法
新 UI の 「連携ステータス」 アイコンは、接続状態（緑＝正常・黄＝警告・赤＝エラー）や最終同期時刻、未処理エラーログを表示します。定期的に確認すれば、問題発生時に即座に対処できます。
プライバシー・利用規約上の留意点とユーザーへの案内例
自動ロール付与は便利ですが、個人情報の取り扱いには注意が必要です。ここでは法的側面と、支援者へ分かりやすく伝える文例を紹介します。
データ取り扱いのポイント
- 支援者の Discord ID はロール付与以外の目的で使用できません（FANBOX 利用規約第5条）。
- 取得した情報は暗号化された形で保管し、第三者への提供は禁止されています。
Discord の開発者ポリシー遵守
Bot が自動でロールを操作する際は、ユーザーの明示的同意 を得る必要があります。支援ページやサーバー案内に以下のような文言を掲載しましょう。
「本サービスでは、支援プランに応じて Discord ロールを自動付与します。ロール付与には Bot が「Manage Roles」権限でサーバーに参加する必要があります。ご同意いただけない場合は、手動でのロール付与をご相談ください。」
告知文サンプル
Discord 連携について
FANBOX の支援プランと Discord ロールを自動同期します。支援者が特定プランに加入すると、即座に「Platinum」ロールが付与されます。この機能は 2024 年 10 月現在 利用可能で、権限は最小限（Manage Roles・Read Messages）のみです。
上記のように簡潔に説明すれば、利用者の不安を軽減できます。
まとめ
- 条件確認 – 支援者数10名以上かつ有料プランが設定されていること。
- FANBOX 側で連携スイッチをオン → Bot 招待リンク取得。
- Discord に Bot を招待し、最小権限（Manage Roles・Read Messages）を付与。
- プランとロールの紐付けを正確に設定し、保存。
- テストで動作確認し、ステータスモニタリングで定期チェック。
この流れを順番に実行すれば、FANBOX と Discord の連携が完了し、支援者へのロール付与が自動化されます。公式ヘルプページの最新情報と併せて活用し、コミュニティ運営の効率化をぜひ体感してください。