回复会发送到您的联系人已知的手机号码。
SMSMobileAPI / API
收到的 SMS API · 您的手机仍然是收件箱
将每条在您手机上接收到的 SMS 转换为可被应用使用的数据。
您的联系人向您现有的手机号码发送普通的 SMS。该信息先到达已连接的手机，然后 SMSMobileAPI 安全同步受支持的数据，使您的应用可以检索、分类并处理该回复。
不会用虚拟接收号码替代您的手机：您的手机、SIM 卡和现有号码仍然是交换的核心。
A联系人发送一条 SMS
“你能回电吗？”
+1 555 012 9841
你能回电吗？
/getsms/200sms.received
number+15550129841
device销售手机
status准备就绪
您的软件使用它
检索发送者、消息内容、接收手机、时间戳、GUID 以及可选的 alias。
在集中管理回复的同时，保留每条 SMS 实际接收的连接手机信息。
简单说明
API 并不会替代您的手机。它使手机收到的 SMS 可被使用。
SMSMobileAPI 在真实手机收件箱之上增加了一个安全的软件层。这使您的 CRM、客服平台或内部应用能够访问符合条件的接收消息数据，而无需更改联系人使用的号码。
联系人发送一条 SMS
联系人向附着在您 SIM 卡上的真实号码发送消息。
您的手机收到该信息
该 SMS 通过移动运营商到达已连接的手机。
应用进行同步
在获得所需权限和后台访问权限后，官方应用会将受支持的消息数据安全地发送到您的账户。
您的软件使用它
可通过 REST API 检索，接收 Webhook V2 事件，或在兼容的集成中显示。
您的应用可以使用的回复
一次请求即可返回消息及处理该消息所需的上下文信息。
使用 GET /getsms/ 列出已同步的入站 SMS。可按接收手机筛选、仅请求未读消息，或检索 Unix 时间戳之后的消息。
- number
- 发送者（可用时为国际格式）。
- message
- 从已连接手机同步的 SMS 文本。
- sIdentifiantPhone
- 接收该 SMS 的已连接手机。
- timestamp_unix
- 消息时间，可用于排序和增量同步。
- guid
- 用于读取状态和后续操作的稳定消息引用。
- alias
- 可选的联系人或应用标签。
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}选择合适的传递模式
通过 API 拉取消息 — 或使用 Webhook V2 立即响应。
这两种方法都使用相同的已连接手机数据。可根据应用的工作方式选择，或将两者结合以实现快速响应与可靠恢复.
当您的应用准备好时再请求消息.
- 构建收件箱或定期同步
- 按手机、时间或未读状态筛选
- 中断后恢复消息
SMSMobileAPI 向您的 HTTPS 目标发送 sms.received 事件.
- 无需轮询即可响应
- 使用持久化投递与自动重试
- 事件可用后立即启动工作流
不仅仅是简单的消息列表
构建完整的已接收-SMS 工作流.
/getsms/列出已接收的 SMS
使用手机、时间戳和未读筛选器，仅检索应用所需内容.
/getsms/set-read/标记为已处理
在应用处理消息后更新 SMSMobileAPI API 的已读状态.
/getsms/update/附加一个 alias
将联系人姓名或应用标签与已接收消息关联.
/conversation/sms/list/构建会话
按电话号码对收发消息分组，用于支持或 CRM 时间线.
通过 API 将消息标记为已读不会改变手机消息应用内的阅读状态.
你可以构建什么?
从单次回复到完整的业务流程.
创建共享的 SMS 收件箱
将多个授权手机的回复汇总到一个支持视图，同时保留接收手机信息.
完善联系人时间线
将收到的回复添加到客户记录，与外发 SMS 和相关的呼叫活动并列显示.
自动识别确认信息
检测确认、取消或改期请求并更新下一步操作.
对重要消息进行升级处理
在条件匹配时通知相关人员、调用 API 或启动 Workflow Studio 自动化.
从零到第一条 API 回复
通过 API 按四个受控步骤接收您的第一个 SMS.
- 1
安装并配对手机
安装最新版官方 SMSMobileAPI 应用，并将兼容手机连接到您的账户.
- 2
启用已接收-SMS 访问权限
在手机应用中授权已接收-SMS 同步以及您的工作流所需的后台运行权限.
- 3
发送一条唯一的测试消息
从其他号码向已连接手机发送一条 SMS，并在已接收 SMS 仪表盘日志中进行验证.
- 4
安全调用端点
将 API 密钥保存在您的服务器上，调用 /getsms/ 并存储 GUID，以便您的应用能避免重复处理.
接收 SMS API 常见问题
开发人员和运维团队首先会问的问题。
API 是否接收 SMS，而不是我的手机？
不是。与之兼容的已连接手机及其 SIM 卡会先接收 SMS。随后 SMSMobileAPI 同步受支持的消息数据，以便您的软件检索。
能否让多部手机为同一应用提供数据？
可以。多部授权手机可以连接到同一账号，接收手机标识允许您的应用保留每条消息的来源信息。
应使用轮询还是 Webhook V2？
当您的应用控制检索计划或需要恢复时，使用 GET /getsms/。当您希望 HTTPS 目标在事件可用时立即做出响应时，请使用 sms.received 的 Webhook V2 事件。许多生产系统会结合两者使用。
如何避免对同一条消息重复处理？
在应用中存储消息 GUID，并使处理具幂等性。处理成功后，您也可以更新 SMSMobileAPI API 的已读状态。
将消息标记为已读会更改手机收件箱吗？
不会。该端点更改的是 API 端的已读状态（供 SMSMobileAPI 工作流使用）；它不会将手机消息应用内的消息标记为已读。
我可以从应用中回复吗？
可以。您的应用可以调用 SMS 的发送端点，由选定的已连接手机通过其 SIM 和手机号码发送回复。
