« Votre application n'a pas les permissions Graph API requises pour l'appairage companion de Cloud API »
Ce message signifie que la plateforme qui a lancé l'inscription n'a pas les permissions WhatsApp exigées par Meta, au niveau d'accès exigé par Meta, pour connecter un numéro de l'app WhatsApp Business à Cloud API. Meta ne laisse une entreprise accorder que les permissions pour lesquelles la plateforme détient l'accès Advanced. L'entreprise ne peut pas la corriger : c'est à la plateforme de le faire.
Ce dont un partenaire a besoin pour chaque permission avant que ses clients puissent l'accorder via Embedded Signup.
L'erreur que renvoient les appels d'API lorsque whatsapp_business_management est utilisé sans accès Advanced sur des comptes dont l'application n'est pas propriétaire.
whatsapp_business_management et whatsapp_business_messaging, les deux permissions dont, selon Meta, les intégrations WhatsApp ont généralement besoin.
Meta exige que la plateforme soit déjà Solution Partner ou Tech Provider pour intégrer des utilisateurs de l'app Business.
Que signifie ce message ?
Le texte complet est le suivant : « Votre application n'a pas les permissions Graph API requises pour l'appairage companion de Cloud API. Vérifiez que les permissions WhatsApp Business avancées sont accordées, puis réessayez. » Les références d'erreurs publiques de Meta ne listent pas cette formulation exacte, mais chacune de ses parties correspond à un élément que Meta documente.
« Votre application » désigne l'application Meta de la plateforme qui exécute l'inscription, pas l'app WhatsApp Business installée sur le téléphone. Meta ne définit pas publiquement l'appairage companion ; dans ce contexte, il décrit Cloud API rejoignant un numéro qui reste enregistré dans l'app WhatsApp Business, ce qui est précisément le principe de Coexistence. Enfin, les permissions WhatsApp Business « avancées » renvoient à l'accès Advanced, le niveau que Meta accorde via App Review.
Quelles permissions sont concernées ?
La documentation des permissions de Meta en nomme deux dont les intégrations WhatsApp ont généralement besoin. whatsapp_business_management couvre les métadonnées du compte, les templates, les numéros de téléphone, les statistiques et les webhooks du compte. whatsapp_business_messaging couvre l'envoi de messages et la réception des webhooks de messages et de statut.
Pour un partenaire dont les clients utilisent l'application, Meta exige App Review et l'accès Advanced pour chaque permission dont l'application a besoin. Meta en énonce directement la conséquence : sans accès Advanced pour une permission, les clients ne peuvent pas l'accorder à l'application via Embedded Signup. Les appels effectués avec whatsapp_business_management sur des comptes dont l'application n'est pas propriétaire, sans accès Advanced, renvoient l'erreur 200.
Une plateforme peut vérifier ce qu'une entreprise a réellement accordé en inspectant le token avec l'endpoint debug_token de Meta, qui liste les permissions accordées sous scopes.
Que peut faire l'entreprise ?
Très peu de choses de son côté, et elle ne devrait pas modifier ses paramètres Meta pour tenter de lever l'erreur. La correction relève de la plateforme : elle doit être Tech Provider ou Solution Partner, ce que Meta impose pour intégrer des utilisateurs de l'app WhatsApp Business, et elle doit obtenir l'accès Advanced pour les permissions WhatsApp.
L'entreprise peut en revanche transmettre le message exact à la plateforme, puis réessayer une fois que celle-ci confirme son accès, ou utiliser une plateforme qui détient déjà ce statut. Relancer le même parcours sur la même plateforme avant cela produit le même résultat, et n'a aucun effet sur l'app WhatsApp Business du téléphone.
Erreurs courantes
- Accorder davantage de permissions dans les paramètres Meta de l'entreprise. L'accès manquant appartient à l'application de la plateforme.
- Auto-héberger un outil sur une application de développeur sans passer par App Review. Sans accès Advanced, les entreprises ne peuvent pas accorder les permissions nécessaires.
- Réessayer à répétition sur la même plateforme. Le résultat ne change que lorsque l'accès de cette plateforme change.
EasyCoexistence est un Tech Provider Meta indépendant, avec sa propre application Meta, et exécute Embedded Signup v4 pour Coexistence : les entreprises connectent leur numéro via une plateforme qui détient déjà l'accès exigé par Meta.
Questions fréquemment posées
Y a-t-il un problème avec mon app WhatsApp Business ?
Non. Le message concerne l'application Meta de la plateforme, pas l'app de votre téléphone, qui continue de fonctionner.
Puis-je accorder la permission moi-même ?
Seules les permissions pour lesquelles la plateforme détient l'accès Advanced vous sont proposées. L'accès manquant doit d'abord être approuvé pour la plateforme.
Comment une plateforme obtient-elle l'accès Advanced ?
Via Meta App Review, pour chaque permission dont son application a besoin, en tant que partenaire dont les clients utilisent l'application.
L'entreprise doit-elle passer par App Review ?
Non. Meta indique qu'un développeur direct qui accède uniquement aux données de sa propre entreprise n'a besoin ni d'App Review ni de l'accès Advanced.
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