Voor de functies die op deze pagina worden beschreven is een abonnement met pushmeldingen vereist.
Het basisconcept over hoe je pushmeldingen naar individuele gebruikers van je app kunt sturen is als volgt:
In deze handleiding verwijst 'gebruiker' altijd naar een persoon die een gebruikersaccount op je website heeft.
- Je gebruiker John opent de app.
- Je website roept de javascript functie
getNotificationTokenaan die het push notificatie token van de app toepassing teruggeeft. - Je website slaat het token op (bijvoorbeeld in de vermelding van John in je gebruikersdatabank).
- Als je een melding naar John wilt sturen, roep je de webtoapp.design API op met het token en wij bezorgen de melding.
Gebruik van de Javascript functie
Je zou eens kunnen kijken naar de
executeWhenAppReady() functie van ons app-helper script. Het zorgt ervoor dat je website niet probeert te communiceren met de app voordat deze klaar is of wanneer je website wordt geladen met een gewone browser (ReferenceError, functie is niet gedefinieerd). Dit is de oude implementatie die gebruikt wordt in apps die gemaakt/bijgewerkt zijn vóór augustus 2021.
Je moet de functie receivePushNotificationToken op je website definiëren, zodat die door de app aangeroepen kan worden. Dat kun je als volgt doen:
<script>
// this function automatically gets called by the app
function receivePushNotificationToken(token) {
// store the token (or whatever you want to do with it)
}
</script>
Dingen om rekening mee te houden:
- De app zal de javascript functie bij elke paginaweergave aanroepen. Het is normaal dat je soms niets met het token doet, bijvoorbeeld als de gebruiker niet ingelogd is en je het token dus niet in de gebruikersdatabank kunt opslaan.
- De app zal de javascript functie niet aanroepen als de app om een of andere reden het push notificatie token niet kon bepalen (zeer onwaarschijnlijk, maar zou theoretisch kunnen gebeuren).
- Het is duidelijk dat niet elke bezoeker van je website je app zal gebruiken, dus de functie zal niet bij elke paginaweergave aangeroepen worden.
Wanneer je het push notificatie token van een app wilt krijgen, roep je eenvoudig de functie getNotificationToken op.
<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>
Dingen om rekening mee te houden:
- Het token is een lange string, bijvoorbeeld:
- Het token van een gebruiker kan veranderen,
- wanneer dezelfde gebruiker de app op een ander toestel gebruikt
- wanneer de app verwijderd en opnieuw geïnstalleerd wordt
- wanneer de gegevens van de app gewist worden
- Houd de push notification tokens geheim.
API-eindpuntverwijzing
Haal je app-specifieke API sleutel uit je app dashboard.
Stuur je API sleutel als een query in de URL en de ''request body'' in het JSON formaat.