使用精确的事件名称涵盖 SMS、通话、WhatsApp 和电子邮件。
WEBHOOK V2 · 将每个移动事件传递到您的软件
将连接移动设备的每个事件即时转化为操作。
SMSMobileAPI Webhook V2 在 SMS 被提交、发送、失败或接收时，在移动通话被漏接、来电或外拨时，以及在受支持的 WhatsApp 或电子邮件活动发生时，向您的应用发送结构化的 HTTPS 事件。您可以从仪表板可视化配置一切——无需轮询循环。
阅读 API 文档选择每个目标接收的事件。在同一工作区中测试、暂停、监控并轮换其签名密钥。
SMS呼叫西澳大利亚电子邮件
已签名的 JSON
SMSMobileAPIWebhookV2持久事件队列
实时
HTTPS POST
客户关系管理支持自动化分析
将不同的事件组发送到不同的 HTTPS 目标。
使用其 HMAC-SHA256 签名和时间戳验证每个请求。
临时目标失败会被重试，不会阻塞其他账户。
WEBHOOK V2 的工作原理
通过三步清晰流程，将真实移动事件传递到您的应用。
您的连接移动设备和 SMSMobileAPI 服务会产生操作事件。Webhook V2 将每个符合条件的事件放入持久传送队列，并向您选择的 HTTPS URL 发送带签名的 JSON 有效载荷。
- 1
事件发生
提交了一条消息、移动设备发送或接收了 SMS、通话状态发生变化，或记录了受支持的 WhatsApp 和电子邮件活动。
- 2
Webhook V2 将其路由
SMSMobileAPI 为每个事件创建一个稳定的事件 ID，并仅为订阅该事件类型的目标入队交付。
- 3
您的软件做出响应
您公开的 HTTPS 端点验证签名、存储事件 ID，并启动您的 CRM、支持、告警或自动化工作流。
15 种精确事件类型
仅订阅您的工作流所需的移动事件。
一个目标可以接收全部事件，或者您可以将生产系统、分析和运维告警分开。每个事件都有精确的名称，使您的应用能够可预测地处理它们。
SMS
5sms.api.submitted通过 API 提交的 SMS
一个 API 请求创建了一个 SMS 发送任务。可用于确认该请求已进入平台。
sms.sentSMS 已发送
连接的移动设备确认了 SMS 的发送操作。
sms.failedSMS 发送失败
已连接的手机返回了一个 SMS 发送错误。
sms.receivedSMS 已接收
已连接的手机同步了一个接收的 SMS。
sms.mobile.sent从手机发送的 SMS
已连接的手机手动发送了一个 SMS。
通话
3call.missed未接来电
已从已连接的手机同步了一个未接来电。
call.incoming来电
已从已连接的手机同步了一个来电。
call.outgoing呼出通话
已从已连接的手机同步了一个呼出通话。
whatsapp.submittedWhatsApp 已提交
已创建一个 WhatsApp 发送任务。
whatsapp.sentWhatsApp 已发送
已连接的 WhatsApp 环境确认消息已发送。
whatsapp.failedWhatsApp 失败
WhatsApp 的发送操作失败。
whatsapp.receivedWhatsApp 已接收
在账户请求同步后检索到了一条 WhatsApp 消息。
whatsapp.voice.transcribed语音留言已转写
一条符合条件的检索到的 WhatsApp 语音留言已被转换为可用文本。
电子邮件
2email.sent电子邮件已发送
SMSMobileAPI 创建了一个电子邮件发送请求。
email.received电子邮件已接收
已连接的邮箱接收到了一封电子邮件。
通过可视化界面配置一切
无需编辑配置文件的专业 webhook 管理。
在 SMSMobileAPI 仪表板中打开 Webhook V2，添加目的地名称和公开的 HTTPS URL，选择要接收的事件，然后保存。仪表板为日常操作和故障排除提供所需的控制项。
多个目的地
为您的 CRM、监控、分析或客户应用创建专用目的地。
事件过滤器
精确选择每个 URL 接收哪些 SMS、通话、WhatsApp 和电子邮件事件。
测试投递
在将目的地用于生产环境之前，先发送一个受控的测试事件。
暂停并重新激活
立即停用某个目的地而不删除其配置。
密钥轮换
在安全流程需要时生成新的签名密钥。
投递活动
查看处于队列中、已投递、重试中和失败的投递，并查看尝试次数和 HTTP 状态信息。
Webhook V23 个活跃
CRM 生产环境
https://crm.example.com/hooks/mobile活动中sms.receivedcall.missedwhatsapp.received
运营警报
https://ops.example.com/events活动中sms.failedwhatsapp.failed
从设计上保证可靠性
为可靠且独立的投递而构建。
Webhook 投递是异步的。您的移动工作流不会等待第三方 URL 的响应，某一失败的目标也不会阻塞其他客户或目标。
持久化队列
符合条件的事件在投递前会被存储，因此接收端的暂时宕机不会导致事件丢失。
至少一次投递
投递可能会重试。请在您自己的应用中存储事件 ID，并确保只处理一次。
递增重试
临时性故障会按递增延迟重试，直到达到平台的重试上限。
故障隔离
缓慢或不可用的端点不会阻止向无关目标的投递。
自动保护
对持续失败的目标可进行暂停，以保护队列和您的基础设施。
运营可见性
仪表板和站点监控可显示队列健康状况、投递结果及近期投递错误。
已签名且可验证
在信任事件之前先验证请求。
每次投递都包含时间戳、投递标识、事件类型、稳定的幂等键和 HMAC-SHA256 签名。将签名密钥保存在您的服务器上，从原始请求体计算签名，并拒绝无效或过期的请求。
X-SMSMobileAPI-Event事件类型，例如 sms.received。X-SMSMobileAPI-Delivery该目标的唯一投递标识。X-SMSMobileAPI-Timestamp签名验证时使用的 Unix 时间戳。X-SMSMobileAPI-SignatureHMAC-SHA256 签名，用于安全比较。Idempotency-Key用于防止重复处理的稳定事件 UUID。一致的事件封装
针对每个渠道，使用一致的 JSON 封装。
该封装在 SMS、通话、WhatsApp 和电子邮件间保持可预测性。data 对象包含与事件类型相关的字段，而顶层标识可用于路由和去重每次投递。
id— 稳定的事件标识type— 精确的事件类型occurred_at— 活动发生的时间data— 渠道特定信息
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}从事件到业务成果
让移动通信触发下一步业务动作。
CRM 会话
将收到的 SMS 或 WhatsApp 消息添加到正确的联系人，并提醒指派的负责人。
未接来电恢复
在未接来电后创建回呼任务、发送后续 SMS 或通知值班团队。
客户支持
当客户通过手机回复时，创建或更新支持工单。
电子商务运营
在移动消息发送、确认或失败后，更新订单沟通工作流。
监控与告警
将投递失败或异常通话活动发送到您的可观测性与事件处理工具。
AI 与数据工作流
将经授权的事件输入分类、报表或辅助工作流，无需反复轮询 API。
停止轮询变更
轮询会反复请求，而 Webhook 在发生变更时会通知您的软件。
即使没有变化，轮询也会消耗请求并在检查之间增加延迟。Webhook V2 会将相关事件推送到您的端点，使自动化更快、更简单且更易扩展。
有新事件吗？重复请求 · 额外延迟
事件
发生时通知我。相关事件 · 即时触发工作流Webhook V2 常见问题
在连接端点前的常见问题。
我需要构建轮询循环吗？＋
不需要。Webhook V2 会将订阅的事件发送到您公开的 HTTPS 端点。当您需要查询历史或详情时，仍可以使用 API。
我可以配置多个 webhook URL 吗？＋
可以。您可以创建多个目标，并为每个目标选择不同的事件集合，具体取决于仪表板中显示的账户限制。
如何确认 SMS 确实已发送？＋
使用 sms.api.submitted 可知道任务已创建，使用 sms.sent 可获知连接的手机上报的确认。请将二者视为两个不同的操作阶段。
Webhook 可能会被重复投递吗？＋
会的。Webhook V2 使用至少一次投递策略。请保存稳定的事件 ID 或 Idempotency-Key，并忽略已处理过的投递。
我的端点需要返回什么？＋
在安全接收事件后返回一个 HTTP 2xx 响应。事件处理可在您的应用内部以异步方式继续进行。
接收到的 WhatsApp 事件会持续收集吗？＋
不会。WhatsApp 的已接收消息检索遵循基于同意的同步流程。whatsapp.received 事件在符合条件的消息被检索后才可用。
您的移动事件。您的软件。您的操作。
立即将您的软件连接到真实手机的活动。
创建账户或登录，打开 Webhook V2，添加一个公开的 HTTPS 目标并选择对您的工作流重要的事件。发送测试事件，验证其签名并激活集成。
