WhatsApp-Fehler 3: Problem mit Berechtigungen oder Funktionen
Fehlercode 3 bedeutet: Der App, die den Endpoint aufruft, fehlt eine Funktion oder Berechtigung, die dieser Endpoint verlangt. Metas Beschreibung lautet „Capability or permissions issue.“ Die Graph API nennt ihn API Method. Die Lösung: Prüfen Sie die gewährten Berechtigungen des Tokens mit dem Access Token Debugger und fügen Sie die Berechtigung hinzu, die der Endpoint braucht.
Metas Code für „Capability or permissions issue.“
Der Name, den der Leitfaden zur Fehlerbehandlung der Graph API dem Code 3 gibt.
whatsapp_business_management und whatsapp_business_messaging: die zwei Berechtigungen, die die meisten WhatsApp-Endpoints benötigen.
Was bedeutet der WhatsApp-Fehlercode 3?
Er bedeutet, dass die Anfrage authentifiziert wurde, die App aber nicht tun darf, was sie verlangt hat.
Meta führt Code 3 in der Cloud API Reference unter den Autorisierungsfehlern mit dem Detailtext „Capability or permissions issue.“ auf. Der Leitfaden zur Fehlerbehandlung der Graph API, den die Cloud API übernimmt, nennt denselben Code API Method und verlangt, dass die App die für den Aufruf nötigen Funktionen oder Berechtigungen besitzt.
Das Token funktioniert also. Die Identität ist nicht das Problem, und genau das unterscheidet diesen Fehler von den Codes 0 und 190. Das Problem ist, worauf das Token zugreifen darf.
Wie prüfen Sie, welche Berechtigungen ein Token hat?
Mit dem Access Token Debugger oder dem Endpoint debug_token, der dieselben Informationen liefert.
Die Antwort listet die gewährten Berechtigungen in der Eigenschaft scopes auf. Vergleichen Sie diese Liste mit der Referenzseite des fehlgeschlagenen Endpoints, denn jede Referenz nennt die Berechtigungen, die sie verlangt.
Bei WhatsApp decken zwei Berechtigungen fast alles ab. whatsapp_business_management brauchen Sie für Konto-Metadaten, Templates, Listen von Telefonnummern, Analysen und Webhooks des Kontos. whatsapp_business_messaging brauchen Sie, um jede Nachricht zu senden und um Webhooks für Nachrichten und Status zu empfangen. Ein Token mit nur einer von beiden scheitert bei Aufrufen, die die andere benötigen.
Warum sieht eine Partner-App Fehler 3, ein direkter Entwickler aber nicht?
Weil Partner, die andere Unternehmen bedienen, eine zusätzliche Hürde haben.
Laut Metas Leitfaden zu Berechtigungen muss ein Partner, dessen Kunden über seine App auf ihre Daten zugreifen, den App Review bestehen und für jede benötigte Berechtigung Advanced Access besitzen. Ein direkter Entwickler, der nur mit den Daten seines eigenen Unternehmens arbeitet, braucht weder App Review noch Advanced Access.
Derselbe Code kann deshalb am eigenen Konto des Entwicklers sauber laufen und am Konto eines Kunden scheitern. Zeigt sich dieses Muster, lautet die Frage nicht, welche Berechtigung dem Token fehlt, sondern ob die App freigegeben wurde, diese Berechtigung für fremde Assets zu nutzen.
Häufige Fehler
- Ein neues Token mit denselben Scopes erzeugen. Ein frisches Token mit denselben Berechtigungen scheitert an derselben Stelle.
- Den Namen der Berechtigung in den Einstellungen der App prüfen statt am Token. Entscheidend ist, was dem Token gewährt wurde.
- Nur am eigenen Konto testen. Partner-Apps brauchen Advanced Access, bevor Konten von Kunden den Aufruf akzeptieren.
EasyCoexistence verbindet jede Nummer über Metas eigenen Embedded-Signup-Ablauf. Das Unternehmen erteilt die Berechtigungen beim Onboarding, und den Zustand der Verbindung sehen Sie danach im Dashboard.
Häufig gestellte Fragen
Liegt Fehler 3 an meiner Telefonnummer?
Nein. Er betrifft, was das Token der App tun darf. Die Nummer wird nicht geprüft, bevor die Anfrage abgelehnt wird.
Was ist der Unterschied zwischen Fehler 3 und Fehler 10?
Code 3 ist ein Problem mit Funktionen oder Berechtigungen. Code 10 besagt, dass eine Berechtigung nicht gewährt oder entzogen wurde. Beides lösen Sie, indem Sie die Scopes des Tokens prüfen.
Welche Berechtigung brauche ich, um Nachrichten zu senden?
whatsapp_business_messaging. Laut Metas Leitfaden zu Berechtigungen ist sie erforderlich, um jede Art von Nachricht zu senden.
Hilft ein erneuter Versuch?
Nein. Die Berechtigungen des Tokens ändern sich zwischen den Versuchen nicht, also bleibt das Ergebnis gleich.
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