アウトバウンドWebhook
アウトバウンドWebhook は、リードイベントが発生したときに LeadHub から外部URLにリードデータをプッシュします。リードをCRMに同期したり、Zapierワークフローをトリガーしたり、外部システムに通知するために使用します。
アウトバウンドWebhookの仕組み
- ターゲットURLとリッスンするイベントを設定したアウトバウンドwebhookを作成します。
- 選択したイベントが発生すると（例: 新しいリードが作成された）、LeadHub はURLにHTTP POSTリクエストを送信します。
- ペイロードはリードデータ全体を含むJSONオブジェクトです。
アウトバウンドWebhookの作成
- インテグレーション → アウトバウンドWebhook に移動します。
- 新規 アウトバウンドWebhook をクリックします。
- 設定します:
| フィールド | 説明 |
|---|---|
| 名前 | 内部名（例: "HubSpotに同期"） |
| URL | POSTを受け取る外部エンドポイント |
| イベント | このwebhookをトリガーするイベント（以下参照） |
| シークレット | リクエスト署名検証のためのオプションのHMACシークレット |
| アクティブ | 有効/無効のトグル |
- 保存 をクリックします。
利用可能なイベント
| イベント | 発生タイミング |
|---|---|
lead.created | 新しいリードレコードが作成された |
lead.updated | リードが変更された |
lead.deleted | リードが削除された |
lead.stage_changed | リードが新しいパイプラインステージに移動した |
lead.assigned | リードがユーザーに割り当てられた |
form.submitted | フォームの送信が受信された |
ペイロード形式
すべてのアウトバウンドwebhookはJSONボディをPOSTします:
{
"event": "lead.created",
"occurred_at": "2026-04-29T10:30:00Z",
"lead": {
"id": 123,
"first_name": "Jane",
"last_name": "Smith",
"email": "[email protected]",
"phone": "+1-555-000-0000",
"source": "web_form",
"status": "new",
"lead_score": 45,
"pipeline": "Sales Pipeline",
"stage": "New Lead",
"assigned_to": "[email protected]",
"tags": ["vip", "from-webinar"],
"created_at": "2026-04-29T10:30:00Z"
}
}
HMAC署名の検証
シークレット を設定すると、LeadHub は HMAC-SHA256 署名で各リクエストに署名します。
署名は X-LeadHub-Signature ヘッダーで送信されます。
確認方法（PHPの例）:
$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
http_response_code(401);
exit;
}
Webhookの配信と再試行
LeadHub はキュー経由で非同期的にwebhookを配信します。外部エンドポイントが非2xxレスポンスを返した場合、指数バックオフで最大3回再試行されます。
配信履歴を確認するには Webhookログ を参照してください。
無効化と削除
- 無効化: アクティブをオフにトグル — イベントは送信されませんが、webhookは保持されます。
- 削除: webhookの設定が永久に削除されます。