Vivoldi Webhook — リアルタイムイベント配信
リンククリック、クーポン利用、スタンプ付与イベントを、大規模トラフィック環境でもリアルタイムかつ安定して配信できます。
HMAC-SHA256 署名検証、重複イベント防止、自動リトライまで標準対応。追加設定なしでエンタープライズレベルの信頼性を利用できます。
Vivoldi Webhookとは？
Vivoldi Webhook は、イベント発生と同時にお客様のエンドポイントへデータを直接送信するリアルタイムなサーバー間連携システムです。
別途 API polling を行う必要はなく、Vivoldi に登録されたエンドポイントへイベントデータを即時配信することで、スムーズなリアルタイムデータ連携を実現します。
💡 Webhook を使用する理由は？
従来の API polling 方式では、定期的にサーバーへリクエストを送信する必要があるため、不要なAPIトラフィックが増加し、イベント検知に遅延が発生する場合があります。
Vivoldi Webhook は、イベント発生時のみお客様のサーバーを呼び出すため、不要なリクエストなしで即時対応が可能です。
CRM 更新、決済処理、マーケティング自動化など、リアルタイム性が重要なワークフローに最適です。
Vivoldi の Webhook システムは、自動リトライと配信保証メカニズムにより、すべてのイベントを安定して確実に配信します。
エンタープライズ環境向けに設計されており、すべてのペイロードは HMAC-SHA256 署名検証 によって保護され、データの改ざんや不正変更を防止します。
Webhook の動作フロー
Vivoldi Webhook は、イベント発生 → 署名生成 → 配信 → ACK（受信確認）の4段階で動作します。
-
ステップ1 — イベント検知
リンククリック、クーポン利用、スタンプ付与など、設定されたイベントが発生すると、Vivoldi システムが即座に検知します。 -
ステップ2 — 署名生成
送信前にペイロードへ HMAC-SHA256 署名を生成し、リクエストヘッダーへ含めます。
お客様のサーバー側では、この署名を検証することで Vivoldi から送信された正規リクエストか確認できます。 -
ステップ3 — HTTPS 配信
署名付きペイロードをお客様のエンドポイントへ HTTPS POST リクエストとして送信します。配信に失敗した場合は、Exponential Backoff 方式で最大5回まで自動再試行します。 -
ステップ4 — ACK（受信確認）
お客様のサーバーが 200 レスポンスを返した場合、正常受信として処理されます。応答がない場合やエラーコードが返された場合は、自動的に再試行キューへ登録されます。
Webhook の主な機能
Vivoldi Webhook は、エンタープライズ環境でも安定運用できるよう、3つの主要機能を中心に設計されています。
-
リアルタイム自動化
イベント発生からお客様システムでの処理までの遅延を最小限に抑えます。
クーポン利用と同時にCRMを更新し、スタンプ付与直後にリワード処理を実行するなど、完全自動化パイプラインを構築できます。 -
エンタープライズレベルのセキュリティ
HMAC-SHA256 署名に加え、タイムスタンプベースの有効期限検証と一意のイベントIDを組み合わせることで、リプレイ攻撃や重複リクエスト処理を防止します。
署名検証の実装方法については、Developer Guide をご参照ください。 -
運用管理のしやすさ
エンドポイント応答エラー時の再試行履歴、失敗通知、自動無効化など、運用管理機能を標準搭載しています。
別途監視システムを構築しなくても、Webhook 配信状況を安定して管理できます。
リアルタイム自動化
リンクアクセス、クーポン利用、スタンプの獲得および特典利用を即時に反映し、マーケティング・CRM・決済ワークフローを自動化しましょう。
エンタープライズセキュリティ
HMAC-SHA256署名、コンテンツハッシュ、タイムスタンプ検証により、リンク・クーポン・スタンプのイベントに対する改ざんやリプレイ攻撃を防止します。
運用の信頼性
少なくとも1回の配信保証、自動再試行、通知メール、無効化ロジックにより、システム障害時でもリンク・クーポン・スタンプのイベントを安定して処理します。
✨ エンタープライズ級リアルタイム連携
大量のリンク・クーポン・スタンプイベントを処理するエンタープライズ環境向けに最適化されています。
高可用性インフラと信頼性の高いキューイングシステムを基盤とし、急激なトラフィック増加時でもイベント欠損なく、CRM・決済・分析プラットフォームと安定して連携できます。