Discord Webhook
Macro Deck に同梱Webhook を通じて、埋め込みやメンションを含むリッチなメッセージを Discord チャンネルに投稿します。ライブプレビュー付きです。
「名前」と「Webhook URL」の入力欄がある「Discord Webhook を追加」ダイアログ
- Webhook を名前付きで保存 (チャンネルごとに 1 つ)
- Discord と同じ見た目のプレビュー付きビジュアルエディター
- フィールド、画像、作成者、フッター付きの埋め込みを最大 10 個
- 許可しない限り、メンションで誰にも通知されない
- テンプレート変数はアクションの実行時に埋め込まれる
Discord Webhook を使うと、その URL を知っていれば何からでも 1 つの Discord チャンネルに投稿できます。Discord Webhook 連携は、Webhook を名前を付けて保存し、メッセージ用のビジュアルエディターを備えた 1 つのアクション Discord Webhook メッセージを送信 を提供します。Macro Deck を実行しているコンピューターに Discord アプリや Discord アカウントは必要ありません。
送信できる内容
エディターには 4 つのタブがあります:
- メッセージ: Discord の Markdown と改行を使えるメッセージ本文と、ユーザーやロールのメンション、
@everyone、@hereを挿入するボタン。 - 埋め込み: 最大 10 個の埋め込み。それぞれにタイトルとタイトルのリンク、説明、色、タイムスタンプ、作成者、フッター、画像、サムネイル、横に並べて表示できる最大 25 個のフィールドを設定できます。
- プロフィール: Webhook 自体のものの代わりに、このメッセージで使うユーザー名とアバター。
- メンション: メッセージ内のメンションで誰に通知してよいか。
既定では、誰か、@everyone、@here をメンションしていても、メッセージは誰にも通知しません。メンションは Discord に表示されますが、通知は届きません。すべてのテキスト欄でテンプレート変数を使え、アクションの実行時に値が埋め込まれるので、現在のシーン、曲、視聴者数などをメッセージに含められます。
エディターの下のプレビューは入力に合わせて変わり、Discord での表示と同じようにメッセージを表示します。プレビューから Discord に何かが送られることはありません。画像はプレースホルダーとして表示され、変数は書いたとおりに表示されます。テストメッセージを送信 は、今すぐ送信 で確認するとすぐにメッセージを Discord に送信するので、実際の見た目を確認できます。
設定例:
- 配信のタイトルとリンクを入れた埋め込みをお知らせチャンネルに投稿する 配信開始 ボタン。
- 再生中の曲を音楽チャンネルに投稿するボタン。
- 配信で何かが起きたときにモデレーター用チャンネルにメッセージを送るオートメーション。
保存した Webhook とカスタム URL
チャンネルごとに設定を 1 つ追加し、各アクションでは Webhook を名前で選びます。URL が変わっても、変更は 1 か所で済みます。1 回限りのメッセージなら、Webhook を カスタム URL にして、URL をアクションに貼り付けることもできます。Macro Deck はすべての Webhook URL を暗号化して保存し、二度と表示せず、ログにも書き込みません。
Macro Deck は送信前に Discord の制限を確認します。たとえばメッセージ本文は 2000 文字まで、すべての埋め込みを合わせて 6000 文字までです。問題があれば、編集中にプレビューの上に一覧表示されます。Discord が Webhook の投稿頻度を制限した場合、待ち時間が 5 秒以下なら Macro Deck は待ってからもう一度だけ送信を試みます。
必要なもの
- Windows、macOS、Linux 上の Macro Deck 3
- Macro Deck を実行しているコンピューターのインターネット接続
- Webhook を管理できる Discord チャンネルと、その Webhook URL
セットアップ
ステップ 1: Discord で Webhook を作成する
Discord でチャンネルの設定を開き、Integrations、Webhooks の順に進んで、Webhook を作成するか既存のものを選びます。Copy Webhook URL をクリックします。URL は
https://discord.com/api/webhooks/で始まります。この URL を知っていれば誰でもチャンネルに投稿できるので、パスワードと同じように扱ってください。ステップ 2: Macro Deck で Discord Webhook を開く
Macro Deck のサイドバーで 連携 をクリックし、Discord Webhook をクリックします。概要 タブの 設定 セクションで 設定を追加 をクリックします。右上のスイッチをオンにしても同じダイアログが開きます。
ステップ 3: Webhook を保存する
Discord Webhook を追加 ダイアログに入力します:
- 名前: アクションで Webhook を選ぶときに表示されます。たとえばチャンネル名です。
- Webhook URL: Discord でコピーした URL です。
続行 をクリックします。他のチャンネルごとに設定を 1 つずつ追加します。
ステップ 4: ボタンにアクションを追加する
デッキ ページで、使いたいボタンをクリックします。デッキのロックが解除されている必要があります。右上のボタンに ロック と表示されていれば解除されています。エディターが開き、短押し が選択されています。+ アクションを追加 をクリックし、アクションを追加 ダイアログの左側で Discord Webhook を選択して、Discord Webhook メッセージを送信 を選びます。
ステップ 5: メッセージを書く
Webhook で保存した Webhook を選びます。メッセージ タブで メッセージ本文 を書き、必要に応じて 埋め込み タブで埋め込みを追加します。プレビューを確認してから、テストメッセージを送信 と 今すぐ送信 をクリックして、Discord でメッセージを確認します。
ステップ 6: ボタンを押す
スマートフォン、タブレット、または Web クライアントでボタンを押します。変数が埋め込まれたメッセージが Discord チャンネルに表示されます。表示されない場合は、Discord が Webhook トークンを拒否したなど、アクションに理由が表示されます。
アクション1
ボタンに設定したり、フローから実行したりできます。
- Discord Webhook メッセージを送信
- 保存した Webhook またはカスタムの Discord Webhook を通じて、埋め込み付きのメッセージを送信します。ライブプレビューで編集できます。
よくある質問
ユーザーやロールをメンションするにはどうすればよいですか?
メンションには Discord の ID が必要です。Discord の詳細設定で Developer Mode をオンにしてから、ユーザーまたはロールを右クリックして Copy ID を選びます。メンション タブで、誰にも通知しない、メンションした全員に通知する、指定した ID だけに通知する、のいずれかを選びます。
Discord 連携との違いは何ですか?
Discord 連携には、埋め込みが 1 つだけでプレビューのない、古い Webhook を実行 アクションがあります。このアクションは引き続き使えます。Discord Webhook では、複数の埋め込み、メンションの制御、メッセージごとのプロフィール、ライブプレビューが加わります。
Webhook URL はどこに保存されますか?
Macro Deck を実行しているコンピューターに暗号化して保存されます。二度と表示されず、ログに書き込まれることも、プレビューに含まれることもありません。変更するには、もう一度入力します。受け付けるのは、discord.com、discordapp.com、ptb.discord.com、canary.discord.com 上の Discord Webhook のアドレスだけです。
テストメッセージで変数が埋め込まれないのはなぜですか?
テストメッセージを送信 は、変数を書いたとおりに送信します。変数に値が埋め込まれるのは、ボタン、オートメーション、スクリプトからアクションが実行されたときだけです。
アクションが失敗するのはなぜですか?
アクションに理由が表示されます。たとえば、メッセージが空または長すぎる、Webhook が Discord にもう存在しない、Discord が Webhook トークンを拒否した、Discord が Webhook の投稿頻度を制限している、などです。トークンが拒否された場合は、Webhook URL をもう一度コピーして設定に入力してください。
Companion アプリでメッセージを編集できますか?
Companion アプリや古いデスクトップアプリでは、アクションの設定がそのまま表示され、メッセージは content や embeds.0.title のようなキーと値になります。ビジュアルエディターで行った変更は保存されません。リッチなメッセージは最新のデスクトップアプリで編集してください。