5G消息状态报告通知

1、概述

5G消息发送状态，转发给客户。流程见平台回调流程。

2、审核结果通知

在开户的时候填写回调地址

3、平台回调参数

名称		数据类型	是否必有	描述
result		string	是	回调状态码（0代表成功响应）
desc		string	是	描述
report		array[object]	否	状态报告对象的集合必需：result = "0"
	chatbot	string	是	chatbot的编号
	msgid	string	是	消息编号字符串长度限制范围：10-36
	dateTime	date	是	时间时间格式：yyyy-MM-dd HH:mm:ss
	phone	string	是	消息接收号码
	status	string	是	状态报告码消息在发送网关前在平台的校验：平台提交状态报告码消息已经发送至网关后的状态：平台发送状态报告码
	desc	string	是	平台发送状态描述
	wgcode	string	否	运营商返回状态 Sent：消息已发出 MessageSent：消息已发出 DeliveredToTerminal：以消息的形态达到终端 DeliveryImpossible：下行消息投递失败 DeliveredToNetwork：已转短消息发送 MessageDisplayed：消息已阅
	wgdesc	string	否	运营商返回描述
	feeCount	Integer	是	平台消息计费条数
	msgDetails	array[object]	否	同一条消息的合并状态报告比如长短信拆分的状态报告

msgDetails对象格式说明：

名称	数据类型	是否必有	描述
feeIdx	Integer	是	拆分的消息下标位置
wgcode	string	否	运营商返回状态 Sent：消息已发出 MessageSent：消息已发出 DeliveredToTerminal：以消息的形态达到终端 DeliveryImpossible：下行消息投递失败 DeliveredToNetwork：已转短消息发送 MessageDisplayed：消息已阅
wgdesc	string	否	运营商返回描述
status	string	是	状态报告码消息在发送网关前在平台的校验：平台提交状态报告码消息已经发送至网关后的状态：平台发送状态报告码
desc	string	是	平台发送状态描述

4、平台回调示例

例：发送成功

{
  "result": "0",
  "report": [
    {
      "dateTime": "2023-02-20 11:18:25",
      "chatbot": "a92e43085a0049ba8928b61fa04eeee",
      "phone": "15766666666",
      "wgcode": "DeliveredToTerminal",
      "msgid": "d4ace58a21581fc2c1fbb4692dfc3eca",
      "wgdesc": "UP2",
      "status": "delivered",
      "desc": "消息已送达"
    },
    {
      "dateTime": "2023-02-20 11:22:05",
      "chatbot": "a92e43085a0049ba8928b61fa04eeee",
      "phone": "15766666666",
      "wgcode": "DeliveredToTerminal",
      "msgid": "5339d03ebe916c435636a881b24a2494",
      "wgdesc": "UP2",
      "status": "delivered",
      "desc": "消息已送达"
    }
  ],
  "desc": "成功"
}

例：发送失败

{
  "result": "0",
  "report": [
    {
      "dateTime": "2023-02-22 14:28:15",
      "chatbot": "a92e43085a0049ba8928b61fa04eeee",
      "phone": "15766666666",
      "wgcode": "DeliveryImpossible",
      "msgid": "d54f51447a604f8e853ade1dec3f8be7",
      "wgdesc": "SVC1005",
      "status": "failed",
      "desc": "消息发送失败"
    }
  ],
  "desc": "成功"
}

5、客户响应参数

名称	数据类型	是否必有	描述
status	string	是	success 成功，其他的都视为推送不成功

6、客户响应示例

HTTP/1.1 200 OK
Server: IAG
Date: Thu, 11 Jun 2020 10:12:21 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 123
Connection: close

{
    "status": "success"
}

文档更新时间: 2026-05-15 14:36 作者：王超