Envoi de notifications push individuelles et personnalisées

Les fonctionnalités décrites sur cette page nécessitent un plan incluant les notifications push.

Le concept de base sur la méthode d'envoi de notifications push aux utilisateurs individuels de votre application est le suivant :

Dans ce guide, le terme 'utilisateur' fait toujours référence à une personne qui possède un compte utilisateur sur votre site web.

Votre utilisateur X ouvre l’application.
Votre site web appelle la fonction JavaScript getNotificationToken qui 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

Nous vous conseillons de consulter la fonction 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 ;
Cela signifie que les anciens jetons de notification d'un utilisateur peuvent ne plus être valides, vous devez donc stocker régulièrement les jetons. Si vous souhaitez qu'un même utilisateur utilise votre application sur plusieurs appareils, vous devez stocker plusieurs jetons pour chaque utilisateur.
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.

Envoi de notifications push à des utilisateurs individuels

Utilisation de la fonction JavaScript

Référence sur le point de terminaison de l'API

Vue d’ensemble des notifications push