后台接入消息服务
用户向小程序客服发送消息时,百度服务器将向开发者填写的服务器配置 URL 推送消息,开发者可以依据自身业务逻辑进行响应。
百度服务器在将用户的消息发给开发者服务器地址后,百度服务器在 2 秒内收不到响应会断掉连接。
关于重试的消息排重,有 msgid 的消息推荐使用 msgid 排重。事件类型消息推荐使用 FromUserName + CreateTime 排重。
服务器收到请求必须作出下述回复。详见下面说明:
- 直接回复 success(推荐方式)
- 直接回复空串
接收消息
各消息类型的推送 JSON.XML 数据包结构如下。
文本消息
用户在客服会话中发送文本消息时将产生如下数据包:
XML 格式
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1482048670</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[this is a test]]></Content>
<MsgId>1234567890123456</MsgId>
</xml>
JSON 格式
{
"ToUserName": "toUser",
"FromUserName": "fromUser",
"CreateTime": 1482048670,
"MsgType": "text",
"Content": "this is a test",
"MsgId": 1234567890123456
}
参数说明
参数 | 说明 |
---|---|
ToUserName | 小程序的 appId |
FromUserName | 发送者的 openid |
CreateTime | 消息创建时间(整型) |
MsgType | text |
Content | 文本消息内容 |
MsgId | 消息 id,64 位整型 |
图片消息
用户在客服会话中发送图片消息时将产生如下数据包:
XML 格式
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1482048670</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<PicUrl><![CDATA[this is a url]]></PicUrl>
<MsgId>1234567890123456</MsgId>
</xml>
JSON 格式
{
"ToUserName": "toUser",
"FromUserName": "fromUser",
"CreateTime": 1482048670,
"MsgType": "image",
"PicUrl": "this is a url",
"MsgId": 1234567890123456
}
参数说明
参数 | 说明 |
---|---|
ToUserName | 小程序的 appId |
FromUserName | 发送者的 openid |
CreateTime | 消息创建时间(整型) |
MsgType | image |
PicUrl | 图片链接(由系统生成) |
MsgId | 消息 id,64 位整型 |