支付寶小程序開放組件 智能客服·Contact-button

2020-09-18 11:13 更新

contact-button 智能客服

更新時間:2020-09-07 13:57:58

智能客服能力由螞蟻金服零號云客服提供。

版本要求:基礎(chǔ)庫 1.14.1 或更高版本;支付寶客戶端 10.1.10 或更高版本,若版本較低,建議做 兼容處理

喚起智能客服組件,開通智能客服:進入對應(yīng)小程序管理后臺后,點擊 用戶互動 > 智能客服 > 立即使用 即可打開云客服免費使用。

前提條件

智能客服僅支持企業(yè)用戶。

示例代碼

集成咨詢窗(必選)

<contact-button tnt-inst-id="企業(yè)編碼" scene="聊天窗編碼"/>

在云客服中進入 設(shè)置 > 服務(wù)窗配置 > 聊天窗 URL。點擊操作欄中的 聊天窗 URL ,獲取 tntInstId(企業(yè)編碼)和 scene(聊天窗編碼)。

說明:每個聊天窗編碼都是唯一的。

image

自定義咨詢按鈕(可選)

<contact-button tnt-inst-id="企業(yè)編碼" scene="聊天窗編碼" size="咨詢按鈕大小" color="咨詢按鈕顏色" icon="咨詢按鈕圖片url" />

默認咨詢按鈕如下: image.png

修改后咨詢按鈕如下: image.png

支付寶端內(nèi)消息提醒(可選)

其中 alipay-card-no,ext-info 兩個屬性的說明詳見下方的屬性描述表格。

<contact-button tnt-inst-id="企業(yè)編碼" scene="聊天窗編碼" alipay-card-no="2088用戶ID" ext-info="擴展信息"/>

提醒一:打開支付寶,中間位置顯示提示,點擊即進入對話窗。(按一定的頻率進行消息提醒,默認30分鐘提醒一次)

image.png

提醒二:服務(wù)提醒中顯示客服回復的消息內(nèi)容,點擊即進入對話窗。

image.png

提醒三:朋友 > 小程序 > 我的 顯示未讀的客服消息,點擊即進入對話窗。(用戶離開聊天窗期間客服發(fā)的消息會進行提醒)

image

接入訪客名片

通過 Java SDK 可以將零號云客服訪客名片功能添加至支付寶小程序中。

屬性

屬性 類型 默認值 描述 使用場景 最低版本
tnt-inst-id String - 必填。企業(yè)唯一編碼,一個企業(yè)支付寶賬號對應(yīng)一個編碼。 - -
scene String - 必填。聊天窗編碼,每個聊天窗的唯一編碼。 - -
size Number/String 25 選填。咨詢按鈕大小,正方形設(shè)置邊長(如25*25 px)。 - 1.9.0 , 1.12.0 開始支持 rpx單位
color String #00A3FF 選填。咨詢按鈕顏色,默認白底藍色。 - 1.9.0
icon ImgUrl - 選填。咨詢按鈕頭像。 - 1.9.0
alipay-card-no String - 選填。支付寶訪客用戶ID(2088開頭)。 客服回答問題時,如客戶已離開咨詢窗口,則通過推送消息到支付寶 card 中提醒客戶。 -
ext-info String - 選填。該屬性主要用于傳遞一些擴展信息給組件,以實現(xiàn)一些高級功能。該屬性值的生成方式為:encodeURIComponent({"字段名":"字段值"}), 其中,字段名和字段值要根據(jù)實際使用的功能進行替換。目前通過傳入擴展信息可支持的 3 個功能:1.訪客名片。需傳 cinfo 和 key 兩個擴展字段,代碼形如encodeURIComponent({"cinfo":"生成的 cinfo","key":"生成的key"}),cinfo 和 key 的值說明 支付寶小程序接入訪客名片;2.聊天窗默認帶出用戶的小程序訂單數(shù)據(jù)。需傳 appId 字段,代碼形如encodeURIComponent({"appId":"商戶小程序appid"})3.未讀客服消息同步至"我的小程序-我的"。同樣需傳 appId 字段,代碼形如 encodeURIComponent({"appId":"商戶小程序appid"})。 - -

常見問題

contact-button 組件寫了沒展示,如何查看聊天記錄?

首先檢查基礎(chǔ)版本庫是否匹配,然后在 支付寶 APP > 朋友 > 服務(wù)提醒 中查看消息記錄。

開通云客服沒有加 contact-button 智能客服代碼,為何有的手機上顯示有的不顯示客服圖標?

進入 小程序控制臺 > 設(shè)置 > 客服設(shè)置,選擇是否顯示客服圖標。

如何獲取 tntInstId(企業(yè)編碼)和 scene(聊天窗編碼)?

進入 支付寶開放平臺 > 運營中心 > 用戶服務(wù) > 智能客服 > 立即使用 > 在線客服 > 服務(wù)窗配置。點擊操作欄中的 聊天窗 URL ,獲取 tntInstId(企業(yè)編碼)和 scene(聊天窗編碼)。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號