Inicio rápido: Configuración de notificaciones push en un centro de notificaciones

Artículo
08/15/2023

Azure Notification Hubs proporciona un motor de inserción que es fácil de usar y que se escala horizontalmente. Use Notification Hubs para enviar notificaciones a cualquier plataforma (iOS, Android, Windows, Baidu), desde cualquier back-end (en la nube o local). Para más información, consulte ¿Qué es Azure Notification Hubs?.

En este inicio rápido, se usará la configuración del sistema de notificación de plataforma (PNS) en Notification Hubs para configurar las notificaciones push en varias plataformas. El inicio rápido muestra los pasos a seguir en Azure Portal. Google Firebase Cloud Messaging incluye instrucciones sobre el uso de la CLI de Azure.

Nota

Para obtener información sobre los pasos de desuso y migración de Firebase Cloud Messaging, consulte Migración de Google Firebase Cloud Messaging.

Si aún no ha creado un centro de notificaciones, cree uno ahora. Para más información, consulte Creación de un centro de notificaciones de Azure en Azure Portal o Creación de un centro de notificaciones de Azure mediante la CLI de Azure.

Apple Push Notification Service

Para configurar Apple Push Notification Service (APNS):

En Azure Portal, en la página Centro de notificaciones, seleccione Apple (APNS) en el menú izquierdo.
Para Modo de autenticación, seleccione Certificado o Token.

a. Si ha seleccionado Certificado:
- Seleccione el icono de archivo, y luego el archivo .p12 que desea cargar.
- Escriba una contraseña.
- Seleccione el modo Espacio aislado. O para enviar notificaciones push a los usuarios que compraron la aplicación en la tienda, seleccione el modo Producción.
b. Si selecciona Token:
- Especifique los valores Id. de clave, Id. de agrupación, Id. de equipo y Token.
- Seleccione el modo Espacio aislado. O para enviar notificaciones push a los usuarios que compraron la aplicación en la tienda, seleccione el modo Producción.

Para más información, consulte Envío de notificaciones push a aplicaciones iOS mediante Azure Notification Hubs.

Para configurar las notificaciones push para Google FCM:

En Azure Portal, en la página Centro de notificaciones, seleccione Google (GCM/FCM) en el menú izquierdo.
Pegue la clave de API del proyecto de Google FCM que guardó anteriormente.
Seleccione Guardar.

Cuando haya completado estos pasos, una alerta le indica que el centro de notificaciones se ha actualizado correctamente. El botón Save (Guardar) está deshabilitado.

Necesitará la clave de API del proyecto de Google Firebase Cloud Messaging (FCM).

Preparación del entorno para la CLI de Azure

Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
- Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
- En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
- Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

En este artículo se necesita la versión 2.0.67 de la CLI de Azure, o cualquier versión posterior. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.

Configuración de notificaciones push para Google FCM

Use el comando az notification-hub credential gcm update para agregar la clave de API de Google al centro de notificaciones.

az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey

La aplicación Android necesita una cadena de conexión para conectar con el centro de notificaciones. Use el comando az notification-hub authorization-rule list para enumerar las directivas de acceso disponibles. Use el comando az notification-hub authorization-rule list-keys para obtener las cadenas de conexión de la directiva de acceso. Especifique el valor de primaryConnectionString o secondaryConnectionString en el parámetro --query para obtener la cadena de conexión principal directamente.

#list access policies for a notification hub
az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table

#list keys and connection strings for a notification hub access policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json

#get the primaryConnectionString for an access policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString

Use el comando az notification-hub test-send para probar el envío de mensajes a la aplicación Android.

#test with message body
az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"

#test with JSON string
az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"

Obtenga referencias de la CLI de Azure para otras plataformas con el comando az notification-hub credential.

Para más información sobre el envío de notificaciones a una aplicación Android, consulte Envío de notificaciones push a dispositivos Android mediante Firebase.

Servicios de notificaciones de inserción de Windows

Para configurar Servicios de notificaciones de inserción de Windows (WNS):

En Azure Portal, en la página Centro de notificaciones, seleccione Windows (WNS) en el menú izquierdo.
Especifique los valores de SID de paquete y Clave de seguridad.
Seleccione Guardar.

Para más información, consulte Envío de notificaciones a aplicaciones de Plataforma universal de Windows mediante Azure Notification Hubs.

Servicio de notificaciones push de Microsoft para Windows Phone

Nota

El Servicio de notificaciones push de Microsoft (MPNS) está en desuso y ya no se admite.

Para configurar el Servicio de notificaciones push de Microsoft (MPNS) para Windows Phone:

En Azure Portal, en la página Centro de notificaciones, seleccione Windows Phone (MPNS) en el menú izquierdo.
Habilite las notificaciones push sin autenticar o autenticadas:

a. Para habilitar las notificaciones push no autenticadas, seleccione Habilitar notificaciones de inserción sin autenticar>Guardar.

b. Para habilitar las notificaciones push no autenticadas:
- Seleccione Cargar certificado en la barra de herramientas.
- Seleccione el icono de archivo y el archivo de certificado.
- Escriba la contraseña del certificado.
- Seleccione Aceptar.
- En la página Windows Phone (MPNS) , seleccione Guardar.

Para más información, consulte Notificaciones push a aplicaciones de Windows Phone mediante Notification Hubs.

Baidu (Android China)

Para configurar las notificaciones push para Baidu:

En Azure Portal, en la página Centro de notificaciones, seleccione Baidu (Android China) en el menú izquierdo.
Escriba la clave de API que ha obtenido en la consola de Baidu en el proyecto Baidu Cloud Push.
Escriba la clave secreta que ha obtenido en la consola de Baidu, en el proyecto Baidu Cloud Push.
Seleccione Guardar.

Cuando haya completado estos pasos, una alerta le indica que el centro de notificaciones se ha actualizado correctamente. El botón Save (Guardar) está deshabilitado.

Para más información, consulte Introducción a Notification Hubs con Baidu.

Pasos siguientes

En este inicio rápido, ha aprendido cómo configurar los valores para los sistemas de notificaciones de distintas plataformas para un centro de notificaciones en Azure Portal.

Para más información acerca de cómo enviar notificaciones push a varias plataformas, consulte estos tutoriales:

Compartir a través de