Plateforme WhatsApp Business > API Cloud

Codes d’erreur de l’API Cloud

L’API Cloud étant basée sur l’API Graph, si vous n’avez pas l’habitude de gérer les erreurs renvoyées par l’API Graph, consultez la documentation sur la gestion des erreurs.

En général, nous vous recommandons d’articuler la logique de gestion des erreurs de votre application autour des valeurs code et des propriétés de charge utile details. Ces valeurs et propriétés sont des indicateurs plus fiables de l’erreur sous-jacente.

Les titres de code, qui ne disposent pas d’une propriété dédiée dans les charges utiles de réponse aux erreurs d’API, sont inclus dans le cadre de la valeur message. Cependant, nous vous recommandons de ne pas compter sur les titres pour votre logique de gestion des erreurs, car ils finiront par devenir obsolètes.

Réception des erreurs : synchrone et asynchrone

L’API Cloud renvoie les erreurs soit de manière asynchrone par réponse de l’API Graph, soit de manière asynchrone par webhook, et parfois par ces deux moyens.

Si vous travaillez avec l’API Cloud, il est recommandé de gérer les erreur en surveillant à la fois la réponse de l’API Graph et le webhook messages. Si vous êtes abonné·e au champ de webhook messages, vous recevez la notification des erreurs de type asynchrone prises en charge.

Webhooks et syntaxe des erreurs renvoyées

Les erreurs renvoyées par l’API Cloud peuvent être présentées dans les objets webhook suivants :

API Cloud

entry.changes.value.errors
entry.changes.value.messages.errors

API On-Premises

errors

Syntaxe de l’erreur renvoyée

{
  "error": {
    "message": "<MESSAGE>",
    "type": "<TYPE>",
    "code": <CODE>,
    "error_data": {
        "messaging_product": "whatsapp",
        "details": "<DETAILS>"
    },
    "error_subcode": <ERROR_SUBCODE>
    "fbtrace_id": "<FBTRACE_ID>"
  }
}

Contenu de l’erreur renvoyée

Propriété	Type de valeur	Description
`code`	Entier	Code d’erreur. Nous vous recommandons d’articuler le système de gestion des erreurs de votre application autour de codes d’erreur au lieu de sous-codes ou de codes de statut de réponse HTTP.
`details`	Chaîne	Description de l’erreur et description de la cause la plus probable de cette erreur. Peut également contenir des informations sur la manière de résoudre l’erreur, par exemple en indiquant les paramètres non valides ou les valeurs acceptables.
`error_subcode`	Entier	Obsolète. N’apparaîtra pas dans les réponses renvoyées avec la version 16.0 et les suivantes. Sous-code de l’API Graph. Comme les réponses n’incluent pas toutes un sous-code, nous vous recommandons d’articuler votre logique de gestion des erreurs autour des propriétés `code` et `details`.
`fbtrace_id`	Chaîne	Identifiant de suivi que vous pouvez inclure lorsque vous contactez l’Assistance directe. Cet identifiant peut nous permettre de débuguer l’erreur.
`message`	Chaîne	Combinaison du code d’erreur et de son titre. Par exemple : `(#130429) Rate limit hit`.
`messaging_product`	Chaîne	Produit de messagerie. Il s’agira toujours de la chaîne `whatsapp` pour les réponses de l’API Cloud.
`type`	Chaîne	Type d’erreur.

Exemple de réponse

{
  "error": {
    "message": "(#130429) Rate limit hit",
    "type": "OAuthException",
    "code": 130429,
    "error_data": {
        "messaging_product": "whatsapp", 
        "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time"
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

Codes d’erreur

Erreurs d’autorisation

Code	Description	Solutions possibles	Code de statut HTTP
`0` Exception d’authentification	Nous n’avons pas pu authentifier l’utilisateur ou l’utilisatrice de l’application.	Cela signifie généralement que le token d’accès inclus a expiré, a été invalidé ou que l’utilisateur·ice de l’application a modifié un paramètre pour empêcher toutes les applications d’accéder à ses données. Nous vous recommandons d’obtenir un nouveau token d’accès.	`401` Non autorisé
`3` Méthode d’API	Problème de fonctionnalité ou d’autorisation.	Utilisez le débogueur de token d’accès pour vérifier que votre application a obtenu les autorisations requises par le point de terminaison. Consultez la section Dépannage.	`500` Erreur de serveur interne
`10` Autorisation refusée	L’autorisation n’a pas été accordée ou a été supprimée.	Utilisez le débogueur de token d’accès pour vérifier que votre application a obtenu les autorisations requises par le point de terminaison. Consultez la section Dépannage. Assurez-vous que le numéro de téléphone utilisé pour définir la clé publique de l’entreprise est sur la liste d’éléments autorisés.	`403` Interdit
`190` Token d’accès expiré	Votre token d’accès a expiré.	Obtenez un nouveau token d’accès.	`401` Non autorisé
`200-299` Autorisation API	L’autorisation n’a pas été accordée ou a été supprimée.	Utilisez le débogueur de token d’accès pour vérifier que votre application a obtenu les autorisations requises par le point de terminaison. Consultez la section Dépannage.	`403` Interdit

Erreurs de limitation de bande passante

Code	Description	Solutions possibles	Code de statut HTTP
`4` Appels d’API trop nombreux	L’application a atteint la limite d’appels d’API.	Chargez l’application dans l’Espace App et consultez la section Plafond de l’application pour vérifier si l’application a atteint son plafond. Si c’est le cas, réessayez plus tard ou réduisez la fréquence ou le nombre de requêtes d’API effectuées par l’application.	`400` Requête erronée
`80007` Problèmes de plafond	Le compte WhatsApp Business a atteint son plafond.	Consultez les plafonds du compte WhatsApp Business. Réessayez plus tard ou réduisez la fréquence ou le nombre de requêtes d’API effectuées par l’application.	`400` Requête erronée
`130429` Plafond atteint	Le débit de messages de l’API Cloud a été atteint.	L’application a atteint la limite de débit de l’API. Consultez la section Débit. Réessayez plus tard ou réduisez la fréquence à laquelle l’application envoie des messages.	`400` Requête erronée
`131048` Limite du taux de spam atteinte	Impossible d’envoyer le message, car des restrictions s’appliquent quant au nombre de messages qu’il est possible d’envoyer à partir de ce numéro de téléphone. Cela peut être dû au fait que de nombreux messages précédemment envoyés ont été bloqués ou marqués comme étant du spam.	Vérifiez le statut de la qualité dans le Gestionnaire WhatsApp et consultez la documentation sur les plafonds selon l’indice de qualité pour plus d’informations.	`400` Requête erronée
`131056` (compte business, compte consommateur) limite de taux de paire atteinte	Trop de messages envoyés par le numéro de téléphone de l’expéditeur·ice au même numéro de téléphone destinataire dans un court laps de temps.	Patientez, puis réessayez si vous souhaitez envoyer des messages au même numéro de téléphone. Vous pouvez toujours envoyer des messages à un autre numéro de téléphone sans attendre.	`400` Requête erronée
`133016` Plafond d’inscriptions ou de désinscriptions dépassé	Échec de l’inscription ou de la désinscription en raison d’un trop grand nombre de tentatives pour ce numéro de téléphone sur une courte période	Le numéro de téléphone professionnel est bloqué parce qu’il a atteint sa limite de tentatives d’inscription/de désinscription. Réessayez une fois le numéro débloqué. Voir « Limites » dans le document Inscription.	`400` Requête erronée

Erreurs d’intégrité

Code Description Solutions possibles Code de statut HTTP

Code	Description	Solutions possibles	Code de statut HTTP
`368` Temporairement bloqué pour infraction aux politiques	Le compte WhatsApp Business associé à l’application a été restreint ou désactivé pour avoir enfreint une politique de la plateforme.	Consultez le document Mise en application de la politique pour en savoir plus sur les infractions aux politiques et sur les manières de les résoudre.	`403` Interdit
`131031` Compte verrouillé	Le compte WhatsApp Business associé à l’application a été restreint ou désactivé pour avoir enfreint une politique de la plateforme, ou nous n’avons pas été en mesure de vérifier les données incluses dans la requête par rapport aux données définies sur le compte WhatsApp Business (par exemple, le code PIN en deux étapes inclus dans la requête est incorrect).	Consultez le document Mise en application de la politique pour en savoir plus sur les infractions aux politiques et sur les manières de les résoudre. Vous pouvez également utiliser l’API Health Status, qui peut fournir des informations supplémentaires sur la ou les raisons pour lesquelles le compte est verrouillé.	`403` Interdit

368

Temporairement bloqué pour infraction aux politiques

Le compte WhatsApp Business associé à l’application a été restreint ou désactivé pour avoir enfreint une politique de la plateforme.

Consultez le document Mise en application de la politique pour en savoir plus sur les infractions aux politiques et sur les manières de les résoudre.

403

Interdit

131031

Compte verrouillé

Le compte WhatsApp Business associé à l’application a été restreint ou désactivé pour avoir enfreint une politique de la plateforme, ou nous n’avons pas été en mesure de vérifier les données incluses dans la requête par rapport aux données définies sur le compte WhatsApp Business (par exemple, le code PIN en deux étapes inclus dans la requête est incorrect).

Consultez le document Mise en application de la politique pour en savoir plus sur les infractions aux politiques et sur les manières de les résoudre.

Vous pouvez également utiliser l’API Health Status, qui peut fournir des informations supplémentaires sur la ou les raisons pour lesquelles le compte est verrouillé.

403

Interdit

Autres erreurs

Code Description Solutions possibles Code de statut HTTP

Code	Description	Solutions possibles	Code de statut HTTP
`1` API inconnue	Requête non valide ou erreur possible du serveur.	Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API. S’il n’y a pas de panne de serveur, consultez la référence du point de terminaison et vérifiez que votre requête est formatée correctement et qu’elle satisfait à toutes les conditions requises pour les points de terminaison.	`400` Requête erronée
`2` Service d’API	Problème temporaire à cause d’un temps d’inactivité ou d’une surcharge.	Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API avant de réessayer.	`503` Service indisponible
`33` La valeur du paramètre n’est pas valide.	Le numéro de téléphone professionnel a été supprimé.	Vérifiez que le numéro de téléphone professionnel est correct.	`400` Requête erronée
`100` Paramètre non valide	La requête comprenait un ou plusieurs paramètres non pris en charge ou mal orthographiés.	Consultez la référence du point de terminaison pour déterminer quels paramètres sont pris en charge et comment ils sont orthographiés. Lors de la configuration, assurez-vous que la clé publique de l’entreprise est une clé publique RSA 2048 bits au format PEM. Veillez à ce qu’il n’y ait pas de confusion entre l’ID du numéro de téléphone que vous enregistrez et un ID de numéro de téléphone déjà stocké. Vérifiez que votre paramètre respecte les éventuelles restrictions de caractères applicables.	`400` Requête erronée
`130472` Le numéro de l’utilisateur·ice fait partie d’une expérimentation	Le message n’a pas été envoyé du fait d’une expérimentation.	Consultez la section Marketing Message Experiment (Expérimentation relative aux messages marketing).	`400` Requête erronée
`131000` Une erreur s’est produite	Impossible d’envoyer le message en raison d’une erreur inconnue. Lors de la configuration d’une clé publique d’entreprise, la signature n’a pas pu être calculée, le point de terminaison GraphQL n’a pu être appelé ou le point de terminaison GraphQL a renvoyé une erreur.	Réessayez. Si l’erreur persiste, contactez l’Assistance directe.	`500` Erreur de serveur interne
`131005` Accès refusé	L’autorisation n’a pas été accordée ou a été supprimée.	Utilisez le débogueur de token d’accès pour vérifier que votre application a obtenu les autorisations requises par le point de terminaison. Consultez la section Dépannage.	`403` Interdit
`131008` Le paramètre requis est manquant	Il manque un paramètre requis dans la requête.	Consultez la référence du point de terminaison pour déterminer quels paramètres sont requis.	`400` Requête erronée
`131009` La valeur du paramètre n’est pas valide.	Une ou plusieurs valeurs de paramètres sont incorrectes.	Consultez la référence du point de terminaison pour déterminer quelles valeurs sont prises en charge pour chaque paramètre et consultez la section Numéros de téléphone pour savoir comment ajouter un numéro de téléphone dans un compte WhatsApp Business.	`400` Requête erronée
`131016` Service indisponible	Un service est temporairement indisponible.	Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API avant de réessayer.	`500` Erreur de serveur interne
`131021` La personne destinataire ne peut pas être l’expéditeur·ice	Le numéro de téléphone de l’expéditeur·ice et celui de la personne destinataire sont les mêmes.	Envoyez un message à un numéro de téléphone différent de celui de l’expéditeur·ice.	`400` Requête erronée
`131026` Message impossible à distribuer	Impossible de distribuer le message. Plusieurs raisons peuvent expliquer cela : Le numéro de téléphone du destinataire n’est pas un numéro WhatsApp. Un modèle d’authentification a été envoyé à un utilisateur ou une utilisatrice de WhatsApp dont l’indicatif pays est +91 (Inde). Pour le moment, les modèles d’authentification ne peuvent pas être envoyés aux utilisateurs et utilisatrices de WhatsApp en Inde. Le destinataire n’a pas accepté nos nouvelles conditions d’utilisation et politique de confidentialité. La personne destinataire utilise une version de WhatsApp trop ancienne ; la version minimale de WhatsApp doit être : Android : 2.21.15.15 SMBA : 2.21.15.15 iOS : 2.21.170.4 SMBI : 2.21.170.4 KaiOS : 2.2130.10 Web : 2.2132.6 Le message n’a pas été distribué pour créer une expérience d’utilisation de grande qualité. Consultez Limites de messages basés sur un modèle marketing par utilisateur·ice.	Utilisez un mode de communication autre que WhatsApp pour demander à la personne utilisant WhatsApp de : vérifier qu’il lui est possible d’envoyer un message à votre numéro de téléphone WhatsApp Business ; vérifier qu’elle a accepté nos dernières Conditions générales (Paramètres > Aide ou Paramètres > Informations sur l’application pour afficher une invite à accepter les dernières conditions/politiques si ce n’est pas déjà fait) ; mettre à jour le client WhatsApp vers la dernière version.	`400` Requête erronée
`131042` Admissibilité des entreprises - problème de paiement	Il y a eu une erreur liée à votre méthode de paiement.	Consultez la section À propos de la facturation de votre compte WhatsApp Business et vérifiez que vous avez configuré la facturation correctement. Problèmes courants : Compte de paiement non associé à un compte WhatsApp Business Ligne de crédit supérieure à la limite Ligne de crédit (compte de paiement) non définie ou non active Compte WhatsApp Business supprimé Compte WhatsApp Business suspendu Fuseau horaire non défini Devise non définie Requête MessagingFor (On Behalf Of (au nom de)) en attente ou refusée Dépassement du seuil gratuit de conversation sans moyen de paiement valide	`400` Requête erronée
`131045` Certificat incorrect	Impossible d’envoyer le message à cause d’une erreur d’inscription du numéro de téléphone.	Inscrivez le numéro de téléphone avant de réessayer.	`500` Erreur de serveur interne
`131047` Message de réengagement	Plus de 24 heures se sont écoulées depuis la dernière réponse de la personne destinataire au numéro de l’expéditeur·ice.	Envoyez à la personne destinataire un message initié par l’entreprise en utilisant un modèle de message.	`400` Requête erronée
`131051` Type de message non pris en charge	Type de message non pris en charge.	Consultez la section Messages pour voir les types de messages pris en charge avant de réessayer en utilisant un type de message pris en charge.	`400` Requête erronée
`131052` Erreur de téléchargement de contenu multimédia	Impossible de télécharger le contenu multimédia envoyé par l’utilisateur ou l’utilisatrice.	Nous n’avons pas pu télécharger le contenu multimédia pour une ou plusieurs raisons, par exemple, parce que le type de contenu multimédia n’est pas pris en charge. Pour en savoir plus sur l’origine du problème, consultez la valeur `error.error_data.details`. Demandez à l’utilisateur·ice d’envoyer le fichier multimédia par un autre moyen que WhatsApp.	`400` Requête erronée
`131053` Erreur d’importation de contenu multimédia	Impossible d’importer le contenu multimédia utilisé dans le message.	Nous n’avons pas pu importer le contenu multimédia pour une ou plusieurs raisons. Il se peut, par exemple, que le type de contenu multimédia ne soit pas pris en charge. Pour en savoir plus sur l’origine du problème, consultez la valeur `error.error_data.details`. Nous vous recommandons de vérifier si les fichiers multimédias à l’origine d’erreurs sont effectivement pris en charge. Par exemple, dans UNIX, vous pouvez utiliser l’inspection de fichier via la ligne de commande pour déterminer son type MIME : `file -I rejected-file.mov` Vous pouvez ensuite vous assurer que son type MIME se trouve bien dans notre liste de types de contenus multimédias pris en charge. Pour optimiser vos envois de contenus multimédias, consultez les pages Mise en cache HTTP de contenus multimédias et Importer le contenu multimédia.	`400` Requête erronée
`131057` Compte en mode maintenance	Compte business en mode maintenance	Le compte WhatsApp Business est en mode maintenance. Il est possible qu’une mise à niveau de débit soit en cours sur le compte.	`500` Requête erronée
`132000` Non-concordance du nombre de paramètres du modèle	Le nombre de valeurs de paramètres variables inclus dans la requête ne correspondait pas au nombre de paramètres variables défini dans le modèle.	Consultez la section Règles relatives aux modèles de message et assurez-vous que la requête comporte toutes les valeurs de paramètres variables qui ont été définies dans le modèle.	`400` Requête erronée
`132001` Modèle inexistant	Le modèle n’existe pas dans la langue indiquée ou n’a pas été approuvé.	Vérifiez que le modèle a été approuvé et que son nom et sa langue sont corrects. Veillez à respecter les règles relatives aux modèles de message.	`404` Introuvable
`132005` Texte inséré dans le modèle trop long	Le texte traduit est trop long.	Ouvrez le Gestionnaire WhatsApp pour vérifier que votre modèle a été traduit. Consultez la section Indice de qualité et statut des modèles.	`400` Requête erronée
`132007` Non-respect de la politique relative au format de caractères du modèle	Le contenu du modèle enfreint une politique WhatsApp.	Consultez la section Motifs de rejets pour déterminer les causes possibles de l’infraction.	`400` Requête erronée
`132012` Non-concordance du format de paramètres du modèle	Valeurs de paramètres variables mal formatées.	Les valeurs des paramètres variables incluses dans la requête n’utilisent pas le format spécifié dans le modèle. Consultez la section Règles relatives aux modèles de message.	`400` Requête erronée
`132015` Modèle en pause	La qualité du modèle étant dégradée, celui-ci a été mis en pause et ne peut pas être envoyé dans un message de modèle.	Améliorez la qualité du modèle et réessayez une fois le modèle approuvé.	`400` Requête erronée
`132016` Modèle désactivé	La qualité du modèle étant dégradée, celui-ci a été mis en pause trop souvent et a été définitivement désactivé.	Créez un modèle avec un autre contenu.	`400` Requête erronée
`132068` Flux bloqué	Le flux est à l’état bloqué.	Corrigez le flux.	`400` Requête erronée
`132069` Flux régulé	L’état du flux est « régulé », et 10 messages utilisant ce flux ont déjà été envoyés au cours de la dernière heure.	Corrigez le flux	`400` Requête erronée
`133000` Désinscription incomplète	Échec d’une précédente tentative de désinscription.	Désinscrivez à nouveau le numéro avant de procéder à l’inscription.	`500` Erreur de serveur interne
`133004` Serveur temporairement indisponible	Le serveur est temporairement indisponible.	Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API et vérifier la valeur `details` de la réponse avant de réessayer.	`503` Service indisponible
`133005` Non-concordance du code PIN de vérification en deux étapes	Code PIN de vérification en deux étapes incorrect.	Vérifiez que le code PIN de vérification en deux étapes inclus dans la requête est correct. Pour réinitialiser le code PIN de vérification en deux étapes : Désactivez la vérification en deux étapes. Envoyez une requête POST comportant le nouveau code PIN au point de terminaison du numéro de téléphone.	`400` Requête erronée
`133006` Revérification du numéro de téléphone nécessaire	Le numéro de téléphone doit être vérifié avant l’inscription.	Vérifiez le numéro de téléphone avant de l’inscrire.	`400` Requête erronée
`133008` Tentatives de saisie du code PIN de vérification en deux étapes trop nombreuses	Tentatives de saisie du code PIN de vérification en deux étapes trop nombreuses pour ce numéro de téléphone.	Réessayez après le délai spécifié dans la valeur de réponse `details`.	`400` Requête erronée
`133009` Tentative de saisie du code PIN de vérification en deux étapes trop rapide	Le code PIN de vérification en deux étapes a été saisi trop rapidement.	Consultez la valeur de réponse `details` avant de réessayer.	`400` Requête erronée
`133010` Numéro de téléphone non inscrit	Numéro de téléphone non inscrit sur la plateforme WhatsApp Business.	Enregistrez le numéro de téléphone avant de réessayer.	`400` Requête erronée
`133015` Veuillez patienter quelques minutes avant d’enregistrer ce numéro de téléphone	Le numéro de téléphone que vous essayez d’enregistrer a été récemment supprimé et l’opération n’est pas encore terminée.	Attendez cinq minutes avant d’envoyer à nouveau la requête.	`400` Requête erronée
`135000` Erreur générique utilisateur	Impossible d’envoyer le message en raison d’une erreur inconnue liée aux paramètres de votre requête.	Consultez la référence du point de terminaison pour déterminer si vous interrogez le point de terminaison à l’aide de la syntaxe correcte. Contactez le service clientèle si vous continuez à recevoir ce code d’erreur en réponse.	`400` Requête erronée

1

API inconnue

Requête non valide ou erreur possible du serveur.

Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API. S’il n’y a pas de panne de serveur, consultez la référence du point de terminaison et vérifiez que votre requête est formatée correctement et qu’elle satisfait à toutes les conditions requises pour les points de terminaison.

400

Requête erronée

2

Service d’API

Problème temporaire à cause d’un temps d’inactivité ou d’une surcharge.

Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API avant de réessayer.

503

Service indisponible

33

La valeur du paramètre n’est pas valide.

Le numéro de téléphone professionnel a été supprimé.

Vérifiez que le numéro de téléphone professionnel est correct.

400

Requête erronée

100

Paramètre non valide

La requête comprenait un ou plusieurs paramètres non pris en charge ou mal orthographiés.

Consultez la référence du point de terminaison pour déterminer quels paramètres sont pris en charge et comment ils sont orthographiés.

Lors de la configuration, assurez-vous que la clé publique de l’entreprise est une clé publique RSA 2048 bits au format PEM.

Veillez à ce qu’il n’y ait pas de confusion entre l’ID du numéro de téléphone que vous enregistrez et un ID de numéro de téléphone déjà stocké.

Vérifiez que votre paramètre respecte les éventuelles restrictions de caractères applicables.

400

Requête erronée

130472

Le numéro de l’utilisateur·ice fait partie d’une expérimentation

Le message n’a pas été envoyé du fait d’une expérimentation.

Consultez la section Marketing Message Experiment (Expérimentation relative aux messages marketing).

400

Requête erronée

131000

Une erreur s’est produite

Impossible d’envoyer le message en raison d’une erreur inconnue.

Lors de la configuration d’une clé publique d’entreprise, la signature n’a pas pu être calculée, le point de terminaison GraphQL n’a pu être appelé ou le point de terminaison GraphQL a renvoyé une erreur.

Réessayez. Si l’erreur persiste, contactez l’Assistance directe.

500

Erreur de serveur interne

131005

Accès refusé

L’autorisation n’a pas été accordée ou a été supprimée.

Utilisez le débogueur de token d’accès pour vérifier que votre application a obtenu les autorisations requises par le point de terminaison. Consultez la section Dépannage.

403

Interdit

131008

Le paramètre requis est manquant

Il manque un paramètre requis dans la requête.

Consultez la référence du point de terminaison pour déterminer quels paramètres sont requis.

400

Requête erronée

131009

La valeur du paramètre n’est pas valide.

Une ou plusieurs valeurs de paramètres sont incorrectes.

Consultez la référence du point de terminaison pour déterminer quelles valeurs sont prises en charge pour chaque paramètre et consultez la section Numéros de téléphone pour savoir comment ajouter un numéro de téléphone dans un compte WhatsApp Business.

400

Requête erronée

131016

Service indisponible

Un service est temporairement indisponible.

Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API avant de réessayer.

500

Erreur de serveur interne

131021

La personne destinataire ne peut pas être l’expéditeur·ice

Le numéro de téléphone de l’expéditeur·ice et celui de la personne destinataire sont les mêmes.

Envoyez un message à un numéro de téléphone différent de celui de l’expéditeur·ice.

400

Requête erronée

131026

Message impossible à distribuer

Impossible de distribuer le message. Plusieurs raisons peuvent expliquer cela :

Le numéro de téléphone du destinataire n’est pas un numéro WhatsApp.
Un modèle d’authentification a été envoyé à un utilisateur ou une utilisatrice de WhatsApp dont l’indicatif pays est +91 (Inde). Pour le moment, les modèles d’authentification ne peuvent pas être envoyés aux utilisateurs et utilisatrices de WhatsApp en Inde.
Le destinataire n’a pas accepté nos nouvelles conditions d’utilisation et politique de confidentialité.
La personne destinataire utilise une version de WhatsApp trop ancienne ; la version minimale de WhatsApp doit être :
- Android : 2.21.15.15
- SMBA : 2.21.15.15
- iOS : 2.21.170.4
- SMBI : 2.21.170.4
- KaiOS : 2.2130.10
- Web : 2.2132.6
Le message n’a pas été distribué pour créer une expérience d’utilisation de grande qualité. Consultez Limites de messages basés sur un modèle marketing par utilisateur·ice.

Utilisez un mode de communication autre que WhatsApp pour demander à la personne utilisant WhatsApp de :

vérifier qu’il lui est possible d’envoyer un message à votre numéro de téléphone WhatsApp Business ;
vérifier qu’elle a accepté nos dernières Conditions générales (Paramètres > Aide ou Paramètres > Informations sur l’application pour afficher une invite à accepter les dernières conditions/politiques si ce n’est pas déjà fait) ;
mettre à jour le client WhatsApp vers la dernière version.

400

Requête erronée

131042

Admissibilité des entreprises - problème de paiement

Il y a eu une erreur liée à votre méthode de paiement.

Consultez la section À propos de la facturation de votre compte WhatsApp Business et vérifiez que vous avez configuré la facturation correctement.

Problèmes courants :

Compte de paiement non associé à un compte WhatsApp Business
Ligne de crédit supérieure à la limite
Ligne de crédit (compte de paiement) non définie ou non active
Compte WhatsApp Business supprimé
Compte WhatsApp Business suspendu
Fuseau horaire non défini
Devise non définie
Requête MessagingFor (On Behalf Of (au nom de)) en attente ou refusée
Dépassement du seuil gratuit de conversation sans moyen de paiement valide

400

Requête erronée

131045

Certificat incorrect

Impossible d’envoyer le message à cause d’une erreur d’inscription du numéro de téléphone.

Inscrivez le numéro de téléphone avant de réessayer.

500

Erreur de serveur interne

131047

Message de réengagement

Plus de 24 heures se sont écoulées depuis la dernière réponse de la personne destinataire au numéro de l’expéditeur·ice.

Envoyez à la personne destinataire un message initié par l’entreprise en utilisant un modèle de message.

400

Requête erronée

131051

Type de message non pris en charge

Type de message non pris en charge.

Consultez la section Messages pour voir les types de messages pris en charge avant de réessayer en utilisant un type de message pris en charge.

400

Requête erronée

131052

Erreur de téléchargement de contenu multimédia

Impossible de télécharger le contenu multimédia envoyé par l’utilisateur ou l’utilisatrice.

Nous n’avons pas pu télécharger le contenu multimédia pour une ou plusieurs raisons, par exemple, parce que le type de contenu multimédia n’est pas pris en charge. Pour en savoir plus sur l’origine du problème, consultez la valeur error.error_data.details.

Demandez à l’utilisateur·ice d’envoyer le fichier multimédia par un autre moyen que WhatsApp.

400

Requête erronée

131053

Erreur d’importation de contenu multimédia

Impossible d’importer le contenu multimédia utilisé dans le message.

Nous n’avons pas pu importer le contenu multimédia pour une ou plusieurs raisons. Il se peut, par exemple, que le type de contenu multimédia ne soit pas pris en charge. Pour en savoir plus sur l’origine du problème, consultez la valeur error.error_data.details.

Nous vous recommandons de vérifier si les fichiers multimédias à l’origine d’erreurs sont effectivement pris en charge.

Par exemple, dans UNIX, vous pouvez utiliser l’inspection de fichier via la ligne de commande pour déterminer son type MIME :

file -I rejected-file.mov

Vous pouvez ensuite vous assurer que son type MIME se trouve bien dans notre liste de types de contenus multimédias pris en charge.

Pour optimiser vos envois de contenus multimédias, consultez les pages Mise en cache HTTP de contenus multimédias et Importer le contenu multimédia.

400

Requête erronée

131057

Compte en mode maintenance

Compte business en mode maintenance

Le compte WhatsApp Business est en mode maintenance. Il est possible qu’une mise à niveau de débit soit en cours sur le compte.

500

Requête erronée

132000

Non-concordance du nombre de paramètres du modèle

Le nombre de valeurs de paramètres variables inclus dans la requête ne correspondait pas au nombre de paramètres variables défini dans le modèle.

Consultez la section Règles relatives aux modèles de message et assurez-vous que la requête comporte toutes les valeurs de paramètres variables qui ont été définies dans le modèle.

400

Requête erronée

132001

Modèle inexistant

Le modèle n’existe pas dans la langue indiquée ou n’a pas été approuvé.

Vérifiez que le modèle a été approuvé et que son nom et sa langue sont corrects. Veillez à respecter les règles relatives aux modèles de message.

404

Introuvable

132005

Texte inséré dans le modèle trop long

Le texte traduit est trop long.

Ouvrez le Gestionnaire WhatsApp pour vérifier que votre modèle a été traduit. Consultez la section Indice de qualité et statut des modèles.

400

Requête erronée

132007

Non-respect de la politique relative au format de caractères du modèle

Le contenu du modèle enfreint une politique WhatsApp.

Consultez la section Motifs de rejets pour déterminer les causes possibles de l’infraction.

400

Requête erronée

132012

Non-concordance du format de paramètres du modèle

Valeurs de paramètres variables mal formatées.

Les valeurs des paramètres variables incluses dans la requête n’utilisent pas le format spécifié dans le modèle. Consultez la section Règles relatives aux modèles de message.

400

Requête erronée

132015

Modèle en pause

La qualité du modèle étant dégradée, celui-ci a été mis en pause et ne peut pas être envoyé dans un message de modèle.

Améliorez la qualité du modèle et réessayez une fois le modèle approuvé.

400

Requête erronée

132016

Modèle désactivé

La qualité du modèle étant dégradée, celui-ci a été mis en pause trop souvent et a été définitivement désactivé.

Créez un modèle avec un autre contenu.

400

Requête erronée

132068

Flux bloqué

Le flux est à l’état bloqué.

Corrigez le flux.

400

Requête erronée

132069

Flux régulé

L’état du flux est « régulé », et 10 messages utilisant ce flux ont déjà été envoyés au cours de la dernière heure.

Corrigez le flux

400

Requête erronée

133000

Désinscription incomplète

Échec d’une précédente tentative de désinscription.

Désinscrivez à nouveau le numéro avant de procéder à l’inscription.

500

Erreur de serveur interne

133004

Serveur temporairement indisponible

Le serveur est temporairement indisponible.

Consultez la page Statut de la plateforme WhatsApp Business pour voir les informations de statut de l’API et vérifier la valeur details de la réponse avant de réessayer.

503

Service indisponible

133005

Non-concordance du code PIN de vérification en deux étapes

Code PIN de vérification en deux étapes incorrect.

Vérifiez que le code PIN de vérification en deux étapes inclus dans la requête est correct.

Pour réinitialiser le code PIN de vérification en deux étapes :

Désactivez la vérification en deux étapes.
Envoyez une requête POST comportant le nouveau code PIN au point de terminaison du numéro de téléphone.

400

Requête erronée

133006

Revérification du numéro de téléphone nécessaire

Le numéro de téléphone doit être vérifié avant l’inscription.

Vérifiez le numéro de téléphone avant de l’inscrire.

400

Requête erronée

133008

Tentatives de saisie du code PIN de vérification en deux étapes trop nombreuses

Tentatives de saisie du code PIN de vérification en deux étapes trop nombreuses pour ce numéro de téléphone.

Réessayez après le délai spécifié dans la valeur de réponse details.

400

Requête erronée

133009

Tentative de saisie du code PIN de vérification en deux étapes trop rapide

Le code PIN de vérification en deux étapes a été saisi trop rapidement.

Consultez la valeur de réponse details avant de réessayer.

400

Requête erronée

133010

Numéro de téléphone non inscrit

Numéro de téléphone non inscrit sur la plateforme WhatsApp Business.

Enregistrez le numéro de téléphone avant de réessayer.

400

Requête erronée

133015

Veuillez patienter quelques minutes avant d’enregistrer ce numéro de téléphone

Le numéro de téléphone que vous essayez d’enregistrer a été récemment supprimé et l’opération n’est pas encore terminée.

Attendez cinq minutes avant d’envoyer à nouveau la requête.

400

Requête erronée

135000

Erreur générique utilisateur

Impossible d’envoyer le message en raison d’une erreur inconnue liée aux paramètres de votre requête.

Consultez la référence du point de terminaison pour déterminer si vous interrogez le point de terminaison à l’aide de la syntaxe correcte. Contactez le service clientèle si vous continuez à recevoir ce code d’erreur en réponse.

400

Requête erronée