CXoneモバイルSDK

現在のバージョン：2.1
API参照：

CXoneモバイルSDKを使えばCXoneデジタルチャットを企業の携帯電話アプリに統合することができます。これにより、アプリユーザーは、デジタル閉じた Digital Experienceに関連するあらゆるチャネル、コンタクト、スキル。チャットチャンネルを通じてコンタクトセンターのエージェントやボットとチャットすることができます。SDKは、デジタルチャットを実装するプロセスを簡素化し、開発者はビジネスロジックの実装を処理する必要がありません。開発者の主なタスクは、プッシュ通知やリッチメッセージのようなCXoneで設定した機能を視覚的に表示し、管理することです。SDKはiOSとAndroidアプリの両方をサポートします。iOSアプリは、Swiftこのリンクが新しいウィンドウで開きます。で記述されなければならず、またAndroidアプリはKotlinこのリンクが新しいウィンドウで開きます。で記述されなければなりません。

CXoneモバイルSDKを使えば次のことが可能です：

SDKのメリットの概要を知るには、CXoneモバイルSDKデータシートこのリンクが新しいウィンドウで開きます。を確認してください。また、短いデモビデオこのリンクが新しいウィンドウで開きます。もご覧いただけます。

ソフトウェア開発キット(SDK)は、開発者のための道具箱のようなものです。ソフトウェアアプリケーションの構築を容易にするツールとリソースのセットを提供します。それは既成の構築ブロックのコレクションと考えることもできます。これらの構築ブロックには既存の機能があります。開発者は、一から独自に機能を構築する代わりに、これらの既存のブロックを使用することができます。SDKを使用する一般的なメリットは以下の4つです：

  1. 効率化：SDKは、開発者の時間を節約する既製のツールと構築済コンポーネントを提供します。車輪の再発明をするのではなく、アプリのユニークな側面に集中することができます。

  2. 一貫性：SDKは異なるアプリの一貫性を保証します。同じツールやライブラリを使用することで、開発者はユーザーに統一されたエクスペリエンスを維持することができます。

  3. プラットフォームの互換性：iOSおよびAndroid SDKは、それぞれのプラットフォーム用にカスタマイズされています。これらはプラットフォーム特有の複雑さを処理し、クロスプラットフォームアプリの作成をより簡単にします。

  4. 品質保証：ロガーで、開発者はコードを検証し、バグを早期に発見し、より信頼性の高いソフトウェアを提供することができます。

まとめると、SDKは開発を簡素化し、品質を保証し、コラボレーションを促進するものであり、効率的なアプリの作成用の必須ツールを作ります。

SDKリソース

公開されたGitHubリポジトリー(Android このリンクが新しいウィンドウで開きます。 iOS このリンクが新しいウィンドウで開きます。)からSDKパッケージをダウンロードします。どちらのリポジトリーにも、開発を始めるのに役立つREADMEファイルが含まれています。また、コードサンプルが/docsに入ったユースケースも提供します。チャットを開発する際にはこれらをインスプレーションとして利用します。両方のリポジトリーには変更履歴も含まれています。

ブラウザー(Android このリンクが新しいウィンドウで開きます。 iOS このリンクが新しいウィンドウで開きます。)でAPI参照にアクセスできます。

開発者は、Android このリンクが新しいウィンドウで開きます。とiOS このリンクが新しいウィンドウで開きます。 プラットフォームの両方用のサンプルのアプリケーションを見ることもできます。これらは実装された機能の例を開発者が見るのに役立ちます。

Mobile SDKのバージョン管理

SDKの現在のバージョンは2.0であり、CXone 24.2メジャーリリースに対応しています。上記のSDKリソースセクションでは、最新のリソースへのリンクを提供しています。

SDKリポジトリーでは、タグを使って以前のバージョンのSDKを見つけることができます。

Mobile SDKがどのようにDigital Experienceに適合するか

Mobile SDKは、Digital Experienceを拡張し、モバイルアプリにデジタルチャットを提供する方法です。Digital ExperienceはデジタルチャネルをサポートするCXoneの一部です。デジタルチャネルの例としては、WhatsApp、Facebookへの投稿、デジタル・チャットなどがあります。CXoneデジタルチャットをアプリに追加するには、CXoneインターフェイスのDigital Experienceセクションで特定の機能を設定する必要があります。その後、SDKで、CXoneに設定した機能にアクセスして使用します。

例えば、開始プロセスの一部は、CXoneでデジタルチャットチャネルを設定することです。アプリは、ご自分が作成したチャンネルとのWebSocket接続を作成します。また、ウェルカムメッセージやプレチャットアンケートのような高度な機能を設定することもできます。これらにより、アプリユーザーの体験を合理化するためのさまざまなオプションが提供されます。ユーザーは、自分の問題やリクエストに関する最初の情報を提供したり、基本的な個人データを入力したりできます。これらの機能はCXoneで初期設定され、これをSDKで使用することができます。

Mobile SDKインフラストラクチャーの図

チャットUIの構築

インテグレーターとして、あなたはチャットUIの構築を担当しています。これは、ファイルの表示や操作、音声メッセージの録音など特定の機能を活用するために必要です。たとえば、コンタクトがメッセージを録音するためにデバイスのマイクにアクセスするためのボタンを追加する必要があります。UIの実装方法の例として、サンプルアプリケーションの(Android このリンクが新しいウィンドウで開きます。 iOS このリンクが新しいウィンドウで開きます。)を参照することができます。

MessageKitのようなサードパーティーのUI開発キットを使用できます。ただし、これはあなたのユースケース応じて制限的になる場合があります。また、NICE CXoneはサードパーティーのUIパッケージを所有する、またはサポートを提供することはありません。

開発を始める前に

モバイルSDKで構築する前に、以下のアイテムを検討してください:

  • CXoneの管理者アカウントとエージェントアカウントの両方を持っていますか？CXoneプラットフォームで必要な機能を設定する際、管理者がサポートできますか？
  • あなたの携帯電話アプリはiOS(Apple)、Android、またはその両方を利用できますか？開発者はSwiftやKotlin言語に精通していますか？
  • 既存のチャットメッセージングチャンネルがありますか、それとも新しいチャンネルを作りますか？
  • アプリユーザーの認証にOAuthを使用しますか？はいの場合、どのOAuthプロバイダーを利用しますか？
  • シングルスレッドとマルチスレッドのどちらの会話を提供したいですか？
  • ポップアップのようなプロアクティブ・アクションやウェルカムメッセージを使用しますか？
  • プッシュ通知を使いたいですか？既存のFirebaseまたはApple開発者アカウントをお持ちですか？
  • どのタイプのリッチメッセージを設定しますか？このようなインタラクティブメッセージを活用できるユースケースにはどのようなものがあるのだろうか？
  • ユーザーデータを追跡しますか？訪問者イベントを使って、どのように分析を作ることができますか？

主要用語

  • スレッド：チャットアプリ内の会話。エージェントまたはコンタクトのいずれかによって送信された最初のメッセージが、スレッドを開始します。会話中の連続したメッセージはスレッドに追加されます。スレッドは各メッセージを含むオブジェクトです。メッセージはメッセージの作者によって構成されます。threadIdは会話全体を識別し、会話内のすべてのメッセージはメッセージIDを持ちます。会話が終わるとスレッドは終了します。

  • シングルスレッド：コンタクトが1回に一つの会話しかできないようなアプリデザイン。

  • マルチスレッド：コンタクトが1回に複数の会話ができるようなアプリデザイン。

  • チャネル：Digital Experienceのコンテキストで、チャネルは、メッセージングのタイプ、または通信に使用されるプラットフォームを参照します。たとえば、WhatsAppリアルタイムのメッセージングチャネルを持つことができます。Mobile SDKは、モバイルアプリにチャットメッセージングチャネルを追加することができます。CXoneプラットフォームにチャンネルが作成されます。これは、チャンネルIDと一緒にチャネルの設定を決定します。アプリユーザーがチャットを開いたときに、このIDを使用してチャットチャネルを開始します。

  • ChannelId：CXoneのデジタルセクションで作成されたデジタルチャットチャネルのID。これは、CXone(ACD> デジタル> ポイントオブコンタクト(PoC)デジタル> チャット> 初期化とテスト)のチャットチャンネルの設定にあります。

  • BrandId：これはDigital Experience用のテナント閉じた テクニカルサポート、請求、およびCXone環境のグローバル設定の管理に使用される高レベルの組織グループIDのようなものです。これはチャットの初期化に使われます。これは、CXone(ACD> デジタル> ポイントオブコンタクト(PoC)デジタル> チャット> 初期化とテスト)のチャットチャンネルの設定にあります。

  • 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のセクション。