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

2025-05-03

Azure Notification Hubs proporciona un motor de notificaciones push que es fácil de usar y escalable. Usa Notification Hubs para enviar notificaciones a cualquier plataforma (iOS, Android, Windows) y desde cualquier backend (en la nube o en las instalaciones). Para más información, consulte ¿Qué es Azure Notification Hubs?.

En este inicio rápido, usará la configuración del sistema de notificaciones de plataforma (PNS) en Notification Hubs para configurar notificaciones push en varias plataformas. En el inicio rápido se muestran los pasos que se deben seguir al usar 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.

Servicio de notificaciones push de Apple

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.
1. 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.
2. 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.

Google Firebase Cloud Messaging V1 (FCMv1)

Para configurar las notificaciones de inserción para Google FCMv1:

En Azure Portal, en la página Centro de notificaciones, seleccione Google (FCMv1) en el menú izquierdo.
Actualice los valores de Clave privada, Id. de proyecto y Correo electrónico del cliente del archivo JSON de la cuenta de servicio que se obtuvo de la consola de Firebase.
Seleccione Guardar.

Captura de pantalla que muestra cómo configurar Notification Hubs para Google FCMv1.

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.

Google Firebase Cloud Messaging (FCM)

Nota

Firebase Cloud Messaging (FCM) ha quedado en desuso y ya no se admite.

Portal
CLI de Azure

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.

Necesita la clave de API para el proyecto 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 Introducción a 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 obtener más información, consulte 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 Autenticación en Azure mediante 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 obtener más información sobre las extensiones, consulte Uso y administración 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, la versión más reciente ya está instalada.

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\"}}"

Puede obtener 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.

Cuando complete estos pasos, una alerta indica que el centro de notificaciones se actualizó 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: