接收消息和事件

当用户在客服会话发送消息、或由某些特定的用户操作引发事件推送时，微信服务器会将消息或事件的数据包发送到开发者填写的 URL，如果使用的是云开发，则可以推送到指定的云函数(详情请参考消息推送)。开发者收到请求后可以使用 发送客服消息 接口进行异步回复。

各消息类型的推送JSON、XML数据包结构如下。

文本消息

用户在客服会话中发送文本消息时将产生如下数据包：

XML 格式

1482048670

1234567890123456

JSON 格式{

"ToUserName": "toUser",

"FromUserName": "fromUser",

"CreateTime": 1482048670,

"MsgType": "text",

"Content": "this is a test",

"MsgId": 1234567890123456

}

参数说明参数说明ToUserName小程序的原始ID

FromUserName发送者的openid

CreateTime消息创建时间(整型)

MsgTypetext

Content文本消息内容

MsgId消息id，64位整型

图片消息

用户在客服会话中发送图片消息时将产生如下数据包：

XML 格式

1482048670

1234567890123456

JSON 格式{

"ToUserName": "toUser",

"FromUserName": "fromUser",

"CreateTime": 1482048670,

"MsgType": "image",

"PicUrl": "this is a url",

"MediaId": "media_id",

"MsgId": 1234567890123456

}

参数说明参数说明ToUserName小程序的原始ID

FromUserName发送者的openid

CreateTime消息创建时间(整型)

MsgTypeimage

PicUrl图片链接(由系统生成)

MediaId图片消息媒体id，可以调用[获取临时素材]((getTempMedia)接口拉取数据。

MsgId消息id，64位整型

小程序卡片消息

用户在客服会话中发送小程序卡片消息时将产生如下数据包：

XML 格式

1482048670

1234567890123456

JSON 格式{

"ToUserName": "toUser",

"FromUserName": "fromUser",

"CreateTime": 1482048670,

"MsgType": "miniprogrampage",

"MsgId": 1234567890123456,

"Title":"title",

"AppId":"appid",

"PagePath":"path",

"ThumbUrl":"",

"ThumbMediaId":""

}

参数说明参数说明ToUserName小程序的原始ID

FromUserName发送者的openid

CreateTime消息创建时间(整型)

MsgTypeminiprogrampage

MsgId消息id，64位整型

Title标题

AppId小程序appid

PagePath小程序页面路径

ThumbUrl封面图片的临时cdn链接

ThumbMediaId封面图片的临时素材id

进入会话事件

用户在小程序“客服会话按钮”进入客服会话时将产生如下数据包：

XML 格式

1482048670

JSON 格式{

"ToUserName": "toUser",

"FromUserName": "fromUser",

"CreateTime": 1482048670,

"MsgType": "event",

"Event": "user_enter_tempsession",

"SessionFrom": "sessionFrom"

}

参数说明参数说明ToUserName小程序的原始ID

FromUserName发送者的openid

CreateTime事件创建时间(整型)

MsgTypeevent

Event事件类型，user_enter_tempsession

SessionFrom开发者在客服会话按钮设置的 session-from 属性