微信小程序開發--客服消息（接收和發送）

接收消息和事件

在頁面中使用 <button open-type="contact" /> 可以顯示進入客服會話按鈕。

當用戶在客服會話發送消息（或進行某些特定的用戶操作引發的事件推送時），微信服務器會將消息（或事件）的數據包（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> <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[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 格式

{
    "ToUserName": "toUser",　　　　　　//小程序的原始ID "FromUserName": "fromUser",　　　　//發送者的openid "CreateTime": 1482048670,　　　　　//事件創建時間(整型） "MsgType": "event",　　　　　　　　//消息類型 "Event": "user_enter_tempsession", //事件類型，user_enter_tempsession "SessionFrom": "sessionFrom"　　　 //開發者在客服會話按鈕設置的session-from屬性 }

發送客服消息

http請求方式：POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
各種消息的數據包JSON如下：
發送文本消息：
{
　　"access_token":"ACCESS_TIKEN", //接口調用憑證
　　"tourse":"OPENID",　　　　　　　　//發送者的openid,即接收到的FromUserName
　　"msgtype":"text",　　　　　　　　 //消息類型
　　"text":{
　　　　"content":"content"　　　　　 //文本內容
　　}
}

發送圖片消息：
{
　　"access_token":"ACCESS_TIKEN",    //接口調用憑證
　　"tourse":"OPENID",　　　　　　　　//發送者的openid,即接收到的FromUserName
　　"msgtype":"image",　　　　　　　　 //消息類型
　　"image":{
　　　　"media_id":"media_id"　　　　　 //文本內容
　　}
}

發送圖文連接：
{
　　"access_token":"ACCESS_TIKEN",    //接口調用憑證
　　"tourse":"OPENID",　　　　　　　　//發送者的openid,即接收到的FromUserName
　　"msgtype":"link",　　　　　　　　 //消息類型
　　"link":{
　　　　"title":"title",　　　　　 //消息標題
　　　　"description":"description",　　　　//圖文鏈接消息
　　　　"url":"url",　　　　　　　//圖文鏈接被點擊后跳轉的鏈接
　　　　"thumb_url":"thumb_url" //封面圖片的臨時cdn鏈接
　　}
}

發送小程序卡片：
{
　　"access_token":"ACCESS_TIKEN",    //接口調用憑證
　　"tourse":"OPENID",　　　　　　　　//發送者的openid,即接收到的FromUserName
　　"msgtype":"miniprogrampage",　　　　　　　　 //消息類型
　　"link":{
　　　　"title":"title",　　　　　 //消息標題
　　　　"pagepath":"pagepath",　　　　//小程序的頁面路徑，要與app.json一致，比如："pages/index/index"
　　　　"thumb_media_id":"thumb_media_id" //小程序消息卡片的封面
　　}
}