WhatsApp-Fehler 131005: Zugriff verweigert, Berechtigung fehlt

Was bedeutet der WhatsApp-Fehler 131005?

Er bedeutet, dass das Token als echt akzeptiert wird, aber nicht die Berechtigung enthält, die der Endpoint prüft.

Metas Cloud API-Referenz führt 131005 mit dem Detailtext "Permission is either not granted or has been removed." auf. Der Graph API-Fehler 10 trägt exakt denselben Satz. Der Unterschied liegt nur im Bereich: 10 ist ein allgemeiner Graph API-Code, 131005 gehört zu den WhatsApp-Codes, die mit 131 beginnen.

Weil der Wortlaut gleich ist, ist auch die Diagnose gleich. Metas Abhilfe für beide: den Access-Token-Debugger verwenden und prüfen, ob die App die Berechtigungen besitzt, die der Endpoint verlangt.

Welche Berechtigung fehlt meistens?

Meist eine der beiden WhatsApp-Berechtigungen, und welche, hängt davon ab, was der Aufruf tut.

Metas Berechtigungsleitfaden teilt sie nach Aufgabe auf. whatsapp_business_messaging wird benötigt, um jede Art von Nachricht zu senden und um Nachrichten- und Status-Webhooks zu empfangen. whatsapp_business_management wird für Metadaten des Kontos, die Verwaltung von Templates, das Auflisten von Telefonnummern, Analysen und Webhooks des Kontos benötigt.

Ein Token, das nur mit der Management-Berechtigung erzeugt wurde, kann das Konto lesen und Templates auflisten, scheitert aber, sobald es senden will. Beim Erzeugen eines System-User-Tokens sieht Metas Leitfaden zu Access Tokens vor, business_management, whatsapp_business_management und whatsapp_business_messaging gemeinsam zuzuweisen.

Wie behebt man den Fehler 131005?

Lesen Sie zuerst das Token aus und ändern Sie dann nur, was fehlt.

Rufen Sie den Endpoint debug_token auf oder fügen Sie das Token in den Access-Token-Debugger ein. Die Eigenschaft scopes listet jede erteilte Berechtigung auf. Vergleichen Sie sie mit der Referenzseite des Endpoints, der fehlgeschlagen ist.

Fehlt eine Berechtigung, erzeugen Sie ein neues Token, das sie enthält, oder lassen Sie sie vom Inhaber des Unternehmens erneut erteilen, wenn das Token aus einem Partner-Ablauf stammt. Sind alle Berechtigungen vorhanden und der Fehler bleibt bestehen, prüfen Sie, ob der System-User hinter dem Token Zugriff auf das konkrete WhatsApp Business-Konto erhalten hat. Ein Token kann vollständig mit Scopes ausgestattet sein und trotzdem diesem Asset nicht zugewiesen sein.

Häufige Fehler

• Annehmen, das Token sei abgelaufen. Ein Ablauf liefert 190 oder 0. Dieser Code bedeutet, dass das Token funktioniert, ihm aber eine Berechtigung fehlt.
• Ein Token nur mit Management-Berechtigung erzeugen und damit senden. Zum Senden wird whatsapp_business_messaging benötigt.
• Die Scopes prüfen und dort aufhören. Ein System-User braucht zusätzlich erteilten Zugriff auf das konkrete WhatsApp Business-Konto.

Häufig gestellte Fragen

Weiterlesen