アクション(動作ノード)リファレンス

「アクション(動作)」は、メッセージの送信、チャンネル・ロールの操作、Ban や Kick などのサーバー管理、外部 API との連携といった、Bot が実際に行う処理を表すノードです。ほとんどの入力欄では、固定の文字や ID のかわりに変数を使えます(変数と式の使い方)。

対象の指定見出しへのリンクをコピー

ロール・チャンネル・カテゴリー・スレッド・メンバーの欄は、「入力方法」を切り替えて指定します。

メッセージを送信見出しへのリンクをコピー

• 送信先は「コマンド実行と同じチャンネル」(既定)/「特定のチャンネル」/「コマンド実行者のDM」から選びます。DM は常にコマンドを実行した本人へ送られます。任意のユーザーを指定して DM を送る機能は未実装です。
• 送信先が「コマンド実行と同じチャンネル」のときは、実行者本人にだけ見えるメッセージにできます。
• 変数名を指定すると、送信したメッセージの ID が保存され、後続の編集・削除・ピン留め・リアクションの対象にできます。
• 本文・埋め込み・コンポーネントのいずれも空のまま実行すると、何も送信せずに次の処理へ進みます(エラーにはなりません)。
• 本文は最大 2000 文字、埋め込み(Embed)は 1 メッセージに最大 10 個、フィールドは 1 埋め込みに最大 25 個です。

メッセージ形式見出しへのリンクをコピー

形式を切り替えても本文・Embed の設定はエディタ上に保持されるため、「通常 (本文 + Embed)」に戻せば再び使えます。

テンプレートと JSON見出しへのリンクをコピー

• 「テンプレート」には、お知らせ・歓迎・ルール・投票・プレゼント企画・エラーの通知と、Components V2 のお知らせカード・ルールカードがあります。適用すると今のメッセージの内容は置き換わります。 メッセージ形式も、選んだテンプレートの形式(通常 / Components V2)に切り替わります。
• 「JSON をコピー」「JSON を貼り付け」で、Discohook と同じ形式の JSON を書き出し・取り込みできます。変数は書き出した JSON にそのまま残りますが、変数やランダムで指定した色は書き出せません。
• 取り込むのは BotShade で送れる項目だけです。ボタンとセレクトメニューは取り込まれないため、ノードとして追加してください。2 件目以降のメッセージと上限を超えた分も取り込みません。固定の日時は、送信した時刻に置き換わります。

ボタン・選択メニュー見出しへのリンクをコピー

「インタラクションモード」で、ボタンやメニューが操作されたあとの挙動を選びます。

選択メニューの制限:

• プレースホルダーは最大 150 文字、「デフォルト」タイプの選択肢は最大 25 件です。
• 複数選択を許可すると、最小選択数(0〜25)・最大選択数(1〜25)を設定できます。選ばれた値はカンマ(,)区切りの 1 つの文字列として変数に入ります。
• 「選択肢ごとに分岐を作る」をオンにすると、選択肢ごとの「比較による条件分岐」と Else をメニューの下に自動で作り、選択肢の追加・削除・値の変更に合わせて更新します。どの選択肢にも当てはまらなければ Else に進みます。次の場合は分岐が作られません。
  • 複数選択のメニュー(作成済みの分岐は残りますが、更新されなくなります)
  • 「保存する変数名」が空のとき
  • メニューの下に別のノードがつながっているとき

ボタン/セレクトの永続化見出しへのリンクをコピー

インタラクションモードとは独立して設定します。

永続を選んだときの補足:

• 「操作できるユーザー」で「全員」か「コマンド実行者のみ」を選べます。
• 「セッション有効期限(秒)」は、0・空欄・30 日を超える値のとき、最長の 30 日に丸められます。期限切れ後のクリックには「期限切れ」と応答します。
• 永続にできる選択メニューは、選択肢を自分で定義する文字列セレクトだけです。ユーザー/ロール/チャンネルの選択メニューは永続にできません。

モーダルを送信見出しへのリンクをコピー

実行者にポップアップの入力フォーム(モーダル)を表示し、入力値を変数として後続のノードで使えるようにします。タイトルは最大 45 文字、入力フィールドは最大 5 個です。

モーダルは次の 2 通りで開きます。

• コマンドの最初のアクションに置く: コマンドを実行した瞬間にモーダルが開きます。
• ボタンの出力からつなぐ: そのボタンがクリックされたときにモーダルが開きます。

条件分岐や権限判定を経由してモーダルにたどり着く構成でも開きます。どの条件も成り立たずモーダルに届かなかった場合は、クリックがそのまま受理されて終わります。

「モーダルを送信」の直下に、もう 1 つ「モーダルを送信」をつなぐことはできません(Discord の仕様上、モーダル送信後の処理から新しいモーダルは開けないため)。あいだに「メッセージを送信」など別のブロックを挟めば使えます。

フィールド種別見出しへのリンクをコピー

ラジオボタン以外の選択系フィールドは複数選択にでき、その場合は値が配列で返ります。

メッセージ操作見出しへのリンクをコピー

「メッセージのピン留め」「リアクションを追加」「メッセージの編集」「メッセージの削除」は、対象を「メッセージ変数」か「メッセージID」で指定します。どちらも「ブロックから」で前の「メッセージを送信」ノードを選べます。

• メッセージ変数には、「メッセージを送信」で付けた変数名を波括弧を付けずに書きます({msg} ではなく msg)。波括弧を付けると、実行時にメッセージが見つかりません。
• 対象のメッセージは実行中のチャンネルから探します。別のチャンネルや DM へ送ったメッセージ、実行者本人にだけ見えるメッセージは取得できず、何もしません。
• 編集できるのは Bot 自身が送ったメッセージだけです。本文も埋め込みも空のまま「メッセージの編集」を実行すると、何も変更しません。
• カスタム絵文字のリアクションは emoji_name:123456789012345678 の形式で指定します。Bot から参照できない絵文字は、リアクションが付かずにスキップされます(エラーにはなりません)。

メッセージ一括削除見出しへのリンクをコピー

• 1 回に削除できるのは 100 件までです。
• コマンドの実行中に投稿された新しいメッセージ(コマンド自身の応答など)は削除対象から除外されます。
• 投稿から 14 日より古いメッセージは 1 件ずつ削除されるため、時間がかかります。
• テキストチャンネルとスレッドでのみ動作します。

チャンネル操作見出しへのリンクをコピー

• 「チャンネル作成」のチャンネルタイプは「テキスト」(既定)/「ボイス」/「カテゴリー」/「ニュース」です。ニュースチャンネルはコミュニティ機能が有効なサーバーでしか作成できません。
• ボイスチャンネルにはトピックや NSFW を設定できません。「最大ユーザー数」はボイスチャンネルにだけ効きます。
• 「チャンネル編集」の「権限の統合」をオフにすると、ノードで設定した権限で既存の権限を上書きします。オンなら既存の権限と統合します。
• 「チャンネル編集」の「タグ」(フォーラム / メディアチャンネルのみ)は、並べたタグで既存のタグを置き換えます。書かなかったタグは削除され、そのタグが付いていた投稿からも外れます。
• 「チャンネル削除」は元に戻せません。ボイスチャンネルを削除すると、接続中のユーザーは切断されます。
• 実行中のチャンネルを削除しないでください。 コマンドを実行しているチャンネルを削除すると、それ以降のメッセージ送信が失敗します。

権限設定の「よく使う設定」は、押すと下の表の権限エントリを追加します。同じ対象のエントリがあれば置き換え、ほかのエントリはそのまま残ります。

スレッド操作見出しへのリンクをコピー

• 「付けるタグ」は、親チャンネルにあるタグの名前(大文字・小文字は区別しません)か ID で指定します。1 つの投稿に付けられるのは 5 個までです。「スレッドを編集」では追加ではなく置き換えになります。一致するタグが無い指定は、エラーにならずに無視されます。
• 「スレッドを削除」は元に戻せません。フォーラムの投稿は最初のメッセージごと削除されます。実行中のスレッドを削除すると、それ以降のメッセージ送信が失敗します。

ロール操作見出しへのリンクをコピー

• 「ロール作成」で作られるロールは、Bot の最上位ロールのすぐ下に配置されます。カラーの書き方は色の指定をご覧ください。空欄なら既定の色です。
• 「ロールアイコン (絵文字)」には通常の絵文字を 1 つ指定します。サーバー絵文字は使えません。ロールアイコンはサーバーのブーストレベル 2 以上でのみ有効で、足りないサーバーでは「ロール作成」はアイコンなしで作成し、「ロール編集」はアイコン以外の変更だけを反映します。空欄のときは、作成ではアイコンなし、編集では今のアイコンのままです。
• 「ロール編集」の「オンラインメンバーとは別で表示」「メンション可能」は「変更しない」(既定)/「オン」/「オフ」から選びます。
• 「ロール削除」は元に戻せず、そのロールを持っていたメンバー全員から外れます。
• Bot は、自分の最上位ロールより上にあるロールを付与・削除・編集できません。自分より上の立場のメンバーへのロール操作やモデレーションも失敗します。

サーバー操作見出しへのリンクをコピー

対象ユーザーの指定見出しへのリンクをコピー

「ロール付与」「ロールはく奪」「メンバーのBAN」「メンバーのKick」「メンバーのTimeout」「メンバーのニックネーム編集」の対象は、1 つの選択欄で次から選びます。

• 「コマンドを実行したユーザー」
• このコマンドのユーザーオプションで指定されたユーザー
• 「ID・変数で指定」(対象の指定の方法で指定します)

以前の「インタラクションを実行したユーザー」は、すでにこの値で保存されているノードにだけ表示され、「コマンドを実行したユーザー」と同じ扱いです。

各ノードの挙動見出しへのリンクをコピー

• BAN: 過去 0〜7 日分のメッセージを削除できます(既定は 0 日で削除しない)。Ban を解除しない限り再参加できません。サーバーを退出済みのユーザーも、「ID・変数で指定」で ID を指定すれば BAN できます。
• Kick: 再参加は防げません。
• Timeout: 「操作」で「タイムアウトする」か「タイムアウトを解除する」を選びます。解除では期間は使われません。期間は 10m(10 分)・1h(1 時間)・1d(1 日)の形で指定します。期間に 0 を指定しても解除にはなりません。タイムアウト中のメンバーはチャンネルを閲覧できますが、メッセージの送信・リアクション・ボイスの利用ができません。より長いタイムアウトが設定済みのメンバーに短いタイムアウトを設定しても変化しません。
• ニックネーム編集: 空にするとニックネームが解除され、ユーザー名に戻ります。
• Bot のステータスを変更: 変更は一時的で、Bot 設定を変更したときと Bot が再接続したときに、Bot 設定のステータスへ戻ります。ステータスは Bot 単位の設定なので、参加しているすべてのサーバーで表示が変わります。Free プランでは何もしません。
• インスタント招待の作成: 有効期限(日数)と最大使用回数は 0 で無期限・無制限、既定はどちらも 1 です。「一時的なリンク」をオンにすると、このリンクで参加してロールを持たないユーザーは 24 時間後に自動で Kick されます。作成したリンクは指定した変数(既定は invite_link)に URL として保存されます。カテゴリーチャンネルには作成できません。

APIリクエストを行う見出しへのリンクをコピー

外部の API に HTTP リクエストを送り、レスポンスを変数に保存します。リクエストビルダーはベータ版で、仕様や入力欄は今後変わることがあります。

「APIリクエスト名」(必須)がレスポンスを受け取る変数の名前になります。myApi の場合:

「テスト送信」の結果には、各項目を後続のノードで使うときの変数パスが表示され、コピーできます(APIリクエスト名の入力が必要です)。JSON パス抽出を設定しているときは、抽出した値を起点にしたパスになります。

リクエストビルダーは「閉じる」を押すとそのまま保存されます。URL が空・形式不正・許可されていない宛先のときは保存できず、閉じられません。

認証とボディ見出しへのリンクをコピー

• 認証・ボディ形式・Cookie から自動で付くヘッダーを、手動で重ねて追加する必要はありません。
• メソッドが GET のときは、ボディ形式が「なし」に固定されます。
• トークンなど秘密の値は、環境変数のシークレットに登録し、{env.NAME} で参照してください。ダッシュボードに値が表示されず、送信時にだけ展開されます。

詳細設定見出しへのリンクをコピー

IFTTTトリガーを実行する見出しへのリンクをコピー

このノードは現在開発中です。 設定は保存できますが、現時点では Bot 側で実行されません。

変数操作見出しへのリンクをコピー

「変数を設定」「変数への演算の適用」「変数の削除」「変数を読み出す」は 変数と式の使い方 で扱います。登録していない BSVAR_ 変数への代入の扱いは 永続変数 を参照してください。

色の指定見出しへのリンクをコピー

埋め込み(Embed)やロールの色は、次の方法で指定します。欄によって使える方法が異なります。

変数を展開した値や、抽選の作成で入力した値が色として読めないときは、エラーにならず色なしになります(ロールでは既定の色)。

既定値見出しへのリンクをコピー

何もせずに次へ進むケース見出しへのリンクをコピー

次の場合は何も変更せず、エラーにもならずに次の処理へ進みます。

• すでに持っているロールの付与、持っていないロールのはく奪
• BAN 済みのユーザーの BAN、Kick 済み・退出済みのユーザーの Kick・Timeout
• BAN の対象に、ID として読めない値や Discord に存在しないユーザーの ID を指定したとき
• 削除済みのメッセージ・チャンネル・ロールの削除、ピン留め済みメッセージのピン留め
• 「スレッドを編集」「スレッドを削除」で、スレッドではないチャンネルを指定したとき

上限と丸め込み見出しへのリンクをコピー

多くは範囲内に丸められ、コマンドは止まりません。ビルダーはこれらの欄に範囲外の値があると警告を出しますが、保存は止めません(変数を含む値は実行時まで検査しません)。

「待機」の上限は 制御フロー を参照してください。

失敗したとき見出しへのリンクをコピー

各アクションには対応する Bot 権限が必要で、足りないと処理が止まり、共通のエラー文が表示されます(表示されるメッセージ)。具体的な失敗理由はユーザーには表示されません。

監査ログの理由見出しへのリンクをコピー

モデレーション・ロール・チャンネルなどの操作は、Discord の監査ログに CmdBuilder: /コマンド名 の形で記録されます。「理由」欄のあるノードで理由を入力すると CmdBuilder: /コマンド名 — 理由 になります(変数も使えます)。Bot が先頭に付ける識別用の文字列と合わせて 512 文字までで、超えた分は切り詰められます。

関連ページ見出しへのリンクをコピー

• コマンドビルダーの概要と使い方
• 変数と式の使い方
• ノードの種類リファレンス — 全ノードの一覧