ServiceNow

Contact Center AI 平台 (CCAI Platform) 可與 ServiceNow CRM 整合。

ServiceNow 開發人員設定

建議的 ServiceNow 最低版本需求:Tokyo patch 1

設定基本驗證使用者

ServiceNow 管理員帳戶可能已啟用兩步驟驗證,並與該使用者建立關聯。因此無法用於取得 CCAI 平台的管理員存取權。您必須在 ServiceNow 中建立使用者帳戶,才能執行這項操作。

建立具有憑證的基本使用者:

  1. 依序前往「User」>「New」。

  2. 填寫詳細資料,然後選取「Web service access only」(僅限存取 Web 服務)。

  3. 記下使用者 ID 和密碼。

ServiceNow 中的必要角色

ServiceNow 的預設角色已預先設定,可在平台內提供特定存取權和權限。管理員可以建立及設定角色,授予特定權限,控管具備該角色的使用者和群組可執行的操作。

如要執行這項整合,您必須在 ServiceNow 中具備下列角色:

  • user_admin:這個角色適用於需要在 ServiceNow 執行個體中管理使用者、群組、位置和公司的管理員。

  • sn_incident_read:這個角色提供事件管理應用程式及其相關功能的唯讀存取權。可讓使用者查看事件記錄。

  • sn_incident_write:這個角色授予事件管理應用程式及其相關函式的寫入權限,允許使用者建立及修改事件記錄。

  • personalize_dictionary:這個角色可自訂字典項目和標籤,滿足特定業務需求。

  • function_field_admin:這個角色適用於需要在報表設計工具中建立、編輯和查看函式欄位的使用者。無法從平台清單或表單建立或刪除函式欄位。

設定執行個體檢視畫面

以下各節將概略說明執行個體檢視畫面所需的設定變更。

(選用) 新增常用聯絡人

「我的最愛」可讓您快速找到 ServiceNow 執行個體中最常用的連結。如要新增常用項目,請選取「Navigator」面板中欄位旁的星號圖示。如果之後想篩選導覽器面板,只查看我的最愛,可以選取導覽器面板中「Filter navigator」(篩選導覽器) 欄位正下方的星號圖示。

實用的常用指令範例:

  • 事件:與自訂 CRM 記錄的關聯。

  • 使用者:自訂 CRM 帳戶的關聯。

  • REST API Explorer:測試 API 的好方法。

手動新增自訂欄位

在要變更的物件檢視畫面中,選取左上角的展開圖示 (3 條橫線)。您可以在自助服務檢視畫面或預設檢視畫面中執行這項操作。

  1. 在選單中依序選取「Configure」>「Form Design」,開啟表單設計工具。

  2. 在左欄中,選取「Field Types」分頁標籤。

  3. 拖曳要新增的自訂欄位類型。

  4. 將欄位類型拖曳到所需區段後,選取齒輪圖示即可查看「Settings」(設定)。

  5. 在視窗中變更標籤,並記下名稱。這個名稱會用於 CCAI Platform 應用程式設定。

  6. 選取畫面右上角的「儲存」。

將工作階段資料對應至客戶關係管理系統

您必須使用 Dialogflow 對應 CCAIP 的適當工作階段資料,並使用下列參數:

虛擬服務專員資料

{
  "ujet": {
    "session_variable": {
      "capture_target": "payload",
      "payload": {
        "value_one": "$session.params.payload_value_one"
      };
      "capture_type": [ "comment", "field" ] // optional, default of ["comment"]
    }
  }
}

中繼資料

https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dsys_user https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dincident

標籤:column_label

API 金鑰:element

在 sys_user 或 incident 的回應中,自訂欄位與標準欄位位於同一層級。

將檔案從 CCAI 平台上傳至 CRM

https://INSTANCE_URL.service-now.com/api/now/attachment/upload

方法:POST

要求資料格式:property

回應資料位置:data.result

類型:Multi-part form

附件類型:Attachment Url

附件網址:download_link

參數:table below

要求示例:

{
    file: FILE_DATA,
    table_name: incident,
    table_sys_id: RECORD_ID
}

整合代理轉接程式 (自訂表單)

下列步驟將逐步說明如何在 ServiceNow 執行個體中啟用代理轉接器和點擊撥號功能。

安裝及設定 OpenFrame

  1. 依序前往「All」(全部) >「System Applications」(系統應用程式) >「All Available Applications」(所有可用的應用程式) >「All」(全部)。

  2. 搜尋 OpenFrame。

  3. 安裝 OpenFrame。

  4. 安裝完成後,依序前往「All」>「OpenFrame」>「Configurations」。

  5. 使用網址建立設定。如果 ServiceNow 執行個體中有多項設定,使用者可能無法存取新建立的設定。請檢查群組和 OpenFrame 設定順序清單,判斷使用者採用的設定。

  6. 在搜尋列中輸入 sys_properties.list。

  7. 編輯 glide.ui.concourse.onmessage_enforce_same_origin_whitelist。

  8. 將新網址新增至值清單。

  9. 編輯 sn_openframe.cross.origin.access。

  10. 將 autoplay 新增至值清單。

為使用者啟用新版 UI 體驗

  1. 在導覽列中輸入 sys_properties.list,然後按下 Enter 鍵。

  2. 將系統屬性 glide.ui.polaris.experience 設為 true。

  3. 將系統的使用者偏好設定 glide.ui.polaris.use 設為 false。

  4. 將使用者的偏好設定 glide.ui.polaris.use 設為 true。(您可以建立使用者偏好設定列)。

更新系統屬性

  1. 在導覽列中輸入 sys_properties.list,然後按下 Enter 鍵。

  2. 編輯 glide.ui.concourse.onmessage_enforce_same_origin_whitelist。

  3. 將網址新增至值清單。多個值之間須以半形逗號分隔。

  4. 編輯 sn_openframe.cross.origin.access。

  5. 將 autoplay 新增至值清單。

  6. 編輯 glide.ui.polaris.experience。

  7. 請變更為 false,因為啟用後部分功能會無法運作。

在表單頂端加入「點選撥號」

  1. 依序前往「System UI」(系統 UI) >「UI Actions」(UI 動作)。

  2. 選取「建立新動作」。

  3. 在如圖所示的表單中,選取要加入這個點擊撥號功能的表格。

  4. 如果表單參照聯絡人或使用者,請使用 g_form.getReference API 存取使用者的電話號碼。如果是自訂表格,參考 ID 和產生的屬性可能會有所不同。與 CCAI 平台的通訊方式相同,因此酬載和資料結構必須與下列內容相同:

    function clickToDial() {
      var user = g_form.getReference('caller_id',function(res) {
        var phone = res.phone || res.mobile_phone;
        var payload = {"name": "clicktodial", "number": phone};
        var data = {"payload": payload, "method": "openframe_communication" };
        CustomEvent.fireAll("openframe_request", data);
      });
    }
    
  5. 如果表單內有要撥打的號碼,請使用 g_form.getValue API 擷取相關值。以下是「使用者」資料表的 UI 動作範例。如果是自訂表格,表單欄位名稱可能不同。與 CCAI Platform 的通訊方式相同,因此酬載和資料結構必須與下列內容相同:

    function clickToDial() {
      var phone = g_form.getValue('phone') || g_form.getValue('mobile_phone');
      var payload = {"name": "clicktodial", "number": phone};
      var context = {"payload": payload, "method" : "openframe_communication" };
      CustomEvent.fireAll("openframe_request", context);
    }
    

在參考資料旁新增點擊撥號功能

  1. 聯絡人參照旁的通話按鈕必須在表單中編輯。在欄位上按一下滑鼠右鍵,然後前往「Configure Dictionary」。如果是屬性,請在 ref_contributions 值中加入 show_phone 或 show_phone_customer_service 值。

  2. 在 UI 巨集中,編輯 show_phone 和 show_phone_customer_service。

  3. 更改下列內容:

上一頁:

var task =    {"entity": p.attr('data-task-table'), "query" :"sys_id="+p.attr('data-task-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-task-value'),"label":p.attr('data-task-label')};
                                        var company = {"entity": p.attr('data-company-table'),"query":"sys_id="+p.attr('data-company-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-company-value'),"label":p.attr('data-company-label')};
                                        var caller = {"entity": p.attr('data-caller-table'),"query": "sys_id="+p.attr('data-caller-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-caller-value'),"label":p.attr('data-caller-label')};

                                        var callContext = [];
                                        callContext.push(task);
                                        callContext.push(company);
                                        callContext.push(caller);

                                        var metaData = {"phoneNumber":p.attr('data-caller-phone'),"taskId":p.attr('data-task-id')};

                                        var data =    {"metaData":metaData , "data": callContext};
                                        var payload = {"type": "OUTGOING_CALL", "data" : data};
                                        var createInteractionData ={};
                                        createInteractionData.interactionSysId = -1;
                                        createInteractionData.direction = 'outbound';
                                        createInteractionData.context_document = p.attr('data-task-id');
                                        createInteractionData.context_table = p.attr('data-task-table');
                                        createInteractionData.account = p.attr('data-company-id');
                                        if(p.attr('data-caller-table') === 'customer_contact')
                                                createInteractionData.contact = p.attr('data-caller-id');
                                        createInteractionData.opened_for = p.attr('data-caller-id');

                                        var ga = new GlideAjax('sn_openframe.OpenFrameAjaxUtility');
                                        ga.addParam('sysparm_name', 'createInteractionWithPropertyCheck');
                                        ga.addParam('context', JSON.stringify(createInteractionData));
                                        ga.getXML(function(serverResponse) {
                                                var result = serverResponse.responseXML.getElementsByTagName("result");
                                                var output = JSON.parse(result[0].getAttribute("data"));
                                                if(output.status == "success"){
                                                        var interaction = {"entity": "interaction", "query" :"sys_id="+output.fields.interactionSysId, "value":output.fields.number, "label":"Interaction", "display":false};
                                                        payload.data.data.push(interaction);
                                                }
                                                var context = {"payload": payload, "method" : "openframe_communication" };
                                                jslog("context with interaction : "+ JSON.stringify(context));
                                                CustomEvent.fireAll("openframe_request", context);
                                        });

新功能:

var phone = p.attr('data-caller-phone')
                   var payload = {"name": "clicktodial", "number": phone};
                   var data = {"payload": payload, "method": "openframe_communication" };
                   CustomEvent.fireAll("openframe_request", data);

CRM 設定

下列步驟說明如何使用 CCAI Platform 入口網站,將 API 連結至 ServiceNow。

  1. 在 CCAI Platform 入口網站中,依序前往「Settings」>「Developer Settings」>「CRM」。

  2. 在「Agent Platform」部分,選取「ServiceNow」ServiceNow。

  3. 在「ServiceNow Domain」欄位中,輸入 ServiceNow 網域資訊。這可能是開發人員執行個體或供應商執行個體 (視需要而定),但與執行個體直接相關,且是 ServiceNow 入口網站網址的第一部分:https://{your instance}.servicenow.com。

  4. 在「ServiceNow Cloud Selection」欄位中,選取「Incident」做為基本票證類型。如果選取「Custom」,系統會顯示其他選項。事件是工作資料表的擴充功能;自訂物件應為事件的擴充功能。

  5. 在「Authentication Credentials」(驗證憑證) 欄位中,輸入使用者名稱和密碼。

  6. 如果您在雲端選取欄位類型中選取「Incident」,會看到下列欄位:

    • 「Lookup account object」包含三個下拉式選單欄位:Object Type、Phone Number lookup fields 和 Phone number primary field。
  7. 如果您在雲端選取欄位類型中選取「Custom」,會看到下列欄位:

    • 查詢記錄物件:

      • Base record object type (基本記錄物件類型):選取 task 或 incident 資料表類型。

      • 記錄物件類型:如果事件表格已擴充,這個欄位會填入資料,您可以視需要選取。

      • 「Lookup account object」包含三個下拉式選單欄位:Object Type、Phone Number lookup fields 和 Phone number primary field。

  8. 自訂使用者 ID 欄位:如要為 Mobile 或 Web SDK,或 Apps API (Chat) 工作階段啟用自訂使用者查詢欄位,請勾選這個方塊。

  9. 電話號碼格式:可選取電話號碼的顯示格式。

  10. 工作階段中繼資料檔案:勾選這個方塊,即可將工作階段中繼資料附加至 CRM 記錄。

  11. 按一下「儲存」即可儲存所選項目。

記錄的自訂欄位

這些是已在表單設計工具中為 ServiceNow 執行個體建立的自訂欄位,可在 CCAI Platform 中使用。您也可以在選單的「Custom Fields for Records」部分中選取「Create」,建立其他自訂欄位。

欄位 類型 定義
u_ujet_custom_field_after_call_work 字串 通話後處理時間長度
u_ujet_custom_field_call_duration 字串 通話時間長度
u_ujet_custom_field_comm_id 整數 通話或即時通訊 ID (視聯絡人類型而定)
u_ujet_custom_field_rating 整數 CSAT 分數
u_ujet_custom_field_email_via_web 字串 從網頁傳送的電子郵件
u_ujet_custom_field_feedback 字串 意見回饋
u_ujet_custom_field_from_phone_number 字串 來電者的電話號碼
u_ujet_custom_field_hold_duration 字串 總保留時間
u_ujet_custom_field_menu_path 字串 選單選項
u_ujet_custom_field_queue_name 字串 佇列名稱
u_ujet_custom_field_session_type 字串 工作階段類型
u_ujet_custom_field_verification True/False 確認驗證完成
u_ujet_custom_field_wait_time 字串 總等待時間

設定 OAuth

如要設定 OAuth,請按照步驟在 ServiceNow 中建立 OAuth 應用程式。然後,在「Developer Settings」>「CRM」>「驗證方式」下方輸入憑證 (OAuth 用戶端 ID 和 OAuth 用戶端密鑰)。

在 ServiceNow 建立 OAuth 應用程式

  1. 在 ServiceNow 帳戶中,依序前往「All」(全部) >「System OAuth」(系統 OAuth) >「Application Registry」(應用程式註冊資料庫)。

  2. 建立 OAuth 應用程式,然後選取「Create an OAuth API endpoint for external clients」(為外部用戶端建立 OAuth API 端點)。

  3. 設定下列欄位:

    • 名稱:輸入不重複的名稱。

    • 用戶端 ID:ServiceNow OAuth 伺服器會自動產生用戶端 ID。

    • 用戶端密鑰:OAuth 應用程式的用戶端密鑰。如要自動生成,請留空。

    • 「Refresh token lifespan」(更新權杖生命週期):更新權杖的有效時間 (以秒為單位)。

    • 存取權杖效期:存取權杖的有效時間,以秒為單位。

    • 重新導向網址:輸入環境網址和子目錄。例如: https://servicenow.yourcompany.co/v1/servicenow/oauth_callback

    • 強制執行權杖限制:限制存取權杖的使用,僅限於 ServiceNow 說明文件中 REST API 存取政策定義的 API。取消選取這個選項,即可在其他 REST API 使用存取權杖。

  4. 按一下「提交」。

  5. 建立應用程式後,返回記錄並擷取用戶端 ID 和新建立的用戶端密鑰。

在開發人員設定中更新設定

  1. 依序前往「Developer Settings」>「CRM」。

  2. 請務必按照上述步驟輸入及設定。

  3. 在「驗證方式」下方,按一下「OAuth」OAuth。

  4. 輸入 OAuth 用戶端 ID 和 OAuth 用戶端密鑰。(請參閱上方的步驟 5)。

  5. 按一下「儲存」。

  6. 按一下「連結憑證」。

虛擬服務專員的自訂欄位對應

如果使用虛擬服務專員,請在「Custom Field Mappings」(自訂欄位對應) 畫面中設定這個欄位。這樣一來,虛擬服務專員變數就能從虛擬服務專員工作階段酬載轉移至 ServiceNow。變數名稱可以是任何字串,這裡列出的欄位標籤只是範例。

在「Custom Field Mappings」(自訂欄位對應) 畫面中,設定初始 Virtual Agent 設定中使用的酬載定義所建立的變數,與 ServiceNow 中相關變數之間的連線。

欄位對應標題 CRM 欄位標籤 自訂資料欄位標籤
虛擬服務專員意見回饋 ccaip_custom_field_incident_feedback va_feedback

新增 CRM 欄位對應

  1. 依序前往「設定」>「作業管理」。

  2. 前往「CRM Custom Field Mapping」部分 > 按一下「View All」。

  3. 按一下「+ 新增客戶關係管理欄位對應」連結。

    • Field Mapping Title:CCAI 平台入口網站中,這個自訂欄位對應的 CCAI 平台名稱。

    • CRM 欄位標籤:CRM 中要對應的 CRM 欄位標籤。

    • 自訂資料欄位標籤 (自訂資料鍵):CCAI Platform 自訂資料酬載中要對應的頂層鍵名稱 (例如 SDK 酬載的 device,或 Apps API Chat 酬載的 orderId)。這個金鑰必須由 CCAI Platform 網頁或行動 SDK 傳送,或 (針對即時通訊互動) 使用 Apps API Send custom data in a chat 端點傳送。鍵必須完全相符 (包括大小寫)。

  4. 按一下「儲存」。

調整其他設定

在「Settings」(設定) 下拉式選單中,您會看到其他設定,可讓您將 CCAI Platform 妥善整合至 ServiceNow 執行個體。如要進一步瞭解如何設定各個部分,請參閱下列清單中的連結。

測試輸出內容

現在,您可以點選 CCAI 平台入口網站畫面頂端的相關按鈕,驗證通話和即時通訊流程的功能。執行這項測試時,請務必停用彈出式視窗攔截器。

ServiceNow 應會建立事件,並在事件的「Activities」(活動) 區段中列出通話或即時通訊聯絡人。這項資訊應顯示為「工作附註」,而非事件留言,這樣客戶就不會看到這項後端活動。

案件說明會自動填入「使用 CCAI 平台通話」或「使用 CCAI 平台即時通訊」,服務專員可能需要更新這項資訊。

如果對通話或即時通訊的輸出內容感到滿意,可以輸入解決方案代碼和附註 (如果已設定 ServiceNow 解決方案代碼和附註欄位),然後關閉案件。

如要確認案件已結案,您可能需要點選瀏覽器上的「back」導覽按鈕。在 ServiceNow 執行個體中,案件解決後會自動關閉,並將您導向客戶記錄頁面,這是預期行為。