这份文档还在翻译中,预期年底前完成。欢迎您提供宝贵的意见及建议。
入站短信
要接收入站短信,请创建 Webhook 端点并在 Nexmo Developer Dashboard 的 API 设置选项卡中配置您的帐户以使用它。
使用 GET 或 POST 请求将发送到您的 Nexmo 虚拟号码之一的所有消息都发送到您的 Webhook。当您在 Webhook 上收到消息时,必须发送 200 OK
响应。如若不然,则 Nexmo 将假定您尚未收到该消息,并将在接下来的 24 小时内重新发送该消息。
级联消息需要特别注意。请参阅级联入站消息。
入站消息剖析
消息将作为具有以下属性的 JSON 对象发送到您的 Webhook 端点:
关键 | 值 | 必填 |
---|---|---|
type |
可能的值为: * text - 标准文本 * unicode - 包含 Unicode 字符的短信 * binary - 二进制消息 |
是 to
|
对于消息类型为 text
或 unicode
如果 type
为 text
或 unicode
,则以下属性会出现在对 Webhook 端点的请求中。
关键 | 值 |
---|---|
text |
此入站消息的消息正文。 |
keyword |
信息正文中的第一个单词。这通常与短代码一起使用。 |
对于消息类型为 binary
如果 type
为 binary
,则以下属性会出现在对 Webhook 端点的请求中。
关键 | 值 |
---|---|
data |
该消息的内容 |
udh |
十六进制编码的用户数据报头 |
对于级联的入站消息
如果发送到您的虚拟号码的消息符合单条消息的最大允许长度,则以下属性不会出现在对 Webhook 端点的请求中。
如果该消息长度超出单条消息中允许的最大字符数,则您将部分接收消息,并且以下属性会出现在请求中。
使用 concat-ref
、concat-total
和 concat-part
属性可以从各个部分构造消息。
并非所有运营商都支持级联消息。如果运营商不支持级联,则净荷中将不存在 concat
字段。
关键 | 值 |
---|---|
concat |
true |
concat-ref |
交易参考。该消息的所有部分共享此 concat-ref 。 |
concat-total |
此级联消息中的部分数量⏎concat-part
|