Webhooks 是什么？
Webhook 会将 Mercateer 前台事件实时推送到您控制的 URL，使您的系统无需轮询 API 即可作出响应。每次交付均为经 HMAC 签名的 JSON 有效载荷，您可通过 API 或仪表盘注册和管理端点，失败的交付将按退避策略重试。
您可以使用 Webhooks 做什么
新潜在客户捕获并创建联系人
会话开始、关闭或请求转接人工
通话结束
预约已预订及预约已重新安排
报价被接受
您可在接收时验证的 HMAC 签名有效载荷
通过 API 或仪表盘注册和管理端点
几分钟内完成安装
1
创建端点
通过 API 或在“设置”>“开发者”中注册您的 URL 并选择要订阅的事件。Mercateer 将为该端点返回一个签名密钥。Crew 和 Fleet 套餐包含 API 访问权限。
2
验证签名
每次收到推送时，先从签名请求头中读取时间戳（t）和签名（v1），然后用你的签名密钥计算字符串 "{timestamp}.{raw request body}" 的 HMAC-SHA256，并与 v1 的值比对。若不匹配，或时间戳已超过 5 分钟，则拒绝该请求，这样你只会处理确实来自 Mercateer 的新鲜数据。（我们 SDK 中的校验辅助方法会替你完成全部步骤。）
3
幂等地处理重试
快速返回 2xx 响应以确认交付。失败的交付将按退避策略重试，因此请以事件 ID 作为处理键，忽略重复项，确保每个事件仅处理一次。
常见问题
兼容您的全套工具
Mercateer 使用与您现有工具相同的协议。