Webhook 是什么、能订阅什么
API 是你们去问美洽要数据,Webhook 反过来——事件发生时美洽主动 POST 一条消息到你们指定的服务器地址。常见可订阅事件:新会话创建、会话结束、新留言、工单创建/状态变更、客户资料变更等。具体事件清单以官方文档为准。
怎么配置
- 你们先准备一个接收地址(HTTPS 接口,能处理 POST JSON)。
- 后台「开放平台-Webhook」里填地址,勾选要订阅的事件。
- 保存后发一条测试推送,确认你们服务收到且解析正常。
使用要点
- 快速响应:接收接口要尽快返回 200(几百毫秒内),耗时逻辑异步处理,否则会被判定超时重推。
- 验签:按文档校验推送签名,防止伪造请求打到你们接口。
- 幂等处理:重推机制意味着同一事件可能收到多次,用事件 ID 去重。
- 失败告警:推送连续失败可能被暂停,接收服务要挂监控。
