<small id="aimcq"></small>
  • # iframe 接入

    客服工作臺、呼叫中心及客戶中心對接業務系統

    # 方案概述

    企業可將自主研發的業務操作頁面以 iframe 的方式嵌入智齒客服工作臺右側、客戶中心客戶詳情頁或呼叫中心通話詳情頁,作為單獨的菜單欄。常見的業務操作頁面例如:提交工單頁、用戶個人資料頁、用戶歷史訂單頁、用戶歷史工單頁。

    圖片

    <集成完畢后客服工作臺的實際效果>

    圖片

    <集成完畢后客戶中心的實際效果>

    圖片

    <集成完畢后呼叫中心的實際效果>

    客服在請求此頁面時,將通過在業務操作頁面的 URL 后追加用戶對接 ID、客服郵箱、安全校驗碼等信息以便企業進行安全驗證、根據用戶身份展示該用戶相關的業務信息。

    當您傳輸敏感信息時,可以使用安全密鑰功能。安全密鑰功能為您提供更高的安全防護等級,該功能對應的 sign 如下表所示

    客服工作臺請求此頁面時,傳入字段包括:

    字段 名稱
    partnerId 對接 ID,咨詢者在第三方系統的 ID,需要企業在集成聊天頁時傳給智齒
    email 當前客服的登陸郵箱
    sign 企業標識和客服 email 的 md5 校驗碼,sign=md5(sysNum+email)
    (開啟安全密鑰后)sign=MD5(sysNum+密鑰+ timestamp +partnerId)若 partnerId 為空,則不用加到 sign 中
    timestamp 時間戳(長整型,毫秒級時間戳)
    createChatTime 時間戳(長整型,毫秒級時間戳)
    uid 咨詢用戶在智齒系統的用戶 ID
    cid 本次咨詢對應會話的會話 ID
    params 自定義資料字段

    注: 當您切換工作臺左側用戶列表時,我們會更新 iframe 的 src 屬性,但 iframe 的 src 屬性更新不會自動刷新嵌入的對接頁面,這時我們會拋出一個 postMessage,您在對接頁面監聽一下即可,postMessage 監聽 name:selected

    呼叫中心-通話記錄-通話詳情頁請求此頁面時,傳入字段包括:

    字段 名稱
    partnerId 對接 ID,第三方系統中的客戶ID,企業需要提前將該ID存儲到智齒客戶中心的客戶檔案里,在通話詳情UI中智齒將該ID傳遞給企業的iframe頁面(用于實現關聯出第三方系統中的更多客戶信息)。
    callId 當前通話的唯一標識
    email 當前客服的登陸郵箱
    sign 企業標識和客服 email 的 md5 校驗碼,sign=md5(sysNum+email)
    (開啟安全密鑰后)sign=MD5(sysNum+密鑰+ timestamp + uphone+uemail)若 uphone 或 uemail 為空,則不用加到 sign 中
    timestamp 時間戳(長整型,毫秒級時間戳)
    uid 若此電話號碼屬于已知用戶,則為該用戶在智齒系統的用戶 ID
    uphone 本次通話的電話號碼
    uemail 若此電話號碼屬于已知用戶,則為該用戶在智齒系統中的第一個郵箱
    ivrPath ivr 軌跡 為一個 json 字符串 navKey 為 ivr 按鍵,navName 為 ivr 按鍵對應的名稱;
    province 號碼歸屬地省份 為 string 字符串
    city 號碼歸屬地城市 為 string 字符串

    呼叫中心-我的任務-任務詳情頁請求此頁面時,傳入字段包括:

    字段 名稱
    email 當前客服的登陸郵箱
    sign 企業標識和客服 email 的 md5 校驗碼,sign=md5(sysNum+email)
    (開啟安全密鑰后)sign=MD5(sysNum+密鑰+ timestamp + uphone+uemail)若 uphone 或 uemail 為空,則不用加到 sign 中
    timestamp 時間戳(長整型,毫秒級時間戳)
    uid 若此電話號碼屬于已知用戶,則為該用戶在智齒系統的用戶 ID
    uphone 本次通話的電話號碼
    uemail 若此電話號碼屬于已知用戶,則為該用戶在智齒系統中的第一個郵箱

    工單中心-工單詳情頁請求此頁面時,傳入字段包括:

    字段 名稱
    email 當前客服的登陸郵箱
    sign 企業標識和客服 email 的 md5 校驗碼,sign=md5(sysNum+email)
    (開啟安全密鑰后)sign=MD5(sysNum+密鑰+ timestamp + uphone+uemail)若 uphone 或 uemail 為空,則不用加到 sign 中
    timestamp 時間戳(長整型,毫秒級時間戳)
    uid 若此電話號碼屬于已知用戶,則為該用戶在智齒系統的用戶 ID
    uphone 客戶的電話號碼
    uemail 客戶在智齒系統中的第一個郵箱
    ticketId 工單 ID

    客戶中心-客戶詳情頁請求此頁面時,傳入字段包括:

    字段 名稱
    partnerId 對接 ID,咨詢者在第三方系統的 ID,需要企業在集成聊天頁時傳給智齒
    email 當前客服的登陸郵箱
    sign 企業標識和客服 email 的 md5 校驗碼,sign=md5(sysNum+email)
    (開啟安全密鑰后)sign=MD5(sysNum+密鑰+ timestamp + uphone+uemail)若 uphone 或 uemail 為空,則不用加到 sign 中
    timestamp 時間戳(長整型,毫秒級時間戳)
    uid 用戶在智齒系統的用戶 ID
    uphone 用戶在智齒系統中的第一個電話號碼
    uemail 用戶在智齒系統中的第一個郵箱

    質檢-質檢詳情頁請求此頁面時,傳入字段包括:

    字段 名稱
    partnerId 對接 ID,咨詢者在第三方系統的 ID,需要企業在集成聊天頁時傳給智齒
    email 當前客服的登陸郵箱
    sign 企業標識和客服 email 的 md5 校驗碼,sign=md5(sysNum+email)
    (開啟安全密鑰后)sign=MD5(sysNum+密鑰+ timestamp + uphone+uemail)若 uphone 或 uemail 為空,則不用加到 sign 中
    timestamp 時間戳(長整型,毫秒級時間戳)
    uid 咨詢用戶在智齒系統的用戶 ID
    cid 本次咨詢對應會話的會話 ID
    uphone 用戶在智齒系統中的第一個電話號碼
    uemail 用戶在智齒系統中的第一個郵箱

    會話監控頁請求此頁面時,傳入字段包括:

    字段 名稱
    partnerId 對接 ID,咨詢者在第三方系統的 ID,需要企業在集成聊天頁時傳給智齒
    email 當前客服的登陸郵箱
    sign 企業標識和客服 email 的 md5 校驗碼,sign=md5(sysNum+email)
    (開啟安全密鑰后)sign=MD5(sysNum+密鑰+ timestamp + uphone+uemail)若 uphone 或 uemail 為空,則不用加到 sign 中
    timestamp 時間戳(長整型,毫秒級時間戳)
    uid 咨詢用戶在智齒系統的用戶 ID
    cid 本次咨詢對應會話的會話 ID
    uphone 用戶在智齒系統中的第一個電話號碼
    uemail 用戶在智齒系統中的第一個郵箱

    # 集成步驟

    第一步,集成客服聊天頁時傳入用戶對接 ID(partnerId) 如果企業開發的業務操作頁面需要和用戶身份關聯,則此步為必選,否則非必選

    第二步,企業根據自己的需要確定業務操作頁面的功能和交互效果,基于智齒的開發要求完成業務操作頁面開發。

    當屏幕寬度為 1280 像素時,頁面規格建議:

    • 人工客服工作臺:建議對接頁面寬度<=300 像素
    • 客戶中心:建議對接頁面寬度<=730 像素,高度<=500 像素
    • 呼叫中心:建議對接頁面寬度<=790 像素,高度<=500 像素
    • 建議企業提供 https 地址,否則如果客服通過 https 訪問智齒客服工作臺時,將無法正常打開對接頁面

    第三步,企業管理員可在智齒客服管理后臺手動配置對接菜單名稱和對接頁面(建議配置 https 地址)配置完畢后客服重新登錄工作臺后即可使用

    圖片

    <管理后臺-設置-對接頁面:添加對接頁面>

    # 接入工單

    # 對接系統內對接頁面

    # 首先添加自定字段或者直接使用默認字段

    pastedGraphic.png

    pastedGraphic_1.png

    # 配置對接到工單中心

    pastedGraphic_2.png

    # 在工單中心點擊對接頁面發送 postMessage 通信創建工單

    注意

    對接頁面參數需要開發人員根據配置好的自定義字段嚴格傳遞,如下圖所示

    {
        "card*title":"云客服*智齒客服",
        "card_url":"http://www.gene-tech.cn",
        "card_desc":"云客服,在線客服系統,云呼叫中心,機器人客服,工單客服,智能客服",
        "card_note":"1500 元",
        "card_picture":"https://img.sobot.com/console/common/face/admin.png"
    }
    

    傳遞的數據格式必須符合 JSON 格式

    發送方式采用 postMessage,例如

    window.parent.postMessage({
        type:”createOrder”,
        params:{
            "card_title":"云客服_智齒客服",
            "card_url":"http://www.gene-tech.cn",
            "card_desc":"云客服,在線客服系統,云呼叫中心,機器人客服,工單客服,智能客服",
            "card_note":"1500元",
            "card_picture":"https://img.sobot.com/console/common/face/admin.png"
        }
    },"*")
    

    type:”createOrder”,固定格式必須傳遞

    params JSON 格式對象,對象中就是自定義字段配置的參數 id

    pastedGraphic_3.png

    實現效果:

    pastedGraphic_4.png

    pastedGraphic_5.png

    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>