Pushmeldingen naar individuele gebruikers sturen

Bijgewerkt op 20. december 2023 door Jan Bunk


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.
  1. Je gebruiker John opent de app.
  2. Je website roept de javascript functie getNotificationToken aan die het push notificatie token van de app toepassing teruggeeft.
  3. Je website slaat het token op (bijvoorbeeld in de vermelding van John in je gebruikersdatabank).
  4. 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).

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
    Dit betekent dat oude meldingstokens van een gebruiker misschien niet meer geldig zijn, dus moet je de tokens regelmatig opslaan. In het geval dat je dezelfde gebruiker wilt ondersteunen om je app op meerdere apparaten te gebruiken, moet je voor elke gebruiker meerdere tokens opslaan.
  • 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.