API
API
简体中文

上行推送

在特定国家/地区/Sender ID，MOY Mobile 国际云通信平台支持接收用户回复短信（上行短信），并将其内容推送至客户服务器。

⚠️ 上行功能不是默认开启，且可能产生额外费用。仅部分国家和 Sender ID

支持该功能，且在部分国家或发送场景中，上行短信按条计费。详情请联系支持或参考官网资费页面。

接收地址设置

客户需在控制台中设置短信上行推送地址，路径如下：

控制台 → 短信 → 设置 → 推送设置 → 上行地址

格式如下：

https://your.domain.com/webhook/sms/mo

⚠️ 配置后地址将被平台缓存 5 分钟，变更最多可能延迟 5 分钟生效。

请求方式

  • 方法：POST
  • 内容类型：application/json
  • 触发时机：终端用户发送短信至平台支持上行的 国家/地区/Sender ID 时

推送数据格式

平台将以 JSON 格式向客户服务端推送如下数据：

{
  "messageId": "1948210789055074304",
  "from": "+1778***9779",
  "to": "+1866***1852",
  "content": "Hello.",
  "receivedAt": "2025-07-24T02:48:23"
}

字段说明

Field Type Description
messageId string 唯一消息 ID，平台生成
from string 用户回复短信的号码（E.164 格式）
to string 接收短信的 Sender ID 或虚拟号码（可选，某些国家可能缺省此字段）
content string 用户发送的上行短信内容（明文）
receivedAt string 平台接收到短信的时间，UTC 时区，ISO 8601 标准格式，格式为 YYYY-MM-DDTHH:mm:ss（例如 2025-07-24T02:48:23）

🔹 字段 to 为可选项，具体是否包含取决于运营商能力及国家限制。

📞 电话号码字段说明：
字段 from 使用 E.164 国际号码格式，例如：+14155552671。
它由 + 前缀 + 国家码 + 区号 + 本地号码组成，不能包含空格或其他符号。

响应要求

客户服务端应返回 HTTP 200 以表示接收成功。

⚠️ 平台当前 不支持失败重试机制，请确保 Webhook 服务高可用并具备处理能力。

示例

平台推送请求示例

POST /webhook/sms/mo HTTP/1.1
Host: your.domain.com
Content-Type: application/json

{
  "messageId": "1948210789055074304",
  "from": "+177****9779",
  "to": "+1866****852",
  "content": "Hello.",
  "receivedAt": "2025-07-24T02:48:23"
}

客户应返回

HTTP/1.1 200 OK

注意事项

  • 并非所有国家/地区支持上行短信。

  • 支持上行的 Sender ID、国家列表及接入号码，请联系支持获取。

  • 若希望启用此功能，请联系技术支持。

📧 支持邮箱：[email protected]

大纲