Mis à jour le 16. septembre 2022 par Jan Bunk
La méthode de base pour envoyer des notifications push à un groupe d'utilisateurs de votre application est la suivante :
executeWhenAppReady()
notre script d'aide de l'application. Il 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 (ReferenceError, function is not defined).
Lorsque vous souhaitez abonner une instance d'application à une rubrique de notification push, il suffit d'appeler la fonction setNotificationTopicSubscriptionStatus avec le nouveau statut d'abonnement (true = abonné, false = désabonné) et le nom de la rubrique souhaitée.
<script>
try {
await setNotificationTopicSubscriptionStatus(true, "mytopic");
}
catch (e) {
// Can occur if:
// - you passed an invalid topic name.
// - you didn't pass all necessary parameters to setNotificationTopicSubscriptionStatus().
// - the app couldn't subscribe to the topic, for example because of connection issues. Should be very unlikely.
// - the app couldn't connect to the native code. Should be very unlikely.
// - push notifications are not included in your current plan
console.log(e);
}
</script>
Les éléments à retenir :
[a-zA-Z0-9-_.~%]{1,850}
Par la suite, il se peut que vous souhaitiez également obtenir une liste des rubriques auxquelles l'instance de l'application est abonnée. La valeur de retour est une liste de chaînes.
<script>
try {
var topics = (await getSubscribedNotificationTopics())["topics"];
}
catch (e) {
// Can occur if:
// - the app couldn't connect to the native code. Should be very unlikely.
// - push notifications are not included in your current plan
console.log(e);
}
</script>
Vous pouvez également consulter un exemple de code plus complet. Voici le code d'un bouton qui permet d'abonner/désabonner l'utilisateur à/de la catégorie de la page active d'un site web WordPress.
Dans les paramètres de l'application, vos utilisateurs peuvent également se désabonner des rubriques de notification.
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.
Vous trouverez ici une liste des documentations du développeur concernant les notifications push :
Voici d'autres articles (non destinés aux développeurs) sur les notifications push :