Mobile SDK

現在のバージョン：2.2（24.4 CXone Mpowerリリースに対応）
API参照：

モバイルSDKの実装を開始するには、NICEから基本実装パッケージを購入する必要があります。 NICEのパートナーが実装をガイドします。

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

Mobile SDKを使えば次のことが可能です：

SDKのメリットの概要を知るには、Mobile 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バージョンは通常、25.2、25.3などのメジャーマーケティングリリースとともに更新されます。CXone Mpower GitHubでは、各リリースバージョンが以下で説明するセマンティックバージョニングに従ってタグ付けされます。

NICEは、SDKの現在および1つ前のメジャーバージョンをサポートしています。 たとえば、現在のバージョンが2.2の場合、NICEはv2.2と1.3（最新の1.xxバージョン）をサポートします。

SDKも更新されるため、アプリを常に最新の状態に保つ必要があります。 上記のSDKリソースセクションでは、最新のリソースへのリンクを提供しています。 SDKリポジトリーでは、タグを使って以前のバージョンのSDKを見つけることができます。 また、SDKには最後の2つのメジャーバージョンまでの下位互換性があることに注意してください。

バージョンの変更

SDKのバージョンがリリースごとに変更される場合、バージョン番号は変更のタイプを示します。 以下、この意味について説明します。

  • 2.0.0：最初の数字は、APIの大きな変更を示しています。

  • 2.1.0：2番目の数字は、破壊的ではない変更を示します。 多くの場合、新機能は互換性のない変更として追加されます。

  • 2.0.1：3番目の数字はバグ修正を示しています。 これらは常に下位互換性があります。

バグ修正

NICE プロフェッショナルサービスは、バグ修正でお客様と協力します。 あなたはそれら（または実装パートナー）を通してバグを送信することができ、彼らはSDKの変更履歴に加えて修正を知らせてくれます。

また、バグは現在サポートされているバージョンで修正されています。 たとえば、現在のバージョンが3.0の場合、サポートされるバージョンは3.0と2.3（2.xの最新バージョン）です。 v2.1でバグを見つけた場合、NICEは2.3と3.0ではそれを修正しますが、2.1と2.2では修正しません。

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

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

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

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

チャットUIの構築

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

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

開発を始める前に

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

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

主要用語

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

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

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

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

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

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

  • CustomerId：チャットエンドユーザーの固有ID。 SDKはチャットの初期化時にこのIDを作成します。 OAuthを設定した場合、このIDはすべてのデバイスにわたり各コンタクトについて同じままです。 OAuthを設定していない場合、このIDは各デバイスごとに異なります。IDはゲストログインのようになります。

  • リージョンまたは環境：CXone Mpower展開がホストされている場合の世界でのロケーションです。 これは次のいずれかになります：オーストラリア(AU1)、カナダ(CA1)、欧州(EU1)、日本(JP1)、北米(NA1)、英国(UK1)。 開発者は、CXone Mpowerシステムがホストされている場合と同じリージョンを使用する必要があります。そうでない場合、チャット接続は拒否されます。

  • コンタクト、顧客、ユーザー：これらの用語はすべて、モバイルのエンドユーザーを参照しますアプリ。 オンラインヘルプでは通常、コンタクトという用語を使用しています。 SDKのドキュメンテーションやコードコメントでは、顧客やユーザーを目にする可能性が高いです。

  • CXone Mpower：CXone Mpowerが提供するすべてのカスタマーエクスペリエンスツールを管理し、アクセスする場合のコアプラットフォーム。 モバイルアプリで提供したいチャット機能に応じて、必要なユーザーアカウント権限を持つ管理者がCXone Mpowerでいくつかの設定タスクを完了する必要があります。

  • Digital Experience：デジタルチャンネルに関するすべてを管理できる場合のCXone Mpowerのセクション。