Scope: SHOP_BA_CHAT 需要申请权限 需要用户授权
触发场景#
场景:获客线索事件(快捷菜单 / 卡片工具触发线索留资)
公共参数#
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| event | string | 事件名 |
| timestamp | string | 事件发生时间标签 格式为 yyyy-MM-dd HH:mm:ss(UTC+8) |
| content | struct | 具体消息结构体 |
消息字段#
| 参数名 | 类型 | 备注 |
|---|---|---|
| main_open_id | string | 主账号 open_id |
| clue_id | string | 线索唯一标识 |
| encode_type | int | 编码类型 1-明文 2-密文 |
| send_scene | string | 获客工具发送场景:欢迎语/自动回复/客服发送/快捷菜单/其他 |
| tool_type | string | 获客工具类型:留资卡/企微卡/链接卡/拨打电话 |
| tool_id | string | 工具 ID |
| tool_name | string | 工具名称 |
| card_title | string | 卡片标题 |
| button_text | string | 按钮文案 |
| benefit | string | 利益点 |
| lead_card_data | struct | 留资卡信息 |
| lead_card_data.additional_info | string | 留资卡补充信息 |
| lead_card_data.phone | string | 手机号 |
| lead_card_data.wechat | string | 微信号 |
示例#
json
{
"event": "ACQUISITE_CLUE",
"content": {
"benefit": "优惠活动,免费咨询,一键报名",
"button_text": "立即提交",
"card_title": "testAPI",
"clue_id": "1212875361645686784",
"encode_type": 1,
"lead_card_data": {
"additional_info": "{\"称呼\":\"xhsks\",\"性别\":\"男\",\"年龄\":\"26\",\"日期\":\"2026.10.11\",\"城市\":\"河北省-石家庄市\",\"什么问题\":\"新角色\",\"年级\":\"年级-高二\"}",
"phone": "17612345678",
"wechat": "dhaoxjd"
},
"main_open_id": "5731314a0af042aca019415a324c3e92",
"send_scene": "自动回复",
"tool_id": "62",
"tool_name": "test",
"tool_type": "留资卡"
},
"timestamp": "2026-10-13 21:33:40"
}