Che cos'è Event Notifications?

Event Notifications è un servizio di instradamento delle notifiche che ti avvisa in caso di eventi critici che si verificano nel tuo account IBM Cloud o che attiva azioni automatizzate tramite webhook. Puoi filtrare e instradare le notifiche di eventi da IBM Cloud servizi come Availability Monitoring, a email, SMS, notifiche di push e webhook.

In che modo i client utilizzano le notifiche push web Firefox ?

Il diagramma riportato di seguito mostra come i client utilizzano Firefox Web Push Notifications.

Obiettivi

Questa esercitazione ti mostra come inviare le notifiche di push come segue:

• Crea un sito web con Event Notifications.
• Ottieni le credenziali web Firefox.
• Scarica l'SDK e completa la configurazione delle notifiche.
• Configurare e inviare Firefox Web Push Notifications a browser.

Crea un'istanza del servizio " Event Notifications "

• Accedi al tuo accountIBM Cloud.
• Nel catalogo “ IBM Cloud ”, cerca “ Event Notifications ” > “ Event Notifications ”.
• Seleziona una regione dall'elenco delle regioni supportate e scegli un piano tariffario.
• Fornisci un nome servizio.
• Seleziona un gruppo di risorse.
• Accettare i termini e gli accordi di licenza facendo clic sulla check box.
• Fai clic su Crea.

Aggiungi un'origine API generica

Per creare una fonte API generica:

• Fare clic su "Sources" nell'istanza di " Event Notifications ".
• Fare clic su "Crea " e selezionare una fonte API nella finestra di dialogo "Crea fonte ".
• Digita un nome e, se lo desideri, una descrizione, quindi fai clic su "Crea sorgente ".

Crea una destinazione Event Notifications

Fare clic su "Destinazioni" nell'istanza di " Event Notifications " e fare clic su "Crea".

Inserisci i seguenti dettagli relativi alla destinazione nella finestra di dialogo "Crea destinazione ".

• Nome: inserisci un nome per la destinazione.
• Descrizione: aggiungi una descrizione facoltativa per la destinazione.
• Tipo: selezionare il tipo " Firefox Notifiche push " dall'elenco a discesa.
• Selezionare un piano di destinazione: destinazione di pre - produzione o destinazione di produzione.
  • Destinazione di pre-produzione: seleziona questa destinazione come destinazione di invio a basso costo per i tuoi ambienti di sviluppo e test.
  • Destinazione di produzione: sfrutta appieno le potenzialità di questa destinazione. Non vi sono limiti al numero di dispositivi e ai messaggi in uscita.
• Inserisci l' URL del tuo sito web.
• Fare clic su " Crea destinazione ".
• Una volta creata la destinazione “ Firefox ”, modificala per ottenere la chiave pubblica “ vapID ” necessaria per l’SDK web.

Crea un argomento Event Notifications

Fare clic su " Argomenti " nell'istanza di " Event Notifications " e fare clic su "Crea". Inserisci i seguenti dettagli relativi all'argomento e ai filtri nelle fasi " Dettagli argomento " e " Filtri evento ":

• Nome: inserisci un nome per l'argomento.
• Descrizione: aggiungi una descrizione facoltativa per l'argomento.
• Fonte: selezionare una fonte dall'elenco a discesa.
• Tipo di evento: selezionare il tipo di evento dall'elenco a discesa.
• Sottotipo di evento: selezionare il sottotipo di evento dall'elenco a discesa dei sottotipi di evento.
• Gravità: selezionare il livello di gravità dall'elenco a discesa "Gravità".
• Condizioni avanzate: crea le tue condizioni personalizzate, che devono rispettare le specifiche di JSONPath. Le espressioni Jsonpath possono essere convalidate in jsonpath.com o extendsclass.com.

Crea una sottoscrizione Event Notifications

Passa alla fase “Abbonamenti ”. Fare clic su Crea e inserire i seguenti dettagli dell'abbonamento nella finestra di dialogo Crea abbonamento.

• Nome dell'abbonamento: inserire un nome per l'abbonamento.
• Tipo di destinazione: selezionare il tipo di destinazione.
• Destinazione: selezionare la destinazione.

Fai clic su Crea sottoscrizione.

Configura l'SDK web Event Notifications Firefox

L'SDK web Firefox consente ai siti Web Firefox di ricevere notifiche di push. Completa la seguente procedura per installare l'SDK web Event Notifications Firefox, inizializzare l'SDK e registrarti per le notifiche per il tuo sito web.

• Per includere l'SDK nel progetto, aggiungere i file ENPushSDK.js,ENPushServiceWorker.js e manifest_Website.json alla cartella root del progetto.

• Modifica il file manifest_Website.json.

  {
     "name": "YOUR_WEBSITE_NAME"
  }
  

• Modifica il nome del file manifest_Website.json con manifest.json.

• Inserisci il tag manifest.json all’interno del tag <head> del tuo file HTML.

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

• Includi l'SDK push web IBM Cloud allo script.

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

• Completa la seguente procedura per abilitare il sito web a inizializzare l'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: Regione dell'istanza di Event Notifications. Ad esempio, us-south, eu-gb, au-syd, eu-de o eu-es.

  • deviceId: facoltativo deviceId per la registrazione del dispositivo.

• Per registrarsi alle notifiche, utilizzare l'API register() o registerWithUserId() per registrare il dispositivo presso il servizio IBM Cloud Event Notifications. Scegli una delle seguenti opzioni:

  • Registrati senza UserId:

     enPush.register(function(response) {
        alert(response.response)
     })
     ```
  * Iscriviti su `UserId`. Per le notifiche basate su ` `userId``, il metodo `register` accetta un parametro in più: ` `userId``.
  
  ```js {: codeblock}
     bmsPush.registerWithUserId("UserId",function(response) {
        alert(response.response)
     })
     ```
     `UserId` è il valore dell'identificativo utente con cui vuoi registrare i dispositivi nell'istanza del servizio push.
  
  

• L'API subscribe sottoscrive il dispositivo per una tag. Una volta che il dispositivo è stato associato a un determinato tag, può ricevere le notifiche inviate per quel tag. Aggiungi il seguente frammento di codice alla tua applicazione web per sottoscrivere un elenco di tag.

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

• Quando la configurazione è completa, esegui la tua applicazione e registrati per le notifiche di push.

Invia notifiche al dispositivo Firefox

Utilizza l'API Invia notifica per inviare la notifica di push per il dispositivo Firefox. Puoi utilizzare l'SDK admin Node o Go invece di richiamare direttamente l'API.