L’API On-Premises ne sera bientôt plus disponible. Consultez notre document Abandon progressif de l’API On-Premises pour de plus amples détails, mais aussi pour connaître la procédure de migration vers notre API Cloud nouvelle génération.
Messages d’erreur et d’état
Ce document fournit des informations supplémentaires sur les types de messages d’erreur et d’état suivants :
Pour la résolution des problèmes liés à l’inscription intégrée, consultez Erreurs lors de la procédure d’inscription intégrée.
Codes d’erreur du client de l’API WhatsApp Business
| Code d’erreur | Description |
|---|---|
| Impossible de télécharger le média à partir de l’expéditeur. |
| Impossible d’envoyer le message en raison d’une ou de plusieurs erreurs liées à votre moyen de paiement.
Vérifiez votre configuration de paiement dans le Gestionnaire WhatsApp, puis réessayez. |
| Impossible d’envoyer le message, car il est en attente depuis trop longtemps (> 1 jour). Cette erreur se produit si le client de l’API WhatsApp Business est fermé depuis plusieurs jours, puis redémarré. Renvoyez le message. |
| Échec de l’envoi du message pendant sa durée de vie. |
|
|
| Impossible d’envoyer le message en raison d’une erreur concernant votre certificat. Téléchargez un nouveau certificat à partir du Gestionnaire WhatsApp et procédez à une réinscription. |
| Impossible d’envoyer le message en raison d’une erreur concernant votre certificat. Téléchargez un nouveau certificat à partir du Gestionnaire WhatsApp et procédez à une réinscription. |
| Cela se produit lorsqu’un message est envoyé, mais que le certificat du client commercial n’est pas correctement signé à l’aide des clés d’identité du client. Cela indique que le client s’est probablement réinscrit avec de nouvelles clés d’identité, mais qu’il n’est pas allé au bout du processus de création du certificat. |
| Impossible d’envoyer le message, car plus de 24 heures se sont écoulées depuis la dernière réponse du client ou de la cliente à ce numéro. Utilisez un modèle de message pour répondre. |
| 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 votre statut de qualité dans le Gestionnaire WhatsApp. Pour plus d’informations, consultez la documentation sur les plafonds selon l’indice de qualité. |
| Impossible d’envoyer le message, car le numéro de l’utilisateur·ice fait partie d’une expérimentation. Annulez l’envoi de messages à cette personne. |
| Échec de l’envoi d’un message, car l’utilisateur·ice associé·e à ce numéro de téléphone a probablement changé. |
| Impossible d’envoyer le message en raison d’une erreur inconnue. Réessayez plus tard. |
| Les messages document avec sous-titres ne sont pas pris en charge pour le moment. |
| |
| La longueur du message dépasse 4 096 caractères. |
| Types de destinataire valides :
|
| Conflit d’UUID possible pour une requête de téléchargement de média ou un média avec cet UUID existe déjà. |
|
|
| Fichier ou ressource introuvable |
| Le destinataire ne figure pas sur la liste d’éléments autorisés. |
| Il manque un paramètre requis. Si vous essayez d’envoyer un Message de liste, il se peut que vous ayez oublié la partie Si vous essayez d’envoyer un message concernant un seul ou plusieurs produits, il est possible que vous ayez oublié le |
| La valeur entrée pour un paramètre est de type incorrect ou tout autre problème. Si vous essayez d’envoyer un Message de liste, vérifiez que l’ID de chaque ligne est unique. Si vous essayez d’envoyer un message concernant un seul produit, il est possible que vous ayez envoyé le mauvais Si vous essayez d’envoyer un message concernant plusieurs produits, vérifiez que votre |
| Présence d’un paramètre non requis. |
| |
| |
|
|
| La limite de débit a été atteinte côté client. |
| Si le système est soumis à une charge importante, cette erreur est renvoyée pour permettre au système de récupérer de la charge. |
| Ce message d’erreur s’affiche lorsqu’une requête destinée uniquement au maître (telle que définir les paramètres, obtenir les paramètres, importer, exporter, demander un code, s’inscrire, etc.) est envoyée à un nœud qui n’est pas un maître principal. Cela peut se produire lorsque le client de l’API WhatsApp Business n’est pas configuré correctement ou en cas d’erreur interne. Refaire la requête devrait résoudre cette erreur. Si l’erreur persiste, contactez l’assistance. |
| Ce message d’erreur s’affiche lorsque des requêtes sont envoyées à un nœud Coreapp qui n’est pas le propriétaire de la partition ou qui est en train de devenir le propriétaire de la partition. Vous pouvez voir ce message d’erreur lorsque nous effectuons un basculement de partition dans la configuration de multi-connexion. Refaire la requête devrait résoudre cette erreur la plupart du temps. Dans le cas contraire, contactez l’assistance. |
| Cette erreur apparaît lorsque vous vous envoyez un message. |
| Ce message d’erreur s’affiche si vous n’avez pas configuré le format webhooks de l’API REST. |
| |
| Vous devez changer de mot de passe. |
| La requête n’est pas valide. |
| Message impossible à distribuer. Consultez la réponse à la question « Pourquoi mon taux de distribution n’est-il pas de 100 % ? » dans les questions-réponses. |
| Vous avez envoyé un message à un·e utilisateur·ice WhatsApp qui a potentiellement changé, et une notification système |
| Votre compte a été bloqué pour l’envoi de messages en raison d’une infraction aux règles d’intégrité. Consultez la page Application de la politique de la plateforme WhatsApp Business pour plus d’informations. |
| Le nombre de paramètres fournis ne correspond pas au nombre de paramètres attendus. |
| Le statut du modèle n’est pas actif, ou le modèle n’existe pas pour une des langues. |
| Le destinataire n’a pas pu télécharger le modèle. |
| Aucun modèle n’existe pour une langue et des paramètres régionaux. |
| Paramètre trop long |
| Texte traduit trop long |
| Non-respect de la règle relative aux espaces |
| Non-respect de la règle relative au format de caractères |
| Le format du média utilisé n’est pas pris en charge. |
| Un composant obligatoire du modèle est manquant. |
| L’URL dans le composant bouton n’est pas valide. |
| Le numéro de téléphone dans le composant bouton n’est pas valide. |
| Le format de paramètre ne correspond pas au format du modèle créé. |
| Les boutons ne sont pas pris en charge par le destinataire. |
| Cette erreur se produit lorsque le téléchargement d’un pack de langues de messages de modèles n’a pas encore été effectué. |
| La requête du message contient un nombre de sections inférieur au seuil minimal ou supérieur au seuil maximal. Pour en savoir plus, consultez la page objet Vous devez avoir au moins 1 objet |
| Le nombre de lignes n’est pas valide. Les Messages Liste doivent comprendre au moins un objet |
| La règle relative au format de caractères n’a pas été respectée. |
| Aucun produit n’a été indiqué pour l’objet de la section ou le nombre total de produits a dépassé le nombre maximal autorisé. |
| L’ID du catalogue que vous avez indiqué n’existe pas ou il n’appartient pas à votre compte WhatsApp Business (WABA). |
| L’ID du catalogue que vous avez indiqué n’est pas relié au numéro de téléphone que vous utilisez pour envoyer un message. |
| Certains produits indiqués dans votre requête ne figurent pas dans le catalogue. |
| Aucun produit n’a été trouvé dans le catalogue que vous avez indiqué. |
| Disponible uniquement pour les entreprises basées en Inde. Cette erreur est générée lorsqu’une entreprise envoie un message concernant un seul produit avec des informations de conformité de e-commerce manquantes et incomplètes. |
| Disponible uniquement pour les entreprises basées en Inde. Cette erreur est générée lorsqu’une entreprise envoie un message concernant plusieurs produits avec des informations de conformité de e-commerce manquantes et incomplètes. |
| Disponible uniquement pour les entreprises basées en Inde. Cette erreur est générée lorsqu’une entreprise envoie un message concernant plusieurs produits avec une combinaison de produits non valides et de produits ayant des informations de conformité manquantes. |
| Erreur générée lorsque la structure de l’objet |
| Disponible uniquement pour les entreprises basées en Inde. Cette erreur est générée lorsqu’une entreprise n’a pas fourni d’informations de conformité. Reportez-vous au point de terminaison Conformité des entreprises. |
| Le statut du modèle est |
| Le statut du modèle est |
| Le statut du modèle est |
| Le flux associé à l’ID spécifié n’existe pas ou ne fait pas partie de votre compte WhatsApp Business, ou son état n’est pas valide. |
| Le flux est à l’état bloqué. Cette erreur peut également se produire lorsque le flux utilise un point de terminaison et que la configuration requise est incomplète, par exemple si la clé publique n’est pas importée ou n’est plus valide. Voir Implémentation d’un point de terminaison pour Flows. |
| Le flux est à l’état régulé, et 10 messages utilisant ce flux ont déjà été envoyés au cours de la dernière heure. |
Pour les codes d’erreur du Gestionnaire des ventes propres à l’Inde, consultez les Pages d’aide Business.
Codes d’état HTTP
Il s’agit de codes d’état HTTP pouvant être utilisés par le client de l’API WhatsApp Business.
| Code HTTP | Description |
|---|---|
| Réussite |
| Réussite (OK) |
| Créé avec succès (pour les requêtes POST) |
| Trouvé |
| Erreurs clients |
| Requête non valide |
| Non autorisé |
| Interdit |
| Introuvable |
| Méthode non autorisée. |
| La condition préalable a échoué |
| Le message est limité |
| Demandes trop nombreuses |
| Erreurs serveur |
| Erreur interne du serveur |
| Délai d’expiration |