チャットアセットを設定する

概要

Control Hubのデジタルチャネルを使用して、Web（ライブチャット）、モバイル（アプリ内メッセージング）、およびプッシュ通知用のチャットアセットを作成して設定します。設定できる設定は、割り当て先で選択したサービスと、ウェブ、モバイル、またはその両方を選択したかどうかによって異なります。

この記事では、サポートされている機能、メッセージング、プッシュプロバイダー認証情報、JSON Webトークン（JWT）認証、JSON Web Keys（JWK）、トランスポートプロトコル、マルチユーザー登録、およびアセット作成後のサービス固有の設定を含む、完全なアセット構成プロセスについて説明します。

サポートされている機能

テーブル 1.サービス別のサポート対象機能
能力	Webex Connect	Webex コンタクトセンター	Webex コンタクトセンターエンタープライズ
Web ライブチャット	サポートされています	サポートされています	サポートされています
モバイルアプリ内メッセージング	サポートされています	サポートされています	サポートされています
ウェブとモバイルを1つの資産に	サポートされています	サポートされていません	サポートされていません
モバイル-アンドロイドプッシュ通知	サポートされています	サポートされています	サポートされています
モバイル-iOSプッシュ通知	サポートされています	サポートされています	サポートされています
Web プッシュ通知	サポートされています（クロームとFirefox）	サポートされていません	サポートされていません
JWT-モバイル	サポートされています	サポートされていて必須	サポートされていて必須
JWT-ウェブ	サポートされています	サポートされていません	サポートされていません
マルチユーザー登録	サポートされています	サポートされています	サポートされています
サーバー側の受信トレイ	サポートされています	該当しません	該当しません
データストリーム	サポートされています	該当しません	該当しません

始める前に

デジタル資産を管理できるフル管理者またはコンタクトセンターの管理者としてControl Hubにサインインします。
Webex Connectデジタルサービス、Webex コンタクトセンター、またはコンタクトセンターエンタープライズが組織に提供されていることを確認してください。権利がなければ、デジタル資産は利用できません。
新しいチャット会話を受け取るコンタクトセンターのエントリポイントとフローを特定してください。
デプロイメントでモバイルプッシュ通知を使用する場合は、選択したプラットフォームで必要な Firebase、Huawei、または Apple の認証情報を準備してください。
JWT認証を使用する予定がある場合は、信頼できるバックエンドが発行したトークンを検証するために使用するパブリックJWKを用意してください。

チャットアセットを設定してください

チャットアセットを設定するには：

1	コントロールハブにサインインしてください。
2	「サービス」>「デジタル資産」に移動します。
3	[アセットを作成] を選択します。
4	「資産の詳細を設定」で、次の値を入力します。名前 (必須): 資産名を入力してください。説明:オプションでユースケースの説明を入力してください。チャンネル (必須):「チャット」を選択します。アセットが作成された後にチャンネルを変更することはできません。割り当て先 (必須): Webex コンタクトセンターWebex Connect、または Webex コンタクトセンターエンタープライズを選択してください。利用できるオプションは組織の資格によって異なります。
5	Messagingで、プラットフォームを選択し、ライブチャット/アプリ内メッセージと必要なプッシュ通知を設定します。表示されるオプションは、選択したプラットフォームによって異なります。 AndroidとiOSの通知設定は、モバイルを選択すると利用できます。 Web Pushは、割り当てられた資産でWebが選択されている場合に使用できますWebex Connect。

メッセージを設定する

Messagingで、プラットフォームを選択し、アセットのメッセージング機能を設定します。

メッセージを設定するには：

一次転送プロトコルと二次転送プロトコルは異なっていなければなりません。 SDKがプライマリプロトコルを使用して接続を確立できない場合は、フォールバックとしてセカンダリプロトコルを使用します。

1	プラットフォーム:Webex Connectでは、ウェブ、モバイル、またはその両方を選択します。モバイルの場合は、Android、iOS、またはその両方を選択してください。 Webex コンタクトセンターまたは Webex コンタクトセンターエンタープライズの場合は、Web かモバイルを選択してください。
2	ライブチャット/アプリ内メッセージング：Webex Connectでは、ウェブとモバイルで利用できます。 Webex Contact CenterまたはWebex Contact Center Enterpriseの場合、Webはライブチャットを、モバイルはアプリ内メッセージを提供します。
3	プライマリ・トランスポート・プロトコル:MQTT または Web Socket を選択してください。
4	二次転送プロトコル：プライマリとして選択されていないプロトコルを選択してください。

プッシュ通知を設定する

アプリケーションが設定されたプッシュプロバイダーを通じて通知を受信する必要があるときにプッシュ通知を許可することを有効にします。表示される通知セクションは、選択したプラットフォームによって異なります。

次のプッシュプロバイダーオプションが利用可能です。

アンドロイド：Firebaseクラウドメッセージング（FCM）、ファーウェイ、またはその両方。 Webex コンタクトセンターWebex Connect、Webex コンタクトセンターエンタープライズに適用されます。
iOS：FCM、Appleプッシュ通知サービス（APNS）、またはAPNS用のトークンベースの認証。 Webex コンタクトセンターWebex Connect、Webex コンタクトセンターエンタープライズに適用されます。
ウェブ:Firebase クラウドメッセージング。 Webex Connectにのみ適用されます。

プラットフォームを選択し、対応するトピックで適切なプロバイダーを設定します。

FirebaseサービスアカウントのJSONを取得してください

Webexは、FirebaseサービスアカウントのJSONファイルを使用して、Firebaseクラウドメッセージングへのサーバーリクエストを認証します。アプリケーションに関連付けられた Firebase プロジェクトを使用してください。

FirebaseサービスアカウントのJSONを取得してアップロードするには：

セキュリティ:FirebaseサービスアカウントのJSONには機密の認証情報が含まれています。安全に保存し、目的のFirebaseプロジェクトのファイルのみをアップロードしてください。

Firebaseクラウドメッセージングの設定手順については、「FCM HTTP v1 APIを使用してメッセージを送信する」を参照してください。

1	Firebaseコンソールを開き、アプリケーションで使用しているFirebaseプロジェクトを選択します。
2	プロジェクト設定 > サービスアカウントを開きます。
3	[新しい秘密鍵を生成] を選択して、ダウンロードを確認します。
4	ダウンロードしたJSONファイルを安全に保存してください。このファイルには秘密鍵の認証情報が含まれています。
5	コントロールハブで、該当するAndroid、iOS、またはウェブ通知設定の JSON ファイルを Firebase サービスアカウント JSON のアップロードにアップロードします。

Androidのプッシュ通知を設定してください

Android通知セクションは、モバイル、Android、プッシュ通知を許可するを選択すると表示されます。プロバイダーを少なくとも1つ選択してください。 FirebaseとHuaweiは個別に設定することも、一緒に設定することもできます。この設定は、Webex コンタクトセンターWebex Connect、 Webex コンタクトセンターのエンタープライズモバイルアセットで使用できます。

プロバイダー文書：Huawei-プッシュキットのセットアップとテスト

1	モバイル、Android、プッシュ通知を許可を選択します。 Androidの通知セクションが表示されます。
2	Firebase クラウドメッセージングを選択し、必要な Firebase サービスアカウント JSON ファイルを Firebase プロジェクトからアップロードします。
3	アプリがファーウェイモバイルサービスを使用するデバイスをサポートしている場合は、ファーウェイを選択し、AppGallery Connectからアプリ内IDとアプリ内シークレットを入力します。ファーウェイの例外：アプリがGoogle Playサービスのないデバイスをサポートしていない場合、ファーウェイの設定をスキップできます。 Webex Connect 現在のガイダンスはEMUI 10.x以降をサポートしています。

iOSプッシュ通知を設定する

iOS通知セクションは、モバイル、iOS、プッシュ通知を許可するを選択すると表示されます。プッシュプロバイダーを1つ選択してください。この設定は、Webex コンタクトセンターWebex Connect、 Webex コンタクトセンターのエンタープライズモバイルアセットで使用できます。

証明書ベースのAPNの設定手順については、「APNへの証明書ベースの接続の確立」を参照してください。

トークンベースのAPNの設定手順については、「APNへのトークンベースの接続の確立」を参照してください。

1	モバイル、iOS、プッシュ通知を許可を選択します。 iOSの通知セクションが表示されます。
2	プッシュプロバイダーを1つ選択してください。
3	Firebase クラウドメッセージングの場合は、Firebase プロジェクトからダウンロードした Firebase サービスアカウント JSON ファイルをアップロードします。
4	Appleプッシュ通知サービス（APNS）の場合は、証明書のパスワードを入力し、サンドボックスまたはプロダクションを選択し、APNS証明書をアップロードし、名前を入力して、構成を検証します。 .p12証明書形式のみがサポートされています。
5	トークンベースのAPNS認証の場合は、キーID、チームID、アプリパッケージまたはバンドルIDを入力し、サンドボックスまたはプロダクションを選択して、APNSプライベートキーファイルをアップロードします。ゲートウェイの選択：開発アプリにはサンドボックスを、本番対応アプリにはProductionを使用してください。 APNSの秘密鍵を安全に保管してください。Appleは、ダウンロードした.p8鍵ファイルを一度だけ取得することを許可しています。
6	プッシュ配信の中断を避けるため、有効期限が切れる前にAppleのプロバイダー証明書を交換してください。

Webプッシュ通知を設定する

ウェブプッシュ通知は、Webex Connectウェブを選択した状態で割り当てられたアセットでのみ利用できます。クロームとFirefoxがサポートされています。 Safariウェブプッシュは現在サポートされていません。

Webプッシュ通知は、Webex コンタクトセンターまたは Webex コンタクトセンターエンタープライズに割り当てられたアセットではサポートされていません。

ウェブプッシュ通知を設定するには：

1	Webex Connectアセットが割り当てられ、Webが選択されていることを確認してください。
2	ChromeまたはFirefoxを使ってウェブサイトにアクセスし、ウェブプッシュ通知を受け取ります。
3	ウェブサイトのURL（必須）：ウェブプッシュ通知を受け取るウェブサイトのURLを入力してください。
4	通知アイコン（必須）：通知アイコンへのパスを入力してください。アイコンは80 x 80ピクセルでなければなりません。
5	Firebaseのドキュメントに従って、ウェブアプリケーション用にFirebaseクラウドメッセージング（FCM）を設定します。
6	FirebaseサービスアカウントJSON（必須）：Firebaseクラウドメッセージング HTTP v1 APIを使用するために必要なプライベートキーを含むFirebaseサービスアカウントのJSONファイルをアップロードします。

JSON Webトークンの認証を設定してください

JWT認証では、有効なJSON Webトークンを使用してSDK通信を承認する必要があります。新しい資産の場合、暗号化タイプは非対称です。

JWTサポートは以下の通りです：

Webex Connect: 同じアセットでモバイルとウェブでサポートされています。
Webex コンタクトセンターと Webex コンタクトセンターエンタープライズ-Web: サポートされていません。
Webex コンタクトセンターと Webex コンタクトセンターエンタープライズ-モバイル:モバイルアセットの設定はサポートされており、必須です。

次の設定を行います。

暗号化タイプ：新しい資産では非対称。
トークンの有効期限（必須）：新しいユーザーIDトークンが必要になるまでにJWTが有効である期間を入力します。有効な範囲：5〜360分。デフォルト:60分。
JSON Webキー（必須）：トークンの検証に使用されるパブリックJWKをアップロードします。ローテーション用の2つ目のキーを追加できます。最大:キー2つ。

子トピックの説明に従って、公開JSON Webキーを追加して準備します。

パブリックJWKを準備してください

アップロードされたファイルには、公開のRSA検証キーが含まれている必要があります。 Webex は次の JWK プロパティを検証します。

JWKのプロパティはRFC 7517のセクション4で定義されています。アルゴリズム固有のプロパティはRFC 7518で定義されています。

テーブル 2.パブリック JWK プロパティ
プロパティ名	説明
alg	キーで使用される暗号化アルゴリズムを識別します。必要な値はRS256です。これはSHA-256を使用してRSASSA-PKCS1-を指定します。v1_5
e	RSA公開鍵の指数。base64URLUintでエンコードされた値として表されます。
key_ops	キーの対象となる操作を指定します。サポートされている値はverifyです。これは、キーがデジタル署名の検証に使用されることを示しています。 RFC 7517、セクション4.3を参照してください。
kty	キーで使用される暗号アルゴリズムファミリーを識別します。値はRSAでなければなりません。 RFC 7517、セクション4.1を参照してください。
n	RSA公開鍵のモジュラス。base64URLUintでエンコードされた値として表されます。
使用します	公開鍵の使用目的を指定します。値は sig でなければなりません。これは、そのキーが署名検証用であることを示しています。 RFC 7517、セクション4.2を参照してください。
子供です	キーを識別し、キーのローテーション時など、特定のキーとの照合に使用されます。 RFC 7517、セクション4.5を参照してください。

公開認証キーだけをアップロードしてください。対応する秘密署名鍵は、JWTを発行する信頼できるシステムに保管してください。

JSON ウェブキーを追加してください

JSON 公開ウェブキーを追加するには:

1	[キーを追加] を選択します。
2	JSON ウェブキー名を入力してください。
3	JSON Webキー発行者を入力してください。この値は、信頼できるバックエンドがJWTを生成するときに使用する発行者と一致する必要があります。
4	公開JWKファイルをアップロードしてください。
5	[保存] を選択します。

マルチユーザー登録を設定する

複数のユーザーが同じ物理デバイスに登録できる場合は、同じデバイスでの複数ユーザー登録を許可します。

プッシュ通知は、アクティブな登録ユーザーと非アクティブな登録ユーザーの両方に配信されます。
ライブチャットまたはアプリ内メッセージは、現在アクティブなユーザーに配信されます。非アクティブなユーザーへのメッセージは、ユーザーが再びアクティブになるまでキューに入れられます。

追加の Webex Connect 設定を行います

Webex Connect次の詳細設定はアセットにのみ適用され、Webex コンタクトセンターや Webex コンタクトセンターのエンタープライズアセットには適用されません。

ユーザーごとに1つのデバイス：ユーザーを1つの登録済みデバイスに制限します。新しいデバイスに登録すると、古いデバイスへのプッシュ配信が停止します。
サーバー側の受信トレイ：後で取得できるように、受信トレイデータのサーバー側のコピーを保存します。
データストリーム：Messaging APIを介して送信されるメッセージについて、Webex Connect選択したインテグレーションに該当するイベントデータを送信します。

保存してアセットを作成してください

該当するメッセージング、JWT認証、マルチユーザー登録、Webex Connectおよび設定を構成したら、設定を保存してチャットアセットを作成します。

[保存] を選択してアセットを作成します。

アセットが正常に作成されたことを確認するのを待ってください。

完全なサービス統合

チャットアセットを作成したら、「割り当て先」で選択したサービスの統合を完了します。 Webex コンタクトセンターWebex Connect、または Webex コンタクトセンターエンタープライズに適用される手順に従ってください。

Webex Connect の完全統合

に割り当てられた資産についてはWebex Connect、Webex Connectでサービスマッピングとフロー設定を完了してください。ノード認証は必要ありません。

スタートノード、カスタムイベント、またはカスタムWebhookを使用して、受信イベントをキャプチャしてフローをトリガーできます。詳細については、「スタートノード」、「カスタムイベント」、「カスタムWebhook」を参照してください。

1	Webex Connectにサインインしてください。
2	チャットアセットの該当するサービスマッピングとフロー設定を完了してください。
3	生成されたアプリIDとクライアントキーを記録してください。
4	選択した各プラットフォームのSDK設定ファイルをダウンロードしてください。

Webex コンタクトセンターの完全な統合

Webex コンタクトセンターに割り当てられたアセットについては、そのアセットをコンタクトセンターのエントリポイントにマップし、Webex コンタクトセンターのノード認証を完了してください。

1つの資産は1つのエントリポイントにのみマッピングできます。カスタマーエクスペリエンスを公開する前に、エントリーポイントとフローマッピングを完了してください。

1	コントロールハブでコンタクトセンターの設定を開きます。
2	チャットの会話を受信するエントリポイントを作成するか、開きます。
3	フローマッピングで、チャットアセットと必要な顧客入力フローを選択します。
4	エントリポイントを保存して、アセットとフローマッピングを確認します。
5	での Webex コンタクトセンターのノード認証を完了してください。Webex Connect 手順については、Webex CC タスク統合ノードとノード認証を参照してください。
6	Web展開の場合は、Live Chatウィジェットを設定し、Control HubでWebサイト埋め込みコードを取得します。

Webex コンタクトセンターのエンタープライズ統合の完全化

Webex Contact Center Enterpriseに割り当てられた資産については、Webex Connectルーティングフローを設定する前にCCEノード認証を完了してください。

1	Webex Connectにサインインしてください。
2	CCEノード認証を完了してください。手順については、CCE統合ノードとノード認証を参照してください。
3	チャットアセットの該当するCCE統合ノードとルーティングフローを設定します。フローの例については、フロー設定を参照してください。
4	フローを保存してテストしてください。

その他の設定ガイダンスについては、ベストプラクティス、ガイドライン、 FAQを参照してください。

例外と制限事項

次の例外と制限に留意してください。

アセットを作成する前に、チャネル、プラットフォーム、割り当て、ルーティングの選択を確認してください。チャンネルは作成後に変更できず、プラットフォームの変更はワークロードによって制限されます。
Webex コンタクトセンターと Webex コンタクトセンターエンタープライズでは、1 つの資産で Web とモバイルを同時に使用することはできません。両方が必要な場合は、別々のアセットを作成してください。
ウェブプッシュ通知は以下でのみ利用可能ですWebex Connect。 Safari Web Push、Webex コンタクトセンター Web プッシュ、Webex コンタクトセンターエンタープライズ Web プッシュはサポートされていません。
JWT 認証は、Webex コンタクトセンターまたは Webex コンタクトセンターエンタープライズに割り当てられた Web アセットではサポートされていません。
Webex Contact Center と Webex Contact Center Enterprise の場合は、コントロールハブのコンタクトセンターセクションでエントリポイント、フロー、ウィジェット、埋め込みコードの設定を行います。
Webex Connectでは、Webex Connectのサービスとフローの設定を完了してください。
サービスにマッピングされたチャットアセットを削除しないでください。最初にダウンストリームのマッピングを削除または更新する必要があります。削除されたアセットは復元できず、既存のマッピングが使用できなくなる可能性があります。
作成後は、適切なSDKを初期化するために必要な、生成されたアプリID、クライアントキー、SDK設定ファイルを保持してください。

Cisco AI Assistant

コメントありがとうございます。

概要