Che cos'è Event Notifications?

Event Notifications è un servizio di routing delle notifiche di eventi che notifica gli eventi critici che si verificano nell'account IBM Cloud o attiva azioni automatiche 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.

Creare un'istanza del servizio Event Notifications

• Accedi al tuo accountIBM Cloud.
• Nel catalogo IBM Cloud, cerca Event Notifications > Event Notifications.
• Selezionare un Region dall'elenco di regioni supportate e selezionare un pricing plan.
• Fornire un 'Service name.
• Selezionare un 'resource group.
• Accettare i termini e gli accordi di licenza facendo clic sulla check box.
• Fare clic su 'Create.

Aggiungi un'origine API generica

Effettuare le seguenti operazioni:

• Vai alla sezione Sources del dashboard Event Notifications.
• Fare clic su Add e selezionare un'origine API.
• Immettere un nome e una descrizione facoltativa e fare clic su Add.

Crea una destinazione Event Notifications

Fai clic Destinations nella console Event Notifications e aggiungi i seguenti dettagli di destinazione:

• Name: aggiungere un nome per la destinazione.
• Description: aggiungere una descrizione facoltativa per la destinazione.
• Type: selezionare il tipo Firefox Push Notifications dall'elenco a discesa.
• Selezionare un piano di destinazione: destinazione di pre - produzione o destinazione di produzione.
  • Pre-production destination- seleziona questa destinazione come destinazione push a basso costo, per i tuoi ambienti di sviluppo e test.
  • Production destination- utilizza la funzionalità completa di questa destinazione. Dispositivi illimitati e messaggi in uscita consentiti.
• Fornite l'URL del vostro sito web.
• Fai clic su Aggiungi.
• Una volta creata la destinazione Firefox. Modificare la destinazione creata per ottenere public vapId key richiesto per il web sdk.

Crea un argomento Event Notifications

Selezionare Topics nella console Event Notifications e fare clic su Create. Immettere i seguenti dettagli argomento:

• Name: immettere un nome per l'argomento.
• Description: aggiungere una descrizione facoltativa per l'argomento.
• Source: selezionare un'origine dall'elenco a discesa.
• Event type: selezionare il tipo di evento dall'elenco a discesa.
• Event sub type: selezionare un tipo secondario di evento dall'elenco a discesa del tipo secondario di evento.
• Severity: selezionare la severità dall'elenco a discesa della severità.
• Advanced conditions: scrivi le tue proprie condizioni personalizzate, che devono seguire le specifiche jsonpath.

Crea una sottoscrizione Event Notifications

Fai clic su Subscriptions nella console Event Notifications. Immettere i dettagli della sottoscrizione riportati di seguito:

• Click Crea per visualizzare la procedura guidata di sottoscrizione.
• Completare le seguenti informazioni di sottoscrizione:
  • Subscription name: nome della sottoscrizione.
  • Subscription description: aggiungere una descrizione facoltativa.
• Nella sezione Subscribe to a topic, selezionare un argomento dall'elenco a discesa e selezionare una destinazione dall'elenco a discesa di destinazione.
• Destination type: selezionare il tipo in Destination e fare clic su Add.

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.

• Modificare il file manifest_Website.json

  {
     "name": "YOUR_WEBSITE_NAME"
  }
  

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

• Includere il 'manifest.json nel tag '<head> del 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 Event Notifications. ad es. us-south,eu-gb, au-syd, eu-de e eu-es.

  • deviceId: facoltativo deviceId per la registrazione del dispositivo.

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

  • Registrati senza UserId:

    enPush.register(function(response) {
       alert(response.response)
    })
    

  • Registrarsi con 'UserId. Per la notifica basata su userId, il metodo di registrazione accetterà un altro parametro - userId.

    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. Dopo aver sottoscritto un particolare tag, il dispositivo 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.