外部系统推送 (Webhook) 深度指南

线索鸭不仅是您的管理后台，更是一个强大的“数据中转枢纽”。通过外部系统推送功能，您可以将线索鸭接收到的线索实时、精准地同步到下游客户自有的 CRM（如 EC、纷享销客等）或其他业务系统中。

一、 全局推送延迟设置

在配置具体规则前，您需要了解全局推送延迟：

• 位置：【下游客户管理】-> 点击具体客户 -> 【配置推送】。
• 作用：设定线索分配给该客户后，等待多少秒再执行推送。
• 场景：若设置为 0 则立即推送；若设置延迟（如 300 秒），您可以在这段时间内进行“人工初筛”。如果延迟期间线索被重新分发（改派），旧的推送任务将自动作废。

二、 5步配置向导详解

点击【新建推送规则】，系统将引导您通过 5 个步骤完成对接。

Step 1: 接口设置 (基础与筛选)

最基础的连接定义。

• 推送驱动：
  • 通用 Webhook：支持标准的 HTTP 协议，适配绝大多数自定义系统。
  • 内置驱动 (如 EC CRM)：系统预设了特定平台的鉴权逻辑，简化配置。
• URL 与方法：支持 POST（推荐）、GET、PUT。
• 认证类型 (Auth)：
  • Bearer Token：常用的 Token 认证。
  • Basic Auth：账号密码认证。
  • API Key：自定义 Header 键值对认证（如 X-API-Key）。
• 自定义 Header：支持添加灵活的 Header（如 User-Agent、App-ID 等）。
• 推送筛选条件：非常重要！ 您可以设定“只有满足特定条件的线索才执行此条推送”。例如：仅推送“城市为上海”且“业务为家装”的线索到该接口。
  

Step 2: 字段映射 (变量化)

在此步骤，您需要定义从我方线索中提取哪些数据。

• 源字段：系统内置字段或您的自定义字段。
• 变量名：为您提取的数据取一个变量名（如 name -> customer_name）。这个变量名将在 Step 3 的模板中被引用。
  

Step 3: 发送格式 (JSON 模板)

这是数据对接的核心，决定了发送给对方的 JSON 报文格式。

• 参考接口：你必须参考对方的接口文档，发送符合对方接口的数据，通过自定义json进行实现
• 自定义 JSON：您可以编写任意深度的嵌套 JSON。
• 引用变量：使用 {{变量名}} 语法引用 Step 2 中定义的变量。
• 示例：

  {
    "lead_info": {
      "full_name": "{{customer_name}}",
      "contact": "{{mobile}}"
    },
    "address":"{{province}} {{city}}"
    "source": "leads_duck"
  }

  可以任意深度嵌套或者 多个变量在一个值里面

Step 4: 返回状态 (成功判定)

定义对方接口返回什么内容才算“推送成功”。

• HTTP 状态码：默认 200 或 201 为成功。
• 业务成功判断 (高级)：有时接口返回 200，但业务上却是失败的（如 {"code": -1, "msg": "duplicate"}）。
  • 您可以配置：当响应 JSON 中的 code 等于 0 时，才真正标记为推送成功。

Step 5: 接口调试 (联调利器)

无需真实分发线索即可测试。

• Request Payload：系统会根据模板自动渲染一份报文，您可以直接在编辑器里修改数据进行模拟。
• 发送测试：点击发送，系统会完整展示 Request (发送的报文) 和 Response (对方返回的 HTTP 状态码及报文)。这是排除因映射错误、URL 错误、认证过期等问题的最快方法。

三、 自动重试机制

• 最大重试次数：默认 3 次。
• 逻辑：如果初次推送失败（未满足 Step 4 的成功条件），系统会在后台队列中根据指数退避策略自动重试，确保网络抖动不会导致数据丢失。

四、 状态监控

在【推送日志】看板中，您可以查看每条记录的详情，点击【详情】可以直接看到 Step 5 中那样的完整报文对比，是运维排障的核心工具。