TQ云呼叫中心與第三方系統(tǒng)對接方案(HTX)

1、TQ呼叫中心與第三方CRM對接文檔TQ云呼叫中心第三方系統(tǒng)對接方案版本信息：201504目錄1概述41.1對接目的41.2對接前提42CRM對接42.1統(tǒng)一平臺42.1.1流程42.1.2配置42.1.3效果演示52.2統(tǒng)一登錄52.2.1流程62.2.2參數(shù)說明63彈屏對接73.1流程73.2參數(shù)說明73.3配置83.4效果演示84點(diǎn)擊外呼84.1方案：JS調(diào)用84.2參數(shù)84.3示例81 概述1.1 對接目的為了保持客戶對現(xiàn)有業(yè)務(wù)系統(tǒng)的使用習(xí)慣，為了實(shí)現(xiàn)客戶數(shù)據(jù)保存到自己原有系統(tǒng)，TQ專門做了相應(yīng)接口，來協(xié)助企業(yè)兼容TQ呼叫中心和業(yè)務(wù)系統(tǒng)兩個重要的模塊1.2 對接前提第三方系統(tǒng)必須基于B/

2、S架構(gòu)2 CRM對接2.1 統(tǒng)一平臺登陸TQ客戶端時，用戶可以直接在TQ客戶端操作配置好的第三方CRM系統(tǒng)2.1.1 流程在TQ系統(tǒng)配置好第三方CRM地址，登陸TQ客戶端時，TQ調(diào)用第三方CRM地址，實(shí)現(xiàn)在TQ客戶端打開第三方 CRM系統(tǒng)功能2.1.2 配置登陸TQ系統(tǒng)的“系統(tǒng)管理”，然后進(jìn)入“第三方接口-CRM接口”，把第三方CRM的url填寫到接口設(shè)置處，選擇“啟用”，然后“保存”2.1.3 效果演示登陸客戶端，點(diǎn)擊“客戶管理”，即可訪問第三方系統(tǒng)。以百度為第三方crm為例：2.2 統(tǒng)一登錄登陸TQ客戶端以后，直接登錄第三方CRM系統(tǒng)，不需要再次輸入賬號密碼人工登陸系統(tǒng)2.2.1 流程 統(tǒng)

3、一認(rèn)證機(jī)制說明n 登陸TQ客戶端時，TQ會調(diào)用第三方系統(tǒng)網(wǎng)址，同時會向該地址推送安全認(rèn)證號token參數(shù)n 第三方系統(tǒng)可根據(jù)token值到TQ認(rèn)證地址去認(rèn)證n 驗(yàn)證TQ認(rèn)證地址返回值，如果認(rèn)證成功則說明調(diào)用有效n 擴(kuò)展第三方系統(tǒng)登陸方式，將TQ號碼和第三方系統(tǒng)賬號做對應(yīng)，允許當(dāng)前帳號直接進(jìn)入系統(tǒng)，并顯示相應(yīng)權(quán)限內(nèi)的數(shù)據(jù)，否則予以提示 認(rèn)證地址：n 認(rèn)證地址： n 返回值：1或-1，1：成功，-1失敗注：所有參數(shù)格式都為小寫，具體如以上參數(shù)表所示。2.2.2 參數(shù)說明參數(shù)名說明備注tokenTQ帳號登錄時在TQ認(rèn)證服務(wù)器生成的唯一標(biāo)識登錄30分鐘內(nèi)無任何操作則自動失效退出TQ客戶端時將被注銷ui

4、n當(dāng)前用戶的TQ帳號admin_uin當(dāng)前用戶的TQ管理員帳號3 彈屏對接客戶來電或坐席去電時，TQ客戶自動彈出保存在第三方系統(tǒng)中與呼叫電話號碼相關(guān)的客戶信息（以及其它個性化操作入口）頁面3.1 流程 客戶來電/座席去電，彈屏事件推送至TQ客戶端 TQ客戶端調(diào)用已配置的第三方彈屏地址同時傳入相應(yīng)參數(shù) 第三方系統(tǒng)接收到參數(shù)后進(jìn)行處理，并返回相應(yīng)信息 TQ客戶端實(shí)現(xiàn)調(diào)用第三方彈屏信息功能3.2 參數(shù)說明注：關(guān)鍵參數(shù)為admin_uin（企業(yè)唯一標(biāo)識）、uin（坐席TQ號）、callerid（電話號碼）參數(shù)名說明備注phoneid電話記錄編號admin_uinTQ管理員賬戶7位純數(shù)字uin彈屏座席T

5、Q號8位純數(shù)字userName座席用戶名seatid座席工號called_id座席電話called_id_key自定義安全參數(shù)格式：座席電話-自定義安全碼callerid客戶電話號碼callerid_key自定義安全參數(shù)格式：客戶電話號碼-自定義安全碼phone_place電話歸屬地gbk編碼phone_place_encode電話歸屬地編碼UTF-8編碼dnis呼入中繼號碼token安全認(rèn)證參數(shù)每次退出賬戶自動注銷isencry客戶號碼是否屏蔽后四位mykey自定義安全參數(shù)格式：yyyy-MM-ddHH:mm-安全碼（年月日時分秒-自定義安全參數(shù)） manual_clicked=0是否點(diǎn)擊外

6、呼0：是 1：否roleid角色id0：管理員；-1：自定義角色；1：系統(tǒng)默認(rèn)普通座席；2：系統(tǒng)默認(rèn)經(jīng)理角色；其他：TQ系統(tǒng)角色idmedia_id媒體id呼入媒體來源idqueuename呼入隊(duì)列url編碼rand訪客id如果有值，則一定要存第三方庫，以便對應(yīng)記錄call_style電話類型1：免費(fèi)電話 2：400電話 3：外呼電話 4：直線呼入client_uin可自定義參數(shù)值1現(xiàn)階段只針對免費(fèi)電話client_id可自定義參數(shù)值2現(xiàn)階段只針對免費(fèi)電話visitor_entry初始來源只針對免費(fèi)電話visitor_comes來訪次數(shù)只針對免費(fèi)電話visitor_keyword關(guān)鍵詞只針對免

7、費(fèi)電話visitor_last_page上一個頁面只針對免費(fèi)電話visitor_page當(dāng)前頁面只針對免費(fèi)電話caller_ipIP地址只針對免費(fèi)電話3.3 配置登陸TQ系統(tǒng)的“系統(tǒng)管理”，然后進(jìn)入“第三方接口-CRM接口”，把第三方彈屏頁面的url填寫到接口設(shè)置處，選擇“啟用”，然后“保存”3.4 效果演示以百度為彈屏頁面為例：4 點(diǎn)擊外呼4.1 方案：JS調(diào)用JS代碼： function tq_call_out(phone_num)trywindow.navigate(app:1234567+phone_num+); catch(e);4.2 參數(shù)說明app:1234567：為固定格式，無需改動phone_num：外呼被叫電話號碼4.3 示例示例 function tq_call_out(phone_num)/if(parseInt(phone_num) != & parseInt(phone_num)