store.store_webhooks における独立したレコードであり、独自の URL、購読イベントリスト、test/prod 環境バインディングを持ちます。
チャネル
URL ホスト
チャネルにかかわらず、任意の HTTPS URL が受け入れられます。URL とチャネルの想定プラットフォームの一致はマーチャントの責任です — Discord URL がchannel: "slack" で設定されている場合、ディスパッチャーはペイロードを Slack の attachments 形式でエンコードして Discord エンドポイントに送信し、エンドポイントはエラーで応答し、その失敗は webhook_deliveries に記録されます。
同一 URL の複数 webhook
同じストア内で、同一 URL を複数の Webhook に設定できます — Webhook はファンアウトモデルを採用し、異なるイベント購読、チャネル、testMode フラグで URL を共有できます。各 Webhook は独立して配信されるため、共有 URL で同一ペイロードを受信するコンシューマーは (eventType, eventId) で重複排除する必要があります。
制限
各ストアでは、すべてのチャネルにわたって最大 20 個の Webhook を持つことができます。制限を超えた場合は 400 が返されます。Webhook の一覧取得
list-webhooks エンドポイントは存在しません — 設定済み Webhook リストの照会は GraphQL Store.storeWebhooks を経由します(test_mode により環境で自動フィルタリングされます):
エンドポイント
Webhook の追加
ストアに新しい Webhook エンドポイントを設定します。
Webhook の更新
Webhook の URL、イベント、または secret を変更します。
Webhook の削除
Webhook を物理削除します(履歴は保持)。