这份文档还在翻译中,预期年底前完成。欢迎您提供宝贵的意见及建议。

入站短信

要接收入站短信,请创建 Webhook 端点并在 Nexmo Developer Dashboard 的 API 设置选项卡中配置您的帐户以使用它。

使用 GETPOST 请求将发送到您的 Nexmo 虚拟号码之一的所有消息都发送到您的 Webhook。当您在 Webhook 上收到消息时,必须发送 200 OK 响应。如若不然,则 Nexmo 将假定您尚未收到该消息,并将在接下来的 24 小时内重新发送该消息。

级联消息需要特别注意。请参阅级联入站消息

入站消息剖析

消息将作为具有以下属性的 JSON 对象发送到您的 Webhook 端点:

关键 必填
type 可能的值为: * text - 标准文本 * unicode - 包含 Unicode 字符的短信 * binary - 二进制消息 to

对于消息类型为 textunicode

如果 typetextunicode,则以下属性会出现在对 Webhook 端点的请求中。

关键
text 此入站消息的消息正文。
keyword 信息正文中的第一个单词。这通常与短代码一起使用。

对于消息类型为 binary

如果 typebinary,则以下属性会出现在对 Webhook 端点的请求中。

关键
data 该消息的内容
udh 十六进制编码的用户数据报头

对于级联的入站消息

如果发送到您的虚拟号码的消息符合单条消息的最大允许长度,则以下属性不会出现在对 Webhook 端点的请求中。

如果该消息长度超出单条消息中允许的最大字符数,则您将部分接收消息,并且以下属性会出现在请求中。

使用 concat-refconcat-totalconcat-part 属性可以从各个部分构造消息。

并非所有运营商都支持级联消息。如果运营商不支持级联,则净荷中将不存在 concat 字段。

关键
concat true
concat-ref 交易参考。该消息的所有部分共享此 concat-ref
concat-total 此级联消息中的部分数量⏎concat-part