Skip to main content
Home
  • 集成
  • 出站 Webhook

出站 Webhook

出站Webhook 在线索相关事件发生时，将线索数据POST推送到外部URL；可用于线索同步至CRM、触发自动化工作流、通知第三方业务系统。

#工作原理

  1. 创建出站Webhook，配置目标URL并选择需要监听的事件。
  2. 选中事件触发，LeadHub向外部地址发起HTTP‑POST请求。
  3. 请求体为携带完整线索信息的JSON载荷。

#创建出站Webhook

  1. 进入 集成 → 出站 Webhook。
  2. 点击新建出站 Webhook。
  3. 参数配置：
字段 说明
名称 后台内部标识，例如“同步到HubSpot”
URL 接收POST请求的外部接口地址
事件 订阅触发Webhook的事件类型
密钥 选填，用于HMAC签名校验请求合法性
活跃 开关，启用/禁用该Webhook
  1. 保存配置。

#支持的事件列表

事件标识 触发时机
lead.created 新建线索记录
lead.updated 线索信息被修改
lead.deleted 线索被删除
lead.stage_changed 线索切换流水线阶段
lead.assigned 线索分配给内部用户
form.submitted 收到表单提交事件

#JSON载荷样例

json 
{
  "event": "lead.created",
  "occurred_at": "2026-04-29T10:30:00Z",
  "lead": {
    "id": 123,
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@example.com",
    "phone": "+1-555-000-0000",
    "source": "web_form",
    "status": "new",
    "lead_score": 45,
    "pipeline": "Sales Pipeline",
    "stage": "New Lead",
    "assigned_to": "sales@yourcompany.com",
    "tags": ["vip", "from‑webinar"],
    "created_at": "2026-04-29T10:30:00Z"
  }
}

#HMAC‑SHA256签名验证

配置密钥后，HTTP请求头携带X‑LeadHub‑Signature签名，用于确认请求来源。 PHP校验示例：

php 
$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

#消息投递与重试

  • Webhook通过队列异步投递。
  • 外部接口返回非2xx状态码，会使用指数退避策略，最多自动重试3次。
  • 可查看Webhook日志，追溯全部投递历史记录。

#禁用与删除

  • 禁用：关闭「活跃」开关，保留配置，不再推送事件。
  • 删除：永久清除该Webhook全部配置。