Envoyer des messages aux détenteurs de pass Wallet

Une fois qu’un utilisateur ajoute votre pass, Pushwoosh l’enregistre comme un abonnement de plateforme (Apple Wallet ou Google Wallet) lié à cet ID utilisateur.

Vous pouvez atteindre les détenteurs de plusieurs manières : envoyer une mise à jour de pass, envoyer une notification push unique, automatiser les messages depuis un Customer Journey, ou notifier les détenteurs d’un pass spécifique via l’API.

Envoyer une mise à jour de pass

Modifier un pass et l’enregistrer envoie la nouvelle version à chaque appareil qui l’a ajouté, sans message séparé. La manière dont vous alertez les détenteurs du changement diffère selon la plateforme.

Apple Wallet

Définissez un Message de modification sur tout champ pour lequel vous souhaitez alerter les détenteurs ; iOS l’affiche comme un message sur l’écran de verrouillage. Les champs sans message de modification se mettent à jour silencieusement.

1. Dans Campagnes → Pass Wallet → Apple Wallet, trouvez le pass et cliquez sur Modifier dans le menu d’actions.
2. Modifiez les champs nécessaires et ajoutez un message de modification à tout champ pour lequel vous souhaitez alerter les détenteurs.
3. Cliquez sur Enregistrer.

Google Wallet

Pour les pass de fidélité, de billet d’événement et de vol, activez Notifier les champs modifiés pour que Google envoie une notification Android en même temps que la synchronisation. Les autres types de pass se synchronisent silencieusement.

1. Dans Campagnes → Pass Wallet → Google Wallet, trouvez le pass et cliquez sur Modifier dans le menu d’actions.
2. Modifiez les champs nécessaires.
3. Assurez-vous que Notifier les champs modifiés est activé.
4. Cliquez sur Enregistrer les modifications.

Pass d'événement et de vol

• Google génère le texte de la notification ; vous ne pouvez pas le personnaliser comme un message de modification d’Apple Wallet.
• Pour les pass d’événement et de vol, la notification ne se déclenche que s’il reste moins de 3 heures avant l’heure de début.
• Google autorise au maximum 3 notifications par pass par 24 heures. Si la limite est atteinte, le pass se met à jour silencieusement.

Envoyer une notification push unique aux détenteurs de pass

Envoyez une notification push autonome à un détenteur de pass ou à une audience plus large. Elle apparaît comme un message sur l’écran de verrouillage sur un pass Apple Wallet, ou comme une notification sur un pass Google Wallet.

1. Ouvrez l’éditeur de push unique. Cliquez soit sur Envoyer un message dans Campagnes → Pass Wallet → Apple Wallet ou Google Wallet, soit allez dans Campagnes → Messages uniques et cliquez sur Envoyer un message → Push unique.

2. À l’étape Contenu, rédigez le message ou sélectionnez un préréglage.

3. À l’étape Audience, définissez qui reçoit le message. Le paramètre par défaut dépend de l’endroit où vous avez ouvert l’éditeur :

   • Depuis Envoyer un message sur un pass : Envoyer à des utilisateurs spécifiques est sélectionné, et Destinataires (ID utilisateur) liste déjà l’ID utilisateur de ce détenteur de pass. Envoyez tel quel pour atteindre ce détenteur unique, ou modifiez l’audience :
     • Ajoutez plus d’ID utilisateur dans Destinataires (ID utilisateur)
     • Passez à Envoyer à un segment
     • Choisissez Envoyer à tous les abonnés
   • Depuis Messages uniques : Définissez l’audience comme dans une notification push unique normale : Envoyer à des utilisateurs spécifiques, Envoyer à un segment, ou Envoyer à tous les abonnés.

4. Sous Plateformes cibles, sélectionnez Apple Wallet, Google Wallet, ou les deux.
5. Envoyez ou programmez le message.

Note

Lorsque vous ciblez un segment, la livraison est effectuée aux utilisateurs de ce segment qui ont la plateforme correspondante enregistrée, et non à tous ceux qui ont enregistré un pass spécifique.

Automatiser les messages depuis un Customer Journey

Envoyez des messages automatiquement en fonction d’événements ou de segments.

Journey à entrée basée sur un déclencheur

Assistance d'un développeur requise

L’envoi d’événements personnalisés nécessite que votre équipe de développeurs intègre l’appel API postEvent dans votre backend ou CRM. Partagez cette section avec eux.

1. Créez un Customer Journey et ajoutez une Entrée basée sur un déclencheur.
2. Sélectionnez l’événement qui doit démarrer le Journey. Créez d’abord un événement personnalisé dans le Control Panel si vous ne l’avez pas déjà fait, par exemple RewardAvailable.
3. Ajoutez et configurez un élément push. Activez Envoyer par ID utilisateur pour que la notification push atteigne chaque appareil lié à l’utilisateur, y compris le pass enregistré.
4. Terminez la configuration et activez le Journey.

Lorsque l’événement d’entrée se déclenche, Pushwoosh envoie la notification push à chaque appareil lié à l’utilisateur. Les détenteurs de pass la reçoivent comme un message sur l’écran de verrouillage sur Apple Wallet, ou comme une notification sur Google Wallet. Les utilisateurs sans pass wallet la reçoivent sur leurs autres appareils.

Contenu du pass

La notification push ne modifie aucun champ du pass. Pour mettre à jour le contenu du pass en même temps que le message, par exemple un solde de points, mettez à jour le pass séparément :

• Apple Wallet : via Modifier dans Tous les pass, ou via l’API Apple PassKit.
• Google Wallet : via Modifier dans Tous les pass, ou via l’API Google Wallet.

Exemple : Notifier un utilisateur qu’une récompense est disponible

POST https://api.pushwoosh.com/json/1.3/postEvent

{
  "request": {
    "application": "XXXXX-XXXXX",
    "userId": "u12345",
    "event": "RewardAvailable",
    "attributes": {
      "reward": "Free coffee",
      "expires": "2026-07-01"
    }
  }
}

Le nom de l’event doit correspondre à un événement créé dans votre Control Panel.

Autres manières de construire le journey

Le flux basé sur un déclencheur ci-dessus est une option. En fonction de ce qui doit démarrer le journey, choisissez un élément d’entrée différent :

• Entrée basée sur l’audience : démarrez le journey pour un segment entier au lieu d’un seul événement. Exécutez-le une fois, selon un calendrier, ou périodiquement (par exemple, chaque semaine pour tous ceux qui détiennent un pass actif), avec de nouveaux utilisateurs entrant au fur et à mesure qu’ils rejoignent le segment.
• Entrée basée sur l’API : démarrez le journey à partir d’un événement commercial qui se produit en dehors de l’application, comme un retard de vol ou un changement de porte d’embarquement. Votre système externe appelle le modèle de requête de l’élément d’entrée et passe un filtre pour cibler les bons utilisateurs, par exemple tous ceux qui ont un tag flightNumber = SU1234 défini lors de l’émission du pass. Convient bien pour les cartes d’embarquement et les billets d’événement.

Notifier les détenteurs d’un pass spécifique via l’API

Pour envoyer un message à tous ceux qui ont enregistré un pass spécifique, appelez Mettre à jour un pass. Cela met à jour le pass et notifie les appareils. Sur Google Wallet, définissez notifyMessage pour envoyer une notification personnalisée en même temps que la mise à jour ; sans cela, le pass se synchronise silencieusement.

• Apple Wallet :
  Mettre à jour un pass
• Google Wallet :
  Mettre à jour un pass