Le concept de base sur la méthode d'envoi de notifications push aux utilisateurs individuels de votre application est le suivant :
- Votre utilisateur X ouvre l’application.
- Votre site web appelle la fonction JavaScript
getNotificationTokenqui renvoie le jeton de notification push de l'instance de l'application. - Votre site web stocke le jeton (par exemple, dans l'entrée de X dans votre base de données des utilisateurs).
- Lorsque vous voulez envoyer une notification à X, vous appelez l'API webtoapp.design avec le jeton et nous envoyons la notification.
Utilisation de la fonction JavaScript
executeWhenAppReady()dans notre script d'aide de l'application. Elle garantit que votre site web n'essaie pas d'interagir avec l'application avant qu'elle ne soit prête ou lorsque votre site web est chargé à l'aide d'un navigateur normal (Erreur de référence, la fonction n'est pas définie). Il s'agit de l'ancienne implémentation utilisée dans les applications créées/mises à jour avant août 2021.
Vous devez définir la fonction receivepushNotificationToken sur votre site web afin qu'elle puisse être appelée par l'application. Vous pouvez le faire de la manière suivante :
<script>
// this function automatically gets called by the app
function receivePushNotificationToken(token) {
// store the token (or whatever you want to do with it)
}
</script>
Les éléments à retenir :
- L'application appellera la fonction JavaScript à chaque chargement de page. Il est normal que vous n’effectuiez parfois aucune opération avec le jeton, par exemple, lorsque l'utilisateur n'est pas connecté et que vous ne pouvez donc pas stocker le jeton dans la base de données des utilisateurs.
- L'application n'appellera pas la fonction JavaScript si, pour une raison quelconque, elle n'a pas pu déterminer le jeton de notification push (ce qui est très peu probable, mais pourrait théoriquement se produire).
- Il est évident que tous les visiteurs de votre site web n'utiliseront pas votre application, et que la fonction ne sera pas appelée à chaque chargement de page.
Pour obtenir le jeton de notification push d'une instance d'application, il suffit d'appeler la fonction 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>
Les éléments à retenir :
- Le jeton est une longue chaîne, par exemple :
- Le jeton d'un utilisateur peut changer,
- lorsque le même utilisateur utilise l'application sur un autre appareil ;
- lorsque l'application est désinstallée et réinstallée ;
- lorsque les données de l'application sont effacées ;
- Gardez les jetons de notification push secrets.
Référence sur le point de terminaison de l'API
Obtenez votre clé API spécifique à votre application depuis le tableau de bord de votre application.
Envoyez votre clé API sous forme de requête dans l'URL et le corps de la requête au format JSON.