Erreur WhatsApp 3 : problème de capacité ou de permissions
Le code d'erreur 3 signifie que l'app qui appelle l'endpoint n'a pas une capacité ou une permission exigée par cet endpoint. Meta le décrit ainsi : « Capability or permissions issue. » La Graph API le nomme API Method. Pour corriger, inspectez les permissions accordées au token avec l'access token debugger, puis ajoutez celle dont l'endpoint a besoin.
Le code de Meta pour « Capability or permissions issue. »
Le nom que le guide de gestion des erreurs de la Graph API donne au code 3.
whatsapp_business_management et whatsapp_business_messaging, les deux permissions dont la plupart des endpoints WhatsApp ont besoin.
Que signifie le code d'erreur WhatsApp 3 ?
Cela signifie que la requête a été authentifiée, mais que l'app n'a pas le droit de faire ce qu'elle demande.
Meta classe le code 3 parmi les erreurs d'autorisation dans la référence de la Cloud API, avec le texte de détail « Capability or permissions issue. » Le guide de gestion des erreurs de la Graph API, dont hérite la Cloud API, appelle ce même code API Method et indique de vérifier que l'app dispose de la capacité ou des permissions nécessaires à l'appel.
Le token fonctionne donc. L'identité n'est pas en cause, ce qui distingue cette erreur des codes 0 et 190. Le problème, c'est ce que le token a le droit de toucher.
Comment vérifier les permissions d'un token ?
Avec l'access token debugger, ou avec l'endpoint debug_token, qui renvoie les mêmes informations.
La réponse liste les permissions accordées dans sa propriété scopes. Comparez cette liste avec la page de référence de l'endpoint qui a échoué, car chaque référence indique les permissions qu'elle exige.
Pour WhatsApp, deux permissions couvrent presque tout. whatsapp_business_management est nécessaire pour les métadonnées du compte, les templates, la liste des numéros de téléphone, les statistiques et les webhooks du compte. whatsapp_business_messaging est nécessaire pour envoyer n'importe quel message et pour recevoir les webhooks de messages et de statut. Un token qui n'en possède qu'une échoue sur les appels qui requièrent l'autre.
Pourquoi une app partenaire voit-elle l'erreur 3 alors qu'un développeur direct ne la voit pas ?
Parce que les partenaires qui servent d'autres entreprises doivent franchir une étape supplémentaire.
Le guide des permissions de Meta indique qu'un partenaire dont les clients utilisent l'app pour accéder à leurs données doit passer l'App Review et disposer de l'accès Advanced pour chaque permission dont l'app a besoin. Un développeur direct qui ne travaille qu'avec les données de sa propre entreprise n'a besoin ni de l'App Review ni de l'accès Advanced.
Le même code peut donc fonctionner sans problème sur le compte du développeur et échouer sur celui d'un client. Quand ce schéma apparaît, la question n'est pas de savoir quelle permission manque au token, mais si l'app a été approuvée pour utiliser cette permission sur des ressources qui ne lui appartiennent pas.
Erreurs courantes
- Générer un nouveau token avec les mêmes scopes. Un token neuf avec les mêmes permissions échoue au même endroit.
- Vérifier le nom de la permission dans les paramètres de l'app plutôt que sur le token. Ce qui compte, c'est ce qui a été accordé au token.
- Tester uniquement avec votre propre compte. Les apps partenaires ont besoin de l'accès Advanced avant que les comptes clients n'acceptent l'appel.
EasyCoexistence connecte chaque numéro via le flux Embedded Signup de Meta, si bien que l'entreprise accorde les permissions lors de l'onboarding et que l'état de la connexion reste visible depuis le dashboard ensuite.
Questions fréquemment posées
L'erreur 3 vient-elle de mon numéro de téléphone ?
Non. Elle concerne ce que le token de l'app est autorisé à faire. Le numéro n'est pas vérifié avant que la requête soit refusée.
Quelle est la différence entre l'erreur 3 et l'erreur 10 ?
Le code 3 est un problème de capacité ou de permissions. Le code 10 indique qu'une permission n'a pas été accordée ou a été retirée. Dans les deux cas, la solution passe par la vérification des scopes du token.
De quelle permission ai-je besoin pour envoyer des messages ?
whatsapp_business_messaging. Le guide des permissions de Meta précise qu'elle est requise pour envoyer tout type de message.
Réessayer peut-il aider ?
Non. Les permissions du token ne changent pas d'une tentative à l'autre, donc le résultat reste le 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