Se connecterCommencer l’essai gratuit
Meta Tech Provider

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.

Messages non stockés par défautApplication Business + Cloud APIMCP pour Claude et ChatGPTOpérationnel en 2 minutes

Requête

CodeCe que cela signifieRéessayer
100Un paramètre n'est pas pris en charge, est mal orthographié ou mal formé.Non
131008Un paramètre obligatoire n'a pas été inclus du tout.Non
131009Un paramètre est présent avec une valeur que l'endpoint rejette.Non
131021L'expéditeur et le destinataire sont le même numéro.Non
131051Le type de message n'est pas pris en charge, souvent à cause d'une limite de Coexistence.Non
131052Meta n'a pas pu télécharger un média envoyé par un client.Non
131053Meta n'a pas pu importer un média que vous avez envoyé. Taille, format ou accessibilité.Non

Template

CodeCe que cela signifieRéessayer
132000Le nombre de paramètres ne correspond pas au template.Non
132001Aucun template n'existe pour cette paire nom et langue.Non
132007Le template enfreint la politique de messagerie. Réécrivez-le et soumettez-le à nouveau.Non
132012Le format du paramètre ne correspond pas à ce que définit le template.Non
132015Le template est suspendu après une baisse de qualité. C'est temporaire.Attendre
132016Le template est désactivé définitivement. Il ne reviendra pas.Non

Fenêtre et destinataire

CodeCe que cela signifieRéessayer
131047La fenêtre de service client de 24 heures est fermée. Envoyez un template.Non
131026Le destinataire ne peut pas recevoir le message du tout.Non
131050La personne s'est désinscrite. Il n'y a aucun contournement, par conception.Non
130497L'envoi de messages vers ce pays est restreint pour votre compte.Non

Enregistrement et PIN

CodeCe que cela signifieRéessayer
131045Le numéro n'a jamais été enregistré pour la messagerie Cloud API.Non
133010Le numéro n'est pas enregistré. L'enregistrement doit être finalisé.Non
133006Le numéro doit être vérifié avant de pouvoir être enregistré.Non
133005Le PIN de vérification en deux étapes était incorrect. Arrêtez de deviner.Non
133008Trop de tentatives de PIN. L'enregistrement est bloqué pendant un certain temps.Attendre

Accès et compte

CodeCe que cela signifieRéessayer
190Le token d'accès a expiré ou a été invalidé.Non
368Le compte est restreint après une violation des règles.Non
131031Le compte est restreint, ou ses données ne correspondent pas à celles de Meta.Non
131042Un problème de paiement sur le compte professionnel bloque l'envoi.Non
131049Meta a bloqué le message pour préserver la santé de l'écosystème.Non

Limites de débit

CodeCe que cela signifieRéessayer
130429La limite de débit de messages du compte a été atteinte.Attendre
131048Une limite anti-spam a été atteinte. La cause est la qualité, pas le volume.Non
131056Trop de messages entre votre numéro et un même destinataire.Non
80007Le compte a atteint sa limite d'appels de gestion. Souvent du polling.Attendre

Temporaires

CodeCe que cela signifieRéessayer
131016Un service Meta est temporairement indisponible.Oui
131000Échec non classé. Réessayez une fois, puis escaladez avec le trace id.Oui

Synchronisation Coexistence

CodeCe que cela signifieRéessayer
2593107La limite de synchronisation de l'historique des discussions a été dépassée.Non
2593108Une synchronisation a été tentée en dehors de la fenêtre de synchronisation de 24 heures.Non

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.

Poursuivre la lecture