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.
- Il tuo utente John apre l'applicazione.
- Il tuo sito web richiama la funzione javascript
getNotificationTokenche restituisce il token di notifica push nel caso dell'app. - Il tuo sito web memorizza il token (per esempio nella voce di John nel tuo database utenti).
- 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). Questa è la vecchia implementazione utilizzata nelle applicazioni create/aggiornate prima di agosto 2021.
Devi definire la funzione receivePushNotificationToken sul tuo sito web in modo che possa essere richiamata dall'applicazione. Puoi farlo come segue:
<script>
// this function automatically gets called by the app
function receivePushNotificationToken(token) {
// store the token (or whatever you want to do with it)
}
</script>
Cose da ricordare:
- L'applicazione richiamerà la funzione javascript ad ogni caricamento di pagina. È normale che a volte non farai nulla con il token, per esempio quando l'utente non è loggato e quindi non puoi memorizzare il token nel database degli utenti.
- L'app non richiamerà la funzione javascript se l'app, per qualche motivo, non può determinare il token di notifica push (molto improbabile, ma potrebbe teoricamente accadere).
- Ovviamente non tutti i visitatori del tuo sito web useranno la tua app, quindi la funzione non sarà richiamata ad ogni caricamento della pagina.
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
- 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.