微信小程序調(diào)用客服消息接口發(fā)送客服消息

來(lái)源：微信小程序 發(fā)布時(shí)間：2017-11-08瀏覽：3785次

微信小程序調(diào)用客服消息接口發(fā)送客服消息

為豐富小程序的服務(wù)能力，提高服務(wù)質(zhì)量，微信為小程序提供客服消息能力，以便小程序用戶(hù)可以方便快捷地與小程序服務(wù)提供方進(jìn)行溝通。

功能介紹

用戶(hù)可使用小程序客服消息功能，與小程序的客服人員進(jìn)行溝通。

客服消息會(huì)話(huà)入口有兩個(gè)：

1、小程序內(nèi)：開(kāi)發(fā)者在小程序內(nèi)添加客服消息按鈕組件，用戶(hù)可在小程序內(nèi)喚起客服會(huì)話(huà)頁(yè)面，給小程序發(fā)消息；

2、已使用過(guò)的小程序客服消息會(huì)聚合顯示在微信會(huì)話(huà)“小程序客服消息”內(nèi)，用戶(hù)可以在小程序外查看歷史客服消息，并給小程序客服發(fā)消息。

客服消息下發(fā)條件：小程序用戶(hù)在小程序內(nèi)喚起客服會(huì)話(huà)或用戶(hù)給小程序客服發(fā)送消息，具體下發(fā)時(shí)間有效期及消息條數(shù)限制見(jiàn)客服消息下發(fā)條件說(shuō)明

客服消息類(lèi)型：目前支持文本及圖片類(lèi)型消息

為盡量滿(mǎn)足小程序開(kāi)發(fā)者的需求，小程序可通過(guò)以下兩種方式下發(fā)客服消息：1、調(diào)用發(fā)送客服消息接口；2、使用公眾平臺(tái)網(wǎng)頁(yè)版客服工具

下發(fā)條件說(shuō)明

當(dāng)用戶(hù)和小程序客服產(chǎn)生特定動(dòng)作的交互時(shí)（具體動(dòng)作列表請(qǐng)見(jiàn)下方說(shuō)明），小程序可向用戶(hù)下發(fā)客服消息。

目前允許的動(dòng)作列表如下，不同動(dòng)作觸發(fā)后，允許下發(fā)消息條數(shù)和下發(fā)時(shí)限不同。下發(fā)條數(shù)達(dá)到上限后，會(huì)返回錯(cuò)誤碼。

可發(fā)送客服消息條數(shù)不累加，上述用戶(hù)動(dòng)作會(huì)觸發(fā)可下發(fā)條數(shù)及可下發(fā)時(shí)限的更新，可下發(fā)消息條數(shù)更新為當(dāng)前可下發(fā)條數(shù)限制的最大值，有效下發(fā)時(shí)間限制也更新為最長(zhǎng)有效時(shí)間。

調(diào)用客服消息接口發(fā)送客服消息

當(dāng)用戶(hù)在小程序內(nèi)打開(kāi)客服會(huì)話(huà)，或是給小程序客服發(fā)消息，微信服務(wù)器會(huì)將消息（或事件）的數(shù)據(jù)包（JSON或者XML格式）POST到開(kāi)發(fā)者填寫(xiě)的URL。開(kāi)發(fā)者收到請(qǐng)求后可以調(diào)用接口進(jìn)行異步回復(fù)。

如小程序的客服消息權(quán)限集已授權(quán)給第三方平臺(tái)，則所有的客服消息將推送到第三方平臺(tái)的服務(wù)器，不再推送到開(kāi)發(fā)者的服務(wù)器或推送到網(wǎng)頁(yè)版客服工具

填寫(xiě)消息推送配置

登錄小程序，在“設(shè)置-開(kāi)發(fā)設(shè)置-消息推送”啟用消息推送功能并完成相關(guān)信息配置（包括服務(wù)器地址、Token、及加密方式等）。

啟用并設(shè)置服務(wù)器配置后，用戶(hù)發(fā)送的消息以及開(kāi)發(fā)者需要的事件推送，都將被微信轉(zhuǎn)發(fā)至開(kāi)發(fā)者URL中。

接口調(diào)用

小程序客服消息API文檔

網(wǎng)頁(yè)版客服工具

小程序也可以直接使用微信公眾平臺(tái)網(wǎng)頁(yè)版客服工具進(jìn)行客服消息回復(fù)。

若小程序沒(méi)有啟用消息推送，則用戶(hù)發(fā)送的消息將會(huì)被轉(zhuǎn)發(fā)至網(wǎng)頁(yè)版客服工具，客服人員可在網(wǎng)頁(yè)版客服工具中接入并回復(fù)用戶(hù)。

如小程序的客服消息權(quán)限集已授權(quán)給第三方平臺(tái)，則所有的客服消息將推送到第三方平臺(tái)的服務(wù)器，不再推送到開(kāi)發(fā)者的服務(wù)器或推送到網(wǎng)頁(yè)版客服工具。

注意：“用戶(hù)通過(guò)客服消息按鈕進(jìn)入會(huì)話(huà)”事件將不會(huì)轉(zhuǎn)發(fā)至網(wǎng)頁(yè)版客服工具。

綁定客服人員

使用網(wǎng)頁(yè)版客服工具前，小程序管理員需在小程序后臺(tái)完成客服人員的綁定。目前小程序支持綁定不多于100個(gè)客服人員。

客服工具使用說(shuō)明

登錄并接入

已被綁定的小程序客服人員可掃碼登錄微信公眾平臺(tái)網(wǎng)頁(yè)版客服工具，并選擇對(duì)應(yīng)的小程序帳號(hào)，登錄后即可看到與小程序?qū)υ?huà)的用戶(hù)，可選擇接入對(duì)話(huà)。

切換客服狀態(tài)

點(diǎn)擊在線(xiàn)狀態(tài)，可以選擇在線(xiàn)狀態(tài)、離開(kāi)狀態(tài)或退出登錄

接收消息

手動(dòng)接入：客服人員上線(xiàn)后，點(diǎn)擊“待接入”，即可在“待接入”列表中，手動(dòng)接入待回復(fù)的對(duì)話(huà)

自動(dòng)接入：當(dāng)待接入的對(duì)話(huà)太多時(shí)，可以在設(shè)置/接入設(shè)置中，開(kāi)啟自動(dòng)接入

重新接入：退出登錄，或?qū)υ?huà)超過(guò)半小時(shí)，需要重新接入，激活對(duì)話(huà)

發(fā)送消息

已經(jīng)接入的會(huì)話(huà)，客服人員可以在48小時(shí)內(nèi)和用戶(hù)進(jìn)行對(duì)話(huà)，目前支持發(fā)送文本、圖片類(lèi)型的消息。

使用規(guī)范

小程序客服消息使用除必須遵守微信小程序平臺(tái)運(yùn)營(yíng)規(guī)范外，還不能違反以下規(guī)則，包括但不限于：

1. 不允許惡意誘導(dǎo)用戶(hù)進(jìn)行可能觸發(fā)客服消息下發(fā)的操作，以達(dá)到可向用戶(hù)下發(fā)客服消息目的

2. 不允許惡意騷擾，下發(fā)與用戶(hù)發(fā)送的消息沒(méi)有關(guān)聯(lián)的、對(duì)用戶(hù)造成騷擾的消息

3. 不允許惡意營(yíng)銷(xiāo)，下發(fā)內(nèi)容涉嫌虛假夸大、違法類(lèi)營(yíng)銷(xiāo)信息

4. 不允許使用客服消息向用戶(hù)下發(fā)虛假、色情、暴力等違反國(guó)家法律規(guī)定的信息