百度智能小程序 后台接入消息服务
后台接入消息服务
用户向小程序客服发送消息时，百度服务器将向开发者填写的服务器配置 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 位整型 |