YouTube概要欄作成Bot

使い方ガイド

Botの導入から参加者一覧の作成までを説明します

🚀 サーバーへの初期導入手順

Botをサーバーに追加したら、まず以下の手順で初期設定を行ってください。

1
Botをサーバーに招待する
招待リンクからBotをサーバーに追加します。
↓
2
登録ボタンを設置する（/g99_setbutton）
メンバーが登録しやすいチャンネルで実行します。登録・確認ボタンが投稿されます。初回のみ実行してください。
任意で notify_channel を指定すると、メンバーが登録した際にそのチャンネル/スレッドへ通知が届きます。後から変更する場合は /g98_settings のWeb設定ページの「登録通知チャンネル」から変更できます。
↓
3
メンバーにSNS情報を登録してもらう
設置したボタンまたは /a01_register からSNS情報を登録してもらいます。
必要であれば案内文のテンプレートをご利用ください。
【お知らせ】 このサーバーにYouTube概要欄作成Botを導入しました。 **配信・コラボに参加される方は、SNS情報の登録をお願いいたします。** 別のサーバーですでに登録している場合は登録不要です。 **登録状況確認ボタンで確認してください。** 📌 **登録方法** #チャンネル名 にある「**登録する**」ボタンを押すか、/a01_register コマンドを実行してください。 ✅ 登録できる情報 ・表示名（YouTube名など） ・X（旧Twitter） ・YouTube ・Twitch ・その他SNS（最大2つ） ご不明な点があればお気軽にお知らせください。 詳しい説明はこちらをご覧ください。 https://mizulab-app.com/discord-bot/guide.html
※ #チャンネル名 はご自身のサーバーのチャンネル名に置き換えてください。
※ 案内の例ですので、自分の言葉に置き換えて投稿してください。
↓
4
参加者一覧を生成する（/g01_chdesc または /g11_roledesc）
未登録者の確認・登録促進・参加者一覧の生成がコマンド一つで完結します。

📋 通常運用の流れ

初期設定完了後、概要欄を作成する際はこの流れで進めます。

1
チャンネル/スレッド指定の場合
/g01_chdesc を実行 → 未登録確認 → 概要欄作成
↓ または
2
ロール指定の場合
/g11_roledesc @ロール を実行 → 未登録確認 → 概要欄作成

⚙️ 管理者コマンドまとめ

コマンド内容頻度
/g01_chdescチャンネル/スレッドの未登録確認＋概要欄作成概要欄作成前
/g11_roledesc指定ロールの未登録確認＋概要欄作成概要欄作成前
/g20_getchdiscordidlistチャンネル/スレッドのメンバーのDiscord ID一覧を取得必要時
/g21_getrolediscordidlist指定ロールのメンバーのDiscord ID一覧を取得必要時
/g98_settingsBot設定をWebページで変更（通知チャンネル・メッセージ等）必要時
/g99_setbutton登録ボタンをチャンネルに設置初回のみ

📋 コマンドまとめ（全員）

コマンド内容
/a01_register自分のSNS情報を登録・更新する
/a02_myprofile自分の登録情報を確認する
/a03_profile @ユーザーこのサーバー内のメンバーの登録情報を確認する（他のサーバーの人には見られません）
/a04_delete自分の登録情報を削除する
1
SNS情報を登録する（/a01_register）

登録ボタンを押すか /a01_register を実行すると入力フォームが表示されます。

1枚目：基本情報の入力
  1. 「表示名」を入力（任意・空欄の場合はDiscordの名前を使用）
  2. 「X URL」を入力（必須）
  3. 「YouTube URL」を入力（任意）
  4. 「Twitch URL」を入力（任意）
  5. 「送信」を押す
twitter.com のURLを入力した場合は自動的に x.com に変換されます。
1枚目送信後に表示されるボタン
ボタン説明
追加URLを入力するニコニコ・Bluesky などを登録する（2枚目フォームが開く）
登録情報を確認する現在の登録内容を確認する（自分にだけ見える）
サブ垢として登録するこのアカウントをサブ垢として設定する（参加者一覧に表示されなくなる）
2枚目：追加URLの入力（任意）
  1. 「追加URL① 名前」にサービス名を入力（例：ニコニコ）
  2. 「追加URL① URL」にURLを入力
  3. 追加URL②も同様に入力（任意）
  4. 「送信」を押す（入力不要な場合はそのまま送信でOK）
名前とURLは必ず両方入力してください。片方だけ入力した場合、参加者一覧に表示されません（データは保存されます）。
2
サブ垢として設定する

1枚目送信後の「サブ垢として登録する」ボタンを押すと設定できます。

  • サブ垢に設定すると参加者一覧に表示されなくなります
  • もう一度ボタンを押すと「メイン垢に戻す」ことができます
  • /a02_myprofile でサブ垢かどうか確認できます
3
登録情報を確認する
コマンド説明
/a02_myprofile自分の登録情報を確認する（自分にだけ見える）
/a03_profile @ユーザーこのサーバー内のメンバーの登録情報を確認する（自分にだけ見える）
4
登録情報を削除する（/a04_delete）

自分の登録情報を削除します。確認ボタンを押すと削除されます。

  • 削除後も /a01_register で再登録できます
  • 削除中は参加者一覧に表示されません
  • /a02_myprofile で削除済みであることが確認できます

📋 コマンドまとめ（管理者）

コマンド内容
/g01_chdesc [#ch/#thread]チャンネル/スレッドの未登録確認＋概要欄作成
/g11_roledesc @ロール指定ロールの未登録確認＋概要欄作成
/g20_getchdiscordidlist [#ch/#thread]チャンネル/スレッドのメンバーのDiscord IDと名前の一覧を取得
/g21_getrolediscordidlist @ロール指定ロールのメンバーのDiscord IDと名前の一覧を取得
/g98_settingsBot設定をWebページで変更（通知チャンネル・メッセージ等）
/g99_setbutton登録・確認ボタンをチャンネルに設置（初期設定）
1
チャンネル/スレッド指定で概要欄を作成する（/g01_chdesc）

未登録者の確認から概要欄の作成までを1コマンドで行えます。

使い方説明
/g01_chdesc実行したチャンネル/スレッドのメンバーで処理
/g01_chdesc #チャンネル指定したチャンネルのメンバーで処理
/g01_chdesc #スレッド指定したスレッドのメンバーで処理
全員登録済みの場合
  1. 「✅ 全メンバーが登録済みです！概要欄を作成しますか？」と表示される
  2. 「📋 概要欄を作成する」「🌐 Webページで編集する」「❌ キャンセル」から選ぶ
  3. 「📋 概要欄を作成する」を押すと参加者一覧が投稿される（「🌐 Webページで編集する」は下の3）
未登録者がいる場合
  1. 未登録者一覧が自分にだけ表示される
  2. 「📢 登録を促す」「📋 このまま概要欄を作成する」「🌐 Webページで編集する」「❌ キャンセル」から選ぶ
  3. 「登録を促す」を押すと未登録者にメンション＋登録ボタンが送信される
別チャンネルを指定した場合、メンションは指定したチャンネルに送信されます。設定ページの「大人数判定の人数」（初期値20人）以上の場合は、投稿前に確認ボタン（✅ 続行）が表示されます。
2
ロール指定で概要欄を作成する（/g11_roledesc）

指定したロールのメンバーで未登録確認から概要欄作成まで行えます。

全員登録済みの場合
  1. 「✅ 全メンバーが登録済みです！概要欄を作成しますか？」と表示される
  2. 「📋 概要欄を作成する」「🌐 Webページで編集する」「❌ キャンセル」から選ぶ
  3. 「📋 概要欄を作成する」を押すと参加者一覧が投稿される
未登録者がいる場合
  1. 未登録者一覧が自分にだけ表示される
  2. 「📋 このまま概要欄を作成する」「🌐 Webページで編集する」「❌ キャンセル」から選ぶ
未登録者は名前のみ表示されます。設定ページの「大人数判定の人数」（初期値20人）以上の場合は、投稿前に確認ボタン（✅ 続行）が表示されます。
3
Webページで編集してから投稿する

/g01_chdesc・/g11_roledesc の確認画面にある「🌐 Webページで編集する」を使うと、参加者一覧を投稿する前に、文章を自由に直せます。

  1. 確認画面で「🌐 Webページで編集する」を押す
  2. 編集用ページのURLが自分にだけ表示されるので、開く（URLは60分間有効）
  3. ページの中でテキストを直す（並び順の変更・一言の追加など）
  4. 「📨 Discordに投稿する」を押すと、コマンドを実行したチャンネル（指定した場合はそのチャンネル）に投稿される
60分を過ぎるとページは使えなくなります。その場合は、もう一度コマンドから実行してください。
4
メンバーのDiscord ID一覧を取得する（/g20・/g21）

企画の名簿づくりなどに使える、メンバーのDiscord IDと名前の一覧を取得します。一覧は自分にだけ表示されます。

使い方説明
/g20_getchdiscordidlist実行したチャンネル/スレッドのメンバー（チャンネルを指定することもできます）
/g21_getrolediscordidlist @ロール指定したロールのメンバー
Botのアカウントは一覧に含まれません。
5
登録ボタンを設置する（/g99_setbutton）

メンバーがボタンから簡単に登録できるようになります。初回のみ実行してください。

  1. ボタンを設置したいチャンネルで /g99_setbutton を実行
  2. 「SNS情報を登録・更新する」「登録情報を確認する」のボタンが投稿される
  3. メンバーはボタンを押すだけで登録できる
ボタンはBot再起動後も有効なまま維持されます。

実行時に notify_channel オプションで通知先チャンネル/スレッドを指定すると、メンバーが登録した際に通知が届きます（任意）。これは設定ページの「登録通知チャンネル」と同じ設定で、どちらで変えても同じものが変わります。

6
Bot設定をWebページで変更する（/g98_settings）

登録通知チャンネル・メッセージ文言・概要欄のラベルなど、サーバーごとの設定をWebページから変更できます。

  1. /g98_settings を実行すると設定ページのURLが発行される（60分間有効）
  2. URLを開いて各項目を変更し「設定を保存する」を押す
  3. 保存後はURLが無効になる
URLは自分にだけ表示されます。設定できる主な項目：登録通知チャンネル（/g99_setbutton の notify_channel と同じ設定）・メッセージ文言・概要欄ヘッダー・SNSラベル・参加者名の前後の文字・大人数判定の人数（初期値20人。この人数以上のとき投稿前に確認ボタンを表示）など。