什么是 Webhook？— 实时通知

定义

Webhook 是一种系统间通信机制：一个应用中发生的事件会自动触发向另一个应用配置的 URL 发送数据。与需要轮询的 API 不同，webhook 在事件发生时主动通知。

发送短信后，运营商会上报状态（已发送、已送达、失败）。SMSGo 收到状态后向您注册的 URL 发起 HTTP POST 请求，以 JSON 格式发送数据。

常见状态包括：queued（排队中）、sending（发送中）、delivered（已送达）、failed（失败）和 expired（过期）。利用这些数据可更新面板、重试或提醒用户。

SMSGo 使用 HMAC-SHA256 对 webhook 签名。您的后端可验证签名，确保 payload 确实来自 SMSGo 且未被篡改。

需要 HTTPS 端点吗？

建议 HTTPS 以保障安全。端点需接受 POST 请求并返回 2xx 状态码。

如果我的端点失败会怎样？

SMSGo 会使用退避策略重试若干次。如果端点持续失败，重试将停止。

可以配置多个 webhook 吗？

通常每个账户配置一个 webhook，但您可以在自己的端点将事件转发到多个内部系统。

Webhook 免费吗？

免费。接收送达状态 webhook 是 SMSGo 的包含功能。

无需银行卡，无月费，额度永不过期。