WhatsApp-Fehler 10: Berechtigung nicht erteilt oder entzogen
Der Fehlercode 10 bedeutet, dass dem Token der App eine Berechtigung fehlt, die der Endpoint braucht. Sie wurde entweder nie erteilt oder entfernt. Metas Beschreibung lautet: "Permission is either not granted or has been removed." Meta nennt außerdem zwei WhatsApp-Ursachen: eine Nummer, die bei Flows mit Endpoint nicht freigegeben ist, und nicht erfüllte Eignungsvoraussetzungen einer API.
Metas Code für "Permission is either not granted or has been removed."
Der Name, den der Leitfaden zur Fehlerbehandlung der Graph API für Code 10 verwendet.
Was eine Partner-App für jede Berechtigung braucht, die sie auf Kundenkonten nutzt.
Was bedeutet der WhatsApp-Fehlercode 10?
Er bedeutet, dass das Token bei Meta angekommen und erkannt wurde, die Berechtigung, die der Aufruf verlangt, ihm aber fehlt.
In Metas Cloud API-Referenz hat Code 10 den Detailtext "Permission is either not granted or has been removed." Der Leitfaden zur Fehlerbehandlung der Graph API nennt ihn API Permission Denied und empfiehlt, die fehlende Berechtigung zu beheben.
Das Wort removed ist wichtig. Eine Berechtigung kann bei der Einrichtung erteilt und später wieder entzogen werden, zum Beispiel wenn jemand den Zugriff der App in den Unternehmenseinstellungen widerruft. Eine Integration, die monatelang lief, kann deshalb plötzlich 10 zurückgeben, ohne dass sich an ihrem eigenen Code etwas geändert hat.
Welche weiteren Ursachen nennt Meta für Fehler 10?
Zwei, die speziell WhatsApp betreffen. Beide übersieht man leicht, weil es dabei gar nicht um Scopes geht.
Bei WhatsApp Flows mit Endpoint sagt Meta, Sie sollten sicherstellen, dass die Nummer, mit der der öffentliche Schlüssel des Unternehmens gesetzt wurde, auf der Freigabeliste steht. Eine Nummer außerhalb dieser Liste löst den Code aus, selbst wenn das Token alle Berechtigungen trägt.
Meta weist außerdem darauf hin, dass ein Konto, das die Eignungsvoraussetzungen der aufgerufenen API nicht erfüllt, diesen Code erhält. Dann hilft keine Änderung am Token, denn die Hürde ist die Eignung des Kontos und nicht die Zugangsdaten.
Wie behebt man Fehler 10?
Beginnen Sie mit dem Access-Token-Debugger, den Meta als erste Prüfung nennt.
Fehlt in der Liste der Scopes die Berechtigung, die der Endpoint braucht, lassen Sie sie vom Unternehmen erneut erteilen. Bei einer Partner-App gehört dazu auch, Advanced Access für die Berechtigung zu bestätigen, denn Metas Leitfaden zu Berechtigungen verlangt ihn für Kundenkonten.
Sehen die Scopes vollständig aus, prüfen Sie die beiden WhatsApp-Ursachen. Bei einem Flows-Aufruf kontrollieren Sie die Freigabeliste für die Nummer, die den öffentlichen Schlüssel gesetzt hat. In allen anderen Fällen lesen Sie die Eignungsvoraussetzungen der aufgerufenen API und bestätigen, dass das Konto sie erfüllt, bevor Sie Zugangsdaten ändern.
Häufige Fehler
- Annehmen, ein Deployment habe die Integration kaputt gemacht. Eine in den Unternehmenseinstellungen entfernte Berechtigung löst diesen Code ohne jede Codeänderung aus.
- Das Token neu erzeugen, obwohl die Ursache die Eignung ist. Zugangsdaten machen ein nicht berechtigtes Konto nicht berechtigt.
- Die Freigabeliste bei Flows übersehen. Bei Flows mit Endpoint liefert eine Nummer außerhalb der Liste 10, auch mit allen Scopes.
EasyCoexistence überwacht jede verbundene Nummer auch nach dem Onboarding. Eine Verbindung, die den Zugriff verliert, erscheint im Dashboard und fällt nicht erst durch fehlgeschlagene Nachrichten auf.
Häufig gestellte Fragen
Ist Fehler 10 dasselbe wie Fehler 131005?
Beide haben in Metas Referenz dieselbe Beschreibung. Code 10 ist der Code der Graph API, 131005 liegt im WhatsApp-Bereich. Sie werden auf dieselbe Weise geprüft.
Kann Fehler 10 bei einer Nummer auftreten, die gestern noch funktionierte?
Ja. Metas Beschreibung schließt entfernte Berechtigungen ein, ein früher erteilter Zugriff kann also später entzogen werden.
Heißt Fehler 10, dass mein Token abgelaufen ist?
Nein. Ein abgelaufenes Token liefert den Code 190 oder 0. Code 10 bedeutet, dass das Token gültig ist, ihm aber eine Berechtigung fehlt.
Wie sehe ich, welche Berechtigungen erteilt wurden?
Rufen Sie debug_token auf oder öffnen Sie den Access-Token-Debugger. Die Eigenschaft scopes listet jede Berechtigung des Tokens auf.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am