Scribe Webhooks
リアルタイムのメール署名イベント

Scribe Webhookは、メール署名のワークスペースで何かが発生するたびに、署名付きのHTTPS POSTリクエストをエンドポイントに送信します。対象となるのは、コンバージョンの記録、訪問者の特定、署名の公開またはインストールの失敗、チームメンバーの追加または削除、キャンペーンの状態変更、連携の接続またはアクセスの喪失です。APIをポーリングする代わりに、イベントに応じて処理できます。

conversion.recorded、visitor.identified、signature.published、signature.installation.failed、teammate.created、teammate.deleted、campaign.scheduled、campaign.started、campaign.paused、campaign.resumed、campaign.ended、integration.connected、integration.access_lost、integration.disconnected。各エンドポイントで、必要なイベントのみ、またはすべてのイベントを購読してください。

Scribeのダッシュボードで「設定」→「Webhook」を開き、「Webhookを管理」をクリックします。HTTPSエンドポイントのURLを追加し、イベントタイプを選択して、テスト配信を送信してください。同じポータルで、配信ログの確認、失敗した配信の再送、署名シークレットのローテーションもできます。

いいえ。Zapier、Make、n8nのcatch hook URLを含め、任意のHTTPS URLを使用できます。署名検証やリトライの完全な制御が必要な場合は、独自のエンドポイントを構築してください。基幹システムに書き込む処理であれば、これらは欠かせません。

すべての配信にはsvix-id、svix-timestamp、svix-signatureヘッダーが含まれます。ScribeのWebhookはSvixを基盤とし、Standard Webhooksの署名方式に準拠しているため、Webhookポータルに表示される署名シークレットを使えば、Svixの公式ライブラリで1回の呼び出しで検証できます。

データが失われることはありません。配信に失敗した場合は、指数バックオフにより約1日間自動的に再試行されます。エンドポイントが正常に戻ったら、Webhookポータルから未配信分を再送してください。配信は少なくとも1回行われるため、svix-idヘッダーで重複を排除してください。

WebhookはScribe APIの一部で、BusinessプランとEnterpriseプラン、および14日間の無料トライアルに含まれています。エンドポイントはワークスペースのオーナーと管理者が管理します。