contact-button

微信小程序組件，客服會話按鈕，用于在頁面上顯示一個客服會話按鈕，用戶點擊該按鈕后會進入客服會話。

示例代碼

相關api：詳見客服消息接口文檔

接收消息和事件

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

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

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

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

1、直接回復success(推薦方式)

2、直接回復空串(指字節長度為0的空字符串，而不是結構體中content字段的內容為空)

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

1、開發者在5秒內未回復任何內容

2、開發者回復了異常數據

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

各消息類型的推送JSON、XML數據包結構如下。

文本消息

用戶在客服會話中發送文本消息時將產生如下數據包：

XML 格式

JSON 格式

參數說明

圖片消息

用戶在客服會話中發送圖片消息時將產生如下數據包：

XML 格式

JSON 格式

參數說明

進入會話事件

用戶在小程序“客服會話按鈕”進入客服會話時將產生如下數據包：

XML 格式

JSON 格式

參數說明

以上就是“(客服會話按鈕)微信小程序組件 contact-button”內容了，更多精彩內容，請點擊【必看】微信小程序 基礎知識全解了解更多。