

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 모바일 채팅에 대한 푸시 알림 활성화
<a name="enable-push-notifications-for-mobile-chat"></a>

모바일 채팅에 대한 푸시 알림은 [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)을 통해 구성됩니다. iOS 또는 Android 디바이스에서 모바일 채팅에 대한 푸시 알림을 활성화하여 모바일 애플리케이션을 적극적으로 사용하지 않는 경우에도 고객에게 새 메시지를 알릴 수 있습니다. [Connect Customer 모바일 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) 또는 사용자 지정 네이티브 솔루션과 통합된 기존 앱에서 이 기능을 활성화할 수 있습니다.

 다음 단계와 리소스는 Connect Customer 푸시 알림을 기본 모바일 애플리케이션에 통합하는 데 도움이 됩니다.

## 1단계: Apple의 APN 및 Google의 FCM 콘솔에서 자격 증명 가져오기
<a name="step-1-enable-push-notifications-for-mobile-chat"></a>

앱에 푸시 알림을 보낼 수 Connect Customer 있도록를 설정하려면 먼저 [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)이 모바일 애플리케이션에 알림을 보낼 수 있도록 Apple의 APNs 및 Google의 FCM 콘솔에서 자격 증명을 얻어야 합니다. 제공한 자격 증명은 사용하는 푸시 알림 시스템에 따라 다릅니다.
+  Apple 푸시 알림 서비스(APN) 자격 증명은 Apple 개발자 설명서의 [Apple에서 암호화 키 및 키 ID 가져오기](https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns#Obtain-an-encryption-key-and-key-ID-from-Apple) 및 [Apple에서 공급자 인증서 가져오기](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns#Obtain-a-provider-certificate-from-Apple)를 참조하세요.
+  Firebase 콘솔을 통해 얻을 수 있는 Google의 Firebase Cloud Messaging(FCM) 자격 증명은 [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging)을 참조하세요.

## 2단계: AWS 콘솔을 사용하여 AWS End User Messaging 서비스 애플리케이션 생성 및 FCM 또는 APNs에 대한 푸시 알림 채널 활성화
<a name="step-2-enable-push-notifications-for-mobile-chat"></a>

 Amazon Connect에서 푸시 알림을 전송하도록 활성화하려면 먼저 [AWS Console](https://console.aws.amazon.com/push-notifications/)에서 [AWS End User Messaging 애플리케이션을 생성하고 푸시 알림 채널을 활성화](https://docs.aws.amazon.com/push-notifications/latest/userguide/procedure-enable-push.html)해야 합니다.

 다음 지침에 따라 애플리케이션을 생성하고 푸시 채널을 활성화합니다. 이 절차를 완료하려면 애플리케이션 이름만 입력하면 됩니다. 나중에 푸시 채널을 활성화하거나 비활성화할 수 있습니다.

1.  [https://console.aws.amazon.com/push-notifications/](https://console.aws.amazon.com/push-notifications/) AWS 최종 사용자 메시징 푸시 콘솔을 엽니다.

1.  **애플리케이션 생성**을 선택합니다.

1.  **애플리케이션 이름**에 애플리케이션의 이름을 입력합니다.

1.  (선택 사항)이 선택적 단계에 따라 **Apple 푸시 알림 서비스(APN)**를 활성화합니다.

   1.  **Apple 푸시 알림 서비스(APN)**에 대해 **활성화**를 선택합니다.

   1.  **기본 인증 유형**에서 다음 중 하나를 선택합니다.

      1.  **키 자격 증명을** 선택하는 경우 Apple 개발자 계정에서 다음 정보를 제공합니다. 인증 토큰을 구성하려면 AWS End User Messaging Push에이 정보가 필요합니다.

         1.  **키 ID** - 서명 키에 할당된 ID입니다.

         1.  **번들 식별자** - iOS 앱에 할당된 ID입니다.

         1.  **팀 식별자** – Apple 개발자 계정 팀에 할당된 ID입니다.

         1.  **인증 키** - 인증 키를 생성할 때 Apple 개발자 계정에서 다운로드하는 .p8 파일입니다.

      1.  **인증서 자격 증명**을 선택한 경우 다음 정보를 제공합니다.

         1.  **SSL 인증서** – TLS 인증서용 .p12 파일입니다.

         1.  **인증서 암호** - 인증서에 암호를 할당했으면 여기에 입력합니다.

         1.  **인증서 유형** - 사용할 인증서 유형을 선택합니다.

1.  (선택 사항) 이 선택적 단계에 따라 **Firebase Cloud Messaging(FCM)**을 활성화합니다.

   1.  **Firebase Cloud Messaging(FCM)**에서 **활성화**를 선택합니다.

   1.  **기본 인증 유형**에서 **토큰 자격 증명**을 선택한 다음 서비스 JSON 파일을 선택합니다.

1.  **애플리케이션 생성**을 선택합니다.

## 3단계: AWS End User Messaging 애플리케이션을 Connect Customer 인스턴스와 연결
<a name="step-3-enable-push-notifications-for-mobile-chat"></a>

 [Connect Customer 인스턴스](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 End User Messaging 애플리케이션을 [Connect Customer 인스턴스](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html)와 연결해야 합니다. 지원되는 언어에 대해 [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/connect/create-integration-association.html) 또는 [Amazon Connect SDK](https://aws.amazon.com/developer/tools/)를 사용하여 이 API를 직접적으로 호출할 수 있습니다. 이 단계는 AWS End User Messaging 애플리케이션과 Connect Customer 인스턴스 간의 각 통합에 필요한 일회성 온보딩 단계입니다.

## 4단계: FCM 또는 APNs로 디바이스 토큰 가져오기 및에 등록 Connect Customer
<a name="step-4-enable-push-notifications-for-mobile-chat"></a>

디바이스 토큰을 가져와 채팅 연락처에 최종 사용자 모바일 디바이스를 등록하여 Connect Customer 채팅의 새 메시지에 대한 푸시 알림을 전송하려면이 토큰을 사용해야 합니다. 모바일 애플리케이션에서 디바이스 토큰을 생성하고 가져오는 방법은 아래 FCM/APNs 개발자 설명서를 참조하세요.
+  Apple 푸시 알림 서비스(APN)의 경우 Apple 개발자 설명서의 [APN으로 앱 등록](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_CreatePushNotificationRegistration.html) 작업에 대한 직접 호출을 포함합니다. 흐름 블록은 사용자 정의 고객 응대 속성에서 `deviceToken` 및 `deviceType`을 읽고 시스템 속성에서 `initialContactId`를 읽은 다음 이러한 값을 Lambda 함수에 전달해야 합니다.

   1.  사용 사례에 따라 최종 사용자가 푸시 알림을 즉시 수신하도록 하려면 채팅을 시작한 직후(흐름 시작 시) 또는 에이전트가 참여하려고 할 때만 고객 응대를 수신하도록 고객 응대를 대기열로 라우팅하기 직전에 Lambda 함수를 배치합니다. API 직접 호출이 이루어지면 에이전트 또는 시스템에서 새 메시지가 올 경우 디바이스가 푸시 알림을 수신하기 시작합니다. 기본적으로 모든 시스템 및 에이전트 메시지에 대해 푸시 알림이 전송됩니다.  
![Connect Customer 관리자 웹 사이트 흐름 디자이너에서 Lambda 함수 흐름 블록을 간접적으로 호출합니다.](http://docs.aws.amazon.com/ko_kr/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_DeletePushNotificationRegistration.html) 작업에 대한 직접 호출을 포함합니다. API 직접 호출이 이루어지면 에이전트 또는 시스템에서 새 메시지가 올 경우 디바이스가 푸시 알림 수신을 중지합니다.

## 5단계: 모바일 애플리케이션에서 푸시 알림 수신
<a name="step-5-enable-push-notifications-for-mobile-chat"></a>

 [Connect Customer 채팅 UI 예제](https://github.com/amazon-connect/amazon-connect-chat-ui-examples) 프로젝트를 확인하고 푸시 알림을 온보딩하고 수신하기 위해 API를 통합하는 방법을 보여주는 샘플 [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) 채팅 웹 보기 예제를 참조하세요. Connect Customer APIs 

## 푸시 알림 사용량 모니터링
<a name="monitor-your-usage-for-push-notification"></a>

 푸시 알림의 신뢰성, 가용성 및 성능을 보장하려면 사용량을 모니터링하는 것이 중요합니다. 여러 채널을 통해 이 정보를 추적할 수 있습니다.

1.  AWS 는 푸시 알림을 위한 포괄적인 모니터링 도구를 제공합니다. 자세한 내용은 [AWS 최종 사용자 메시징 푸시 모니터링을](https://docs.aws.amazon.com/push-notifications/latest/userguide/monitoring-overview.html) 참조하세요.

1.  사용 중인 푸시 알림 서비스에 따라 해당 콘솔을 통해 추가 사용 데이터에 액세스할 수 있습니다.

   1.  Firebase Cloud Messaging(FCM) : FCM 사용량에 대한 인사이트는 [메시지 전송 이해](https://firebase.google.com/docs/cloud-messaging/understand-delivery?platform=android)에 대한 FCM 설명서를 참조하세요.

   1.  Apple 푸시 알림 서비스(APN) : [지표 및 APN을 사용하여 푸시 알림 상태 보기](https://developer.apple.com/documentation/usernotifications/viewing-the-status-of-push-notifications-using-metrics-and-apns)의 APN 설명서 섹션을 검토하여 알림 상태를 모니터링합니다.