„Your app is missing required Graph API permissions for Cloud API companion pairing“
Diese Fehlermeldung bedeutet: Der Plattform, die die Anmeldung gestartet hat, fehlen die WhatsApp-Berechtigungen, die Meta verlangt, und zwar auf dem Zugriffslevel, das Meta verlangt, um die Nummer einer WhatsApp Business App mit der Cloud API zu verbinden. Meta lässt ein Unternehmen nur Berechtigungen erteilen, für die die Plattform Advanced access besitzt. Das Unternehmen kann das Problem nicht beheben, die Plattform muss es tun.
Was ein Partner für jede Berechtigung braucht, bevor seine Kunden sie über Embedded Signup erteilen können.
Der Fehler, den API-Anfragen zurückgeben, wenn whatsapp_business_management ohne Advanced access für Konten verwendet wird, die der App nicht gehören.
whatsapp_business_management und whatsapp_business_messaging, die beiden Berechtigungen, die laut Meta WhatsApp-Integrationen im Allgemeinen benötigen.
Meta verlangt, dass die Plattform bereits Solution Partner oder Tech Provider ist, um Nutzer der WhatsApp Business App zu onboarden.
Was bedeutet die Fehlermeldung?
Der vollständige Text lautet: „Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again.“ In Metas öffentlichen Fehlerreferenzen steht genau dieser Wortlaut nicht, aber jeder Teil davon entspricht etwas, das Meta dokumentiert.
„Your app“ ist die Meta-App der Plattform, die die Anmeldung durchführt, nicht die WhatsApp Business App auf dem Telefon. Meta definiert Companion Pairing öffentlich nicht. Im Kontext beschreibt es, dass die Cloud API eine Nummer einbindet, die weiterhin in der WhatsApp Business App registriert bleibt, also genau die Coexistence-Konstellation. Und „advanced“ WhatsApp Business permissions meint Advanced access, das Level, das Meta über den App Review vergibt.
Um welche Berechtigungen geht es?
Metas Dokumentation zu Berechtigungen nennt zwei, die WhatsApp-Integrationen im Allgemeinen benötigen. whatsapp_business_management deckt Konto-Metadaten, Templates, Nummern, Analysen und Webhooks des Kontos ab. whatsapp_business_messaging deckt das Senden von Nachrichten sowie den Empfang von Nachrichten- und Status-Webhooks ab.
Für einen Partner, dessen Kunden seine App nutzen, verlangt Meta für jede Berechtigung, die die App braucht, einen App Review und Advanced access. Die Folge nennt Meta direkt: Ohne Advanced access für eine Berechtigung können Kunden sie der App nicht über Embedded Signup erteilen. Aufrufe mit whatsapp_business_management auf Konten, die der App nicht gehören, geben ohne Advanced access den Fehlercode 200 zurück.
Eine Plattform kann prüfen, was ein Unternehmen tatsächlich erteilt hat, indem sie das Token mit Metas debug_token-Endpoint untersucht. Er listet die erteilten Berechtigungen unter scopes auf.
Was kann das Unternehmen tun?
Auf seiner Seite sehr wenig, und es sollte nicht versuchen, seine Meta-Einstellungen zu ändern, um den Fehler zu beseitigen. Die Lösung liegt bei der Plattform: Sie muss Tech Provider oder Solution Partner sein, was Meta als Voraussetzung für das Onboarding von Nutzern der WhatsApp Business App nennt, und für die WhatsApp-Berechtigungen muss Advanced access genehmigt sein.
Das Unternehmen kann die genaue Fehlermeldung an die Plattform melden und es erneut versuchen, sobald die Plattform ihren Zugriff bestätigt hat, oder eine Plattform nutzen, die diesen Status bereits hält. Ein erneuter Versuch mit demselben Ablauf auf derselben Plattform führt vorher zum gleichen Ergebnis und hat keine Auswirkung auf die WhatsApp Business App auf dem Telefon.
Häufige Fehler
- Mehr Berechtigungen in den eigenen Meta-Einstellungen des Unternehmens erteilen. Der fehlende Zugriff gehört zur App der Plattform.
- Ein Tool selbst hosten, das auf einer Entwickler-App ohne App Review läuft. Ohne Advanced access können Unternehmen die nötigen Berechtigungen nicht erteilen.
- Wiederholt auf derselben Plattform versuchen. Das Ergebnis ändert sich erst, wenn sich der Zugriff dieser Plattform ändert.
EasyCoexistence ist ein unabhängiger Meta Tech Provider mit eigener Meta-App und betreibt Embedded Signup v4 für Coexistence. Unternehmen verbinden ihre Nummer also über eine Plattform, die den von Meta verlangten Zugriff bereits besitzt.
Häufig gestellte Fragen
Stimmt etwas mit meiner WhatsApp Business App nicht?
Nein. Die Fehlermeldung bezieht sich auf die Meta-App der Plattform, nicht auf die App auf Ihrem Telefon, die weiterhin funktioniert.
Kann ich die Berechtigung selbst erteilen?
Sie können nur Berechtigungen erteilen, für die die Plattform Advanced access besitzt. Der fehlende Zugriff muss zuerst für die Plattform genehmigt werden.
Wie erhält eine Plattform Advanced access?
Über den Meta App Review für jede Berechtigung, die ihre App braucht, als Partner, dessen Kunden die App nutzen.
Braucht das Unternehmen einen App Review?
Nein. Laut Meta braucht ein Entwickler, der direkt nur auf die Daten seines eigenen Unternehmens zugreift, weder App Review noch Advanced access.
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