CXone Mobile SDK

目前版本：2.2
API 參考：

為了幫助您開始實作行動 SDK，您必須從NICE購買基本實作套件。

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.2，與CXone24.4 主要版本相關。 上面的 SDK 資源部分提供了最新資源的連結。

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

NICE 支援 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的Digital部分中建立的數位聊天通道的 ID。 您可以在CXone(ACD>Digital>數位聯絡點>聊天>初始化和測試）中的聊天通道設定中找到此編號。

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

  • 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的部分，您可以在其中管理有關數位通道的所有內容。