Erreurs de l’API WhatsApp Business : que signifie chaque code et comment le corriger

L’API WhatsApp Business ne fonctionne pas : vérifiez d’abord ces cinq points

Quand tous les messages s’arrêtent d’un coup, la cause est presque toujours l’une de cinq choses, et vous pouvez toutes les vérifier en quelques minutes. Parcourez-les dans cet ordre, car les premières vérifications concernent tous les messages et la dernière ne concerne que certains clients.

1. 1

   Vérifiez la page d’état de Meta

   Ouvrez la page d’état de l’API WhatsApp Business de Meta. Si Meta signale un problème, attendez qu’il soit résolu avant de modifier des paramètres. Les codes 1, 2, 131016 et 133004 renvoient ici.
2. 2

   Vérifiez l’état de votre numéro dans Whapi

   Dans le tableau de bord Whapi à l’intérieur de Shopify, votre numéro WhatsApp doit afficher un statut vert. Meta n’envoie et ne reçoit des messages que pour les numéros au statut Connected. S’il n’est pas connecté, cliquez sur Connect WhatsApp et reconnectez-le.
3. 3

   Vérifiez le moyen de paiement dans Meta

   Ouvrez WhatsApp Manager et cherchez une invitation Add payment method sur la page Overview. Sans moyen de paiement valide, les messages modèles échouent, souvent avec l’erreur 131042. Suivez le guide du moyen de paiement.
4. 4

   Vérifiez le statut du modèle

   Chaque automatisation Whapi envoie un modèle que Meta doit valider. Un modèle encore en cours d’examen, refusé ou suspendu échoue avec 132001, 132015 ou 132016. Voir pourquoi les modèles sont refusés.
5. 5

   Vérifiez le numéro du client

   Si seuls certains clients ne reçoivent pas les messages, regardez le code du message en échec. 131026 signifie que le numéro ne peut pas recevoir de messages WhatsApp, 131047 que la fenêtre de 24 heures est fermée, 131049 et 131050 concernent les messages marketing.

Erreurs de configuration et de connexion

Les erreurs de configuration apparaissent dans la fenêtre d’inscription de Meta après avoir cliqué sur Connect WhatsApp dans Whapi. Elles viennent du parcours Embedded Signup de Meta ; la formulation ci-dessous est donc celle de Meta, et la correction se fait du côté de Meta ou de WhatsApp.

« Your phone number isn’t eligible to connect to the WhatsApp Business Platform »

Il s’agit du code 3441045 de Meta, affiché lorsque vous connectez le numéro d’une WhatsApp Business App. La seule résolution indiquée par Meta est qu’il faut plus d’activité sur la WhatsApp Business App pour déterminer l’éligibilité, et Meta ne publie aucun minimum. Le guide du numéro non éligible détaille ce qu’il faut faire ainsi que les erreurs de vérification associées.

« This number is registered to an existing WhatsApp account »

Meta affiche ce message lorsque le numéro est déjà utilisé sur WhatsApp Messenger, la WhatsApp Business App ou l’API WhatsApp Business. Si le numéro est sur la WhatsApp Business App et que vous voulez continuer à utiliser l’application, choisissez plutôt Connect a WhatsApp Business App dans la configuration de Whapi (c’est la Coexistence WhatsApp). Pour utiliser le numéro uniquement avec l’API, supprimez d’abord le compte WhatsApp sur le téléphone. Meta indique que le numéro peut mettre jusqu’à 3 minutes à redevenir disponible.

« The business is already sharing this WhatsApp Business account with a partner »

Il s’agit du code 2655093. Le numéro de votre WhatsApp Business App est encore connecté à un autre fournisseur, et Meta ne permet pas de changer de partenaire dans ce parcours. Déconnectez le partenaire actuel dans la WhatsApp Business App sous Settings > Account > Business Platform, attendez 15 minutes, puis reconnectez-vous. Le guide pour migrer votre numéro vers Whapi couvre à la fois les numéros en Coexistence et ceux réservés à l’API.

La fenêtre de Meta ne s’ouvre pas ou se ferme en cours de route

L’inscription de Meta s’exécute dans une fenêtre contextuelle. Lancez la configuration de Whapi sur un ordinateur, autorisez les fenêtres contextuelles pour votre interface d’administration Shopify dans le navigateur et rechargez la page. Si Meta affiche « Your Facebook account is too new to create a business account. Try again in an hour », attendez ou connectez-vous avec un compte Facebook plus ancien et actif. S’il affiche « User does not have permission to create WhatsApp Business Accounts », il vous faut un accès Administrateur au portefeuille d’entreprise que vous avez sélectionné.

Nom d’affichage refusé

Meta vérifie votre nom d’affichage WhatsApp par rapport à ses consignes sur les noms d’affichage. Si l’inscription affiche « Your verified name violates WhatsApp guidelines. Please edit your verified name and try again », consultez les consignes sur les noms d’affichage (en anglais) et saisissez un nom qui les respecte. Vous pouvez modifier un nom d’affichage jusqu’à 10 fois en 30 jours dans WhatsApp Manager, sous Account tools > Phone numbers > Profile. L’erreur 131037 ne concerne que les numéros professionnels 555 fournis par Meta sans nom d’affichage validé.

Vérification d’entreprise et limites de numéros

Un nouveau portefeuille d’entreprise peut enregistrer deux numéros de téléphone professionnels. Meta relève ce plafond à 20 une fois l’entreprise vérifiée ou lorsqu’elle atteint une limite d’envoi de 2 000. Tant que la vérification n’est pas terminée, Meta limite aussi le nombre de comptes WhatsApp Business que vous pouvez créer (code 2388098). Voir la vérification d’entreprise Meta pour WhatsApp pour les documents et les étapes.

Erreurs de paiement et de facturation

L’erreur 131042, « There was an error related to your payment method », signifie que Meta ne peut pas facturer le compte Messaging qui envoie vos messages. La liste des causes de Meta comprend l’absence de compte de paiement rattaché, une ligne de crédit au-delà de sa limite, un compte WhatsApp Business supprimé ou suspendu, et un fuseau horaire ou une devise jamais définis.

Depuis le 1er octobre 2026, l’absence de moyen de paiement interrompt aussi les messages de service une fois épuisés les 1 000 messages gratuits par numéro professionnel et par mois, et les modèles Utility envoyés dans une fenêtre de 24 heures ouverte sont facturés. L’article sur la modification tarifaire d’octobre 2026 détaille le sujet.

Le guide du moyen de paiement explique comment ajouter une carte dans WhatsApp Manager et les erreurs de carte que Meta affiche, comme « Couldn’t save payment method ». Les prix des messages par pays figurent sur la page des tarifs de l’API WhatsApp.

Erreurs de distribution des messages

Les erreurs de distribution concernent un client ou un message à la fois ; le reste de vos messages continue donc de partir. Considérez-les comme une information sur ce client et évitez de renvoyer le même message en boucle.

131026 : message non distribuable

Meta donne trois raisons : le numéro n’est pas un numéro WhatsApp, le client n’a pas accepté les dernières conditions d’utilisation de WhatsApp, ou l’application du client est plus ancienne que le minimum pris en charge par Meta. Si une confirmation de commande échoue, appelez le client ou envoyez-lui un SMS. Le guide de l’erreur 131026 liste les vérifications.

131047 : fenêtre de 24 heures fermée

Les réponses libres ne sont autorisées que dans les 24 heures suivant le dernier message du client. Passé ce délai, envoyez un modèle validé. En savoir plus sur l’ erreur 131047 et la fenêtre de service client.

131049 et 131050 : messages marketing retenus

131049 signifie que Meta a limité les modèles marketing pour ce client « to maintain healthy ecosystem engagement » ; attendez au moins 24 heures avant de renvoyer. 131050 signifie que le client a choisi de ne plus recevoir de messages marketing de votre entreprise ; ne réessayez donc pas. Les deux concernent les modèles marketing. Voir le guide de l’erreur 131049.

130429 et 131056 : envoi trop rapide

130429 signifie que le débit de messages du numéro a été atteint ; réessayez plus tard. 131056 signifie que trop de messages ont été envoyés au même client en peu de temps ; attendez avant de lui écrire de nouveau, les autres clients n’étant pas concernés.

131021 : test envoyé à votre propre numéro professionnel

Meta ne délivre pas un message d’un numéro vers lui-même. Quand vous utilisez Send Test Message dans Whapi, saisissez un numéro WhatsApp personnel différent du numéro professionnel.

Erreurs de modèles

Les erreurs de modèles signifient que Meta n’a pas validé le modèle, que les variables du message ne correspondent pas, ou que Meta l’a suspendu parce que des clients l’ont bloqué ou signalé. Whapi soumet les modèles à Meta lorsque vous configurez une automatisation, et Meta décide de la catégorie et de la validation.

• 132001 : le modèle n’existe pas dans cette langue ou n’est pas validé. Vérifiez son statut dans Whapi ou WhatsApp Manager.
• 132000 et 132012 : les variables envoyées ne correspondent pas au nombre ou au format du modèle. Faites-les correspondre, ou communiquez le nom de l’automatisation au support Whapi.
• 132005 : une traduction est trop longue. Raccourcissez cette version linguistique.
• 132007 : le contenu enfreint une politique de WhatsApp. Voir pourquoi Meta refuse des modèles.
• 132015 et 132016 : suspendu pour faible qualité, puis définitivement désactivé après des suspensions répétées. Modifiez un modèle suspendu ; remplacez un modèle désactivé par un nouveau contenu.
• 131064 : le compte a atteint une limite d’envoi pour violations de la classification des modèles. Veillez à rédiger les notifications de commande en Utility et les promotions en Marketing. Le guide Utility ou Marketing explique la différence.
• 2388019 : le compte a déjà atteint le maximum de 250 modèles. Supprimez ceux que vous n’utilisez plus.
• Modèle recatégorisé en Marketing : il n’existe pas de code d’erreur pour cela. Depuis le 9 avril 2025, un modèle soumis comme Utility que Meta juge Marketing est validé comme Marketing, et Meta peut aussi modifier plus tard la catégorie d’un modèle validé. Un contenu mixte, comme une notification de commande avec un code de réduction, compte comme Marketing. Vous pouvez demander un réexamen dans les 60 jours suivant le changement de catégorie.

Indice de qualité, limites d’envoi et restrictions de compte

Meta abaisse les limites ou restreint un numéro lorsque des clients bloquent ou signalent ses messages, ou lorsque l’entreprise enfreint une politique WhatsApp Business. Whapi utilise l’API WhatsApp Business officielle de Meta, ce qui évite les blocages que déclenchent les outils WhatsApp Web non officiels, mais Meta peut tout de même limiter n’importe quel numéro qui enfreint ses politiques.

Limites d’envoi

Une limite d’envoi plafonne le nombre de clients uniques que vous pouvez contacter en dehors d’une fenêtre de service client sur une période glissante de 24 heures. Elle est fixée par portefeuille d’entreprise et partagée par tous ses numéros. Les nouveaux portefeuilles démarrent à 250. Pour atteindre 2 000, vérifiez votre entreprise, ou envoyez 2 000 messages délivrés en dehors des fenêtres de service à des clients uniques en 30 jours avec des modèles de haute qualité. Ensuite, Meta relève automatiquement la limite à 10 000, 100 000 puis illimitée lorsque la qualité reste élevée et que vous utilisez au moins la moitié de votre limite actuelle en 7 jours. Consultez la vôtre dans WhatsApp Manager sous Account tools > Messaging limits.

131048, 368 et 131031 : envois ou comptes restreints

131048 signifie que l’envoi depuis le numéro est restreint parce que trop de messages précédents ont été bloqués ou signalés comme spam ; vérifiez l’état de qualité dans WhatsApp Manager. Les codes 368 et 131031 signifient que le compte a été restreint ou désactivé pour violation d’une politique. Lisez l’alerte dans Business Support Home et faites-y appel si vous pensez qu’il s’agit d’une erreur. Le code 130497 signifie que la catégorie de votre entreprise ne permet pas d’écrire à des clients dans certains pays.

Gardez un bon indice de qualité

• N’écrivez qu’aux clients qui ont commandé chez vous ou qui ont donné leur opt-in.
• Envoyez les notifications de commande, comme les confirmations de commande, en modèles Utility et gardez les promotions dans des modèles Marketing.
• Gardez un marketing pertinent et peu fréquent, et facilitez la désinscription.

Coexistence, appels, Flows et noms d’utilisateur

Ces erreurs viennent de fonctionnalités WhatsApp plus récentes. La plupart des boutiques ne les rencontrent qu’en connectant le numéro d’une WhatsApp Business App ou en testant une fonctionnalité que Meta déploie encore.

Coexistence : erreurs d’association et listes de diffusion

La Coexistence connecte le numéro de votre WhatsApp Business App à l’API pour que vous puissiez continuer à discuter depuis votre téléphone pendant que Whapi envoie des automatisations. Meta désactive les listes de diffusion dans l’application une fois la connexion faite, et les listes existantes passent en lecture seule. « Error while pairing Cloud API » et les autres erreurs d’association, l’historique des conversations manquant et les déconnexions sont traités dans la Coexistence WhatsApp ne fonctionne pas.

« Calling APIs cannot be enabled for this phone number »

L’erreur 138015 de Meta signifie que les appels WhatsApp Business ne peuvent pas encore être activés pour ce numéro. La solution de Meta est de s’assurer que la limite d’envoi du numéro est de 2 000 ou plus. Suivez les étapes sur les limites d’envoi ci-dessus pour y arriver.

WhatsApp Flows : « Blocked By Integrity »

L’erreur 139000 signifie que Meta a identifié un problème d’intégrité sur le compte qui empêche de créer ou de publier un Flow. Consultez Business Support Home pour voir les restrictions sur l’entreprise, puis contactez le support de Meta, seule voie que Meta indique pour ce code.

Identifiants utilisateur propres à l’entreprise (BSUID)

WhatsApp introduit des noms d’utilisateur facultatifs ; Meta identifie donc désormais aussi les clients par un identifiant utilisateur propre à l’entreprise (BSUID), unique pour chaque portefeuille d’entreprise. Certains types de messages ne peuvent pas être adressés à un BSUID, et Meta renvoie 131062, « Business-scoped User ID (BSUID) recipients are not supported for this message. » Envoyer au numéro de téléphone du client l’évite. Les commandes Shopify contiennent le numéro de téléphone, qui est celui qu’utilisent les automatisations de commande.

Pannes de Meta et accès expiré

Les codes 2, 131016 et 133004 signifient que le service de Meta est surchargé ou brièvement indisponible ; la solution est d’attendre et de réessayer. Le code 1 peut être une erreur de serveur ou une requête mal formée, et le conseil de Meta pour ces quatre codes est de consulter d’abord metastatus.com. 131000 est une erreur inconnue ; réessayez une fois et signalez-la si elle se répète.

Les codes 0 et 190 signifient que le jeton d’accès qui permet à Whapi d’envoyer pour votre compte a expiré ou a été invalidé. Meta cite aussi comme cause un paramètre utilisateur qui bloque l’accès de toutes les applications à ses données. Les codes 10 et 200 à 299 signifient qu’une autorisation a été retirée. Dans chaque cas, reconnectez WhatsApp depuis le tableau de bord Whapi pour que Meta délivre un nouvel accès.

Comment obtenir de l’aide pour une erreur de l’API WhatsApp

Envoyez d’abord le code d’erreur, car il indique au support où chercher. Le support Whapi répond par e-mail à info@usewhapi.com et sur WhatsApp. Indiquez :

• le code d’erreur et le message de Meta, ou une capture d’écran ;
• la date et l’heure de l’incident, avec votre fuseau horaire ;
• le numéro de commande Shopify ou l’automatisation concernée ;
• si tous les messages échouent ou seulement ceux de certains clients.

Pour les problèmes de compte, de facturation ou de politique que seul Meta peut résoudre, ouvrez un ticket dans Meta Direct Support. Pour les problèmes de carte, Meta vous demande de choisir le sujet « Dev: Billing, Credit & Pricing » et le type de demande « Credit Card Billing ». Si vous ne voyez pas ce sujet, Meta indique de demander à votre fournisseur d’ouvrir le ticket ; écrivez-nous donc et nous le ferons. Vous pouvez aussi nous joindre via la page de contact.