Codes d'erreur WhatsApp Cloud API
Voici tous les codes d'erreur WhatsApp Cloud API que nous documentons, dans un seul tableau, avec leur signification et l'utilité d'une nouvelle tentative. La plupart sont déterministes : la même requête échoue de la même façon et une boucle de nouvelles tentatives transforme une mauvaise requête en limite de débit.
EasyCoexistence surveille la connexion en continu et enregistre les événements de compte et de qualité de Meta dans la chronologie de la connexion.
Requête
| Code | Ce que cela signifie | Réessayer |
|---|---|---|
| 100 | Un paramètre n'est pas pris en charge, est mal orthographié ou mal formé. | Non |
| 131008 | Un paramètre obligatoire n'a pas été inclus du tout. | Non |
| 131009 | Un paramètre est présent avec une valeur que l'endpoint rejette. | Non |
| 131021 | L'expéditeur et le destinataire sont le même numéro. | Non |
| 131051 | Le type de message n'est pas pris en charge, souvent à cause d'une limite de Coexistence. | Non |
| 131052 | Meta n'a pas pu télécharger un média envoyé par un client. | Non |
| 131053 | Meta n'a pas pu importer un média que vous avez envoyé. Taille, format ou accessibilité. | Non |
Template
| Code | Ce que cela signifie | Réessayer |
|---|---|---|
| 132000 | Le nombre de paramètres ne correspond pas au template. | Non |
| 132001 | Aucun template n'existe pour cette paire nom et langue. | Non |
| 132007 | Le template enfreint la politique de messagerie. Réécrivez-le et soumettez-le à nouveau. | Non |
| 132012 | Le format du paramètre ne correspond pas à ce que définit le template. | Non |
| 132015 | Le template est suspendu après une baisse de qualité. C'est temporaire. | Attendre |
| 132016 | Le template est désactivé définitivement. Il ne reviendra pas. | Non |
Fenêtre et destinataire
| Code | Ce que cela signifie | Réessayer |
|---|---|---|
| 131047 | La fenêtre de service client de 24 heures est fermée. Envoyez un template. | Non |
| 131026 | Le destinataire ne peut pas recevoir le message du tout. | Non |
| 131050 | La personne s'est désinscrite. Il n'y a aucun contournement, par conception. | Non |
| 130497 | L'envoi de messages vers ce pays est restreint pour votre compte. | Non |
Enregistrement et PIN
| Code | Ce que cela signifie | Réessayer |
|---|---|---|
| 131045 | Le numéro n'a jamais été enregistré pour la messagerie Cloud API. | Non |
| 133010 | Le numéro n'est pas enregistré. L'enregistrement doit être finalisé. | Non |
| 133006 | Le numéro doit être vérifié avant de pouvoir être enregistré. | Non |
| 133005 | Le PIN de vérification en deux étapes était incorrect. Arrêtez de deviner. | Non |
| 133008 | Trop de tentatives de PIN. L'enregistrement est bloqué pendant un certain temps. | Attendre |
Accès et compte
| Code | Ce que cela signifie | Réessayer |
|---|---|---|
| 190 | Le token d'accès a expiré ou a été invalidé. | Non |
| 368 | Le compte est restreint après une violation des règles. | Non |
| 131031 | Le compte est restreint, ou ses données ne correspondent pas à celles de Meta. | Non |
| 131042 | Un problème de paiement sur le compte professionnel bloque l'envoi. | Non |
| 131049 | Meta a bloqué le message pour préserver la santé de l'écosystème. | Non |
Limites de débit
| Code | Ce que cela signifie | Réessayer |
|---|---|---|
| 130429 | La limite de débit de messages du compte a été atteinte. | Attendre |
| 131048 | Une limite anti-spam a été atteinte. La cause est la qualité, pas le volume. | Non |
| 131056 | Trop de messages entre votre numéro et un même destinataire. | Non |
| 80007 | Le compte a atteint sa limite d'appels de gestion. Souvent du polling. | Attendre |
Temporaires
Synchronisation Coexistence
Comment lire la colonne des nouvelles tentatives
Elle comporte trois valeurs, et se tromper entre elles est l'erreur la plus coûteuse de toute cette référence.
Non signifie que l'échec est déterministe. C'est la requête, le template ou l'état du destinataire qui a échoué : renvoyer exactement la même requête produit la même erreur tout en consommant du débit dont vous aurez besoin plus tard. Oui signifie que l'échec vient de Meta et qu'un délai progressif le résout réellement. Attendre signifie que la condition est réelle mais temporaire : une limite ou un verrou qui se lève seul. Réessayer avant sa levée ne sert à rien et peut la prolonger.
Pourquoi la plupart de ces erreurs ne peuvent pas être résolues par une nouvelle tentative
Parce que la plateforme renvoie des codes précis plutôt que des codes génériques. Un paramètre mal formé, un template inexistant, une fenêtre de messagerie fermée et un destinataire désabonné sont identifiables au moment de la réponse ; Meta les nomme donc au lieu d'échouer de façon vague.
- Un problème de requête ne devient pas correct à la deuxième tentative.
- Un problème de template se trouve dans le template, que la requête ne peut pas modifier.
- Un problème de fenêtre ou de désabonnement concerne l'état du destinataire, pas le vôtre.
- Une restriction de compte est une décision, et réessayer ne constitue pas un recours.
Que journaliser lorsqu'une de ces erreurs survient
Suffisamment d'informations pour la diagnostiquer sans la reproduire : c'est ce qui fait la différence entre une correction en cinq minutes et une journée de suppositions.
- La réponse complète, y compris le trace id, demandé par le support Meta.
- Le corps de la requête telle qu'elle a été envoyée, pas telle que vous la vouliez. L'écart entre les deux est généralement le bug.
- Le phone number id, afin de distinguer un problème sur un numéro d'un problème touchant tout le compte.
- L'horodatage, afin de comparer l'échec avec l'état de la connexion à ce moment-là.
Les codes qui n'existent que sur Coexistence
Il y en a deux, et ils prêtent à confusion parce qu'ils ressemblent à des échecs d'envoi ordinaires. 2593107 et 2593108 concernent tous deux la synchronisation de l'historique des discussions, l'étape qui copie les conversations récentes depuis l'application WhatsApp Business lorsqu'un numéro est connecté pour la première fois.
Ce ne sont pas des erreurs de messagerie et elles ne signifient pas que la connexion a échoué. Une synchronisation qui dépasse sa limite ou s'exécute hors de sa fenêtre laisse le numéro connecté et capable d'envoyer normalement, avec moins d'historique copié que prévu. Les interpréter comme une connexion défaillante pousse à déconnecter puis à recommencer, ce qui fait perdre davantage d'historique au lieu de le récupérer.
Questions fréquemment posées
Quelles erreurs dois-je réessayer ?
131016 et 131000, avec un délai progressif. 130429, 132015 et 133008 disparaissent d'eux-mêmes si vous attendez. Toutes les autres sont déterministes.
Un code d'erreur signifie-t-il que mon numéro est déconnecté ?
Généralement non. La plupart concernent la requête, le template ou le destinataire. Les problèmes de connexion apparaissent dans les webhooks de compte et de qualité, pas comme des erreurs d'envoi.
Qu'est-ce qu'un trace id ?
Un identifiant présent dans la réponse qui permet au support Meta de retrouver la requête précise. Journalisez-le à chaque échec : sans lui, un ticket ne peut pas être traité.
Ces codes sont-ils identiques chez tous les fournisseurs ?
Oui. Ils viennent de la Cloud API de Meta et sont donc identiques, quel que soit le fournisseur qui a connecté le numéro. Un fournisseur peut seulement modifier la clarté avec laquelle ils vous parviennent.
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 gratuitAucun frais pendant 3 jours. Annulez à tout moment.