迷ったらここで確認

用語集

Discord と Bot 開発でよく登場する用語を、基本・運営・開発・安全の観点で整理した用語集です。

全45語

1 基本

11語

Discord

Discord は、サーバーやDMでテキスト・音声・映像のやり取りができるコミュニケーションサービスです。コミュニティ運営、友人同士の連絡、BotやActivityの利用など、目的ごとに場所を分けて利用します。

関連: Discord とは？ / Discord の基本的な利用方法

サーバー

サーバーは、Discord上で人が集まるコミュニティ単位です。チャンネル、ロール、権限、Bot設定をまとめて管理する場所として利用します。公開範囲を広げる前に運営体制と安全設定を整えることが大切です。

チャンネル

チャンネルは、会話や情報を置く場所です。テキスト、ボイス、フォーラム、ステージなど用途別に分け、権限や通知の単位としても扱います。

関連: Discord とは？ / サーバーの作り方とチャンネル設計

DM

DM は、サーバー内のチャンネルではなく相手と直接やり取りする場所です。知らない相手からのDMやリンクは慎重に扱い、必要に応じてプライバシー設定で制限します。

関連: Discord とは？ / Discord のプライバシー設定入門

メンション

メンションは、特定のユーザー、ロール、全員などに通知を飛ばす指定です。Botや運営告知で利用するときは、意図しない通知やスパムにならないよう対象を確認します。

ニックネーム

ニックネームは、サーバー内で表示名を変える仕組みです。本人確認や問い合わせ対応では、アカウント名・ID・サーバー内表示を混同しないようにします。

通知

通知は、新しいメッセージやメンションを知らせる設定です。アプリ全体、サーバー、チャンネルごとに調整し、重要な連絡だけ残す形にすると利用しやすくなります。

Activity

Activity は、Discord内の通話などで利用できる体験型コンテンツです。通常のBotとは異なり、参加者が一緒に遊んだり作業したりする画面体験として扱われます。

スレッド

スレッドは、チャンネル内の話題を一時的に分ける会話スペースです。質問対応や作業相談を本流から分けたいときに利用します。

フォーラムチャンネル

フォーラムチャンネルは、投稿ごとに話題を分けて一覧できるチャンネル形式です。質問、募集、事例共有など、後から探したい情報を整理する用途に向いています。

関連: サーバーの作り方とチャンネル設計

ステージチャンネル

ステージチャンネルは、話す人と聞く人を分けた音声イベント向けのチャンネルです。説明会、発表、公開収録のように登壇者中心で進める場に向いています。

関連: サーバーの作り方とチャンネル設計

2 サーバー運営

11語

ロール

ロールは、メンバーの分類・表示・権限付与に利用する役割ラベルです。運営、参加者、Bot用などに分けると、権限や通知対象をまとめて管理しやすくなります。

関連: 権限とセキュリティの基本 / 逆引き:チャンネル・ロール・メンバー操作

権限

権限は、誰が何を見られるか、書けるか、管理できるかを決める操作許可です。強い権限を広く渡すと事故や悪用につながるため、必要な範囲に絞って付与します。

ロール階層

ロール階層は、ロール同士の上下関係です。Botや運営メンバーが操作できる対象はこの上下関係の影響を受けるため、Bot用ロールの位置も確認します。

関連: 権限とセキュリティの基本 / 逆引き:チャンネル・ロール・メンバー操作

権限上書き

権限上書きは、カテゴリやチャンネル単位でロール・メンバーの許可や拒否を個別に変える設定です。便利ですが増えすぎると原因調査が難しくなるため、基本はロールとカテゴリで整理します。

関連: 権限とセキュリティの基本 / 逆引き:チャンネル・ロール・メンバー操作

Administrator

Administrator は、サーバー管理上の多くの制限を通過できる非常に強い権限です。設定が簡単になる代わりに事故時の影響も大きいため、共同管理者と呼べる相手だけに限定します。

AutoMod

AutoMod は、特定ワード、スパム的な投稿、過剰なメンションなどを自動で抑止するDiscord標準の防御機能です。Botを追加する前に、まず標準機能で防げる範囲を確認すると安全です。

監査ログ

監査ログは、サーバー内で誰がいつ何を変更したかを確認する記録です。ロール、チャンネル、メンバー対応などに違和感があるとき、原因確認の最初の手がかりになります。

タイムアウト

タイムアウトは、問題行動への対応として一時的に発言などを制限するモデレーション手段です。BANやKickより軽い対応として、状況確認や冷却期間を作る目的で利用します。

BAN / Kick

BAN / Kick は、メンバーをサーバーから退出させる強いモデレーション操作です。誤操作や濫用の影響が大きいため、実行権限、対象者、理由、記録を確認してから扱います。

招待リンク

招待リンクは、ユーザーをサーバーへ参加させるためのURLです。公開範囲が広いリンクは荒らしやスパムの入口にもなるため、配布先と管理権限を確認します。

外部Bot

外部Botは、自分で作っていない公開Botや第三者提供のBotです。導入時は提供元、更新状況、要求権限、認証画面の内容を確認し、不明なBotには強い権限を渡さないようにします。

3 Bot・開発

17語

Bot

Bot は、Discord上で自動応答や管理補助などを行うアプリケーションです。サーバー運営の定型作業や外部サービス連携に役立ちますが、必要な権限だけを渡して利用します。

App

App は、BotやActivityなどを含む、Discord上で利用できるアプリの総称です。利用者側では「アプリ」と見えていても、開発者側ではApplication、Bot、OAuth2設定に分かれて管理します。

Application

Application は、Developer Portal上で作成・管理するアプリの単位です。Bot、OAuth2、スラッシュコマンド、Activityなどの設定をまとめる器として扱います。

Developer Portal

Developer Portal は、Discord向けApplicationを作成・設定する開発者向けの管理画面です。Botの作成、Tokenの再発行、OAuth2、Intentなど、開発前後の重要設定をここで扱います。

OAuth2

OAuth2 は、Botやアプリに必要な認可を行う仕組みです。サーバーへの導入や外部サービス連携で登場し、表示された権限や要求内容を確認してから進める必要があります。

Intent

Intent は、BotがDiscordから受け取るイベントの範囲を選ぶ設定です。コード側の指定とDeveloper Portal側の設定がずれると、メッセージやメンバー関連のイベントが届かない原因になります。

Privileged Intent

Privileged Intent は、特に慎重に扱う必要があるイベント範囲の設定です。必要な機能がある場合だけ有効化し、最小権限の考え方とあわせて管理します。

Gateway

Gateway は、BotがDiscordからイベントを受け取るための接続経路です。Botのオンライン状態、イベント到達、再接続の確認ではGateway接続や起動ログが手がかりになります。

Interaction

Interaction は、スラッシュコマンド、ボタン、セレクト、Modalなど利用者操作に対してDiscordから送られる処理要求です。通常のメッセージイベントとは応答の流れが違うため、初回応答や後続返信を分けて考えます。

スラッシュコマンド

スラッシュコマンドは、「/」から呼び出すDiscordのアプリコマンドです。登録、反映範囲、権限、Interaction応答を分けて確認すると、表示されない・反応しない原因を切り分けやすくなります。

prefix command

prefix command は、「!help」のように先頭記号とメッセージ本文で呼び出す従来型のコマンドです。Message Content Intentやon_messageの処理が関係するため、スラッシュコマンドとは別の確認が必要です。

defer

defer は、Interactionに対して「処理中」であることを先に返す応答です。外部API、DB、画像生成など時間がかかる処理では、期限切れを避けるために利用します。

関連: 逆引き:コマンド・Interaction・UI

follow-up

follow-up は、Interactionの初回応答後に追加で返す返信です。defer後の編集、追加返信、エラー通知を混同すると二重返信や期限切れが起きるため、流れを分けて設計します。

関連: 逆引き:コマンド・Interaction・UI

Embed

Embed は、Discordメッセージ内でタイトル、説明、画像、リンクなどを構造化して見せる表示形式です。見やすい通知や結果表示に利用できますが、TokenやWebhook URLなどが画像・URLに写り込まないよう確認します。

Cog

Cog は、discord.pyでコマンドやイベント処理を機能ごとに分けるためのまとまりです。Botが大きくなったとき、管理・読み込み・再利用の単位として役立ちます。

View

View は、discord.pyでボタンやセレクトなどのUI部品をまとめる仕組みです。callback、timeout、custom idの管理とあわせて、Interactionがどこで止まるかを確認します。

Rate Limit

Rate Limit は、APIへのリクエストが短時間に集中しすぎないよう制限される仕組みです。エラー対応では、待つべき制限なのか、設計を変えるべき連投なのかをログで分けて確認します。

4 安全

6語

Token

Token は、Botを動かすための秘密情報です。漏えいするとBotの乗っ取りにつながるため、コード、ログ、スクリーンショット、公開チャットに載せず、疑いがあれば再発行します。

client secret

client secret は、OAuth2連携などでアプリ側の秘密情報として扱う値です。Tokenと同じく公開してはいけないため、共有資料やリポジトリに含めず、安全な保管場所で管理します。

関連: 逆引き:DB・外部API・Token・Intent

Webhook

Webhook は、外部サービスからDiscordチャンネルへ投稿するための入口です。URLを知っている相手が投稿できる場合があるため、公開場所に貼らず、不要になったら削除・再発行します。

環境変数

環境変数は、Tokenや接続先などをコードの外から渡す設定値です。秘密情報をリポジトリに入れないために利用しますが、ログや管理画面への表示にも注意が必要です。

個人情報

個人情報は、ユーザー名、ID、メール、サーバー名、画像内の情報など、個人やコミュニティを特定し得る情報です。記事、ログ、スクリーンショットを公開する前に、不要な情報を伏せる必要があります。

ホスティング

ホスティングは、Botを自分のPC以外で動かし続けるための実行環境です。Tokenや環境変数、ログの扱いも運用責任に含まれるため、便利さだけでなく管理方法も確認します。