Un contact n'a pas reçu vos messages ? Comment investiguer ?

WAX fournit un journal d'activité, appelé Activities, qui vous permet de suivre pour tous les contacts entrés dans le flow si le parcours que vous avez dessiné s'est bien réalisé à chaque étape et si ce n'est pas le cas, vous pourrez savoir ce qu'est s'est passé et comment résoudre le problème.

Où trouver les Flow Activities ?

Pour accéder aux Flow Activities dans une campagne en draft (pas encore envoyée), vous devrez :

Ouvrir la campagne en question depuis la liste de vos campagne s dans WAX
Cliquer sur "Show activity" sur la barre du haut (disponible à l'étape 1 "Content" uniquement)

Pour accéder aux Flow Activities dans une campagne completed (déjà envoyée), vous devrez :

Ouvrir la campagne en question depuis la liste de vos campagne s dans WAX
Cliquer sur l'onglet "Activities" sur la barre du haut

Pour accéder aux Flow Activities dans une automatisation, vous devrez :

Ouvrir la campagne en question depuis la liste de vos automatisations dans WAX
Cliquer sur l'onglet "Activities" sur la barre du haut

Comment lire la page Activities ?

La liste des activités

Le panneau affiche tous les contacts qui sont entrés dans le flow, avec horodatage et statut. Vous pouvez :

Rechercher un contact par numéro de téléphone ou nom pour vérifier s'il a bien été inclus dans le flow
Filtrer par type d'erreur pour identifier rapidement les exécutions problématiques
Filtrer par période pour restreindre l'affichage à une fenêtre de temps donnée

Le détail d'une activité

En cliquant sur un contact dans la liste, le flow se met en surbrillance pour visualiser exactement le chemin emprunté, node par node. Vous voyez ainsi en un coup d'œil où le contact est passé, où il s'est arrêté, et pourquoi.

Par exemple ici, on voit que le contact n'a cliqué sur aucun CTA, donc le flow n'a pas continué pour lui.

Pour chaque activity, et pour certains nodes vous aurez accès aux :

Flow payload : les données techniques transmises au démarrage de l'exécution (ex. : reference_id,...)
Variables : les valeurs dynamiques utilisées lors de l'exécution d'un node(ex. : prénom du contact, contenu d'un message)
Contact attributes : les attributs connues sur le contact au moment de l'exécution du node (ex. : whatsapp_opt_in_status, language...)

💡 Ces données sont particulièrement utiles pour comprendre pourquoi un contact a pris un chemin inattendu, par exemple, s'il a été exclu d'un node en raison d'un attribut manquant.

Les exécutions en erreur

Lorsqu'un node n'a pas pu s'exécuter, l'activité est marquée Error. En cliquant dessus, vous accédez au détail de l'erreur : le node concerné, la cause, et les actions possibles.

Dans certains cas, vous pourrez effectuer une nouvelle tentative directement depuis l'interface pour corriger rétroactivement le résultat d'une exécution passée sans avoir à relancer toute la campagne. Il arrive aussi que parfois WAX réalise une nouvelle tentative lorsque c'est possible.

Dans les deux cas le retry count ne sera pas égal 0. Le retry count indique le nombre de tentative réalisée pour corriger le node en erreur.

ℹ️ Il n'est pas possible d'annuler une activity en cours ou terminée.

Comment résoudre les erreurs les plus fréquentes ?

Nom de l'erreur	Description	Actions
Meta encoutered a payment issue on your account	Il y a un problème de paiement sur votre compte Meta lié à votre compte WhatsApp Business. Les messages ne peuvent pas être envoyés tant que ce problème n'est pas résolu.	1. Rendez-vous sur votre Meta Business Manager et réglez votre solde impayé ou définissez un nouveau moyen de paiement par défaut. 2. Une fois corrigé, revenez ici et relancez les activités en erreur.
Meta blocked this message to protect WhatsApp ecosystem health	Ce message n'a pas été délivré afin de limiter le nombre de messages marketing qu'un utilisateur peut recevoir sur une période donnée. Cela n'est pas lié à votre contenu ni à votre configuration WAX.	Vous pouvez relancer ce message après 24 heures. Aucune modification n'est nécessaire de votre côté.
Meta blocked this message to protect WhatsApp ecosystem health in the USA	L'envoi de templates marketing vers des contacts américains n'est pas autorisé pour le moment. Cela n'est pas lié à votre contenu ni à votre configuration WAX.	Vous pouvez ajouter une condition pour les numéros commençant par le préfixe +1 (États-Unis) et envoyer un SMS à la place.
Meta blocked this message because the conversation window expired	Plus de 24 heures se sont écoulées depuis la dernière interaction de ce contact avec votre numéro WhatsApp. Meta n'autorise plus l'envoi de messages Reply en dehors de cette fenêtre.	Envoyez un template de message approuvé pour réengager ce contact directement depuis WAX Inbox ou via votre intégration service client.
Your WhatsApp number is no longer registered	Le numéro WhatsApp Business lié à votre compte n'est plus enregistré sur Meta. Cela est probablement dû au fait que le numéro a été supprimé ou déconnecté.	Contactez votre CSM.
An undefined error has occurred	Cette erreur est inconnue et doit être investiguée par l'équipe WAX.	Contactez WAX.
Your media file could not be uploaded	WAX a rencontré un problème lors de l'envoi du fichier média joint à ce message. Il s'agit généralement d'une erreur temporaire. Nous traitons déjà le fichier en arrière-plan et allons relancer automatiquement.	Aucune action requise. Ce node sera relancé automatiquement. Si le problème persiste, vérifiez que votre fichier média est valide et accessible.
Media URL could not be resolved	La variable utilisée dans l'URL du média a retourné une valeur vide ou invalide, et aucun média par défaut n'a été défini en fallback. Le message n'a pas pu être envoyé.	Vérifiez que la variable redirige vers une URL valide et publiquement accessible pour tous vos contacts. Si certains contacts ne disposent pas de cette valeur, définissez un média par défaut sur ce template pour éviter les échecs futurs.
Webhook returned an error	Le webhook a répondu avec un code de statut 4xx ou 5xx, ce qui indique un problème de configuration de votre endpoint ou de votre serveur. Cela n'est pas lié à WAX.	Vérifiez l'URL de votre webhook et les logs de votre serveur pour identifier le problème, puis relancez cette exécution une fois résolu.