Mobile SDK

Mobile SDKでは、CXone Mpower デジタルチャットを企業の携帯電話アプリに統合することができます。 これにより、アプリユーザーは、デジタル Digital Experienceに関連するあらゆるチャネル、コンタクト、またはスキル。チャットチャンネルを通じてコンタクトセンターのエージェントやボットとチャットすることができます。 SDKは、デジタルチャットを実装するプロセスを簡素化し、開発者はビジネスロジックの実装を処理する必要がありません。 開発者の主なタスクは、プッシュ通知やCXone Mpowerリッチメッセージなど、 ボタン、画像、メニュー、オプションピッカーなど、デジタルメッセージングの要素。で設定した機能を視覚的に表示および管理することです。

SDKは、iOSとAndroid アプリの両方をサポートしています。 iOS アプリはSwift で記述しAndroid アプリKotlin で記述する必要があります。 さらに、SDK には、Android バージョン 7.0 以上、iOS バージョン 15.0 以上が必要です。

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

• LiveChatとチャットメッセージングチャネルの両方を実装することができます。
  • LiveChatはリアルタイムのメッセージングです。
  • チャットメッセージングはダイレクトメッセージ(DM)のような非同期メッセージングです。
• コンタクトは、マルチスレッド マルチスレッドのアプリでは、コンタクトは新しいトピックについて議論するために、好きなだけスレッドを作成できます。 これらのスレッドは同時にアクティブにすることができます。メッセージングを通じてコンタクトセンターと複数のインタラクションをド同時に持つことができます。 また、シングルスレッド シングルスレッドアプリでは、各連絡先に1つのチャットスレッドがあり、組織とのやり取りを処理します。構成を設定することもできます。
• リッチメディアを使用して、アプリチャットにクイック返信、リスト、リンクのようなインタラクティブメッセージを追加できます。
• コンタクトとエージェントは、ビデオやドキュメントのように添付ファイルを相互に共有することができます。
• コンタクトとエージェントは、相手がいつ入力しているかを見ることでエンゲージし続けることができます。
• 新規メッセージの到着などのイベントに基づいて、アプリ内およびプッシュ通知をトリガーすることができます。
• イベントや条件に基づいてアプリの中にコンテンツをポップアップさせるプロアクティブなルールを作成することができます。
• ウェルカムメッセージやプレチャットフォームで、コンタクトから最初の情報を収集し、インタラクションを活性化することができます。

SDKリソース

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

ブラウザー(Android iOS )でAPI参照にアクセスできます。

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

Mobile SDKのバージョン管理

SDKバージョンは通常、25.2、25.3などのメジャーマーケティングリリースとともに更新されます。CXone Mpower GitHubでは、各リリースバージョンが以下で説明するセマンティックバージョニングに従ってタグ付けされます。

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で使用することができます。

チャットUIの構築

Mobile SDKには、デフォルトのUI/UXモジュールが付属しています。 標準実装パッケージの一部として実装することを選択できます。 このデフォルトモジュールは、すべてのチャット機能を自動的に処理するため、次のような追加の開発の必要性が軽減されます。

• リッチメッセージ ボタン、画像、メニュー、オプションピッカーなど、デジタルメッセージングの要素。

• 添付

• ファイルの操作

• エラーメッセージ

• 絵文字の動作

ただし、潜在的なローカリゼーション、プッシュ通知、OAuth認証など、特定の追加設定を行うこともできます。 English以外の言語をサポートする場合は、テキスト文字列の翻訳を提供する必要があります。 非English言語を実装する場合は、UI のすべての領域をテストして、表示が適切に処理されることを確認してください。

Mobile SDKサンプルアプリケーションでは、デフォルトのUI/UXを紹介しています。 UI/UX モジュールのドキュメントは、開発者が確認できるように、モジュール自体に含まれています。

最後に、独自のUIを使用または開発することもできます。デフォルトのUI/UXを使用する義務はありません。 独自の UI (またはサードパーティの UI パッケージ) を使用している場合、NICE はサポートを提供しません。

開発を始める前に

モバイル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のセクション。