Pourquoi mon message modèle WhatsApp apparaît-il comme « undeliverable » ?

Lorsqu'un message modèle envoyé via la WhatsApp Business API de SparkTG n'atteint pas le destinataire, le journal de la campagne affiche un échec de livraison pour ce contact. Cela ne signifie pas que SparkTG n'a pas réussi à envoyer le message : cela signifie que la couche de livraison de WhatsApp a renvoyé un statut non livrable après l'expédition du message. La cause racine se situe toujours du côté du destinataire ou dans les politiques de livraison de Meta.

Qu'est-ce qui rend un message modèle non livrable ?

Il existe cinq motifs distincts pour lesquels WhatsApp marque un message modèle sortant comme non livrable. Identifier celui qui s'applique à votre situation est le chemin le plus rapide vers la solution.

Motif 1 : le numéro du destinataire n'est pas sur WhatsApp

Le numéro de téléphone existe mais n'a jamais été enregistré sur WhatsApp, ou le compte WhatsApp associé à ce numéro a été désactivé. C'est la cause la plus courante d'échecs massifs de campagne avec des listes de contacts fraîchement importées.

1. 1

   Utilisez la validation des numéros de SparkTG avant l'envoi

   SparkTG Dashboard → Campaigns → New Campaign → Audience. Cliquez sur Validate Contacts avant de planifier. SparkTG vérifiera chaque numéro dans la base de données de WhatsApp et signalera les numéros non enregistrés afin que vous puissiez les exclure avant de consommer des crédits.

2. 2

   Nettoyez régulièrement votre liste de contacts

   Des numéros valides il y a six mois peuvent ne plus correspondre à des comptes WhatsApp actifs. Lancez une validation sur toute liste de contacts datant de plus de 90 jours avant de l'utiliser dans une campagne.

Motif 2 : le destinataire a bloqué le numéro de votre entreprise

Si un utilisateur a bloqué votre numéro WhatsApp Business, tous les messages sortants, y compris les messages modèles, sont silencieusement marqués comme non livrables. WhatsApp ne notifie pas les entreprises lorsqu'elles sont bloquées, afin de protéger la vie privée de l'utilisateur.

• Vous ne pouvez pas vous débloquer vous-même : seul le destinataire peut lever le blocage.
• Contactez-le par un autre canal (e-mail, SMS, téléphone) et demandez-lui de vérifier Settings → Privacy → Blocked Contacts dans WhatsApp.
• Un taux de blocage élevé sur une campagne indique que le contenu ou la fréquence de vos messages n'est pas souhaité : auditez votre processus d'opt-in et la pertinence de vos modèles.

Motif 3 : le destinataire n'a pas accepté les dernières Conditions d'utilisation de WhatsApp

WhatsApp met à jour ses Conditions d'utilisation périodiquement. Tant qu'un utilisateur n'a pas accepté les conditions mises à jour, il ne peut pas recevoir de messages de la Business API, même s'il peut encore envoyer et recevoir des messages personnels.

1. 1

   Demandez au destinataire d'ouvrir WhatsApp

   Lorsque des conditions mises à jour sont en attente, WhatsApp affiche une invite d'acceptation la prochaine fois que l'utilisateur ouvre l'application. L'utilisateur n'a qu'à ouvrir WhatsApp et accepter.

2. 2

   Si l'invite n'apparaît pas automatiquement

   Demandez au destinataire d'aller dans WhatsApp → Settings → Help → Terms and Privacy Policy. Si une version mise à jour est en attente, elle apparaîtra à cet endroit.

3. 3

   Relancez après l'acceptation

   Une fois que le destinataire a accepté les conditions, relancez le message depuis SparkTG Dashboard → Campaign Logs → sélectionnez le contact en échec → Retry.

Motif 4 : le destinataire utilise une version obsolète de WhatsApp

Les messages modèles avec boutons interactifs, en-têtes ou médias enrichis nécessitent une version minimale de WhatsApp sur l'appareil du destinataire. Les versions très anciennes de l'application ne peuvent pas afficher ces types de messages.

• Android : version 2.21.15.15 ou ultérieure
• WhatsApp Business (Android) : version 2.21.15.15 ou ultérieure
• iOS : version 2.21.170.4 ou ultérieure
• WhatsApp Business (iOS) : version 2.21.170.4 ou ultérieure
• KaiOS : version 2.2130.10 ou ultérieure
• WhatsApp Web : version 2.2132.6 ou ultérieure

1. 1

   Demandez au destinataire de mettre à jour WhatsApp

   Android : Google Play Store → My Apps → WhatsApp → Update. iOS : App Store → recherchez WhatsApp → Update.

2. 2

   Relancez après la mise à jour

   La plupart des échecs de livraison causés par la version de l'application sont résolus immédiatement après une mise à jour. Relancez depuis SparkTG Dashboard → Campaign Logs.

Motif 5 : limite de fréquence des messages marketing par utilisateur de Meta

Pour éviter que les utilisateurs ne soient submergés de messages d'entreprises, Meta limite le nombre de messages modèles marketing qu'un même utilisateur peut recevoir de toutes les entreprises dans une fenêtre de temps donnée. C'est une limite par utilisateur, valable sur toute la plateforme : elle s'applique même si votre entreprise n'a jamais écrit à ce contact auparavant.

• Il n'existe aucun moyen de contourner cette limite : c'est une restriction de la plateforme de Meta.
• Les contacts concernés redeviennent joignables lorsque la limite se réinitialise, normalement en 24 heures.
• Relancer immédiatement ne sert à rien : attendez la réinitialisation avant de réessayer.
• Les catégories de modèles utilitaire et authentification ne sont pas soumises à cette limite de fréquence. Recatégoriser en modèles utilitaires les messages qui y sont éligibles peut améliorer la délivrabilité.

Questions fréquentes

• Cette erreur est-elle causée par SparkTG ? Non. SparkTG transmet correctement le message à l'API de Meta. Le statut non livrable est renvoyé par la couche de livraison de WhatsApp selon l'état du compte du destinataire ou les politiques propres à Meta.
• Les messages non livrés me seront-ils facturés ? WhatsApp facture par session de conversation, et non par message individuel. Si aucune session n'a été ouverte, aucun frais de conversation ne s'applique. Consultez SparkTG Dashboard → Billing → Usage pour le détail par contact.
• Puis-je relancer automatiquement les messages en échec ? Oui. Allez dans SparkTG Dashboard → Campaign Settings → Retry Policy pour programmer des relances automatiques des contacts en échec après un intervalle défini.
• Comment voir quels contacts ont échoué et pourquoi ? SparkTG Dashboard → Campaigns → sélectionnez votre campagne → Delivery Report. Chaque contact en échec affiche le code d'erreur précis et le motif renvoyés par Meta.

Comment réduire les taux de messages non livrables dans les prochaines campagnes

• N'envoyez des messages qu'aux contacts ayant donné un opt-in actif pour recevoir des messages WhatsApp de votre entreprise : c'est une exigence des politiques de Meta et le facteur qui influence le plus les taux de livraison.
• Validez votre liste de contacts avant chaque campagne avec l'outil de validation des numéros intégré de SparkTG.
• Évitez d'envoyer des modèles marketing à haute fréquence à la même audience sur une courte période : cela accélère l'atteinte de la limite marketing par utilisateur.
• Utilisez les catégories de modèles utilitaire ou authentification chaque fois que c'est approprié : elles sont exemptées de la limite de fréquence marketing.
• Surveillez régulièrement la note de qualité de votre modèle dans SparkTG → WhatsApp → Channel Status. Une note en baisse est un signal précoce de hausse des taux de messages non livrables.