Utilisation avancée des notifications push

Mis à jour le 29. juillet 2021 par Jan Bunk


Les fonctionnalités décrites sur cette page nécessitent l’extension de notifications push. veuillez-nous contacter si cette extension n'est pas encore activée pour votre application.

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.
  1. Votre utilisateur X ouvre l’application.
  2. Votre site Web appelle la fonction JavaScript getNotificationToken qui renvoie le jeton de notification push de l'instance de l'application.
  3. Votre site Web stocke le jeton (par exemple dans l'entrée de X dans votre base de données des utilisateurs).
  4. 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() de notre script d'aide de l'application. Cela permet de s'assurer que votre site Web n'essaie pas d'interagir avec l'application avant qu'elle ne soit prête ou pendant le chargement de votre site Web à l'aide d'un navigateur ordinaire.
Afficher l'utilisation des anciennes fonctions

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 enabled for your app
        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.

Envoi d'une notification via l'API webtoapp.design

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.