一本到中文字幕高清不卡在线,亚洲国产精品尤物yw在线观看,欧美日本在线,亚韩无码一区二区在线视频,精品72久久久久久久中文字幕,国产一区二区三区久久

歡迎來到海淘科技官網 官方微信 官方微博 平面活動官網
微信

網絡傳播媒介服務提供商

熱線電話

021-62677988

海淘新聞
首頁 > 新聞列表 > 【0.11.1221版本新增功能】微信小程序客服消息使用指南

【0.11.1221版本新增功能】微信小程序客服消息使用指南

發布時間: 2017-01-07 13:56

為豐富小程序的服務能力,提高服務質量,微信為小程序提供客服消息能力,以便小程序用戶可以方便快捷地與小程序服務提供方進行溝通。

功能介紹

用戶可使用小程序客服消息功能,與小程序的客服人員進行溝通。

客服消息會話入口有兩個:

1、小程序內:開發者在小程序內添加客服消息按鈕組件,用戶可在小程序內喚起客服會話頁面,給小程序發消息;

2、已使用過的小程序客服消息會聚合顯示在微信會話“小程序客服消息”內,用戶可以在小程序外查看歷史客服消息,并給小程序客服發消息。

客服消息下發條件:小程序用戶在小程序內喚起客服會話或用戶給小程序客服發送消息,具體下發時間有效期及消息條數限制見客服消息下發條件說明

客服消息類型:目前支持文本及圖片類型消息

為盡量滿足小程序開發者的需求,小程序可通過以下兩種方式下發客服消息:1、調用發送客服消息接口;2、使用公眾平臺網頁版客服工具

下發條件說明

當用戶和小程序客服產生特定動作的交互時(具體動作列表請見下方說明),小程序可向用戶下發客服消息。

目前允許的動作列表如下,不同動作觸發后,允許下發消息條數和下發時限不同。下發條數達到上限后,會返回錯誤碼。

可發送客服消息條數不累加,上述用戶動作會觸發可下發條數及可下發時限的更新,可下發消息條數更新為當前可下發條數限制的最大值,有效下發時間限制也更新為最長有效時間。

調用客服消息接口發送客服消息

當用戶在小程序內打開客服會話,或是給小程序客服發消息,微信服務器會將消息(或事件)的數據包(JSON或者XML格式)POST到開發者填寫的URL。開發者收到請求后可以調用接口進行異步回復。

填寫消息推送配置

登錄小程序,在“設置-開發設置-消息推送”啟用消息推送功能并完成相關信息配置(包括服務器地址、Token、及加密方式等)。

啟用并設置服務器配置后,用戶發送的消息以及開發者需要的事件推送,都將被微信轉發至開發者URL中。

接口調用

小程序客服消息API文檔

網頁版客服工具

小程序也可以直接使用微信公眾平臺網頁版客服工具進行客服消息回復。

若小程序沒有啟用消息推送,則用戶發送的消息將會被轉發至網頁版客服工具,客服人員可在網頁版客服工具中接入并回復用戶。

注意:“用戶通過客服消息按鈕進入會話”事件將不會轉發至網頁版客服工具。

綁定客服人員

使用網頁版客服工具前,小程序管理員需在小程序后臺完成客服人員的綁定。目前小程序支持綁定不多于100個客服人員。

客服工具使用說明

登錄并接入

已被綁定的小程序客服人員可掃碼登錄微信公眾平臺網頁版客服工具,并選擇對應的小程序帳號,登錄后即可看到與小程序對話的用戶,可選擇接入對話。

切換客服狀態

點擊在線狀態,可以選擇在線狀態、離開狀態或退出登錄

接收消息

手動接入:客服人員上線后,點擊“待接入”,即可在“待接入”列表中,手動接入待回復的對話

自動接入:當待接入的對話太多時,可以在設置/接入設置中,開啟自動接入

重新接入:退出登錄,或對話超過半小時,需要重新接入,激活對話

發送消息

已經接入的會話,客服人員可以在48小時內和用戶進行對話,目前支持發送文本、圖片類型的消息。

使用規范

小程序客服消息使用除必須遵守微信小程序平臺運營規范外,還不能違反以下規則,包括但不限于:

不允許惡意誘導用戶進行可能觸發客服消息下發的操作,以達到可向用戶下發客服消息目的

不允許惡意騷擾,下發與用戶發送的消息沒有關聯的、對用戶造成騷擾的消息

不允許惡意營銷,下發內容涉嫌虛假夸大、違法類營銷信息

不允許使用客服消息向用戶下發虛假、色情、暴力等違反國家法律規定的信息

客服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 格式

參數說明

轉發消息到客服工具

如果開發者希望消息被轉發到客服工具處理,請按照下述結構返回響應包。響應包的數據格式(XML或JSON)需要與設置的接收消息數據格式一致。

XML 格式

JSON 格式

參數說明

新增組件:

contact-button

客服會話按鈕,用于在頁面上顯示一個客服會話按鈕,用戶點擊該按鈕后會進入客服會話。

示例代碼

發送客服消息

當用戶和小程序客服產生特定動作的交互時(具體動作列表請見下方說明),微信將會把消息數據推送給開發者,開發者可以在一段時間內(目前修改為48小時)調用客服接口,通過POST一個JSON數據包來發送消息給普通用戶。此接口主要用于客服等有人工消息處理環節的功能,方便開發者為用戶提供更加優質的服務。

目前允許的動作列表如下,不同動作觸發后,允許的客服接口下發消息條數和下發時限不同。下發條數達到上限后,會收到錯誤返回碼,具體請見返回碼說明頁:

客服接口-發消息

接口調用請求說明

各消息類型所需的JSON數據包如下:

發送文本消息

發送圖片消息

參數說明

返回碼說明

臨時素材接口

獲取臨時素材

小程序可以使用本接口獲取客服消息內的臨時素材(即下載臨時的多媒體文件)。目前小程序僅支持下載圖片文件。

接口調用請求說明

HTTP 請求方式: GET,HTTPS 調用

請求示例(示例為通過curl命令獲取多媒體文件)

參數說明

返回說明

正確情況下的返回 HTTP 頭如下:

如果返回的是視頻消息素材,則內容如下:

錯誤情況下的返回JSON數據包示例如下(示例為無效媒體ID錯誤):

新增臨時素材

小程序可以使用本接口把媒體文件(目前僅支持圖片)上傳到微信服務器,用戶發送客服消息或被動回復用戶消息。

接口調用請求說明

HTTP 請求方式:POST/FORM,HTTPS 調用

調用示例(使用curl命令,用FORM表單方式上傳一個多媒體文件):

參數說明

返回說明

正確情況下的返回 JSON 數據包結果如下:

錯誤情況下的返回JSON數據包示例如下(示例為無效媒體類型錯誤):

相關文章:

版權所有 @ 2007-2023上海海淘信息科技有限公司 滬ICP備11050025號-4