¿Qué es Event Notifications?

Event Notifications es un servicio de enrutamiento de notificaciones de eventos que te avisa de los eventos críticos que se producen en tu cuenta de IBM Cloud o que activa acciones automatizadas mediante webhooks. Puedes filtrar y redirigir las notificaciones de eventos de servicios de IBM Cloud, como Availability Monitoring, a correo electrónico, SMS, notificaciones push y webhooks.

¿Cómo utilizan los clientes las notificaciones de envío push web de Firefox?

El diagrama siguiente muestra cómo los clientes utilizan las notificaciones de envío web de Firefox.

Objetivos

Esta guía de aprendizaje muestra cómo enviar notificaciones de envío push de la siguiente manera:

• Cree un sitio web con Event Notifications.
• Obtener credenciales web de Firefox.
• Descargue el SDK y complete la configuración de las notificaciones.
• Configure y envíe notificaciones de envío web de Firefox a un navegador.

Crear una instancia de servicio de Event Notifications

• Inicia sesión en tu cuenta de IBM Cloud.
• En el catálogo IBM Cloud, busca Event Notifications > Event Notifications.
• Selecciona una región de la lista de regiones compatibles y elige un plan de precios.
• Proporcione un Nombre de servicio.
• Seleccione un Grupo de recursos.
• Acepte los acuerdos de licencia y los términos pulsando el recuadro de selección.
• Pulse Crear.

Añadir un origen de API genérico

Para crear una fuente de API genérica:

• Haz clic en Fuentes en la instancia de Event Notifications.
• Haz clic en Crear y selecciona una fuente de API en el cuadro de diálogo Crear fuente.
• Escribe un nombre y una descripción opcional y haz clic en Crear fuente.

Crear un destino Event Notifications

Haz clic en Destinos en la instancia de Event Notifications y haz clic en Crear.

Introduce los siguientes datos del destino en el cuadro de diálogo Crear destino.

• Nombre: introduce un nombre para el destino.
• Descripción: añade una descripción opcional para el destino.
• Tipo: selecciona el tipo Firefox en la lista desplegable de notificaciones push.
• Seleccione un plan de destino: Destino de preproducción o Destino de producción.
  • Destino de preproducción: selecciona este destino como destino de envío de bajo coste para tus entornos de desarrollo y pruebas.
  • Destino de producción: aprovecha al máximo todas las capacidades de este destino. Se permite un número ilimitado de dispositivos y mensajes salientes.
• Proporcione el URL de su sitio web.
• Haz clic en Crear destino.
• Una vez creado el destino Firefox, edítalo para obtener la clave pública vapID necesaria para el SDK web.

Crear un tema Event Notifications

Haz clic en Temas en la instancia de Event Notifications y haz clic en Crear. Introduce los siguientes detalles sobre el tema y los filtros en los pasos Detalles del tema y Filtros de eventos:

• Nombre: introduce un nombre para el tema.
• Descripción: añade una descripción opcional para el tema.
• Fuente: selecciona una fuente de la lista desplegable.
• Tipo de evento: selecciona el tipo de evento en la lista desplegable.
• Subtipo de evento: selecciona el subtipo de evento en la lista desplegable de subtipos de evento.
• Gravedad: selecciona la gravedad en la lista desplegable de gravedad.
• Condiciones avanzadas: escribe tus propias condiciones personalizadas, que deben cumplir con las especificaciones de jsonpath. Las expresiones Jsonpath pueden validarse en jsonpath.com o en extendsclass.com.

Crear una suscripción de Event Notifications

Pasa al paso Suscripciones. Haga clic en Crear e introduzca los siguientes datos de la suscripción en el cuadro de diálogo Crear suscripción.

• Nombre de la suscripción: introduce un nombre para la suscripción.
• Tipo de destino: selecciona el tipo de destino.
• Destino: selecciona el destino.

Pulse Crear suscripción.

Configurar el SDK web de Event Notifications Firefox

El SDK web de Firefox permite a los sitios web de Firefox recibir notificaciones push. Siga los pasos siguientes para instalar el SDK web de Event Notifications Firefox, inicializar el SDK y registrarse para las notificaciones de su sitio web.

• Para incluir el SDK en el proyecto, añada los archivos ENPushSDK.js, ENPushServiceWorker.js y manifest_Website.json a la carpeta raíz del proyecto.

• Edite el archivo manifest_Website.json.

  {
     "name": "YOUR_WEBSITE_NAME"
  }
  

• Cambie el nombre del archivo manifest_Website.json a manifest.json.

• Incluye el en manifest.json la etiqueta <head> de tu archivo HTML.

  <link rel="manifest" href="https://github.com/IBM/event-notifications-destination-webpush-sdk/blob/main/manifest_Website.json">
  

• Incluye el SDK de notificaciones push web de IBM Cloud en el script.

  <script src="https://github.com/IBM/event-notifications-destination-webpush-sdk/blob/main/ENPushSDK.js" async></script>
  

• Sigue los siguientes pasos para que el sitio web pueda inicializar el SDK.

  var enPush = new ENPush()
  function callback(response) {
     alert(response.response)
  }
  var initParams = {
     "instanceGUID": "<instance_guid>",
     "apikey": "<instance_apikey>",
     "region": "<region>",
     "deviceId": "<YOUR_DEVICE_ID>",
     "firefoxDestinationId": "<firefox_destination_id>",
     "firefoxApplicationServerKey": "<Firefox_VapId_public_key>"
  }
  enPush.initialize(initParams, callback)
  

  • region: Región de la instancia de Event Notifications. Por ejemplo, us-south, eu-gb, au-syd, eu-de, o eu-es.

  • deviceId: deviceId opcional para el registro de dispositivos.

• Para registrarse y recibir notificaciones, utilice la API registerWithUserId() o register() para registrar el dispositivo en el servicio IBM Cloud Event Notifications. Seleccione una de las opciones siguientes:

  • Registrarse sin UserId:

     enPush.register(function(response) {
        alert(response.response)
     })
     ```
  * Regístrate en `UserId`. Para las notificaciones `userId` basadas en, el método register acepta un parámetro más: `userId`.
  
  ```js {: codeblock}
     bmsPush.registerWithUserId("UserId",function(response) {
        alert(response.response)
     })
     ```
     `UserId` es el valor de identificador de usuario con el que desea registrar dispositivos en la instancia de servicio de envío.
  
  

• La API de subscribe suscribe el dispositivo para una etiqueta. Después de que el dispositivo esté suscrito a una etiqueta determinada, el dispositivo puede recibir notificaciones que se envían para dicho código. Añada el siguiente fragmento de código a la aplicación web para suscribirse a una lista de etiquetas.

  enPush.subscribe(tagName, function(response) {
     alert(response.response)
  })
  

• Cuando la configuración se haya completado, ejecute la aplicación y regístrese para notificaciones push.

Enviar notificaciones al dispositivo Firefox

Utilice API de notificación de envío para enviar la notificación push para el dispositivo Firefox. Puede utilizar el SDK de administración de Nodo o Go en lugar de llamar directamente a la API.