Message WhatsApp API non remis : les causes, dans l'ordre
Un message WhatsApp API accepté n'est pas un message remis : Meta communique le résultat plus tard, dans un webhook de statut : sent, delivered, read ou failed, avec un code d'erreur. Vérifiez dans l'ordre : le statut failed et son code, la fenêtre de 24 heures (131047), le moyen de paiement (131042), le template (132001, 132015), le destinataire (131026, 131049, 131050), puis les limites et la connexion du numéro.
easyCoexistence surveille chaque numéro connecté en permanence, vous envoie un e-mail quand Meta cesse de remettre les messages, supprime la connexion ou fait baisser la qualité, et transmet les webhooks de statut de Meta sans modification à votre système.
sent (une coche), delivered (deux), read (deux coches bleues) et failed (un triangle d'erreur rouge), tels que les webhooks de statut les signalent.
Plus de 24 heures se sont écoulées depuis la dernière réponse du destinataire : Meta recommande alors d'envoyer un template.
Impossible à remettre : le numéro n'est pas sur WhatsApp, le destinataire n'a pas accepté les nouvelles conditions, ou il utilise une ancienne version de WhatsApp.
Durée par défaut pendant laquelle WhatsApp retente un template utilitaire ou marketing non remis avant de l'abandonner ; les templates d'authentification ont 10 minutes par défaut.
Débit fixe d'un numéro utilisé à la fois dans l'application WhatsApp Business et dans la Cloud API.
Pourquoi un message accepté n'arrive-t-il toujours pas ?
Parce que la réponse de l'API et la remise sont deux événements distincts. Lors de l'envoi, Meta renvoie un identifiant de message dès qu'elle accepte la requête ; que le message atteigne le téléphone du client arrive plus tard, dans un webhook de statut sur le champ messages. sent signifie qu'il a quitté les serveurs de Meta (une coche), delivered qu'il a atteint l'appareil (deux coches), read qu'il a été ouvert (deux coches bleues), et failed qu'il n'a pas pu être envoyé ou remis, indiqué dans le tableau errors : code, title et error_data.details. Donc, premier réflexe : ne devinez pas. Recherchez le statut failed de cet identifiant de message et lisez son code. Sans destination de webhook, rien ne l'enregistre.
Quelles sont les causes, dans l'ordre de vérification ?
Des plus fréquentes sur un numéro qui vient d'être connecté aux plus rares. Chaque ligne indique le code de Meta, pour que le statut failed vous dise dans quel cas vous êtes :
- Fenêtre fermée : 131047, plus de 24 heures depuis le dernier message du client. Les messages en texte libre nécessitent une fenêtre ouverte : envoyez un template.
- Paiement : 131042, ou templates abandonnés sans avertissement. Depuis le 1er octobre 2026, les messages de service s'arrêtent aussi une fois 1 000 messages par mois utilisés sans moyen de paiement.
- Template : 132001 non approuvé ou mauvaise langue, 132000 mauvais nombre de variables, 132012 mauvais format, 132015 en pause, 132016 désactivé.
- Destinataire : 131026 non inscrit sur WhatsApp, ancienne version ou conditions non acceptées ; 131050 messages marketing arrêtés ; 131049 retenu pour préserver un engagement sain ; les templates marketing vers des numéros américains ne sont pas remis.
- Limites : 131048 restreint après des signaux de spam, 131056 trop de messages à une même personne, 130429 débit dépassé, 20 messages par seconde sur un numéro Coexistence.
- Compte : 131031 ou 368, le compte WhatsApp Business restreint ou désactivé pour violation de politique.
- Connexion : le numéro n'est plus lié, par exemple après 14 jours sans ouvrir l'application WhatsApp Business.
Comment gérer les codes côté destinataire ?
Différemment, car certains méritent une nouvelle tentative et d'autres jamais. 131050 signifie que la personne a choisi d'arrêter vos messages marketing : Meta indique de ne pas réessayer, et le webhook user_preferences vous signale quand elle arrête ou reprend. 131049 est une retenue de Meta pour préserver un engagement sain, souvent une limite par utilisateur sur les templates marketing : Meta conseille d'attendre au moins 24 heures avant de renvoyer, car un envoi plus tôt ne renvoie que la même erreur. 131026 couvre les numéros absents de WhatsApp, les utilisateurs n'ayant pas accepté les conditions actuelles de WhatsApp et les très anciennes versions de l'application : vérifiez d'abord le format du numéro et l'indicatif pays, puis demandez au client par un autre canal.
Combien de temps WhatsApp continue-t-il d'essayer de remettre le message ?
Pendant la durée de vie du message (TTL). Lorsqu'un téléphone est éteint ou hors couverture, WhatsApp retente la remise au lieu d'échouer immédiatement : par défaut pendant 30 jours pour les templates utilitaires et marketing, et 10 minutes pour les templates d'authentification. Une entreprise peut la raccourcir par template avec message_send_ttl_seconds, de 30 secondes à 12 heures pour les utilitaires et de 30 secondes à 15 minutes pour l'authentification. Un message non remis dans sa durée de vie est abandonné. Un message au statut sent sans statut delivered après des heures attend généralement sur le téléphone du client, il n'est pas perdu : réglez une TTL courte pour les codes et les alertes urgentes, afin qu'une remise tardive ne prête jamais à confusion.
Qu'est-ce que cela change pour les réponses IA et les automatisations ?
Lisez d'abord l'exécution, puis le statut. Dans l'onglet Runs, une exécution Skipped n'a rien envoyé et indique pourquoi : « Plus de 24 heures depuis le dernier message du client », « Vous avez récemment répondu à ce chat depuis votre téléphone » ou « Limite de réponses IA atteinte pour ce chat pour cette heure-ci ». Une exécution Done signifie que Meta a accepté chaque réponse, ce qui ne prouve pas la remise. easyCoexistence ne stocke pas les statuts de message : avec les automatisations activées, ils atteignent votre URL de transfert si vous en définissez une, et en mode direct ils vont directement à votre propre endpoint. Depuis ChatGPT ou Claude, demandez à votre IA d'exécuter get_number_health : elle renvoie le statut en direct, la note de qualité et les 15 derniers événements de surveillance, dont un bloc sending avec le code de Meta.
Comment le configurer
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
Erreurs courantes
- Relancer sur un 131050. La personne a arrêté vos messages marketing ; les tentatives supplémentaires ne seront jamais remises et ne peuvent qu'ajouter des signaux négatifs.
- Considérer un identifiant de message comme remis. Meta accepte d'abord et signale les échecs plus tard : un workflow qui s'arrête à l'identifiant rate chaque message refusé.
- Envoyer une réponse en texte libre un jour plus tard. Après 24 heures sans message du client, seul un template est accepté.
- Fonctionner sans destination de webhook. Les statuts failed n'arrivent que par webhook ; sans lui, la raison pour laquelle un message n'est pas arrivé est perdue.
Votre IA peut vérifier un numéro depuis ChatGPT ou Claude avec get_number_health. De US$ 9 à US$ 0,75 par numéro connecté et par mois, dégressif à mesure que vous ajoutez des numéros, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Pourquoi le message n'affiche-t-il qu'une coche pendant des heures ?
Une coche correspond au statut sent : Meta l'a envoyé, mais le téléphone ne l'a pas reçu, généralement parce qu'il est éteint ou hors ligne. WhatsApp continue d'essayer jusqu'à épuisement de la durée de vie du template, 30 jours par défaut pour les utilitaires et le marketing.
Pourquoi les réponses arrivent-elles mais pas les templates ?
En général, c'est un problème de moyen de paiement sur le compte WhatsApp Business. Meta remet les messages de service dans le quota gratuit mensuel du numéro sans moyen de paiement, mais ne remet pas les templates. Ajoutez une carte dans Facturation et paiements.
Puis-je voir les messages en échec dans l'application WhatsApp Business ?
Pas vraiment. Sur un numéro Coexistence, les messages envoyés via l'API apparaissent dans le fil de discussion de l'application, mais la raison de l'échec ne figure que dans le code d'erreur du webhook de statut.
Meta facture-t-il les messages non remis ?
Non. Meta ne facture que les messages remis, et les tentatives avec un template en pause ne sont pas facturées non plus.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le