Contact Center AI 平台 (CCAI Platform) 可與 ServiceNow CRM 整合。
ServiceNow 開發人員設定
建議的 ServiceNow 最低版本需求:Tokyo patch 1
設定基本驗證使用者
ServiceNow 管理員帳戶可能已啟用兩步驟驗證,並與該使用者建立關聯。因此無法用於取得 CCAI 平台的管理員存取權。您必須在 ServiceNow 中建立使用者帳戶,才能執行這項操作。
建立具有憑證的基本使用者:
依序前往「User」>「New」。
填寫詳細資料,然後選取「Web service access only」(僅限存取 Web 服務)。
記下使用者 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 條橫線)。您可以在自助服務檢視畫面或預設檢視畫面中執行這項操作。
在選單中依序選取「Configure」>「Form Design」,開啟表單設計工具。
在左欄中,選取「Field Types」分頁標籤。
拖曳要新增的自訂欄位類型。
將欄位類型拖曳到所需區段後,選取齒輪圖示即可查看「Settings」(設定)。
在視窗中變更標籤,並記下名稱。這個名稱會用於 CCAI Platform 應用程式設定。
選取畫面右上角的「儲存」。
將工作階段資料對應至客戶關係管理系統
您必須使用 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
依序前往「All」(全部) >「System Applications」(系統應用程式) >「All Available Applications」(所有可用的應用程式) >「All」(全部)。
搜尋 OpenFrame。
安裝 OpenFrame。
安裝完成後,依序前往「All」>「OpenFrame」>「Configurations」。
使用網址建立設定。如果 ServiceNow 執行個體中有多項設定,使用者可能無法存取新建立的設定。請檢查群組和 OpenFrame 設定順序清單,判斷使用者採用的設定。
在搜尋列中輸入
sys_properties.list。編輯
glide.ui.concourse.onmessage_enforce_same_origin_whitelist。將新網址新增至值清單。
編輯
sn_openframe.cross.origin.access。將
autoplay新增至值清單。
為使用者啟用新版 UI 體驗
在導覽列中輸入
sys_properties.list,然後按下 Enter 鍵。將系統屬性
glide.ui.polaris.experience設為 true。將系統的使用者偏好設定
glide.ui.polaris.use設為 false。將使用者的偏好設定
glide.ui.polaris.use設為 true。(您可以建立使用者偏好設定列)。
更新系統屬性
在導覽列中輸入
sys_properties.list,然後按下 Enter 鍵。編輯
glide.ui.concourse.onmessage_enforce_same_origin_whitelist。將網址新增至值清單。多個值之間須以半形逗號分隔。
編輯
sn_openframe.cross.origin.access。將 autoplay 新增至值清單。
編輯
glide.ui.polaris.experience。請變更為 false,因為啟用後部分功能會無法運作。
在表單頂端加入「點選撥號」
依序前往「System UI」(系統 UI) >「UI Actions」(UI 動作)。
選取「建立新動作」。
在如圖所示的表單中,選取要加入這個點擊撥號功能的表格。

如果表單參照聯絡人或使用者,請使用
g_form.getReferenceAPI 存取使用者的電話號碼。如果是自訂表格,參考 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); }); }如果表單內有要撥打的號碼,請使用
g_form.getValueAPI 擷取相關值。以下是「使用者」資料表的 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); }
在參考資料旁新增點擊撥號功能
聯絡人參照旁的通話按鈕必須在表單中編輯。在欄位上按一下滑鼠右鍵,然後前往「Configure Dictionary」。如果是屬性,請在
ref_contributions值中加入show_phone或show_phone_customer_service值。在 UI 巨集中,編輯
show_phone和show_phone_customer_service。更改下列內容:
上一頁:
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。
在 CCAI Platform 入口網站中,依序前往「Settings」>「Developer Settings」>「CRM」。
在「Agent Platform」部分,選取「ServiceNow」ServiceNow。
在「ServiceNow Domain」欄位中,輸入 ServiceNow 網域資訊。這可能是開發人員執行個體或供應商執行個體 (視需要而定),但與執行個體直接相關,且是 ServiceNow 入口網站網址的第一部分:
https://{your instance}.servicenow.com。在「ServiceNow Cloud Selection」欄位中,選取「
Incident」做為基本票證類型。如果選取「Custom」,系統會顯示其他選項。事件是工作資料表的擴充功能;自訂物件應為事件的擴充功能。在「Authentication Credentials」(驗證憑證) 欄位中,輸入使用者名稱和密碼。
如果您在雲端選取欄位類型中選取「
Incident」,會看到下列欄位:- 「Lookup account object」包含三個下拉式選單欄位:
Object Type、Phone Number lookup fields和Phone number primary field。
- 「Lookup account object」包含三個下拉式選單欄位:
如果您在雲端選取欄位類型中選取「
Custom」,會看到下列欄位:查詢記錄物件:
Base record object type (基本記錄物件類型):選取
task或incident資料表類型。記錄物件類型:如果事件表格已擴充,這個欄位會填入資料,您可以視需要選取。
「Lookup account object」包含三個下拉式選單欄位:
Object Type、Phone Number lookup fields和Phone number primary field。
自訂使用者 ID 欄位:如要為 Mobile 或 Web SDK,或 Apps API (Chat) 工作階段啟用自訂使用者查詢欄位,請勾選這個方塊。
電話號碼格式:可選取電話號碼的顯示格式。
工作階段中繼資料檔案:勾選這個方塊,即可將工作階段中繼資料附加至 CRM 記錄。
按一下「儲存」即可儲存所選項目。
記錄的自訂欄位
這些是已在表單設計工具中為 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 應用程式
在 ServiceNow 帳戶中,依序前往「All」(全部) >「System OAuth」(系統 OAuth) >「Application Registry」(應用程式註冊資料庫)。
建立 OAuth 應用程式,然後選取「Create an OAuth API endpoint for external clients」(為外部用戶端建立 OAuth API 端點)。
設定下列欄位:
名稱:輸入不重複的名稱。
用戶端 ID:ServiceNow OAuth 伺服器會自動產生用戶端 ID。
用戶端密鑰:OAuth 應用程式的用戶端密鑰。如要自動生成,請留空。
「Refresh token lifespan」(更新權杖生命週期):更新權杖的有效時間 (以秒為單位)。
存取權杖效期:存取權杖的有效時間,以秒為單位。
重新導向網址:輸入環境網址和子目錄。例如:
https://servicenow.yourcompany.co/v1/servicenow/oauth_callback強制執行權杖限制:限制存取權杖的使用,僅限於 ServiceNow 說明文件中 REST API 存取政策定義的 API。取消選取這個選項,即可在其他 REST API 使用存取權杖。
按一下「提交」。
建立應用程式後,返回記錄並擷取用戶端 ID 和新建立的用戶端密鑰。
在開發人員設定中更新設定
依序前往「Developer Settings」>「CRM」。
請務必按照上述步驟輸入及設定。
在「驗證方式」下方,按一下「OAuth」OAuth。
輸入 OAuth 用戶端 ID 和 OAuth 用戶端密鑰。(請參閱上方的步驟 5)。
按一下「儲存」。
按一下「連結憑證」。
虛擬服務專員的自訂欄位對應
如果使用虛擬服務專員,請在「Custom Field Mappings」(自訂欄位對應) 畫面中設定這個欄位。這樣一來,虛擬服務專員變數就能從虛擬服務專員工作階段酬載轉移至 ServiceNow。變數名稱可以是任何字串,這裡列出的欄位標籤只是範例。
在「Custom Field Mappings」(自訂欄位對應) 畫面中,設定初始 Virtual Agent 設定中使用的酬載定義所建立的變數,與 ServiceNow 中相關變數之間的連線。
| 欄位對應標題 | CRM 欄位標籤 | 自訂資料欄位標籤 |
|---|---|---|
| 虛擬服務專員意見回饋 | ccaip_custom_field_incident_feedback |
va_feedback |
新增 CRM 欄位對應
依序前往「設定」>「作業管理」。
前往「CRM Custom Field Mapping」部分 > 按一下「View All」。
按一下「+ 新增客戶關係管理欄位對應」連結。
Field Mapping Title:CCAI 平台入口網站中,這個自訂欄位對應的 CCAI 平台名稱。
CRM 欄位標籤:CRM 中要對應的 CRM 欄位標籤。
自訂資料欄位標籤 (自訂資料鍵):CCAI Platform 自訂資料酬載中要對應的頂層鍵名稱 (例如 SDK 酬載的
device,或 Apps API Chat 酬載的orderId)。這個金鑰必須由 CCAI Platform 網頁或行動 SDK 傳送,或 (針對即時通訊互動) 使用 Apps APISend custom data in a chat端點傳送。鍵必須完全相符 (包括大小寫)。
按一下「儲存」。
調整其他設定
在「Settings」(設定) 下拉式選單中,您會看到其他設定,可讓您將 CCAI Platform 妥善整合至 ServiceNow 執行個體。如要進一步瞭解如何設定各個部分,請參閱下列清單中的連結。
測試輸出內容
現在,您可以點選 CCAI 平台入口網站畫面頂端的相關按鈕,驗證通話和即時通訊流程的功能。執行這項測試時,請務必停用彈出式視窗攔截器。
ServiceNow 應會建立事件,並在事件的「Activities」(活動) 區段中列出通話或即時通訊聯絡人。這項資訊應顯示為「工作附註」,而非事件留言,這樣客戶就不會看到這項後端活動。
案件說明會自動填入「使用 CCAI 平台通話」或「使用 CCAI 平台即時通訊」,服務專員可能需要更新這項資訊。
如果對通話或即時通訊的輸出內容感到滿意,可以輸入解決方案代碼和附註 (如果已設定 ServiceNow 解決方案代碼和附註欄位),然後關閉案件。
如要確認案件已結案,您可能需要點選瀏覽器上的「back」導覽按鈕。在 ServiceNow 執行個體中,案件解決後會自動關閉,並將您導向客戶記錄頁面,這是預期行為。