靠轮询 API 来判断某件事有没有发生,既慢又浪费请求。Webhook 把这个逻辑反了过来:你给 sona.to 一个 URL,当帖子发布或发布失败、站点审计或 AI 可见性检查结束的那一刻,sona.to 就发来一个带签名的 HTTP 请求。把它指向 Zapier、Make、n8n 或你自己的服务器,你技术栈的其余部分就会自动响应。
事件即时送达
八个事件覆盖了值得响应的结果:帖子已发布或发布失败、站点审计完成或失败、AI 可见性检查完成或失败,以及 AI 助手开始或不再提到你的品牌。每个事件携带的字段与 API 返回的一致,因此 Webhook 和 GET 的内容相同。

带签名,可以信任
每个请求都带有基于时间戳和消息体计算的 HMAC SHA-256 签名,密钥是创建 Webhook 时仅显示一次的密钥。校验通过,就说明该请求确实来自 sona.to,且不是重放。

重试与投递日志
投递失败会在 60 秒后重试,然后是 5 分钟,然后是 30 分钟。每次尝试都会记录状态码和耗时,因此排查有问题的接收端很容易。

使用方法
1
添加 URL
粘贴你的工具给出的地址。必须使用 https。
2
选择事件
勾选该接收端应当接收哪些事件。
3
保存密钥
签名密钥只显示一次。请保存好,用于校验收到的请求。
4
自动响应
事件发生的那一刻你的工作流就会运行,无需轮询。
适合人群
Zapier、Make 和 n8n 用户:帖子发出时触发一个工作流。
团队:把发布确认或失败推送到聊天频道。
代理机构:把每一条客户帖子记录进自己的报表系统。
开发者:希望自己的系统主动响应,而不是轮询。
常见问题
