はじめに
この記事は HowTelevision Advent Calendar 2024 10日目の記事になります。
私は新型質問箱サービス「mond」の開発に携わっています。
mond では月額のサブスクとして、メンバー限定の回答を閲覧できるメンバーシップという機能を提供しています。
mond の回答者の中には、メンバー限定のコンテンツを Discord サーバーで展開している方々がいらっしゃいます。そのため、mond のメンバーシップ加入者限定でその Discord サーバーに参加できる権利を付与できたらいいよね、という話になりました。
最近この機能の実装に取り組んだので、本記事ではこの機能に関する設計についてまとめていこうと思います。
DB 設計
mond のメンバーシップ情報を格納するテーブルなど一部省略していますが、Discord 連携に必要なのはざっと下記のテーブルたちです。
| テーブル名 | 概要 |
|---|---|
user |
mond のユーザー情報 |
discord_user |
メンバーシップ参加者の Discord ユーザー情報 |
discord_guild |
メンバーシップ開設者の Discord サーバー情報 |
discord_guild_member |
Discord サーバーへの参加情報を格納する中間テーブル |
Discord サーバーのデータを保持するテーブル名は下記を参考にして discord_guild としています。
Discord内では、いわゆるグループのことをサーバーと呼ぶが、APIを使ってボットを作るときはGuildと呼ぶことが多い
メンバーシップ開設者側
まずは、メンバーシップ開設者側の Dicord 連携です。メンバーシップ開設者が保有する Discord サーバーと mond を連携させるための処理になります。
全体像
アクセストークンに必要なスコープ
| スコープ名 | 説明 | 認可画面に表示される文言 |
|---|---|---|
identify |
allows /users/@me without email | ユーザー名、アバター画像、バナーにアクセス |
guilds |
allows /users/@me/guilds to return basic information about all of a user's guilds | あなたがどのサーバーに入っているか確認します |
bot |
for oauth2 bots, this puts the bot in the user's selected guild by default | Bot をサーバーに追加 |
Bot に与える必要がある権限
| 権限名 | 説明 | 認可画面に表示される文言 |
|---|---|---|
CREATE_INSTANT_INVITE |
Allows creation of instant invites | 招待を作成 |
KICK_MEMBERS |
Allows kicking members | メンバーをキック |
MANAGE_CHANNELS |
Allows management and editing of channels | チャンネルの管理 |
MANAGE_GUILD |
Allows management and editing of the guild | サーバー管理 |
MANAGE_ROLES |
Allows management and editing of roles | ロールの管理 |
MANAGE_WEBHOOKS |
Allows management and editing of webhooks | ウェブフックの管理 |
実際の流れ
| 1. mond の設定画面から連携を開始する | 2. Discord サーバー情報へのアクセスを mond に許可する | 3. mond の Bot に与える権限を許可する | 4. Bot が Discord サーバーに追加される |
|---|---|---|---|
 |
 |
 |
 |
メンバーシップ参加者側
次に、メンバーシップ参加者側の Dicord 連携です。こちらはメンバーシップ参加者の Discord アカウントと mond を連携させるための処理になります。
全体像
アクセストークンに必要なスコープ
| スコープ名 | 説明 | 認可画面に表示される文言 |
|---|---|---|
identify |
allows /users/@me without email | ユーザー名、アバター画像、バナーにアクセス |
guilds.join |
allows /guilds/{guild.id}/members/{user.id} to be used for joining users to a guild | サーバーに参加します |
実際の流れ
| 1. mond のメンバーシップを購読開始する | 2. Discord アカウント情報へのアクセスを mond に許可する | 3. Bot によってDiscord サーバーに追加される |
|---|---|---|
 |
 |
 |
おわりに
今回は mond における Discord 連携の設計に関する記事を書いてみました。
だいぶ端折っているので、年末年始に余裕があれば設計の続きと実装編も書こうと思います。
弊社のアドベントカレンダーで mond に関する記事が他にも公開されていますので、ご興味があれば覗いてみてください。