モバイルチャットのプッシュ通知を有効にする - Amazon Connect

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

モバイルチャットのプッシュ通知を有効にする

モバイルチャットのプッシュ通知は、AWS End User Messaging で設定します。iOS または Android デバイスでモバイルチャットのプッシュ通知を有効にすると、モバイルアプリケーションをアクティブに使用していない場合でも、新しいメッセージについて顧客に警告できます。この機能は、Amazon Connect モバイル SDKウェブビューソリューション、またはカスタムネイティブソリューションと統合された既存のアプリケーションで有効にできます。

次のステップとリソースは、ネイティブモバイルアプリケーションに Amazon Connect プッシュ通知を統合する際に役立ちます。

ステップ 1: Apple の APNs と Google の FCM コンソールから認証情報を取得する

アプリにプッシュ通知を送信できるように Amazon Connect を設定するには、まず Apple の APNs と Google の FCM コンソールから認証情報を取得する必要があります。これにより、AWS End User Messaging でモバイルアプリケーションに通知を送信できるようになります。提供する認証情報は、使用するプッシュ通知システムによって異なります。

ステップ 2: AWS コンソールを使用して AWS End User Messaging サービスアプリケーションを作成し、FCM または APNs のプッシュ通知チャネルを有効にする

Amazon Connect がプッシュ通知を送信できるようにするには、まずAWS End User Messaging アプリケーションを作成し、AWS コンソール でプッシュ通知チャネルを有効にする必要があります。

アプリケーションを作成し、いずれかのプッシュチャネルを有効にするには、次の手順に従います。この手順を完了するには、アプリケーション名を入力するだけです。プッシュチャネルは、後で有効または無効にできます。

  1. AWS End User Messaging Push コンソール (https://console.aws.amazon.com/push-notifications/) を開きます。

  2. [アプリケーションを作成] を選択します。

  3. [アプリケーション名] に、アプリケーションの名前を入力します。

  4. (オプション) このオプションのステップに従って、Apple Push Notification service (APNs) を有効にします。

    1. Apple Push Notification Service (APNs)[有効化] を選択します。

    2. [デフォルトの認証タイプ] で、次のいずれかを選択します。

      1. [キー認証情報] を選択した場合、Apple デベロッパーアカウントから以下の情報を提供してください。AWSEnd User Messaging Push では、認証トークンを作成するためにこの情報が必要です。

        1. [Key ID] – 署名キーに割り当てられた ID。

        2. [Bundle identifier] – iOS アプリケーションに割り当てられた ID。

        3. [Team identifier] – Apple デベロッパーアカウントチームに割り当てられた ID。

        4. [Authentication key] – 認証キーを作成するときに Apple デベロッパーアカウントからダウンロードする .p8 ファイル。

      2. [Certificate credentials] を選択した場合は、次の情報を入力します。

        1. [SSL certificate] – TLS 証明書の .p12 ファイル。

        2. Certificate password – 証明書にパスワードを指定している場合は、そのパスワードをここに入力します。

        3. [証明書タイプ] – 使用する証明書の種類を選択します。

  5. (オプション) このオプションのステップに従って、Firebase Cloud Messaging (FCM) を有効にします。

    1. Firebase Cloud Messaging (FCM)[有効] を選択します。

    2. [デフォルトの認証タイプ] で [トークン認証情報] を選択し、サービス JSON ファイルを選択します。

  6. [アプリケーションを作成] を選択します。

ステップ 3: AWS End User Messaging アプリケーションをAmazon Connectインスタンスに関連付ける

Amazon Connect インスタンスでプッシュ通知を有効にするには、CreateIntegrationAssociation API を PINPOINT_APP IntegrationType で呼び出して、AWS End User Messaging アプリケーションをAmazon Connectインスタンスに関連付ける必要があります。この API は、AWS CLIまたは Amazon Connect SDK を使用して、サポートされている任意の言語で呼び出すことができます。これは、AWS End User Messaging アプリケーションと Amazon Connect インスタンス間の各統合に必要な 1 回限りのオンボーディングステップです。

ステップ 4: FCM または APNs SDK を使用してデバイストークンを取得し、Amazon Connect に登録する

デバイストークンを取得し、これを使用してエンドユーザーのモバイルデバイスを Amazon Connect チャットコンタクトに登録して、チャット内の新しいメッセージのプッシュ通知を送信する必要があります。デバイストークンの生成方法とモバイルアプリケーションからの取得方法については、以下の FCM/APNs デベロッパードキュメントを参照してください。

チャットコンタクトにデバイスを登録するには、以下を実行することをお勧めします。

  1. モバイルアプリケーションが StartChatContact API を呼び出すときに、deviceTokendeviceTypeコンタクト属性として渡します。ウェブビューおよびホスト通信ウィジェットのユーザーの詳細については、「「通信ウィジェットにコンタクト属性を渡す方法」を参照してください。

  2. コンタクトフローの Lambda 関数に CreatePushNotificationRegistration アクションへの呼び出しを埋め込みます。フローブロックは、ユーザー定義のコンタクト属性から deviceTokendeviceType を読み、システム属性から initialContactId を読み取って、これらの値を Lambda 関数に渡します。

    1. ユースケースに応じて、エンドユーザーに即座にプッシュ通知を受信させる場合は、チャットの開始直後 (フローの開始時) に Lambda 関数を配置し、エージェントが参加しようとしているときにのみコンタクトを受信できるようにするには、コンタクトをキューにルーティングする直前に Lambda 関数を配置します。API コールが行われると、エージェントまたはシステムから新しいメッセージが送信されたときに、デバイスはプッシュ通知の受信を開始します。デフォルトでは、プッシュ通知はすべてのシステムメッセージとエージェントメッセージで送信されます。

      Amazon Connect 管理ウェブサイトのフローデザイナーで Lambda 関数フローブロックを呼び出します。
  1. (オプション) フローの Lambda 関数で DeletePushNotificationRegistration アクションへの呼び出しを埋め込みます。API コールが行われると、エージェントまたはシステムから新しいメッセージが送信されたときに、デバイスはプッシュ通知の受信を停止します。

ステップ 5: モバイルアプリケーションでプッシュ通知を受信する

Amazon Connect Chat UI Examples プロジェクトを確認し、プッシュ通知をオンボードおよび受信するために Amazon Connect API を統合する方法を示すサンプルの iOS および Android チャットウェブビューの例を参照してください。

プッシュ通知の使用状況をモニタリングする

プッシュ通知の信頼性、可用性、パフォーマンスを確保するには、その使用状況をモニタリングすることが重要です。この情報は、複数のチャネルで追跡できます。

  1. AWS には、プッシュ通知用の包括的なモニタリングツールが用意されています。詳細については、「AWS End User Messaging Push のモニタリング」を参照してください。

  2. 使用しているプッシュ通知サービスに応じて、それぞれのコンソールで追加の使用状況データにアクセスできます。

    1. Firebase Cloud Messaging (FCM): FCM の使用状況に関するインサイトについては、FCM ドキュメントの「メッセージ配信について」を参照してください。

    2. Apple Push Notification service (APNs): 通知ステータスをモニタリングする方法については、APNs ドキュメントの「Viewing the status of push notifications using Metrics and APNs」セクションを参照してください。