本文档介绍如何配置Webhook，实现自动化流程与第三方平台或自定义服务的集成。

什么是Webhook

Webhook是一种HTTP回调机制，允许应用在特定事件发生时，自动向配置的URL发送HTTP请求，实现实时数据推送和系统集成。

第一部分：三大平台Webhook配置

创建群机器人

飞书

1. 进入飞书群聊
2. 点击群设置 → 群机器人 → 添加机器人
3. 选择"自定义机器人"
4. 设置机器人名称和描述
5. 配置安全设置（签名校验）
6. 复制Webhook地址

企业微信

1. 进入企业微信群聊
2. 点击群设置 → 群机器人
3. 点击"添加群机器人"
4. 设置机器人名称
5. 复制Webhook地址

钉钉

1. 进入钉钉群聊
2. 点击群设置 → 智能群助手 → 添加机器人
3. 选择"自定义"机器人
4. 设置机器人名称和安全设置
5. 复制生成的Webhook地址

在来鼓自动化中配置

1. 进入自动化 → 后台自动化
2. 根据你的需求选择不同的触发事件进入画布并链接「webhook推送」节点
3. 配置webhook推送节点：
   1. 粘贴Webhook地址
   2. 设置推送消息的标题
   3. 设置推送的顾客信息字段
4. 保存并启用画布。

第二部分：自定义Webhook配置

概述

来鼓通过Webhooks功能将工作台的对话、顾客数据，以回调方式主动同步到你的服务器，你可以基于收到的数据做进一步处理。

请求格式

请求方法: POST

请求头: Content-Type: application/json

数据结构说明

基本结构

{
  "id": "string",           // 事件ID，UUID v7格式（去除连字符）
  "eventType": "string",    // 事件类型，固定为 "cus_became_leads"
  "createdAt": 1640995200000, // 创建时间戳（毫秒）
  "body": {                 // 客户数据，根据配置的字段动态生成
    // 以下字段根据工作流配置动态包含
  }
}

Body 字段说明

用户基本信息

字段名	类型	说明
customerId	string	用户ID
nickname	string	用户昵称
name	string	用户姓名
telephone	string	手机号（旧版）
tel	string	手机号（新版）
weixin	string	微信号
address	string	所属地域
comment	string	备注
tagIds	array	关联标签ID列表
tagsDetail	json	标签明细，key为标签ID，value为标签名称
subSourceId	string	来源账号ID
subSourceName	string	来源账号名称
source	string	来源平台；redbook-小红书，douyin-抖音
incomingNoteId	string	来源笔记的ID
incomingNoteTitle	string	来源笔记的标题
advertiserId	string	广告主ID
advertiserName	string	广告主名称
campaignId	string	广告计划ID
campaignName	string	广告计划名称
creativityId	string	广告创意ID
creativityName	string	广告创意名称
customerChannel	string	企微加微用户与小红书用户关联信息
wecomLinkName	string	企微添加名称
wecomLinkId	string	企微添加链接
weixinUrl	string	微信二维码

用户自定义字段信息

对于用户在「设置-顾客字段」中新建的顾客字段，来鼓同样可以通过webhook推送到群机器人或者自定义Webhook配置

字段名	类型	说明
example1	string	用户自定义字段的对接名称（单选、字符、数字）
example2	arrry	用户自定义字段的对接名称（多选）

请求示例

{
  "id": "018f1234567890abcdef1234567890ab",
  "eventType": "cus_became_leads",
  "createdAt": 1640995200000,
  "body": {
    "customerId": "cus_123456",
    "name": "张三",
    "nickname": "小红薯用户",
    "subSourceId": "source_001",
    "subSourceName": "小红书官方账号",
    "telephone": "13800138000",
    "weixin": "wx_zhangsan",
    "address": "北京市朝阳区",
    "comment": "重要客户",
    "tagIds": [1, 2, 3],
    "advertiserId": "adv_001",
    "advertiserName": "广告主A",
    "campaignId": "camp_001",
    "campaignName": "春季推广活动"
  }
}