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を使えば次のことが可能です：

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

SDKリソース

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

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

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

Mobile SDKバージョン管理

SDKのバージョンは、通常、25.3、25.4などの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にどのように適合するか

Mobile 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 ではサポートされません。

Mobile SDK制限

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

• NiCE外でのセットアップに関する質問については、Mobile SDKからプロフェッショナルサービス時間を購入することをお勧めします。

• SDKは、既存のモバイルアプリがないと使用できません。 KotlinまたはSwiftでネイティブに記述された独自のアプリケーションを用意する必要があります。

• React Native などの非ネイティブまたはハイブリッド フレームワークはサポートされていません。

• このSDKは、Digital経由のチャットではなく、スタンドアロンのGuideチャットで動作します。

開発を始める前に

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

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

主要用語

用語	詳細
スレッド	チャットアプリ内の会話。 エージェントまたはコンタクト コンタクトセンターでエージェント、IVR、またはボットとやり取りする人。のいずれかによって送信された最初のメッセージが、スレッドを開始します。 会話中の連続したメッセージはスレッドに追加されます。 スレッドは各メッセージを含むオブジェクトです。 メッセージはメッセージの作者によって構成されます。 threadIdは会話全体を識別し、会話内のすべてのメッセージはメッセージIDを持ちます。 会話が終わるとスレッドは終了します。
シングルスレッド	コンタクトが一度に1つの会話しかできないアプリ設計。
マルチスレッド	コンタクトが一度に複数の会話を行えるアプリ設計。
チャネル	Digital Experienceのコンテキストでは、チャネルは、メッセージングのタイプまたは通信に使用されるプラットフォームを指します。 たとえば、WhatsAppリアルタイムのメッセージングチャネルを持つことができます。 Mobile SDKは、モバイルアプリにチャットメッセージングチャネルを追加することができます。 CXone Mpowerプラットフォームにチャンネルが作成されます。 これは、チャンネルIDと一緒にチャネルの設定を決定します。 アプリユーザーがチャットを開いたときに、このIDを使用してチャットチャネルを開始します。
チャネルID	DigitalのCXone Mpowerセクションで作成されたデジタルチャットチャネルのID。 これは、CXone Mpower(ACD> Digital> ポイントオブコンタクト(PoC)デジタル> チャット> 初期化とテスト)のチャットチャンネルの設定にあります。
ブランドID	これは、の CXone Mpowerシステムにおけるテクニカルサポート、請求、およびグローバル設定を管理するために使用される上位レベルの組織グループ。テナントDigital ExperienceIDのようなものです。 これはチャットの初期化に使われます。 これは、CXone Mpower(ACD> Digital> ポイントオブコンタクト(PoC)デジタル> チャット> 初期化とテスト)のチャットチャンネルの設定にあります。
カスタマー ID	チャットエンドユーザーの一意の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のセクションで、デジタルチャネルに関するすべてを管理できます。