Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Habilitación de notificaciones push para el chat móvil
Las notificaciones push para el chat móvil se configuran desde [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html). Puede activar las notificaciones push para el chat móvil en dispositivos iOS o Android, lo que le permite alertar a los clientes sobre nuevos mensajes aunque no estén utilizando la aplicación móvil en ese momento. Puede habilitar esta función en su aplicación existente integrada con el [Amazon Connect dispositivo móvil SDKs](https://docs.aws.amazon.com/connect/latest/adminguide/integrate-chat-with-mobile.html), en una [solución de visualización web](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples) o en una solución nativa personalizada.
Los siguientes pasos y recursos te ayudarán a empezar a integrar las notificaciones Amazon Connect push en tus aplicaciones móviles nativas:
## Paso 1: Obtén las credenciales de la consola FCM de Apple APNs y Google
Para configurarla de Amazon Connect forma que pueda enviar notificaciones automáticas a tus aplicaciones, primero tienes que obtener las credenciales de la consola FCM de Apple APNs y Google, que permitirán a [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html) enviar notificaciones a tus aplicaciones móviles. Las credenciales que se proporcionan dependen del sistema de notificaciones push utilizado:
+ Para obtener información sobre las credenciales del servicio de notificaciones push de Apple (APNs), consulta [Cómo obtener una clave de cifrado y un identificador de clave de Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns#Obtain-an-encryption-key-and-key-ID-from-Apple) y cómo [obtener un certificado de proveedor de Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns#Obtain-a-provider-certificate-from-Apple) en la documentación para desarrolladores de Apple.
+ Para obtener las credenciales de Firebase Cloud Messaging (FCM) de Google, vaya a la consola de Firebase (consulte [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging)).
## Paso 2: Crea una aplicación de servicio de mensajería para el usuario AWS final mediante la AWS consola y activa el canal de notificaciones push para FCM o APNs
Antes de poder habilitar Amazon Connect para enviar notificaciones push, primero tiene que [crear una aplicación de AWS End User Messaging y habilitar el canal de notificaciones push](https://docs.aws.amazon.com/push-notifications/latest/userguide/procedure-enable-push.html) en la [consola de AWS](https://console.aws.amazon.com/push-notifications/).
Siga estas instrucciones para crear una aplicación y habilitar cualquiera de los canales push. Para completar este procedimiento, solo tiene que introducir el nombre de la aplicación. Puede habilitar o deshabilitar cualquiera de los canales push en otro momento:
1. Abre la consola push de mensajería para el usuario AWS final en [https://console.aws.amazon.com/push-notifications/](https://console.aws.amazon.com/push-notifications/)
1. Elija **Creación de aplicación**.
1. En **Nombre de la aplicación**, especifique un nombre para su aplicación.
1. (Opcional) Siga este paso opcional para activar el **servicio de notificaciones push de Apple (APNs)**.
1. Para el **servicio de notificaciones push de Apple (APNs)**, selecciona **Activar**.
1. Para **Tipo de autenticación predeterminado**, elija una de las siguientes opciones:
1. Si eliges **Credenciales clave**, proporciona la siguiente información de tu cuenta de desarrollador de Apple. AWS End User Messaging Push requiere esta información para crear los tokens de autenticación.
1. **ID de clave**: el ID asignado a la clave de firma.
1. **Identificador de paquete**: el ID que está asignado a la aplicación de iOS.
1. **Identificador de equipo**: el ID que está asignado al equipo de la cuenta de desarrollador de Apple.
1. **Clave de autenticación**: el archivo .p8 que descarga desde la cuenta de desarrollador de Apple al crear una clave de autenticación.
1. Si elige **Certificate credentials (Credenciales de certificado)**, facilite la siguiente información:
1. **SSL certificate** (Certificado SSL): archivo .p12 del certificado TLS.
1. **Contraseña de certificado**: si ha asignado una contraseña al certificado, ingrésela aquí.
1. **Tipo de certificado**: seleccione el tipo de certificado que se va a utilizar.
1. (Opcional) Siga este paso opcional para habilitar **Firebase Cloud Messaging (FCM**).
1. Para **Firebase Cloud Messaging (FCM)**, seleccione **Habilitar**.
1. Seleccione **Credenciales de token** como **Tipo de autenticación predeterminado** y elija el archivo JSON de su servicio.
1. Elija **Creación de aplicación**.
## Paso 3: Asocie la aplicación de mensajería para el usuario AWS final a una Amazon Connect instancia
Para habilitar las notificaciones push en una [Amazon Connect instancia](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html), tendrás que asociar una aplicación de mensajería para el usuario AWS final a una [Amazon Connect instancia](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html) llamando a la [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API con la `PINPOINT_APP` [IntegrationType](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html#API_CreateIntegrationAssociation_RequestSyntax). Puede llamar a esta API con [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/connect/create-integration-association.html) o con el [SDK de Amazon Connect](https://aws.amazon.com/developer/tools/) para cualquier idioma compatible. Este paso de incorporación se realiza una sola vez y es necesario para cada integración entre una aplicación de mensajería para el usuario AWS final y una Amazon Connect instancia.
## Paso 4: Obtén el token del dispositivo con FCM o el APNs SDK y regístralo en Amazon Connect
Deberás buscar el token del dispositivo y usarlo para registrar el dispositivo móvil de un usuario final con un contacto de Amazon Connect chat para enviar notificaciones automáticas cuando haya nuevos mensajes en el chat. Lee la siguiente documentación para FCM/APNs desarrolladores para saber cómo se genera y obtiene el token del dispositivo desde la aplicación móvil.
+ Para el servicio de notificaciones push de Apple (APN), consulta Cómo [registrar tu aplicación con él APNs](https://developer.apple.com/documentation/usernotifications/registering-your-app-with-apns) en la documentación para desarrolladores de Apple.
+ Para Firebase Cloud Messaging (FCM), consulte [Prácticas recomendadas para la administración de tokens de registro de FCM](https://firebase.google.com/docs/cloud-messaging/manage-tokens).
Para registrar el dispositivo con un contacto de chat, le sugerimos que haga lo siguiente:
1. Cuando la aplicación móvil llame a la [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API, transfiere la `deviceToken` y `deviceType` como [atributos de contacto](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes). Para los usuarios de visualización web y widgets de comunicación alojados, consulte [Cómo pasar los atributos de contacto al widget de comunicaciones](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html#how-to-contact-attributes-chatwidget) para obtener más información.
1. Inserte una llamada a la [CreatePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)acción en una función Lambda en un flujo de contactos. El bloque de flujo debe leer `deviceToken` y `deviceType` partir de los atributos de contacto definidos por el usuario y el `initialContactId` de los atributos del sistema; luego, debe pasar estos valores a la función de Lambda.
1. En función de su caso de uso, coloque la función de Lambda inmediatamente después de iniciar el chat (al principio del flujo) si desea que el usuario final reciba notificaciones push de inmediato, o justo antes de enrutar el contacto a una cola para que reciba el contacto solo cuando el agente esté a punto de unirse. Una vez realizada la llamada a la API, el dispositivo empezará a recibir notificaciones push cuando llegue un nuevo mensaje del agente o del sistema. De forma predeterminada, se enviarán notificaciones push para todos los mensajes del sistema y del agente.
![\[Invoque el bloque de flujo de la función de lambda en el diseñador de flujos del sitio web de administración de Amazon Connect .\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/step-4-set-up-push-notifications-for-mobile-chat-1.png)
1. (opcional) Inserte una llamada a la [DeletePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)acción en una función Lambda de un flujo. Una vez realizada la llamada a la API, el dispositivo dejará de recibir notificaciones push cuando llegue un nuevo mensaje del agente o del sistema.
## Paso 5: recepción de una notificación automática en aplicaciones móviles
Consulta nuestro proyecto de [ejemplos de interfaz de usuario de Amazon Connect chat](https://github.com/amazon-connect/amazon-connect-chat-ui-examples) y consulta nuestros ejemplos de vistas web de chat para [iOS](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/iOS-WKWebView-sample) y [Android](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/android-webview-sample) que muestran cómo integrarse Amazon Connect APIs para incorporar y recibir notificaciones push.
## Supervisión del uso de las notificaciones push
Con el fin de garantizar la fiabilidad, la disponibilidad y el rendimiento de las notificaciones push, es fundamental supervisar su uso. Puede hacer un seguimiento de esta información a través de varios canales:
1. AWS proporciona herramientas de monitoreo integrales para las notificaciones push. Para obtener más información, consulte [Supervisión de los mensajes push de los usuarios AWS finales](https://docs.aws.amazon.com/push-notifications/latest/userguide/monitoring-overview.html).
1. En función del servicio de notificaciones push que utilice, podrá acceder a datos de uso adicionales a través de sus respectivas consolas.
1. Firebase Cloud Messaging (FCM): consulte la documentación de FCM ([Información sobre la entrega de mensajes](https://firebase.google.com/docs/cloud-messaging/understand-delivery?platform=android)) para obtener más información sobre su uso de FCM.
1. Servicio de notificaciones push de Apple (APNs): consulta la sección de APNs documentación sobre cómo [ver el estado de las notificaciones push mediante las métricas y APNs](https://developer.apple.com/documentation/usernotifications/viewing-the-status-of-push-notifications-using-metrics-and-apns) cómo supervisar el estado de las notificaciones.