跳到主要内容

出站 Webhook

出站 Webhook 在线索事件发生时，将线索数据从 LeadHub 推送到外部 URL。可用于将线索同步到 CRM、触发 Zapier 工作流或通知外部系统。

工作原理​

  1. 您创建一个带有目标 URL 和要监听事件的出站 Webhook。
  2. 当选定事件发生时（例如创建新线索），LeadHub 向您的 URL 发送 HTTP POST 请求。
  3. 有效负载是包含完整线索数据的 JSON 对象。

创建出站 Webhook​

  1. 进入集成 → 出站 Webhook。
  2. 点击新建出站 Webhook。
  3. 配置：
字段说明
名称内部名称（例如"同步到 HubSpot"）
URL接收 POST 请求的外部端点
事件触发此 Webhook 的事件（见下文）
密钥用于请求签名验证的可选 HMAC 密钥
活跃开关，用于启用或禁用
  1. 点击保存。

可用事件​

事件触发时机
lead.created创建新线索记录
lead.updated线索被修改
lead.deleted线索被删除
lead.stage_changed线索移至新的管道阶段
lead.assigned线索被分配给用户
form.submitted收到表单提交

有效负载格式​

所有出站 Webhook 发送 JSON 正文：

{
  "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 配置。