Webhook

在您的后端接收异步事件。

配置

账户	配置位置
合作伙伴	合作伙伴中心 / 合作伙伴设置（webhook_url、webhook_secret）
开发者	/dev/settings 控制台或 PUT /api/v1/dev/settings

有关开发者 Webhook，请参阅开发者文档。

签名

请求中包含：

X-Seed360-Signature: <hmac_hex>
X-Seed360-Event: message.status

使用您的 Webhook 密钥验证签名（基于原始请求正文计算 HMAC-SHA256）。应拒绝无效签名。

事件类型

事件	触发时机
message.status	投递状态发生变化
conversation.message	支持对话中出现新消息
account.claimed	用户完成账户认领 / 关联
template.status	模板获批准 / 被拒绝

有效载荷示例

{
  "event": "message.status",
  "partner": "seed",
  "message_ref": "52c22ee0…",
  "state": "delivered",
  "channel": "inapp",
  "phone": "+228XXXXXXXX",
  "at": "2026-07-21T07:10:00Z"
}

测试端点

POST /api/v1/webhooks/test - 启用时，向您配置的 URL 触发示例回调。

最佳实践

• 及时返回 2xx，并采用异步处理
• 事件可能重试，因此处理程序必须具备幂等性
• 仅使用 TLS
• 记录签名验证失败，以便安全监控