微信小程序API接收消息和事件,頁面中使用<contact-button/>可以顯示進入客服會話按鈕

接收消息和事件

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

當(dāng)用戶在客服會話發(fā)送消息（或進行某些特定的用戶操作引發(fā)的事件推送時），微信服務(wù)器會將消息（或事件）的數(shù)據(jù)包（JSON或者XML格式）POST請求開發(fā)者填寫的URL。開發(fā)者收到請求后可以使用發(fā)送客服消息接口進行異步回復(fù)。

微信服務(wù)器在將用戶的消息發(fā)給小程序的開發(fā)者服務(wù)器地址（開發(fā)設(shè)置處配置）后，微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會斷掉連接，并且重新發(fā)起請求，總共重試三次，如果在調(diào)試中，發(fā)現(xiàn)用戶無法收到響應(yīng)的消息，可以檢查是否消息處理超時。關(guān)于重試的消息排重，有msgid的消息推薦使用msgid排重。事件類型消息推薦使用FromUserName + CreateTime 排重。

服務(wù)器收到請求必須做出下述回復(fù)，這樣微信服務(wù)器才不會對此作任何處理，并且不會發(fā)起重試，否則，將出現(xiàn)嚴重的錯誤提示。詳見下面說明：

1、直接回復(fù)success（推薦方式）
2、直接回復(fù)空串（指字節(jié)長度為0的空字符串，而不是結(jié)構(gòu)體中content字段的內(nèi)容為空）

一旦遇到以下情況，微信都會在小程序會話中，向用戶下發(fā)系統(tǒng)提示“該小程序客服暫時無法提供服務(wù)，請稍后再試”：

1、開發(fā)者在5秒內(nèi)未回復(fù)任何內(nèi)容
2、開發(fā)者回復(fù)了異常數(shù)據(jù)

如果開發(fā)者希望增強安全性，可以在開發(fā)者中心處開啟消息加密，這樣，用戶發(fā)給小程序的消息以及小程序被動回復(fù)用戶消息都會繼續(xù)加密，詳見消息加解密說明。

各消息類型的推送JSON、XML數(shù)據(jù)包結(jié)構(gòu)如下。

文本消息

用戶在客服會話中發(fā)送文本消息時將產(chǎn)生如下數(shù)據(jù)包：

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
}

參數(shù)說明

圖片消息

用戶在客服會話中發(fā)送圖片消息時將產(chǎn)生如下數(shù)據(jù)包：

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",
    "FromUserName": "fromUser",
    "CreateTime": 1482048670,
    "MsgType": "image",
    "PicUrl": "this is a url",
    "MediaId": "media_id",
    "MsgId": 1234567890123456
}

參數(shù)說明

進入會話事件

用戶在小程序“客服會話按鈕”進入客服會話時將產(chǎn)生如下數(shù)據(jù)包：

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",
    "FromUserName": "fromUser",
    "CreateTime": 1482048670,
    "MsgType": "event",
    "Event": "user_enter_tempsession",
    "SessionFrom": "sessionFrom"
}

參數(shù)說明