Erreur WhatsApp 4 : l'app a atteint sa limite d'appels API
Le code d'erreur 4 signifie que l'app a atteint sa limite d'appels API. Meta le décrit ainsi : « The app has reached its API call rate limit. » Il compte les appels de l'app sur une heure glissante, pas les messages envoyés depuis un numéro. Consultez la consommation dans l'App Dashboard, patientez, puis réduisez la fréquence des appels de l'app à l'API.
Le code de Meta pour « The app has reached its API call rate limit. »
Nombre d'appels qu'une app peut effectuer en une heure selon les Graph API Platform Rate Limits.
Le nom que le guide Graph API sur la gestion des erreurs donne au code 4.
Que signifie le code d'erreur WhatsApp 4 ?
Il signifie que votre app a effectué trop d'appels API dans la fenêtre en cours, et que les appels suivants sont refusés tant que le compteur n'a pas baissé.
Meta classe le code 4 parmi les erreurs de limitation (throttling), avec le texte de détail « The app has reached its API call rate limit. » Le guide Graph API sur la gestion des erreurs l'appelle API Too Many Calls et le décrit comme un problème temporaire de limitation.
Il côtoie deux autres codes de limitation faciles à confondre avec lui. Le 80007 indique que le WhatsApp Business Account a atteint sa limite. Le 130429 concerne le débit de messages de la Cloud API. Le code 4 n'est ni l'un ni l'autre : c'est le budget d'appels de l'app elle-même.
Comment la limite d'appels de l'app est-elle calculée ?
Pour les requêtes effectuées avec un token d'accès d'app, le guide Graph API Rate Limiting de Meta donne une formule : le nombre d'appels sur une heure est égal à 200 multiplié par le nombre d'utilisateurs.
Ce nombre d'utilisateurs repose sur les utilisateurs actifs quotidiens uniques de l'app, avec des chiffres hebdomadaires et mensuels utilisés quand l'activité quotidienne fléchit. C'est une limite portée par l'app dans son ensemble, et non par utilisateur : quelques utilisateurs très actifs peuvent en consommer l'essentiel.
Le guide précise aussi que la consommation apparaît dans l'App Dashboard et, une fois assez d'appels effectués, dans un en-tête X-App-Usage sur les réponses. Cet en-tête permet de voir la limite approcher avant l'arrivée de l'erreur 4.
Que faire après l'erreur 4 ?
Cessez d'appeler l'API un moment, puis appelez-la moins.
Le guide Rate Limiting de Meta est direct sur le premier point : une fois la limite atteinte, arrêtez les appels API, car continuer augmente le compteur et allonge le délai avant que les appels réussissent de nouveau.
Le second point relève de la conception. Répartissez les requêtes de façon régulière plutôt que par rafales, filtrez les réponses pour qu'un seul appel renvoie ce dont vous avez besoin, et évitez les appels qui récupèrent des données redondantes. Les interrogations répétées sont le coupable habituel. Une intégration qui demande le même statut de compte toutes les quelques secondes dépense son budget pour des réponses qu'elle possède déjà.
Erreurs courantes
- Réessayer en boucle. Chaque appel supplémentaire s'ajoute au compteur et repousse la reprise.
- La prendre pour une limite d'envoi. Le code 4 compte les appels de l'app, alors que le débit de messages relève du 130429.
- Interroger les endpoints de statut à intervalle court. Relire sans cesse des données inchangées consomme le budget horaire.
EasyCoexistence surveille chaque numéro connecté 24 h/24, 7 j/7 de son côté : vous n'avez donc pas à construire le suivi de la santé de la connexion comme une boucle d'interrogation qui puise dans le budget d'appels de votre app.
Questions fréquemment posées
L'erreur 4 est-elle la même que l'erreur 130429 ?
Non. Le 130429 concerne le débit de messages d'un numéro. L'erreur 4 correspond au nombre d'appels API effectués par votre app.
Combien de temps dure l'erreur 4 ?
Jusqu'à ce que le nombre d'appels dans la fenêtre glissante d'une heure repasse sous la limite. Appeler pendant ce temps la prolonge.
Où voir à quel point mon app est proche de la limite ?
Dans la section Application Rate Limit de l'App Dashboard, et dans l'en-tête X-App-Usage renvoyé avec les réponses.
L'erreur 4 est-elle la même que l'erreur 80007 ?
Non. Meta utilise le 80007 quand le WhatsApp Business Account atteint sa limite, tandis que l'erreur 4 compte les appels de l'app elle-même.
Poursuivre la lecture
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 gratuitVérifié le