程序开发--客服消息(接收)
接收消息和事件
在页⾯中使⽤  可以显⽰进⼊客服会话按钮。
当⽤户在客服会话发送消息(或进⾏某些特定的⽤户操作引发的事件推送时),服务器会将消息(或事件)的数据包(JSON或者XML 格式)POST请求开发者填写的URL。开发者收到请求后可以使⽤接⼝进⾏异步回复。
服务器在将⽤户的消息发给⼩程序的开发者服务器地址(开发设置处配置)后,服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次,如果在调试中,发现⽤户⽆法收到响应的消息,可以检查是否消息处理超时。关于重试的消息排重,有msgid的消息推荐使⽤msgid排重。事件类型消息推荐使⽤FromUserName + CreateTime 排重。
服务器收到请求必须做出下述回复,这样服务器才不会对此作任何处理,并且不会发起重试,否则,将出现严重的错误提⽰。详见下⾯说明:
1、直接回复success(推荐⽅式)
2、直接回复空串(指字节长度为0的空字符串,⽽不是结构体中content字段的内容为空)
⼀旦遇到以下情况,都会在⼩程序会话中,向⽤户下发系统提⽰“该⼩程序客服暂时⽆法提供服务,请稍后再试”:
哀怎么读
1、开发者在5秒内未回复任何内容
2、开发者回复了异常数据
幼儿园教师节简单祝福语
各消息类型的推送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",      //⼩程序的原始ID
"FromUserName": "fromUser",   //发送者的openid 
"CreateTime": 1482048670,    //消息创建时间(整型)
"MsgType": "text",        //消息类型
"Content": "this is a test",  //⽂本消息内容
"MsgId": 1234567890123456    //消息id,64位整形
}
图⽚消息
⽤户在客服会话中发送图⽚消息时将产⽣如下数据包:
XML 格式
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
justin bieber 女友<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1482048670</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<PicUrl><![CDATA[this is a url]]></PicUrl>
<MediaId><![CDATA[media_id]]></MediaId>
<MsgId>1234567890123456</MsgId>
</xml>
JSON 格式
{
"ToUserName": "toUser",    //⼩程序的原始ID
"FromUserName": "fromUser",  //发送者的openid
"CreateTime": 1482048670,   //消息创建时间(整型)
"MsgType": "image",      //消息类型
"PicUrl": "this is a url",  //图⽚链接(由系统⽣成)
"MediaId": "media_id",    //图⽚消息媒体id,可以调⽤获取临时素材接⼝拉取数据    "MsgId": 1234567890123456   //消息id,64位整型
}
⼩程序卡⽚消息(已被废弃)
⽤户在客服会话中发送⼩程序卡⽚消息时将产⽣如下数据包:
XML 格式
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1482048670</CreateTime>
<MsgType><![CDATA[miniprogrampage]]></MsgType>
<MsgId>1234567890123456</MsgId>
<Title><![CDATA[Title]]></Title>
<AppId><![CDATA[AppId]]></AppId>
<PagePath><![CDATA[PagePath]]></PagePath>
<ThumbUrl><![CDATA[ThumbUrl]]></ThumbUrl>
<ThumbMediaId><![CDATA[ThumbMediaId]]></ThumbMediaId>
</xml>
JSON 格式
水浒传名字
{
"ToUserName": "toUser",       //⼩程序的原始ID
"FromUserName": "fromUser",    // 发送者的openid
"CreateTime": 1482048670,      // 消息创建时间(整型)
"MsgType": "miniprogrampage",    // 消息类型
"MsgId": 1234567890123456,     // 消息id,64位整型
"Title":"title",          // 标题
"AppId":"appid",          // ⼩程序appid
"PagePath":"path",         // ⼩程序页⾯路径
"ThumbUrl":"",            // 封⾯图⽚的临时cdn链接
"ThumbMediaId":""          // 封⾯图⽚的临时素材id
}
进⼊会话事件(已被废弃)
⽤户在⼩程序“客服会话按钮”进⼊客服会话时将产⽣如下数据包:XML 格式
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1482048670</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[user_enter_tempsession]]></Event>
<SessionFrom><![CDATA[sessionFrom]]></SessionFrom>
</xml>
JSON 格式