Skip to Content
Bot の管理Bot概要

Bot 概要(ステータス・起動/停止・設定)

このページは、ダッシュボードで 1 台の Bot を開いたときに最初に表示される「概要画面」の使い方を説明します。ここでは、Bot の稼働状態の確認、起動・停止、サーバーへの招待リンク作成、名前やアイコンなどのプロフィール設定、特権インテントの切り替え、そしてトークン変更や Bot 削除といった重要操作までをまとめて行えます。

この画面は、ダッシュボードで作成済みの Bot をクリックすると開きます。Bot をまだ作っていない方は、先に 最初の Bot を作成する をご覧ください。

画面の構成

概要画面には、上から順に次のセクションが並びます。

セクション内容
Bot の基本情報「Application ID」「内部システム識別子」「作成日時」「最終更新」を表示。ID はコピー可能
「権限と招待リンク」サーバーへの招待リンクを生成し、付与する権限を選びます
「ランタイムステータス」Bot の稼働状態・統計を確認し、起動/停止などの操作を行います
「Bot設定」プロフィール(名前・アイコン)、特権インテント、ステータスを設定します
「デンジャーゾーン」Bot の削除やトークン変更を行う、取り消せない重要操作です

設定を変更すると、画面下部に未保存の変更を知らせる帯が表示されます。詳しくは 変更の保存 をご覧ください。

Bot の基本情報

項目説明
Application IDDiscord 上のアプリケーション ID です。招待リンクなどで使われます
内部システム識別子BotShade 内部で Bot を管理するための ID です
作成日時この Bot を BotShade に登録した日時です
最終更新Bot の情報が最後に更新された日時です

「Application ID」と「内部システム識別子」の右側にはコピーアイコンがあり、クリックすると値をクリップボードにコピーできます。コピーすると、アイコンが一時的にチェックマークに変わり「コピーしました」と表示されます。

権限と招待リンク

作成した Bot を実際の Discord サーバーで動かすには、必要な権限を選んだ招待リンクを作成し、サーバーに追加します。

このセクションは、見出しの行をクリックすると開閉します。

権限プリセット

最初は「権限プリセット」から選ぶのが簡単です。次の 4 つが用意されています。ボタンをクリックすると、その用途に合った権限がまとめて選択されます。

プリセット主な用途
「基本」チャンネルの閲覧・メッセージ送信・埋め込み・ファイル添付・履歴閲覧など、基本的な動作に必要な権限
「モデレーター」基本の権限に加え、メッセージ管理・Kick・Ban・Timeout などモデレーション向けの権限
「管理者」管理者権限(すべての操作が可能になる権限)
「音楽」チャンネル閲覧・メッセージ送信・埋め込みに加え、ボイスチャンネルへの接続・発言など音楽用の権限

個別に権限を選ぶ

プリセットだけでなく、権限を 1 つずつ細かく選ぶこともできます。「詳細権限設定」を使います。

  • 権限は「一般」「テキスト」「音声」「メンバー管理」のカテゴリーに分かれて一覧表示されます。
  • 各権限のチェックボックスをオン/オフして選びます。プリセットで選んだ状態から追加・削除することもできます。
  • 探したい権限がある場合は、「権限を検索…」の欄に権限名(例: メッセージ)を入力すると絞り込めます。

招待リンクをコピーして招待する

権限を選ぶ

「権限プリセット」のいずれか、または「詳細権限設定」で必要な権限にチェックを入れます。選んだ内容に合わせて「生成された招待リンク」の URL が自動的に作られます。

招待リンクをコピーする

「生成された招待リンク」の横にある「コピー」ボタンをクリックします。「コピー完了」と表示され、招待リンクがコピーされます。

Discord でサーバーに招待する

コピーしたリンクをブラウザのアドレスバーに貼り付けて開きます。Discord の画面で Bot を追加したいサーバーを選び、表示された権限を確認して認証すると、Bot がサーバーに追加されます。

招待リンクには、選んだ権限が含まれた状態で生成されます。あとで権限を変え忘れていたことに気づいたときは、もう一度権限を選び直し、新しいリンクで招待し直してください。Discord サーバーへの招待手順をさらに詳しく知りたい場合は Bot を Discord サーバーに招待する をご覧ください。

ランタイムステータス

「ランタイムステータス」セクションでは、Bot が今どのような状態で動いているかを確認できます。

稼働状態と統計の見方

セクション上部の「コンテナ状態」に、現在の状態が表示されます。状態には次のものがあります。

表示意味
オンライン正常に稼働しています
起動中起動処理を行っています
停止中一時停止の状態です
失敗起動に失敗しました(下部に対処の案内が出ます)
停止停止しています
取得中 / 不明状態を取得中、または取得できていません

その下には、4 つの統計が並びます。

項目内容
「サーバー」Bot が参加しているサーバー数
「ユーザー」Bot が見ているユーザー数
「WS遅延」Discord との常時接続(WebSocket)における通信遅延(ミリ秒)
「API遅延」Discord API への応答遅延(ミリ秒)

数値が「-」になっている場合は、まだデータが取得できていないか、Bot が停止していることを意味します。

最新の状態に更新する

セクション右上の「更新」ボタンをクリックすると、最新の稼働状態と統計を取得し直します。

起動・停止・強制停止

統計の下に、操作ボタンが「起動」「停止」「再起動」「強制停止」の順に並んでいます。

操作ボタンをクリックする

「起動」「停止」「強制停止」のうち、行いたい操作のボタンをクリックします。

確認ダイアログで実行する

ボタンに応じて「起動の確認」「停止の確認」「強制停止の確認」のいずれかのダイアログが開き、それぞれ「Botを起動しますか？」「Botを停止しますか？」「Botを強制停止しますか？」と確認を求められます。内容を確認し、ダイアログ内の同名のボタン(「起動」「停止」「強制停止」)をクリックすると実行されます。中止する場合は「キャンセル」をクリックします。

状態が落ち着くまで待つ

実行後はコンテナ状態が「起動中」や「停止中」に変わり、その後は自動的に最新の状態が反映されます。処理に時間がかかると「起動に時間がかかっています。しばらくお待ちください…」のような案内が表示されることがあります。

ボタンは、その状態でできない操作のときはクリックできなくなります(例: すでにオンラインのときは「起動」、停止中のときは「停止」「強制停止」が無効になります)。

「強制停止」は Bot のプロセスを即座に終了させます。通常は「停止」をご利用ください。「強制停止」は、「停止」をクリックしても止まらないときなどに使う最終手段です。

再起動したいとき

「再起動」ボタンは現在ご利用いただけません。再起動したい場合は「停止」を実行してから「起動」を実行してください。

起動に失敗したとき

起動に失敗すると、「ランタイムステータス」のすぐ上に「起動に失敗しました」と書かれた赤い案内が表示されます。失敗の理由ごとに、原因と対処の方法が示されます。

失敗の理由(表示例)対処
Discord トークンが無効です「トークンを再入力」ボタンからトークンを入力し直します
Privileged Intents が Discord Developer Portal で有効化されていませんDiscord Developer Portal 側で特権インテントを有効にします
サーバー数が 2500 を超えましたプランのアップグレードが必要です
Discord の起動回数制限に達しました24 時間後に自動的に再試行されます(操作は不要)
キャパシティ満杯のため起動できません自動的に再試行されます(操作は不要)
起動を 5 回試行しましたが失敗しました「再試行」ボタンで再度起動を試みます
Bot プロセスが繰り返し起動失敗しました / IP がブロックされました などサポートへのお問い合わせが案内されます

案内に表示されるボタンの種類は理由によって異なり、「トークンを再入力」「再試行」「サポートに問い合わせる」「Discord Developer Portal を開く」などが表示されます。自動再試行の案内のように、ボタンが表示されず説明文だけのこともあります。

「自動的に再試行されます」「24 時間後に自動再試行されます」と表示されている場合は、こちらで操作する必要はありません。時間をおいてから「更新」ボタンで状態を確認してください。

Bot設定

「Bot設定」セクションでは、Bot のプロフィール・特権インテント・ステータスを設定できます。

プロフィール設定(名前・アイコン)

「プロフィール設定」では、Bot のアイコンと名前を変更できます。

アイコンを変更する

丸いアイコン画像、またはその下の「変更」をクリックすると、画像を選ぶ画面が開きます。画像を選ぶとトリミング(切り抜き)画面が表示されるので、範囲を調整して確定すると、新しいアイコンが保存されます。アイコンを元に戻したいときは、アイコンの下にあるゴミ箱アイコン(削除ボタン)をクリックすると削除できます。

Bot 名を変更する

「Bot名」の入力欄に新しい名前を入力します(プレースホルダーは「Bot名を入力…」、最大 32 文字)。入力したら横の「保存」ボタンをクリックすると反映されます。名前が今と同じ場合や空欄の場合は「保存」はクリックできません。

Discord から取り込む

Discord 側で設定済みの名前・アイコンを取り込みたい場合は、セクション右上の「Discordから同期」ボタンをクリックします。同期中はボタンが「同期中」の表示に変わり、完了すると画面の名前・アイコンが Discord 側の内容に更新されます。

Bot 名・アイコンの変更は Discord API を通じて行われます。そのため、変更が反映されるまでに時間がかかる場合があります。

特権インテント設定

「特権インテント設定」では、Discord の特権ゲートウェイインテント(Privileged Gateway Intents)を切り替えます。各項目はプルダウンで「✓ ON - 有効」または「✗ OFF - 無効」を選びます。

項目用途の目安
「プレゼンスインテント」メンバーのオンライン状態などを扱う機能で必要です
「サーバーメンバーインテント」メンバー一覧や参加・退出を扱う機能で必要です
「メッセージコンテントインテント」メッセージ本文を読み取る機能で必要です

各項目を選んだあとは、画面下部に表示される未保存の帯から「保存」をクリックして反映してください(後述の 変更の保存 を参照)。

特権インテントは、Discord Developer Portal 側でも対応するインテントを有効にしておく必要があります。ここで「ON」にしても Discord 側が無効のままだと、起動に失敗することがあります。

ステータス設定

「ステータス設定」では「ステータスタイプ」と「ステータステキスト」を設定できます。

「ステータスタイプ」「ステータステキスト」の設定は、ベータ版では無効化されています。将来のアップデートで、Bot の表示ステータス(「ゲームをプレイ中」「視聴中」などのタイプと表示テキスト)を設定できるようになる予定です。

デンジャーゾーン

「デンジャーゾーン」は、取り消せない重要な操作をまとめたエリアです。見出しの行をクリックすると展開し、「Botを削除」「トークン変更」の操作が表示されます。

トークン変更

Bot のトークンを新しいものに差し替えます。

「変更する」をクリックする

「トークン変更」の行にある「変更する」ボタンをクリックすると、「トークン変更」のダイアログが開きます。

新しいトークンを入力する

入力欄に新しい Bot トークンを貼り付けます。

「トークンを変更」をクリックする

ダイアログ下部の「トークンを変更」ボタンをクリックすると更新されます(処理中は「更新中…」と表示されます)。中止する場合は「閉じる」をクリックします。

トークン変更は、同じ Bot アプリケーションのトークンのみ受け付けます。別の Bot のトークンは使用できません。更新後は、Bot が自動的に新しいトークンで再起動し、数秒間停止します。

Bot を削除

Bot とそれに関連するすべてのデータを完全に削除します。

「削除する」をクリックする

「Botを削除」の行にある「削除する」ボタンをクリックすると、「Bot削除の確認」ダイアログが開きます。

確認欄に Bot 名を入力する

ダイアログには削除対象の Bot 名が表示されます。確認のため、入力欄に表示されている Bot 名を正確に入力します。入力が一致すると「✓ 入力が一致しました」と表示されます。

「完全に削除」をクリックする

入力が一致すると「完全に削除」ボタンがクリックできるようになります。これをクリックすると Bot が削除され、ダッシュボードに戻ります。中止する場合は「キャンセル」をクリックします。

Bot の削除は取り消せません。すべてのカスタムコマンド・モジュール設定・データが完全に失われます。実行するには、確認のため Bot 名を正確に入力する必要があります。本当に削除してよいか、よく確認してから操作してください。

変更の保存

「特権インテント設定」など、保存が必要な項目を変更すると、画面下部に「未保存の変更があります」「変更を保存するか、破棄してください」という帯が表示されます。

  • 変更を反映するときは「保存」をクリックします。「保存しました」と表示されれば完了です。
  • 変更をなかったことにするときは「破棄」をクリックします。

未保存の帯が表示されているうちは、変更がまだ反映されていません。設定を変えたら「保存」をクリックするのを忘れないようにしてください。なお、プロフィール設定の名前・アイコンや「Discordから同期」、デンジャーゾーンの操作は、それぞれの画面内のボタンをクリックした時点で個別に反映されるため、この帯には含まれません。

次のステップ / 関連ページ

最終更新:
Botの一覧と新規作成サーバー