短信从您自己的手机发出。了解工作原理
石窟画API 第一种架构安全设备配对交付可见度多设备控制已版本文件
SMSMobileAPI ›解决方案指南

接收 SMS Webhook

将接收到的短信从您的移动设备推送到您的应用

将传入 SMS 事件传递到您的 HTTPS 端点,具有账户范围的目标、事件过滤、签名、日志和自动重试。

  • 与之兼容的移动设备
  • 您的 SIM 和号码
  • API、工作流与集成
API请求已接受
事件活动已同步

轮询会造成延迟并产生不必要的 API 流量

当回复到达已连接的移动设备时,你的应用应在不重复请求新消息的情况下作出反应。Webhook V2 会将事件推送到你选择的 HTTPS 目标。

从业务事件到有用结果

一条受控链将您的软件、SMSMobileAPI 和您拥有的移动设备连接起来。

01 SMS 到达手机
02 事件已采集
03 签名的 HTTPS 传递
04 您的应用响应

监看接收到的 SMS 到达你的端点

序列会自动重复。可在任一步骤暂停,以便按自己的节奏阅读。

00:40引导式演练
  1. 1
    订阅

    添加一个 HTTPS 目标并选择 received-SMS 事件。

  2. 2
    接收

    联系人向已连接的手机号发送 SMS。

  3. 3
    验证

    在信任 JSON 载荷之前,您的服务器会验证签名。

  4. 4
    处理

    快速返回成功状态,然后异步继续处理。

示例:将客户回复转换为工单更新

客户回复配送通知。Webhook V2 将事件发布到客服中间件,中间件匹配电话号码、将回复添加到工单并提醒分配的客服。

结果:接近实时的入站处理,无需轮询循环。

在扩展之前了解运行条件

当其真实约束被包含在设计中时,物理手机架构非常强大。

1

目标必须使用公共 HTTPS 并应快速以成功状态响应。

2

始终验证 Webhook 签名并使事件处理幂等。

3

只有在移动应用获得权限并启用接收 SMS 通道后,投递才会开始。

一个移动平台,若干实现路径

从最适合您团队的最简单路径开始,当工作流增长时再结合更多功能。

常见问题

如果我的端点暂时不可用,会发生什么?

失败的投递会自动重试并保留在专用投递日志中可见。

一个账户可以使用多个 webhook URL 吗?

是。创建多个目标并精确选择每个目标接收哪些事件类型。

我是否应在响应前执行长时间处理?

否。验证并存储事件,快速返回成功,然后异步处理较长的工作。

连接您的手机并通过真实消息验证工作流。

创建一个账户,配对一台兼容手机并验证完整路径,然后再扩展。