Click-to-Call

Click-to-Call 讓您的聯絡人Closed 在您的聯絡中心內與客服專員、IVR 或機械人互動的人員。只需點擊一下即可致電真人客服專員。 訪客可透過您網站上的按鈕,直接撥打電話給客服專員。 這可以幫助您減少或消除:

  • 連接銷售或支援團隊的額外步驟。

  • 管理費用,例如服務號碼費和行動裝置附加費。

Click-to-Call透過以JavaScript撰寫的軟體開發套件 (SDK) 運作。 若要設定,您必須與開發人員合作,在您的網站上實作 SDK。 您必須與可提供特定憑證的客戶代表合作。

Click-to-Call 的金鑰事實

  • Click-to-Call支援桌面瀏覽器。 目前不支援行動裝置。

  • Click-to-Call 目前支援以下地區:

    • 加拿大

    • 德國

    • 日本

    • UK

    • 美國

  • 有關 Click-to-Call SDK 的關鍵資訊包括:

  • SDK 由一個clicktocall.js檔案組成。 在您希望顯示Click-to-Call按鈕的每個網頁上,都必須包含或引用此項。 您也必須實作自己的 UI 元件,如Click-to-Call按鈕和呼叫控制。 Click-to-Call按鈕必須叫用 SDK 中的makeCall功能,這啟動WebRTC呼叫。 如果通話請求通過NiCE CXone的驗證,則通話已撥打。

  • SDK 提供一個選項,可以使用 X-標頭,將使用者資料、網站中繼資料及路由資料作為 SIP invite 請求的一部分傳遞。您必須設定與 Click-to-Call 聯絡點Closed 呼入聯絡用以發起互動的入口點,例如電話號碼或電郵地址。相關聯的 Studio 程式碼,以取得資料並視需要使用。這可能包括在客服專員的畫面彈出視窗中顯示使用者資料,或使用路由資料來做出路由決策。

    此規定為可选,您僅應在需要時進行設定。如果您不需要它,您可以在不傳遞任何資料的情況下設定 makeCall() 函數。

    收集和傳遞資料是您的責任。SDK 僅提供傳輸資料的機制,並不會產生、驗證或管理資料。

  • 針對 Click-to-Call SDK 更新:

    • 變更(包括改進、新功能及兼容性更新)並非按固定排程進行。

    • SDK 已傳送為單一 JavaScript 檔案。當有更新時,NiCE 會為您提供最新版本。然後,您必須在您的實作中 replace 現有檔案。

    • SDK 維持向下兼容性,因此現有版本可繼續運作而不受影響。然而,如果發生重大變更,您可能需要更新至最新版本。

整合的先決條件

為了準備將 Click-to-Call 整合到您的網站,您必須:

  • 向您的客戶代表取得客戶 ID。

  • 請與您的客戶代表合作,為 Click-to-Call 配置專屬的電話號碼。

  • 在您自己的伺服器上實作 POST API。 此 API 必須產生 JWT 權杖以進行驗證。 此功能驗證來電要求是否合法。

  • 請將公共金鑰提供給您的客戶代表,以進行驗證。

  • 考慮您的 UI 設計。 您必須為通話的聯絡人端開發自己的使用者介面,包括通話控制按鈕,例如靜音或結束通話。 SDK 包含 React 和 Angular 元件範例,您的開發人員可以使用這些範例作為參考和啟發。 電話的客服專員方是在其客服專員應用程式中處理的,因此只需要為聯絡方進行 UI 開發。

NiCE CXone 設定

除了新增Click-to-Call功能到您的網站上,您也必須確保在NiCE CXone中設定了您的路由元件。 您的NiCE CXone管理員可以設定必要的元件。

請確定您已擁有如下元件:

  • 一個已建立並指派了必要座席的撥入語音ACD技能。

  • 為語音呼叫設定了聯絡點(POC)。 每個 Click-to-Call 電話號碼必須有這些電話 POC(Point of Contact,聯絡人)。 在您的網站上實作Click-to-Call的開發者必須為contactAddress檔案JavaScript使用此項。

  • 一個Studio程式碼,用於將通話路由至客服專員。

視乎您的NiCE CXone設定,您可能可以使用現有的路由元件,或者您可能需要建立並設定新的元件。

SDK 整合

請確定您已完成或準備了先決條件部分的必要項目。

  1. 將clicktocall.js檔案加入您認為合適的網頁。

  2. 在clicktocall.js檔案中,設定 POST API 的 API 端點 URL。

    let getJWT1TokenURL = '<YOUR_TOKEN_ENDPOINT_URL>';
  3. 新增下列 UI 元件至您的網站。 請務必賦予每個元件唯一的識別碼。 SDK 套件包含 React 和 Angular 的 UI 元件範例。 您可以在 IntegrationHelpers/UIComponents 目錄中找到這些內容。

    • 開始語音通話的按鈕。

    • 掛斷或中斷通話的按鈕。

    • 通話音訊靜音和取消靜音的按鈕。

    • 顯示 DTMF 輸入鍵盤的按鈕。

    • 用於顯示鍵盤按鍵的<div>。

    • 用於顯示電話成功或錯誤訊息的標籤。

    • <audio>標記來播放某些聲音,例如撥號音或通話連接聲音。

  4. 更新clicktocall.js檔案,並引用您在上一步中新增的 UI 元件。

    let clickToCallButtonId = '<YOUR_CLICK_TO_CALL_BUTTON_ID>';
    let hangUpButtonId = '<YOUR_HANG_UP_BUTTON_ID>';
    let muteAudioButtonId = '<YOUR_MUTE_AUDIO_BUTTON_ID>';
    let keypadButtonId = '<YOUR_KEYPAD_BUTTON_ID>';
    let dtmfKeyDivId = '<YOUR_DTMF_KEY_DIV_ID>';
    let callStatusMessageLabelId = '<YOUR_CALL_STATUS_MESSAGE_LABEL_ID>';
    let remoteAudioId = '<YOUR_AUDIO_CONTROL_ID>';
  5. 在clicktocall.js檔案的配置部分配置您的偏好配置。 本部分包含數個控制特定行為類型的配置變數。

    • 使用retryCount設定重試次數。 如果通話中斷,這是系統嘗試重新連接通話的次數。 預設為 3。

    • 設定POCREnvironmentXHeaderValue值為PROD。

    • 在phoneServerConfig和clientId中設定電話伺服器的配置設定。

      let phoneServerConfig = {
      	domain: '<Domain of the SIP server>', //Set value of this configuration to 'cxonevoice.com'
      	addresses: [], //Keep this array empty
      	iceServers: [], //Keep this array empty
      	userName: '<username>', //This configuration is a human-readable string used to identify the sender in a more friendly way. In agent applications like CXone Agent, this might be displayed on the screen during a call. Tthis value should not contain any spaces and should not exceed 20 characters. 
      	displayName: '', // This is an optional field and its value can be kept the same as userName 
      	password: '' //Keep this field empty
      }
      let clientID = '<YOUR_CLIENT_ID>'; //Set the value of this configuration as provided by CXone 
  6. 如果您想要自訂與通話失敗或斷線相關的聯絡人端通知,請變更clicktocall.js中下列變數的文字字串。

    • callFailedToConnectErrorMessage

    • uiErrorMessage

    • contactSupportTeamMessage

    let callFailedToConnectErrorMessage = 'Call failed to connect. Service not available!';
    let uiErrorMessage = {
    'Default': 'Error occurred. Please try again!',
    'Terminated': 'Call ended successfully!',
    'Canceled': 'Call cancelled. Please try again!',
    'Failed': callFailedToConnectErrorMessage,
    'login failed': callFailedToConnectErrorMessage,
    'disconnected': callFailedToConnectErrorMessage,
    'logout': callFailedToConnectErrorMessage,
    'SIP Failure Code': callFailedToConnectErrorMessage,
    'RTP Timeout':  'RTP Timeout': 'The call ended unexpectedly due to network issues. Please ensure your internet is stable and try placing the call again!',
    'Token Claims': 'An error occurred during the call attempt. Please retry!'
    						}
    let contactSupportTeamMessage = "We're sorry, could not connect the call. Please try again later or contact our support team!";
  7. 如果您想分配最近的資源來處理 Click-to-Call 要求,請設定以位置為基礎的資源。若要這樣做,請在clicktocall.js中執行以下操作:

    1. 使用 getAvailableLocations() 函數傳回已部署所需資源(例如 Session Border Controllers(SBC))的位置清單。這些位置有助於判斷處理 Click-to-Call 要求的最佳資源。

    2. 位置選擇整合到 UI 中。您可以用以下兩種方式之一執行此操作:

      • 使用者可選擇控制項:提供一個可選取的元素,例如下拉式選單或單選按鈕,讓聯絡人可從 getAvailableLocations() 函數所提供的選項中選取其最近的位置。

      • 自動配對:如果系統能夠判斷聯絡人的位置,請將其配對至由 getAvailableLocations() 函數所公開的其中一個位置,並將其傳遞至 makeCall() 函數。

    3. 設定預設位置。若要這樣做,請將 defaultLocation 變數設為您的聯絡人最常來電的位置。預設位置必須是 getAvailableLocations() 函數所傳回的位置之一。

      // Variable to store default location
      let defaultLocation = "US";
  8. 將makeCall(contactAddress, [location], [userData], [routingData])方法新增到Click-to-Call按鈕。 location、userData 及 routingData 參數為可选。

    userData及routingData參數會傳遞使用者和路由資料,以用於路由決策或在Agent Workspace (Agent)中顯示。這是透過SIP邀請請求使用X標頭完成的。然後,您可以在用於聯絡點的Studio程式碼中處理該資料。

    • userData:顯示與使用者相關的資訊。
    • routingData:顯示用於路由決策的資料。

    這些參數必須以包含鍵值對的物件形式提供。SDK 使用 JSON.stringify() 將兩個物件轉換為字串,並以 X-標頭的形式在 SIP invite 請求中傳輸:

    • X-user-data:包含 userData 物件。

    • X-routing-data:包含 routingData 物件。

    userData和routingData是獨立的物件,因此您可以根據需要分開資料。不過,如果您願意,亦可只在其中一個參數中傳遞所有必要的資料。如果您的Studio程式碼已相應設定,您亦可在單一X標頭中傳輸所有資料。

    由於可在X標頭中傳遞的資料大小有限制,因此每個userData及routingData物件在字串轉換後的字元長度不應超過1,000個字元(1 KB)。

    請參閱以下範例,為您的特定使用情況配置它:

    • 不傳遞任何參數:

      makeCall(contactAddress);
    • 僅傳遞 location:

      makeCall(contactAddress, "US");
    • 傳遞 location、userData 並且 routingData 時:

      makeCall(contactAddress, "US", { name: "Elizabeth Bennet", age: 20 }, { skill: "sales" });
    • userData

      makeCall(contactAddress, undefined, { name: "John Doe", age: 30 }, undefined);
  9. 如果您已將 makeCall() 方法設定為使用 userData 或 routingData 物件,則必須使用以下動作,在與 Click-to-Call 聯絡點Closed 呼入聯絡用以發起互動的入口點,例如電話號碼或電郵地址。相關聯的 Studio 程式碼中處理 X-標頭資料:

  10. 若要傳送DTMFClosed 當聯絡人按下電話鍵盤上的按鍵時所產生的訊號音。音頻信號,請在按一下DTMF按鈕時呼叫guiSendDTMF(digit)函數。

  11. 測試您的配置,以確保能夠成功建立並路由通話。