需在扣子中配置唯一webhook端点以响应crm事件：进入bot设置→网络回调→添加http端点，获取https://webhook.coze.com/开头的不可修改url；crm端推送须含customer_id与status字段，支持json或表单格式，并启用secret token签名验证；扣子侧需开启自动解析并映射字段至crm_current_status、crm_id变量；测试返回200且日志显示解析成功即完成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当CRM系统中客户状态变更、工单创建或线索分配后，需要立即让扣子（Coze）Bot感知并响应，就必须在扣子中配置合法、可验证、能解析的Webhook接收端点。
获取扣子Webhook专属接收地址
进入扣子Bot后台 → 【Bot设置】→【网络回调（Webhook）】→ 点击【添加HTTP端点】。
填写名称（如“CRM-Status-Sync”），选择触发方式为“手动调用”，然后点击【创建】；系统自动生成一个以https://webhook.coze.com/开头的唯一URL，形如https://webhook.coze.com/v1/webhook/abc123xyz。
【该URL不可修改、不可复用，每次新建端点都会刷新，务必复制后立刻使用】。
配置CRM端推送参数与签名验证
登录CRM管理后台，在【集成中心】→【自定义Webhook】中新建推送规则。
方法一：标准JSON推送（推荐）
① 事件类型选“客户跟进状态更新”或“工单创建”，确保勾选“仅当字段值实际变化时触发”。
② 目标URL粘贴上一步复制的扣子Webhook地址。
③ 请求方法选POST，载荷格式选application/json，在请求体中必须包含customer_id和status两个字段，其他如updated_at、operator为可选。
④ 启用签名验证：输入双方约定的Secret Token（例如coze-crm-2026），并勾选“在请求头中添加X-Hub-Signature-256”。
方法二：表单格式兼容推送（仅限不支持JSON头部签名的老版CRM）
将字段改为x-www-form-urlencoded格式，把customer_id=CRM1001&status=high_intent作为请求体发送，同时在Header中手动添加X-Coze-Secret: coze-crm-2026。
注意：如果CRM不支持自定义Header，签名验证将失效，数据可信度下降，不建议生产环境启用。
绑定字段到Bot内部变量并启用自动解析
回到扣子【网络回调】页面，找到刚创建的端点，点击右侧【编辑】。
扣子 (Windows) 是字节跳动推出的一站式 AI Agent 平台客户端，支持多 Agent 协作、可视化工作流和知识库管理。最新版本新增 Claude Code 与 Codex CLI 接入、多端同步和项目级管理功能，同时优化了插件生态和 AI 响应速度，让用户在 Windows 上即可高效创建、运行和协作智能体，满足个人、团队及企业场景需求。
开启“自动解析JSON Body”开关；在字段映射区域，左侧填status，右侧选Bot内置变量crm_current_status；同理将customer_id映射至crm_id。
这一步做完后，后续所有来自CRM的推送，Bot在对话中即可直接调用{{crm_current_status}}变量生成应答，比如“您当前跟进状态是{{crm_current_status}}”。
保存设置，此时端点状态变为“已启用”。
测试推送与日志验证
在CRM端点击“发送测试请求”，或使用curl命令模拟一次真实推送：
curl -X POST https://webhook.coze.com/v1/webhook/abc123xyz \-H "Content-Type: application/json" \-H "X-Hub-Signature-256: sha256=xxxxxx" \-d '{"customer_id":"CUS-8891","status":"已签约","updated_at":"2026-06-07T17:32:10Z"}'
返回HTTP 200且日志中出现“Webhook received and parsed: CUS-8891 → 已签约”，说明配置完成。
