Funktionerna som beskrivs på denna sida kräver en plan som inkluderar push-notiser.
Det grundläggande konceptet för hur du kan skicka push-notiser till enskilda användare av din app är följande:
I den här guiden avser "användare" alltid en person som har ett användarkonto på din webbplats.
- Din användare John öppnar appen.
- Din webbplats anropar javascriptfunktionen
getNotificationTokensom returnerar appinstansens push-notifikationstoken. - Din webbplats lagrar detta token (t.ex. i Johns post i din användardatabas).
- När du vill skicka ett meddelande till John anropar du webtoapp.design API:et med detta token och vi levererar meddelandet.
Använda Javascript-funktionen
Du kanske vill kolla in
executeWhenAppReady()-funktionen i vårt hjälparskript för appen. Det säkerställer att din webbplats inte försöker interagera med appen innan den är redo eller när din webbplats laddas med en vanlig webbläsare (ReferenceError, funktionen är inte definierad). Detta är den gamla införingen (implementeringen) som används i appar som skapats/uppdaterats före augusti 2021.
Du måste definiera funktionen receivePushNotificationToken på din webbplats så att den kan anropas av appen. Du kan göra det på följande sätt:
<script>
// this function automatically gets called by the app
function receivePushNotificationToken(token) {
// store the token (or whatever you want to do with it)
}
</script>
Saker att tänka på:
- Appen anropar javascript-funktionen vid varje sidladdning. Det är normalt att du ibland inte gör något med tokenet, till exempel när användaren inte är inloggad och du därför inte kan lagra tokenet i användardatabasen.
- Appen anropar inte javascript-funktionen om appen av någon anledning inte kan fastställa push-notifikationstoken (mycket osannolikt, men det kan teoretiskt sett hända).
- Alla besökare på din webbplats kommer naturligtvis inte att använda din app, så funktionen kommer inte att anropas vid varje sidladdning.
När du vill hämta en appinstans push-notifikationstoken anropar du helt enkelt funktionen 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>
Saker att tänka på:
- Token är en lång sträng, till exempel:
- En användares token kan ändras,
- när samma användare använder appen på en annan enhet
- när appen avinstalleras och installeras på nytt
- när appens data rensas
- Håll push-notifikationstoken hemliga.
API Endpoint Referens
Hämta din appspecifika API-nyckel från din apps instrumentpanel.
Skicka din API-nyckel som en fråga i URL:en och förfrågningskroppen i JSON-format.