ナレッジベース

Zinn® Ads のイベントを Zapier、Make、および独自のシステムに送信します

新しい検出結果、適用された変更、および開始されたアラート用の署名付き Webhook。エンドポイントがダウンしている場合は再試行されます。

Zinn® Ads はイベントをお客様独自の Webhook エンドポイントに送信できるため、Zapier、Make、または独自のシステムで発生した瞬間に対応できます。イベントはads.finding.opened、ads.change.applied、ads.alert.startedです。

設定手順

ダッシュボードで通知チャネルを開き、Webhookエンドポイントを追加します。HTTPS アドレスである必要があります。専用の署名シークレットが作成され、一度だけ表示されます。
エンドポイントを検証します。テストリクエストが1件送信されますので、2xx ステータスで応答する必要があります。
Zinn® Adsを開き、Zapier、Make および独自システム用 Webhookを見つけ、そのエンドポイントで受信するイベントにチェックを入れてイベントを保存を選択します。テストを送信をクリックするとサンプルが1件送信されます。

配信内容

すべての配信は JSON 形式の POST です。ヘッダーのX-Zinn-Event (イベント名) およびX-Zinn-Delivery (配信ごとの ID: 処理済みの配信は破棄してください) が含まれ、さらにエンドポイントのシークレットで作成された<X-Zinn-Timestamp>.<raw body>の HMAC-SHA256であるX-Zinn-Signature: sha256=<hex>も付与されます。本文を信頼する前に、署名を検証し、古いタイムスタンプを拒否してください。各イベントの構造は、OpenAPI 仕様のwebhooks内に公開されています。

エンドポイントが停止している場合

配信に失敗した場合、1分後、5分後、25分後、125分後、625分後にさらに5回再試行され、各試行はエンドポイントの配信ログに記録されます。検証されていないエンドポイントには何も送信されず、イベントの選択が空の場合はそのエンドポイントに対する Zinn® Ads が無効になります。

ステップバイステップガイド

zinnads.com の[MCP および AI アシスタントから Zinn® Ads を制御する] (https://zinnads.com/kb/control-zinn-ads-from-mcp-and-ai-assistants)では、実際の画面のスクリーンショットを交えて手順を解説しています。Zinn® Ads のすべてのガイド: [zinnads.com/kb] (https://zinnads.com/kb)。