系统集成

通过 webhook 接收短信状态

实施场景 · 这是实施示例，并非真实客户的成功故事。效果取决于您的集成、手机、网络和运营商。

AI 生成的场景示意照片

需要解决的问题

API 响应表示任务已创建，而非最终结果。CRM 需要单独接收状态变化。

配置公开 HTTPS webhook，验证原始请求体签名，保存事件后再返回成功。根据消息 ID 更新订单记录，并处理事件重复投递。

不要对重新序列化的 JSON 验签。sent 不等于 delivered。状态未知时，由负责人员决定是否重新发送。

您的后端通过 API 创建任务，已连接的 Android 使用 SIM 卡发送短信。请在系统中保存消息 ID，并通过 webhook 接收状态变化。排队并不等于已发送：手机必须在线，运营商也必须接受消息。

首先使用您自己的测试号码。检查 Android 权限、息屏连接、使用相同 Idempotency-Key 的重试以及未知状态处理。不要将 API 密钥放入浏览器代码或公开仓库。