Invia notifiche push ai singoli utenti

Aggiornato il 20. dicembre 2023 da Jan Bunk


Le funzioni descritte in questa pagina richiedono un piano che includa le notifiche push.

Il concetto di base su come puoi inviare notifiche push ai singoli utenti della tua app è il seguente:

In questa guida, 'utente' si riferisce sempre ad una persona che ha un account utente sul tuo sito web.
  1. Il tuo utente John apre l'applicazione.
  2. Il tuo sito web richiama la funzione javascript getNotificationToken che restituisce il token di notifica push nel caso dell'app.
  3. Il tuo sito web memorizza il token (per esempio nella voce di John nel tuo database utenti).
  4. Quando vuoi inviare una notifica a John, richiama l'API webtoapp.design con il token e noi invieremo la notifica.

Usa la funzione Javascript

Potresti voler controllare la funzione executeWhenAppReady() del nostro helper script per le app. Assicura che il tuo sito web non cerchi di interagire con l'applicazione prima che sia pronta o quando il sito web viene caricato con un normale browser (ReferenceError, function is not defined).

Quando vuoi ottenere il token di notifica push nel caso dell'app, richiama semplicemente la funzione getNotificationToken.


<script>
    try {
        var token = (await getNotificationToken())["token"];
    }
    catch (e) {
        // Can occur if:
        // - the app couldn't connect to the native code. Should be very unlikely.
        // - the app couldn't get the push notification token, maybe because of connection issues. Should be very unlikely.
        // - push notifications are not included in your current plan
        console.log(e);
    }
</script>
    

Cose da ricordare:

  • Il token è una lunga stringa, per esempio:
  • Il token di un utente può cambiare,
    • quando lo stesso utente usa l'app su un dispositivo diverso
    • quando l'app viene disinstallata e reinstallata
    • quando i dati dell'app vengono cancellati
    Questo significa che i vecchi token di notifica di un utente potrebbero non essere più validi, quindi dovresti memorizzare regolarmente i token. Nel caso in cui tu voglia supportare lo stesso utente che usa la tua app su più dispositivi, devi memorizzare più token per ogni utente.
  • Mantieni segreti i token di notifica push.

Riferimento dell'endpoint API

Ottieni la chiave API specifica della tua app dalla dashboard.

Invia la tua chiave API come query nell'URL e il corpo della richiesta nel formato JSON.

Panoramica delle notifiche push