Das grundlegende Konzept, wie du Push-Benachrichtigungen an einzelne Nutzer deiner App senden kannst, ist wie folgt:
- Dein Benutzer John öffnet die App.
- Deine Webseite ruft die Javascript-Funktion
getNotificationTokenauf, die das Push-Benachrichtigungs-Token der App-Instanz zurückgibt. - Deine Webseite speichert das Token (zum Beispiel in Johns Eintrag in deiner Benutzerdatenbank).
- Wenn du eine Benachrichtigung an John senden möchtest, rufst du die webtoapp.design API mit dem Token auf und wir senden die Benachrichtigung.
Verwendung der Javascript Funktion
executeWhenAppReady() Funktion von unser App-Helfer-Skript. Es stellt sicher, dass deine Website nicht versucht, mit der App zu interagieren, bevor sie bereit ist oder wenn deine Website mit einem normalen Browser geladen wird (ReferenceError, Funktion ist nicht definiert). Dies ist die alte Implementierung, die in Apps verwendet wird, die vor August 2021 erstellt/aktualisiert wurden.
Du musst die Funktion receivePushNotificationToken auf deiner Webseite definieren, damit sie von der App aufgerufen werden kann. Dies kannst du wie folgt tun:
<script>
// this function automatically gets called by the app
function receivePushNotificationToken(token) {
// store the token (or whatever you want to do with it)
}
</script>
Dinge, die du im Hinterkopf behalten solltest:
- Die App wird die Javascript-Funktion bei jedem Pageload aufrufen. Es ist normal, dass du manchmal nichts mit dem Token machst, z. B. wenn der Benutzer nicht eingeloggt ist und du daher das Token nicht in der Benutzerdatenbank speichern kannst.
- Die App wird die Javascript Funktion nicht aufrufen, wenn die App aus irgendeinem Grund das Push Notification Token nicht ermitteln konnte (sehr unwahrscheinlich, könnte aber theoretisch passieren).
- Offensichtlich wird nicht jeder Besucher deiner Webseite deine App nutzen, also wird die Funktion nicht bei jedem Seitenaufruf aufgerufen werden.
Wenn du das Push-Benachrichtigungs-Token einer App-Instanz erhalten möchtest, rufe einfach die getNotificationToken Funktion auf.
<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>
Dinge, die du im Hinterkopf behalten solltest:
- Der Token ist ein langer String, z.B.:
- Der Token eines Benutzers kann sich ändern,
- wenn der gleiche Benutzer die App auf einem anderen Gerät benutzt
- wenn die App deinstalliert und neu installiert wird
- wenn die Daten der App gelöscht werden
- Halte die Push-Benachrichtigungs-Tokens geheim.
API-Endpunkt-Referenz
Hol dir deinen App-spezifischen API-Schlüssel von deinem App Dashboard.
Sende deinen API-Schlüssel als Query in der URL und den Request Body im JSON-Format.