CXone Mobile SDK

目前版本：2.1
API 參考：

CXone Mobile SDK允許您將CXone數位聊天整合到您的企業手機應用程式中。這使得應用程式使用者可以透過數位Closed 任何與Digital Experience相關的通道、聯絡或技能。聊天通道與您的聯絡中心客服專員和機器人聊天。SDK 簡化了實現數位聊天的過程；開發人員不需要處理業務邏輯的實作。開發人員的主要任務是直觀地顯示和管理您在CXone中設定的功能，例如推送通知或富訊息。SDK 支援iOS和Android應用程式。iOS應用程式 必須寫為 Swift在新視窗中打開此連結 ，而Android應用程式必須用 Kotlin在新視窗中打開此連結。

透過 CXone Mobile SDK：

要快速了解 SDK 的優勢，您可以查看CXone Mobile SDK資料表在新視窗中打開此連結。您也可以觀看簡短示範影片在新視窗中打開此連結。

軟體開發工具包 (SDK) 就像是開發人員的工具箱。它提供了一組工具和資源，使構建軟體應用程式更加容易。您可以將其視為預製構建塊的集合。這些構建塊具有現有功能。您的開發人員可以使用這些現有的塊，而不是從頭開始自行構建功能。以下是使用 SDK 的四個好處：

  1. 效率：SDK 提供現成的工具和預先構建的元件，可以節省開發人員的時間。他們可以專注於應用程式的獨特方面，而不是反復做重複的工作。

  2. 一致性：SDK 確保不同應用程式之間的一致性。透過使用同一套工具和函式庫，開發人員可以讓使用者保持統一的體驗。

  3. 平台相容性：iOS和AndroidSDK 是針對其各自的平台量身定制的。它們處理平台特定的複雜性，從而更容易建立跨平台應用程式。

  4. 品質保證：使用記錄器，開發人員可以驗證他們的代碼，及早發現錯誤並提供更可靠的軟體。

總之，SDK 簡化了開發、確保了品質並促進了協作，使其成為高效建立應用程式的重要工具。

SDK 資源

從公共GitHub存放庫下載 SDK 套件 (Android在新視窗中打開此連結iOS在新視窗中打開此連結）。兩個存放庫都包含一個 README 文件，可協助您開始開發工作。他們還在/docs中提供帶有代碼範例的用例。在開發聊天時可以使用這些作為靈感。這兩個存放庫還包含變更記錄。

您可以在瀏覽器中存取 API 參考 (Android在新視窗中打開此連結iOS在新視窗中打開此連結）。

您的開發人員也可以查看Android 在新視窗中打開此連結 和 iOS 在新視窗中打開此連結 平台的應用程式 範例。它們可以幫助開發人員查看已實現的功能範例。

Mobile SDK 版本

SDK 的目前版本是 2.0，與CXone24.2 主要版本相關。上面的 SDK 資源部分提供了最新資源的連結。

在 SDK 存放庫中，您可以使用標記來尋找先前版本的 SDK。

Mobile SDK 如何與Digital Experience相容

Mobile SDK 是一種擴展Digital Experience並在行動應用程式中提供數位聊天的方法。Digital Experience是CXone中支援數位通道的部分。數位通道的範例包括WhatsApp、臉書上的帖文或數位聊天。要將CXone 數位聊天新增到應用程式中， 您必須在CXone介面的Digital Experience部分中配置某些功能。然後，透過 SDK，您可以存取和使用在CXone中設定的功能。

例如，入門過程的一部分是在CXone中設定數位聊天通道。您的應用程式與您建立的通道建立WebSocket連接。您也可以設定進階功能，如歡迎訊息或聊天前調查。這些為您提供了多種選項來簡化應用程式使用者體驗。使用者可以提供有關其問題或請求的初始資訊、輸入基本個人資料等。這些功能最初在CXone中設定，然後您可以將其與 SDK 一起使用。

Mobile SDK 基礎結構圖

構建您的聊天 UI

作為整合者，您負責構建聊天 UI。這是利用某些功能（如顯示和處理檔案或錄製語音訊息）所必需的。例如，您需要新增一個按鈕供聯絡人按下以存取裝置的麥克風來錄製訊息。您可以參考範例應用程式(Android在新視窗中打開此連結iOS在新視窗中打開此連結）了解如何實現 UI 的範例。

您可以使用第三方 UI 開發套件，例如 MessageKit。但是，這可能會受到限制，具體取決於您的用例。此外，NICE CXone不擁有任何第三方 UI 包，也不提供對任何第三方 UI 包的支援。

開始開發前

在使用 mobile SDK 進行建置之前，請考慮以下事項：

  • 您在 CXone 中同時擁有管理員和客服專員帳號嗎？管理員可以協助您在 CXone平台 中設定必要的功能嗎？
  • 您的手機應用程式可用於iOS(Apple)、Android或兩者？您的開發人員熟悉 Swift 和 Kotlin 語言嗎？
  • 您有現有的聊天訊息通道，還是想建立一個新通道？
  • 您會使用OAuth來驗證您的應用程式使用者嗎？若是，您將使用哪個 OAuth 供應商？
  • 您想提供單執行緒或多執行緒的對話嗎？
  • 您會使用主動動作，例如彈出視窗或歡迎訊息嗎？
  • 您想使用推送通知嗎？您是否有現有的 Firebase 或Apple開發者帳戶？
  • 您想要設定哪些類型的富訊息？您可以在哪些用例中利用這些互動訊息？
  • 您想追蹤使用者資料嗎？如何使用訪客事件進行分析？

關鍵術語

  • 執行緒：聊天應用程式中的對話。由客服專員或聯絡人Closed 在聯絡中心與客服專員、IVR 或機器人互動的人。傳送的第一個訊息開始一個執行緒。對話中的每個連續訊息都會新增到執行緒中。執行緒是包含每個訊息的物件。訊息由訊息作者建構。threadId標識整個對話，對話中的所有訊息都有一個訊息 ID。對話結束時，執行緒也會結束。

  • 單執行緒：一種應用程式設計，其中聯絡人一次只能進行一個對話。

  • 多執行緒：一種應用程式設計，其中聯絡人可以一次進行多個對話。

  • 通道：在Digital Experience的環境中，通道是指訊息傳遞類型或用於通訊的平台。例如，您可以有一個WhatsApp即時訊息通道。行動 SDK 可讓您在行動應用程式上新增聊天訊息通道。在CXone平台中建立通道。這決定了通道的設定以及通道 ID。當應用程式使用者打開聊天時，您可以使用此 ID 啟動聊天通道。

  • ChannelId：在CXone的數位部分中建立的數位聊天通道的 ID。您可以在CXone(ACD>數位>數位聯絡點>聊天>初始化和測試）中的聊天通道設定中找到此編號。

  • BrandId：這類似於Digital Experience的租戶Closed 用於管理 CXone 環境的技術支援、計費和全域設定的高級組織分組 ID。其用於初始化聊天。您可以在CXone(ACD>數位>數位聯絡點>聊天>初始化和測試）中的聊天通道設定中找到此編號。

  • CustomerId：聊天最終使用者的唯一 ID。SDK 在聊天初始化時建立此 ID。如果您設定了OAuth，則每個聯絡人在其所有裝置上的此 ID 都保持不變。如果您沒有設定OAuth，則該 ID 對於每個裝置都不相同；ID 將變成訪客登入名稱。

  • 區域或環境：託管CXone部署的全球位置。這可以是：澳洲 (AU1)、加拿大 (CA1)、歐洲 (EU1)、日本 (JP1)、北美 (NA1) 或英國 (UK1)。開發者必須使用託管您的CXone系統的同一區域，否則聊天連接將被拒絕。

  • 聯絡人、客戶和使用者：這些術語均指行動應用程式的最終使用者。線上說明通常使用術語聯絡人。在 SDK 文件和代碼備註中，您可能會看到客戶和使用者。

  • CXone：核心平台，您可以在其中管理和存取NICE CXone提供的所有客戶體驗工具。根據您想要在行動應用程式中提供的聊天功能，擁有必要使用者帳號權限的管理員必須在CXone中完成多項設定任務。

  • Digital Experience：CXone的部分，您可以在其中管理有關數位通道的所有內容。