"Your app is missing required Graph API permissions for Cloud API companion pairing"
Dit bericht betekent dat het platform dat de aanmelding startte de WhatsApp-machtigingen mist die Meta vereist, op het toegangsniveau dat Meta vereist, om een nummer van de WhatsApp Business app met Cloud API te verbinden. Meta laat een bedrijf alleen machtigingen verlenen waarvoor het platform Advanced access heeft. Het bedrijf kan dit niet oplossen; het platform moet het doen.
Wat een partner per machtiging nodig heeft voordat zijn klanten die via Embedded Signup kunnen verlenen.
De fout die API-aanroepen teruggeven wanneer whatsapp_business_management wordt gebruikt zonder Advanced access op accounts die de app niet bezit.
whatsapp_business_management en whatsapp_business_messaging, de twee machtigingen die WhatsApp-integraties volgens Meta meestal nodig hebben.
Meta vereist dat het platform al Solution Partner of Tech Provider is om gebruikers van de WhatsApp Business app te onboarden.
Wat betekent het bericht?
De volledige tekst luidt: "Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again." De openbare foutreferenties van Meta noemen deze exacte formulering niet, maar elk onderdeel ervan verwijst naar iets wat Meta wel documenteert.
"Your app" is de Meta-app van het platform dat de aanmelding uitvoert, niet de WhatsApp Business app op de telefoon. Meta definieert companion pairing niet openbaar. In context beschrijft het dat Cloud API zich aansluit bij een nummer dat geregistreerd blijft in de WhatsApp Business app, en dat is de Coexistence-opzet. En "advanced" WhatsApp Business permissions verwijst naar Advanced access, het niveau dat Meta via App Review toekent.
Om welke machtigingen gaat het?
De documentatie van Meta over machtigingen noemt er twee die WhatsApp-integraties meestal nodig hebben. whatsapp_business_management omvat accountmetadata, templates, telefoonnummers, analytics en account-webhooks. whatsapp_business_messaging omvat het versturen van berichten en het ontvangen van webhooks voor berichten en status.
Voor een partner wiens klanten zijn app gebruiken, vereist Meta App Review en Advanced access voor elke machtiging die de app nodig heeft. Meta noemt het gevolg zelf: zonder Advanced access voor een machtiging kunnen klanten die niet via Embedded Signup aan de app verlenen. Aanroepen met whatsapp_business_management op accounts die de app niet bezit, geven zonder Advanced access fout 200 terug.
Een platform kan controleren wat een bedrijf echt heeft verleend door het token te inspecteren met het debug_token-endpoint van Meta, dat de verleende machtigingen onder scopes toont.
Wat kan het bedrijf doen?
Aan de kant van het bedrijf zelf weinig, en het moet niet proberen zijn Meta-instellingen aan te passen om dit op te lossen. De oplossing ligt bij het platform: het moet Tech Provider of Solution Partner zijn, wat Meta als vereiste noemt voor het onboarden van gebruikers van de WhatsApp Business app, en het moet Advanced access goedgekeurd hebben gekregen voor de WhatsApp-machtigingen.
Wat het bedrijf wel kan doen, is de exacte tekst van het bericht aan het platform melden en het opnieuw proberen zodra het platform zijn toegang bevestigt, of een platform gebruiken dat die status al heeft. Dezelfde stappen eerder opnieuw doorlopen op hetzelfde platform geeft hetzelfde resultaat, en het heeft geen invloed op de WhatsApp Business app op de telefoon.
Veelgemaakte fouten
- Meer machtigingen verlenen in de eigen Meta-instellingen van het bedrijf. De ontbrekende toegang hoort bij de app van het platform.
- Een tool zelf hosten op een developer-app zonder App Review. Zonder Advanced access kunnen bedrijven de benodigde machtigingen niet verlenen.
- Herhaaldelijk opnieuw proberen op hetzelfde platform. Het resultaat verandert pas als de toegang van dat platform verandert.
EasyCoexistence is een onafhankelijke Meta Tech Provider met een eigen Meta-app en draait Embedded Signup v4 voor Coexistence, zodat bedrijven hun nummer verbinden via een platform dat de toegang die Meta vereist al heeft.
Veelgestelde vragen
Is er iets mis met mijn WhatsApp Business app?
Nee. Het bericht verwijst naar de Meta-app van het platform, niet naar de app op je telefoon, die gewoon blijft werken.
Kan ik de machtiging zelf verlenen?
Alleen machtigingen waarvoor het platform Advanced access heeft, verschijnen bij jou om te verlenen. De ontbrekende toegang moet eerst voor het platform worden goedgekeurd.
Hoe krijgt een platform Advanced access?
Via Meta App Review voor elke machtiging die de app nodig heeft, als partner wiens klanten de app gebruiken.
Heeft het bedrijf App Review nodig?
Nee. Meta zegt dat een directe developer die alleen de eigen bedrijfsgegevens benadert geen App Review en geen Advanced access nodig heeft.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op