如何通过指定HTTP URL接收消息回执状态报告_Chat App 消息服务(Chat App)-阿里云帮助中心

您可以通过指定HTTP URL来接收Chat App 消息服务的消息回执状态报告。

协议说明

参数	说明
协议	HTTP + JSON
编码	UTF-8

请求说明

单次推送可能会包含多条消息状态报告结果。

MsgFrameType是template的请求样例

[
    {    
    "Status":"Failed",
    "ErrorDescription":"131026:Receiver is incapable of receiving this message(Message Undeliverable.)",
    "MsgFrameType":"template",
    "TaskId":"202307030171*******9",
    "From":"86131*******8",
    "Timestamp":1691043638000,
    "OriginPhoneNumber":"86130*******8",
    "TemplateCode":"820561547132813184",
    "Type":"TEMPLATE",
    "Language":"id",
    "TemplateName":"wa_otp_v_0_0_3",
    "To":"86138*******8",
    "ErrorCode":"131026",
    "MessageId":"2023078469463703*******3"
    },
    {    
    "Status":"Failed",
    "ErrorDescription":"131026:Receiver is incapable of receiving this message(Message Undeliverable.)",
    "MsgFrameType":"template",
    "TaskId":"202307030171*******9",
    "From":"86131*******8",
    "Timestamp":1691043638000,
    "OriginPhoneNumber":"86130*******8",
    "TemplateCode":"820561547132813184",
    "Type":"TEMPLATE",
    "Language":"id",
    "TemplateName":"wa_otp_v_0_0_3",
    "To":"86137*******8",
    "ErrorCode":"131026",
    "MessageId":"2023078469463703*******3"
    }
]

MsgFrameType是message的请求样例

[
    {    
    "Status":"Read",
    "MsgFrameType":"message",
    "Type":"INTERACTIVE",
    "TaskId":"2023068473353098*******8",
    "From":"86131*******8",
    "To":"86138*******8",
    "Timestamp":1691132091000,
    "OriginPhoneNumber":"86131*******8",
    "MessageId":"2023038470553398*******8",
    "ConversationId":"72222201111****",
    "ConversationType": "service"
    },
    {    
    "Status":"Read",
    "MsgFrameType":"message",
    "Type":"INTERACTIVE",
    "TaskId":"2023068473353098*******8",
    "From":"86131*******8",
    "To":"86138*******1",
    "Timestamp":1691132091000,
    "OriginPhoneNumber":"86131*******8",
    "MessageId":"2023038470553398*******8",
    "ConversationId":"72222201111****",
    "ConversationType": "service"
    }
]

字段说明

名称	类型	是否必填	描述
MessageId	String	是	消息的ID。
From	String	是	消息发送方号码。
To	String	是	消息接收方号码。
Timestamp	Long	是	时间戳为Unix timestamp 毫秒。
Status	String	是	消息发送状态。取值： Sent：消息已发送。 Delivered：消息已投递到用户设备。 Read：消息已被用户阅读。 Failed：消息发送失败。 Deleted：消息已被用户删除。说明 Deleted状态暂不可用，WhatsApp不会推送给ChatApp消息服务。
StatusDescription	String	是	状态码的描述。
ErrorCode	String	否	错误码。
ErrorDescription	String	否	错误码描述。详情请参见API错误码。
ConversationType	String	否	会话类型。取值： service：用户发起会话 utility：交易相关消息 marketing：营销类消息 authentication：身份验证消息
ConversationId	String	否	会话ID。
MsgFrameType	String	是	消息类型。取值： message：任意格式的消息，时间限制为在收到用户最后一条消息后的24小时内可发送此类消息。 template：在控制台已被审核通过的消息模板，可以在任意时间发送。
Type	String	否	消息内容中多媒体资源类型。取值： image：图片 video：视频 document：文档 audio：音频 none：纯文本
TaskId	String	否	客户任务ID。默认取值MessageId。说明如果TaskId未传值，则TaskId=MessageId。
OriginPhoneNumber	String	否	消息发送方的真实号码。
TemplateCode	String	否	消息模板编码。说明当MsgFrameType=template时有值。

响应说明

接收到回执后，响应的HTTP状态码必须为200，且响应体格式需如下所示，否则会推送失败，触发重新推送。

响应样例

{
  "code" : 0,
  "msg" : "成功"
}

字段说明

名称	类型	是否必选	描述
code	Number	是	应答编码。
msg	String	否	描述信息。

重新推送

第一次推送失败后，间隔1分钟、5分钟后会进行重推，直至推送成功为止。如果推送3次后仍失败，不再重试。