翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# モバイルチャットのプッシュ通知を有効にする
モバイルチャットのプッシュ通知は、[AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html) で設定します。iOS または Android デバイスでモバイルチャットのプッシュ通知を有効にすると、モバイルアプリケーションをアクティブに使用していない場合でも、新しいメッセージについて顧客に警告できます。この機能は、[Amazon Connect モバイル SDK](https://docs.aws.amazon.com/connect/latest/adminguide/integrate-chat-with-mobile.html)、[ウェブビューソリューション](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples)、またはカスタムネイティブソリューションと統合された既存のアプリケーションで有効にできます。
次の手順とリソースは、ネイティブモバイルアプリケーションへの Amazon Connect プッシュ通知の統合を開始するのに役立ちます。
## ステップ 1: Apple の APNs と Google の FCM コンソールから認証情報を取得する
アプリにプッシュ通知を送信 Amazon Connect できるように を設定するには、まず Apple の APNs と Google の FCM コンソールから認証情報を取得する必要があります。これにより、[AWS エンドユーザーメッセージング](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)がモバイルアプリケーションに通知を送信できるようになります。提供する認証情報は、使用するプッシュ通知システムによって異なります。
+ Apple Push Notification service (APNs) 認証情報については、Apple デベロッパードキュメントの「[Obtain an encryption key and key ID from Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns#Obtain-an-encryption-key-and-key-ID-from-Apple)」および「[Obtain a provider certificate from Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns#Obtain-a-provider-certificate-from-Apple)」を参照してください。
+ Google の Firebase Cloud Messaging (FCM) 認証情報は、Firebase コンソールから取得できます ([「Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging)」を参照)。
## ステップ 2: AWS コンソールを使用して AWS エンドユーザーメッセージングサービスアプリケーションを作成し、FCM または APNs のプッシュ通知チャネルを有効にする
Amazon Connect がプッシュ通知を送信できるようにするには、まず[AWS End User Messaging アプリケーションを作成](https://docs.aws.amazon.com/push-notifications/latest/userguide/procedure-enable-push.html)し、[AWS コンソール](https://console.aws.amazon.com/push-notifications/) でプッシュ通知チャネルを有効にする必要があります。
アプリケーションを作成し、いずれかのプッシュチャネルを有効にするには、次の手順に従います。この手順を完了するには、アプリケーション名を入力するだけです。プッシュチャネルは、後で有効または無効にできます。
1. [https://console.aws.amazon.com/push-notifications/](https://console.aws.amazon.com/push-notifications/) で AWS エンドユーザーメッセージングプッシュコンソールを開きます。
1. [**アプリケーションを作成**] を選択します。
1. **[アプリケーション名]** に、アプリケーションの名前を入力します。
1. (オプション) このオプションのステップに従って、**Apple Push Notification service (APNs)** を有効にします。
1. **Apple Push Notification Service (APNs)** で **[有効化]** を選択します。
1. **[デフォルトの認証タイプ]** で、次のいずれかを選択します。
1. **キー認証情報**を選択した場合は、Apple 開発者アカウントから次の情報を入力します。 AWS エンドユーザーメッセージングプッシュでは、認証トークンを構築するためにこの情報が必要です。
1. [**Key ID**] – 署名キーに割り当てられた ID。
1. [**Bundle identifier**] – iOS アプリケーションに割り当てられた ID。
1. [**Team identifier**] – Apple デベロッパーアカウントチームに割り当てられた ID。
1. [**Authentication key**] – 認証キーを作成するときに Apple デベロッパーアカウントからダウンロードする .p8 ファイル。
1. [**Certificate credentials**] を選択した場合は、次の情報を入力します。
1. [**SSL certificate**] – TLS 証明書の .p12 ファイル。
1. **Certificate password** – 証明書にパスワードを指定している場合は、そのパスワードをここに入力します。
1. **[証明書タイプ]** – 使用する証明書の種類を選択します。
1. (オプション) このオプションのステップに従って、**Firebase Cloud Messaging (FCM)** を有効にします。
1. **Firebase Cloud Messaging (FCM)** で **[有効]** を選択します。
1. [デフォルトの認証タイプ] で **[トークン認証情報]** を選択し、サービス JSON ファイルを選択します。
1. [**アプリケーションを作成**] を選択します。
## ステップ 3: AWS エンドユーザーメッセージング アプリケーションを Amazon Connect インスタンスに関連付ける
[Amazon Connect インスタンス](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html)でプッシュ通知を有効にするには、 [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html) API を `PINPOINT_APP` [IntegrationType](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html#API_CreateIntegrationAssociation_RequestSyntax) で呼び出して、 AWS エンドユーザーメッセージングアプリケーションを[Amazon Connect インスタンス](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html)に関連付ける必要があります。この API は、[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/connect/create-integration-association.html)または [Amazon Connect SDK](https://aws.amazon.com/developer/tools/) を使用して、サポートされている任意の言語で呼び出すことができます。これは、 AWS エンドユーザーメッセージングアプリケーションと Amazon Connect インスタンスの統合ごとに必要な 1 回限りのオンボーディングステップです。
## ステップ 4: FCM または APNs を使用してデバイストークンを取得し、 に登録する Amazon Connect
デバイストークンを取得し、これを使用してエンドユーザーのモバイルデバイスを Amazon Connect チャット連絡先に登録して、チャットで新しいメッセージのプッシュ通知を送信する必要があります。デバイストークンの生成方法とモバイルアプリケーションからの取得方法については、以下の FCM/APNs 開発者ドキュメント を参照してください。
+ Apple Push Notification service (APNs) については、Apple デベロッパードキュメントの「[Registering your app with APNs](https://developer.apple.com/documentation/usernotifications/registering-your-app-with-apns)」を参照してください。
+ Firebase Cloud Messaging (FCM) については、「[FCM 登録トークン管理のベストプラクティス](https://firebase.google.com/docs/cloud-messaging/manage-tokens)」を参照してください。
チャットコンタクトにデバイスを登録するには、以下を実行することをお勧めします。
1. モバイルアプリケーションが [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) API を呼び出すときに、`deviceToken` と `deviceType` を[コンタクト属性](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes)として渡します。ウェブビューおよびホスト通信ウィジェットのユーザーの詳細については、「[「通信ウィジェットにコンタクト属性を渡す方法](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html#how-to-contact-attributes-chatwidget)」を参照してください。
1. コンタクトフローの Lambda 関数に [CreatePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html) アクションへの呼び出しを埋め込みます。フローブロックは、ユーザー定義のコンタクト属性から `deviceToken` と `deviceType` を読み、システム属性から `initialContactId` を読み取って、これらの値を Lambda 関数に渡します。
1. ユースケースに応じて、エンドユーザーに即座にプッシュ通知を受信させる場合は、チャットの開始直後 (フローの開始時) に Lambda 関数を配置し、エージェントが参加しようとしているときにのみコンタクトを受信できるようにするには、コンタクトをキューにルーティングする直前に Lambda 関数を配置します。API コールが行われると、エージェントまたはシステムから新しいメッセージが送信されたときに、デバイスはプッシュ通知の受信を開始します。デフォルトでは、プッシュ通知はすべてのシステムメッセージとエージェントメッセージで送信されます。
![\[Amazon Connect 管理ウェブサイトのフローデザイナーで Lambda 関数フローブロックを呼び出します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-4-set-up-push-notifications-for-mobile-chat-1.png)
1. (オプション) フローの Lambda 関数で [DeletePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html) アクションへの呼び出しを埋め込みます。API コールが行われると、エージェントまたはシステムから新しいメッセージが送信されたときに、デバイスはプッシュ通知の受信を停止します。
## ステップ 5: モバイルアプリケーションでプッシュ通知を受信する
Chat [Amazon Connect UI Examples](https://github.com/amazon-connect/amazon-connect-chat-ui-examples) プロジェクトを確認し、プッシュ通知をオンボードおよび受信するために Amazon Connect APIs を統合する方法を紹介する [iOS](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/iOS-WKWebView-sample) および [Android](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/android-webview-sample) チャットウェブビューのサンプル例を参照してください。
## プッシュ通知の使用状況をモニタリングする
プッシュ通知の信頼性、可用性、パフォーマンスを確保するには、その使用状況をモニタリングすることが重要です。この情報は、複数のチャネルで追跡できます。
1. AWS には、プッシュ通知用の包括的なモニタリングツールが用意されています。 詳細については、[AWS 「エンドユーザーメッセージングプッシュのモニタリング](https://docs.aws.amazon.com/push-notifications/latest/userguide/monitoring-overview.html)」を参照してください。
1. 使用しているプッシュ通知サービスに応じて、それぞれのコンソールで追加の使用状況データにアクセスできます。
1. Firebase Cloud Messaging (FCM): FCM の使用状況に関するインサイトについては、FCM ドキュメントの「[メッセージ配信について](https://firebase.google.com/docs/cloud-messaging/understand-delivery?platform=android)」を参照してください。
1. Apple Push Notification service (APNs): 通知ステータスをモニタリングする方法については、APNs ドキュメントの「[Viewing the status of push notifications using Metrics and APNs](https://developer.apple.com/documentation/usernotifications/viewing-the-status-of-push-notifications-using-metrics-and-apns)」セクションを参照してください。