定义
Webhook 是平台在发生某个事件（如消息已送达、已读或失败，或客户回复到达）时，向您提供的 URL 发送的 HTTP 请求，让您的系统无需轮询就能立即得知该事件。
您注册一个端点（例如 https://example.com/hooks/messaging）。事件发生时，平台会发送一个带 JSON 请求体的 POST 请求来描述该事件：消息 ID、状态、时间戳、渠道和错误详情。您的服务器应迅速返回 2xx 状态码，并异步处理该事件。
请针对真实的投递情况来构建：webhook 可能延迟、乱序或重复到达。使用消息 ID 和状态去重，绝不要让状态倒退（例如从 READ 退回 DELIVERED），并保持可安全重试的幂等处理程序。
安全方面：只接受 HTTPS，对每个请求校验签名或共享密钥，在验证通过之前不要信任负载内容。Standard Webhooks 规范等行业惯例描述了常见的签名和重试模式。
在消息领域，webhook 为送达报告、已读率、上行回复、退订以及渠道回退决策提供数据。
OmniChannels.ai 为送达状态（SUBMITTED、SENT、DELIVERED、READ、FAILED、REJECTED）发送 webhook，并在各渠道间统一为同一种格式。
示例
{"messageId":"msg_123","channel":"whatsapp","status":"DELIVERED","timestamp":"2026-10-10T09:15:02Z"}