WhatsApp-fout 3: probleem met capability of rechten
Foutcode 3 betekent dat de app die het endpoint aanroept een capability of recht mist dat dat endpoint vereist. Meta omschrijft het als "Capability or permissions issue." De Graph API noemt het API Method. De oplossing is de toegekende rechten van het token te bekijken met de Access Token Debugger en het ontbrekende recht toe te voegen.
De code van Meta voor "Capability or permissions issue."
De naam die de Graph API-gids voor foutafhandeling aan code 3 geeft.
whatsapp_business_management en whatsapp_business_messaging, de twee rechten die de meeste WhatsApp-endpoints nodig hebben.
Wat betekent WhatsApp-foutcode 3?
Het betekent dat het verzoek is geauthenticeerd, maar dat de app niet mag doen wat ze vroeg.
Meta noemt code 3 in de Cloud API-referentie onder de autorisatiefouten, met de detailtekst "Capability or permissions issue." De Graph API-gids voor foutafhandeling, die de Cloud API overneemt, noemt dezelfde code API Method en zegt dat je moet controleren of de app de capability of rechten heeft die de aanroep nodig heeft.
Het token werkt dus. De identiteit is niet het probleem, en dat onderscheidt deze fout van code 0 en 190. Het probleem is waar het token bij mag.
Hoe controleer je welke rechten een token heeft?
Met de Access Token Debugger of het debug_token-endpoint, dat dezelfde informatie teruggeeft.
Het antwoord toont de toegekende rechten in de eigenschap scopes. Vergelijk die lijst met de referentiepagina van het endpoint dat mislukte, want elke referentie noemt de rechten die ze vereist.
Voor WhatsApp dekken twee rechten bijna alles. whatsapp_business_management is nodig voor accountmetadata, templates, lijsten met telefoonnummers, analyses en account-webhooks. whatsapp_business_messaging is nodig om elk bericht te versturen en om bericht- en status-webhooks te ontvangen. Een token met maar één van beide faalt bij aanroepen die het andere nodig hebben.
Waarom ziet een partner-app fout 3 en een directe ontwikkelaar niet?
Omdat partners die andere bedrijven bedienen een extra drempel hebben.
In de rechtengids van Meta staat dat een partner wiens klanten de app gebruiken om bij hun gegevens te komen, App Review moet doorstaan en Advanced access moet hebben voor elk recht dat de app nodig heeft. Een directe ontwikkelaar die alleen met de gegevens van het eigen bedrijf werkt, heeft geen App Review of Advanced access nodig.
Dezelfde code kan dus probleemloos draaien op het eigen account van de ontwikkelaar en falen op het account van een klant. Zie je dat patroon, dan is de vraag niet welk recht op het token ontbreekt, maar of de app is goedgekeurd om dat recht te gebruiken op assets die ze niet zelf bezit.
Veelgemaakte fouten
- Een nieuw token genereren met dezelfde scopes. Een vers token met dezelfde rechten faalt op dezelfde plek.
- De naam van het recht controleren in de instellingen van de app in plaats van op het token. Wat telt is wat het token is toegekend.
- Alleen testen met je eigen account. Partner-apps hebben Advanced access nodig voordat accounts van klanten de aanroep accepteren.
EasyCoexistence verbindt elk nummer via Meta's eigen Embedded Signup-flow, zodat het bedrijf de rechten bij de onboarding verleent en de status van de verbinding daarna zichtbaar blijft in het dashboard.
Veelgestelde vragen
Is fout 3 een probleem met mijn nummer?
Nee. Het gaat om wat het token van de app mag doen. Het nummer wordt niet gecontroleerd voordat het verzoek wordt geweigerd.
Wat is het verschil tussen fout 3 en fout 10?
Code 3 is een probleem met capability of rechten. Code 10 zegt dat een recht niet is verleend of is ingetrokken. Beide los je op door de scopes van het token te controleren.
Welk recht heb ik nodig om berichten te versturen?
whatsapp_business_messaging. In de rechtengids van Meta staat dat het vereist is om elk type bericht te versturen.
Helpt het om het opnieuw te proberen?
Nee. De rechten van het token veranderen niet tussen pogingen, dus het resultaat blijft hetzelfde.
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