后台接入消息服务

用户向小程序客服发送消息时,百度服务器将向开发者填写的服务器配置 URL推送消息,开发者可以依据自身业务逻辑进行响应。百度服务器在将用户的消息发给开发者服务器地址后,百度服务器在2秒内收不到响应会断掉连接。

关于重试的消息排重,有 msgid 的消息推荐使用 msgid 排重。事件类型消息推荐使用 FromUserName + CreateTime 排重。

服务器收到请求必须做出下述回复。详见下面说明:

  1. 直接回复success(推荐方式)
  2. 直接回复空串

接收消息

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

文本消息

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

XML 格式
  1. <xml>
  2. <ToUserName><![CDATA[toUser]]></ToUserName>
  3. <FromUserName><![CDATA[fromUser]]></FromUserName>
  4. <CreateTime>1482048670</CreateTime>
  5. <MsgType><![CDATA[text]]></MsgType>
  6. <Content><![CDATA[this is a test]]></Content>
  7. <MsgId>1234567890123456</MsgId>
  8. </xml>

JSON 格式

  1. {
  2. "ToUserName": "toUser",
  3. "FromUserName": "fromUser",
  4. "CreateTime": 1482048670,
  5. "MsgType": "text",
  6. "Content": "this is a test",
  7. "MsgId": 1234567890123456
  8. }
参数说明
参数说明
ToUserName小程序的appId
FromUserName发送者的openid
CreateTime消息创建时间(整型)
MsgTypetext
Content文本消息内容
MsgId消息id,64位整型

图片消息

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

XML 格式
  1. <xml>
  2. <ToUserName><![CDATA[toUser]]></ToUserName>
  3. <FromUserName><![CDATA[fromUser]]></FromUserName>
  4. <CreateTime>1482048670</CreateTime>
  5. <MsgType><![CDATA[image]]></MsgType>
  6. <PicUrl><![CDATA[this is a url]]></PicUrl>
  7. <MsgId>1234567890123456</MsgId>
  8. </xml>
JSON 格式
  1. {
  2. "ToUserName": "toUser",
  3. "FromUserName": "fromUser",
  4. "CreateTime": 1482048670,
  5. "MsgType": "image",
  6. "PicUrl": "this is a url",
  7. "MsgId": 1234567890123456
  8. }
参数说明
参数说明
ToUserName小程序的appId
FromUserName发送者的openid
CreateTime消息创建时间(整型)
MsgTypeimage
PicUrl图片链接(由系统生成)
MsgId消息id,64位整型