WhatsApp-fout 131005: toegang geweigerd, machtiging ontbreekt

Wat betekent WhatsApp-fout 131005?

Het betekent dat het token als echt wordt geaccepteerd, maar niet de machtiging heeft die het endpoint controleert.

In de Cloud API-referentie van Meta staat 131005 met de detailtekst "Permission is either not granted or has been removed." Graph API-fout 10 heeft precies dezelfde zin. Het verschil zit alleen in het bereik: 10 is een algemene Graph API-code, terwijl 131005 hoort bij de WhatsApp-codes die met 131 beginnen.

Omdat de woorden gelijk zijn, is ook de diagnose gelijk. Meta adviseert in beide gevallen de access token debugger te gebruiken en na te gaan of de app de machtigingen heeft die het endpoint vereist.

Welke machtiging ontbreekt meestal?

Meestal een van de twee WhatsApp-machtigingen, en welke dat is hangt af van wat de aanroep doet.

De machtigingengids van Meta verdeelt ze naar taak. whatsapp_business_messaging is nodig om elk type bericht te versturen en om webhooks voor berichten en status te ontvangen. whatsapp_business_management is nodig voor accountmetadata, beheer van templates, het opvragen van telefoonnummers, analyses en webhooks van het account.

Een token dat alleen met de beheermachtiging is gegenereerd, kan het account lezen en templates opvragen, en faalt dan zodra het iets probeert te versturen. Bij het genereren van een token voor een systeemgebruiker laat de access token-gids van Meta je business_management, whatsapp_business_management en whatsapp_business_messaging samen toewijzen.

Hoe los je fout 131005 op?

Lees eerst het token en pas dan alleen aan wat ontbreekt.

Roep het debug_token-endpoint aan of plak het token in de access token debugger. De eigenschap scopes toont elke verleende machtiging. Vergelijk die met de referentiepagina van het endpoint dat faalde.

Is een machtiging afwezig, genereer dan een nieuw token dat haar bevat, of laat de eigenaar van het bedrijf haar opnieuw verlenen als het token uit een partnerflow komt. Zijn alle machtigingen aanwezig en blijft de fout bestaan, controleer dan of de systeemgebruiker achter het token toegang heeft gekregen tot het specifieke WhatsApp Business Account. Een token kan namelijk volledig gescoped zijn en toch niet aan dat onderdeel zijn toegewezen.

Veelgemaakte fouten

• Aannemen dat het token is verlopen. Bij verlopen geeft Meta 190 of 0. Deze code betekent dat het token werkt, maar een machtiging mist.
• Een token genereren met alleen de beheermachtiging en daarmee gaan verzenden. Verzenden vraagt om whatsapp_business_messaging.
• De scopes controleren en dan stoppen. Een systeemgebruiker heeft ook toegang nodig tot dat specifieke WhatsApp Business Account.

Veelgestelde vragen

Lees verder