Aller au contenu principal
B - Automatisation & Flows• 5 min de lecture

Error handling WhatsApp flows : gérer les échecs et cas limites

Gérez les erreurs et cas limites dans vos flows WhatsApp comme un professionnel. Stratégies de fallback, gestion des timeouts, retry logic et bonnes pratiques opérationnelles.

Tout flow WhatsApp qui fonctionne en production rencontrera des erreurs. Un message qui n'est pas livré. Un webhook externe qui timeout. Un client qui entre une valeur inattendue. Un numéro de commande inexistant. Ignorer ces cas c'est exposer vos clients à des expériences frustrantes et votre équipe à des incidents opérationnels. Voici comment concevoir des flows résistants et gérer élégamment les erreurs.

Taxonomie des erreurs dans les flows WhatsApp

Erreurs de livraison (côté WhatsApp) :

  • Message non livré (numéro invalide, hors réseau)
  • Message livré mais non lu après X heures
  • Compte WhatsApp destinataire suspendu ou supprimé
  • Limite d'envoi quotidienne atteinte

Erreurs d'intégration (côté système) :

  • API CRM indisponible (timeout, erreur 500)
  • Variable de personnalisation vide ou incorrecte
  • Webhook non reçu ou mal formé
  • Base de données inaccessible lors de la vérification de statut

Erreurs comportementales (côté utilisateur) :

  • Réponse hors du menu attendu ("Pour quoi faire ?" au lieu de OUI/NON)
  • Réponse après expiration du délai prévu
  • Double envoi de la même action
  • Contenu inapproprié envoyé au chatbot

Erreurs de contenu (côté flow) :

  • Template HSM refusé par Meta pendant une campagne
  • Changement de format de données externe non anticipé
  • Variable trop longue pour la limite de caractères

Stratégies de gestion d'erreur par type

Pour les erreurs de livraison :

Stratégie fallback multi-canal : Si le message WhatsApp n'est pas livré dans les 30 minutes, déclencher un envoi SMS de substitution avec le même contenu condensé. Si le SMS échoue, alerter l'équipe pour contact manuel.

Configuration de retry automatique : Pour les erreurs temporaires (numéro temporairement hors réseau), configurer un retry après 1h, puis après 4h, puis après 24h. Après 3 tentatives échouées, marquer le contact comme "WhatsApp invalide" et alerter.

Pour les erreurs d'intégration :

Circuit breaker : Si l'API externe échoue 3 fois de suite, "ouvrir le circuit" : arrêter les tentatives pendant 15 minutes, utiliser des données en cache si disponibles, et alerter l'équipe technique. Après la pause, "tester" avec un seul appel avant de reprendre normalement.

Messages de fallback prédéfinis : Si les données dynamiques ne peuvent pas être récupérées, envoyer un message générique plutôt qu'un message erroné.

Avant : "Votre commande {{numéro_commande}} est..." → Erreur API → Envoi de "Votre commande {{numéro_commande}} est {{ERROR:undefined}}"

Après : "Votre commande est en cours de traitement. Pour connaître le statut exact, utilisez ce lien : {{lien_suivi_statique}}" (lien de fallback toujours disponible)

Pour les erreurs comportementales :

Le fallback NLU (Natural Language Understanding) : Quand le contact répond quelque chose d'inattendu, le chatbot doit gérer élégamment.

Tentative 1 :

"Je n'ai pas bien compris votre réponse. Pouvez-vous choisir parmi ces options ? [Option 1] [Option 2] [Option 3]"

Tentative 2 :

"Toujours là ! Je vais vous connecter à un membre de notre équipe qui pourra mieux vous aider. [Parler à un agent maintenant] [Me rappeler dans 1h]"

Après 2 incompréhensions : Escalade automatique vers agent humain.

Pour les stratégies d'escalade et de parallélisme, consultez notre guide sur le parallélisme des flows WhatsApp et l'automatisation WhatsApp flows.

Monitoring et alertes des erreurs en production

Dashboard d'erreurs en temps réel : Configurez un tableau de bord qui affiche en temps réel :

  • Taux d'échec de livraison (objectif < 2%)
  • Taux d'erreur des intégrations (objectif < 0.5%)
  • Taux de fallback (messages envoyés en mode fallback)
  • Conversations bloquées (sans résolution depuis > 30 min)

Alertes automatiques : Configurez des alertes (email, SMS, ou... WhatsApp) pour les équipes techniques quand :

  • Le taux d'erreur de livraison dépasse 5% en 15 minutes
  • Un timeout d'API se produit plus de 3 fois en 5 minutes
  • Plus de 10 conversations sont en attente d'escalade humaine

Logs détaillés : Chaque erreur doit être loguée avec : timestamp, contact ID, type d'erreur, message concerné, contexte (étape du flow, valeurs des variables). Ces logs permettent le débogage post-mortem et l'identification des patterns d'erreur.

FAQ

Comment tester les cas d'erreur avant le déploiement en production ? Créez un environnement de test avec des scénarios d'erreur simulés : numéros invalides dans votre liste de test, API fictives qui retournent des erreurs 500, variables délibérément vides. Testez chaque branche d'error handling avant le déploiement. Notre guide sur le testing et debugging des flows WhatsApp détaille les méthodes de test.

Un message WhatsApp en double peut-il être envoyé en cas de retry après erreur ? Oui, et c'est un risque réel avec les retries automatiques. Si un message a été envoyé mais que la confirmation de livraison n'a pas été reçue (erreur réseau sur la réponse), un retry naïf peut envoyer le même message en double. Utilisez des "idempotency keys" : chaque tentative d'envoi doit être liée à un identifiant unique, et le système vérifie si cet identifiant a déjà été traité avec succès avant d'envoyer à nouveau.

Comment gérer l'erreur "fenêtre de 24h expirée" sur WhatsApp ? La fenêtre de 24h (après quoi vous devez utiliser un template HSM approuvé) est une contrainte Meta. Si votre flow essaie d'envoyer un message de session après la fenêtre, l'API retournera une erreur. Votre error handling doit détecter cette erreur et basculer automatiquement sur un template HSM approuvé si disponible, ou mettre le contact en attente pour qu'un agent le recontacte dans la fenêtre autorisée (proactif via template).

Doit-on prévenir les clients quand une erreur technique affecte leur flow ? Oui, mais avec discernement. Pour les erreurs légères (délai de réponse de 5 minutes au lieu de 1), pas nécessairement. Pour les erreurs qui affectent significativement l'expérience (commande non confirmée, paiement en attente de vérification manuelle), envoyez un message proactif au client avec une explication honnête et un délai de résolution estimé. La transparence est toujours préférable au silence.


Construisez des flows WhatsApp robustes qui gèrent élégamment chaque erreur et cas limite. Créez votre compte Whakup et accédez aux outils de monitoring et de gestion d'erreur avancés.

#whatsapp marketing#error handling whatsapp#gestion erreurs flows
Pablo Lenormand
Pablo LenormandCo-fondateur & CPO

Co-fondateur et Chief Product Officer de Whakup, Pablo conçoit les fonctionnalités qui permettent aux marques africaines de maximiser leur impact sur WhatsApp.

🚀

Prêt à passer à l'action ?

Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.

Démarrer l'essai gratuit