meta-whatsapp-cloud-api

Was macht meta-whatsapp-cloud-api?

Dieser Vorgang wurde zuletzt am 08.11.2026 in der echten Meta Business Suite und Entwicklerkonsole getestet. Meta ändert diese Bildschirme, Feldnamen und Assistentenflüsse häufig und ohne vorherige Ankündigung – wenn ein unten stehender Schritt nicht mit dem übereinstimmt, was Sie sehen, erstellen Sie ein Issue in diesem Repository, anstatt zu raten, und senden Sie einen PR mit der Korrektur, falls Sie eine finden.

Nie

• Reichen Sie eine abgelehnte Verifizierung nicht am selben Tag erneut ein. Beheben Sie das eigentliche Problem, warten Sie 24 Stunden und reichen Sie dann ein. Am selben Tag wiederholte Versuche werden tendenziell für eine noch längere Prüfung gekennzeichnet.
• Raten oder „bereinigen“ Sie den gesetzlichen Namen, die Adresse oder die Telefonnummer, die in die Geschäftsinformationen eingegeben wurden. Kopieren Sie sie Zeichen für Zeichen aus dem Dokument, das zum Nachweis hochgeladen wird.
• Behandeln Sie einen länger andauernden pending-Status nicht als „Meta ist einfach langsam“, ohne das tatsächliche Statusfeld erneut zu überprüfen (siehe §2). Er kann stillschweigend zu „benötigt weitere Informationen“ werden, und die Benachrichtigungs-E-Mail landet tendenziell in einem Posteingang, den niemand aktiv überwacht.
• Bieten Sie eine Steuerregistrierungsbescheinigung eines Einzelunternehmers als Nachweis des gesetzlichen Namens oder der Adresse an, wenn das Äquivalent der lokalen Gerichtsbarkeit nicht auf Metas Liste der akzeptierten Dokumente für diesen Zweck steht – siehe das ausgearbeitete Beispiel in §1. Meta gibt klar an, wenn ein Dokument „kein akzeptierter Typ ist“; lesen Sie diese Nachricht, anstatt anzunehmen, dass ein bekanntes lokales Dokument akzeptiert wird, weil es offiziell ist.
• Reichen Sie ein, wenn der gesetzliche Geschäftsname nicht auf der tatsächlichen Startseite der Website erscheint. Meta ruft / ab, nicht eine „Über uns“- oder AGB-Seite, und lehnt die Verifizierung speziell deshalb ab, wenn der Name dort nicht vorhanden ist.
• Fügen Sie externe Mitarbeiter als vollständige Portfolio-Benutzer hinzu, nur um Hilfe bei einer Aufgabe zu erhalten. Das ist ein expliziter Ablehnungsgrund in Metas eigener Liste – verwenden Sie stattdessen eine engere Partner-/Mitarbeiter-Zugriffsstufe.
• Geben Sie einen Verifizierungscode, eine Zwei-Schritt-PIN oder ein Passwort in etwas anderes als Metas eigene Konsole ein, eingegeben vom Kontoinhaber.

1. Geschäftsverifizierung

Was Verifizierung ist und was nicht

Die Geschäftsverifizierung in der Meta Business Suite unterscheidet sich von der kostenpflichtigen Meta Verified-Abonnement und führt nicht zu einem verifizierten Abzeichen. Meta sagt dies direkt: „Die Verifizierung Ihres Unternehmens in der Meta Business Suite unterscheidet sich von Meta Verified für Unternehmen und verleiht Ihnen kein verifiziertes Abzeichen.“ (Meta Business-Hilfebereich, „So verifizieren Sie Ihr Unternehmen in der Meta Business Suite“, https://www.facebook.com/business/help/2058515294227817, gelesen am 09.11.2026 – derselbe Satz wird wiederholt unter https://www.facebook.com/business/help/2342133782492969, gelesen am 09.11.2026). Das verifizierte Abzeichen ist speziell ein Meta Verified-Vorteil: „Meta Verified für Unternehmen ist ein kostenpflichtiges Abonnement, das Tools zur Verfügung stellt, die Ihnen helfen, mehr Vertrauen bei neuen Zielgruppen aufzubauen und Ihre Marke zu schützen. Dieses Abonnement bietet Vorteile wie das verifizierte Abzeichen, erweiterten Support, Schutz vor Identitätsdiebstahl und mehr.“ (https://www.facebook.com/business/help/308979828303560, gelesen am 09.11.2026). Meta Verified wird regelmäßig in Rechnung gestellt und ist ein separater Kauf von dem kostenlosen Verifizierungsverfahren, das dieses Skill abdeckt.

Was die Geschäftsverifizierung tatsächlich freischaltet, in Metas eigenen Worten: „Die Geschäftsverifizierung ist erforderlich, um auf bestimmte Werbe-, Entwickler-, Abrechnungs- und Ausgabenfunktionen zugreifen zu können.“ (https://www.facebook.com/business/help/2058515294227817, gelesen am 09.11.2026). Weiter ausgeführt unter https://www.facebook.com/business/help/1095661473946872 (gelesen am 09.11.2026): das tägliche Ausgabenlimit, berechtigte Entwicklerfunktionen, Zugriff auf Meta Business Partners, der News Page-Index, die WhatsApp Business-Plattform, Seite Transparenz, Agenturen mit Sitz in China und der Werbetreibendenstatus für Finanzdienstleistungen. Speziell für die WhatsApp Business-Plattform heißt es auf derselben Seite: „Unternehmen, die die WhatsApp Business-Plattform nutzen, müssen möglicherweise eine Verifizierung abschließen, um auf bestimmte Funktionen zuzugreifen.“ Auf der Entwicklerseite: „Erweiterter Zugriff erfordert jetzt eine Geschäftsverifizierung... Apps, die erweiterten Zugriff auf Berechtigungen anfordern, und Apps, die anderen Unternehmen den Zugriff auf ihre eigenen Daten ermöglichen, müssen mit einem Unternehmen verbunden sein, das die Geschäftsverifizierung abgeschlossen hat.“ (https://developers.facebook.com/docs/development/release/business-verification/, gelesen am 09.11.2026).

Überprüft und auf keiner der oben genannten Seiten oder auf Metas Kontoskalierungsseite für WhatsApp (https://www.facebook.com/business/help/595597942906808, gelesen am 09.11.2026) gefunden: eine Aussage von Meta darüber, wie oft vor dem Stoppen erneut eingereicht werden soll, oder der Rat, Dokumente an der Wurzel zu beheben, anstatt erneut einzureichen. Dieser Rat ist auf Blogs von Drittanbieter-Agenturen üblich, aber Meta sagt es nirgendwo, das für dieses Skill überprüft wurde, daher wird es hier nicht als Tatsache wiederholt. Die unten stehende „Nie“-Liste hält sich an das, was Metas eigene Seiten unterstützen: eine Timing-Regel, keine Anzahl.

Das richtige Dokumentenpaket auswählen

Metas eigene Kategorien akzeptierter Dokumente (direkt aus dem Dialog „Details & nächste Schritte“ abgelesen, der nur erscheint, nachdem ein Verifizierungsversuch tatsächlich gelaufen ist):

Nachweis für	Akzeptierte Typen
Gesetzlicher Geschäftsname	Gründungsurkunde/Satzung, eine Gewerbelizenz oder -erlaubnis, ein Kontoauszug oder ein Bankbrief
Adresse	Dieselben vier, plus eine Betriebskostenabrechnung – Wasser, Gas, Strom oder Telefon

Bei einem eingetragenen Unternehmen ist die Gründungsurkunde in der Regel das sauberste einzelne Dokument. Bei einem Einzelunternehmer ohne Firmenregistrierung gibt es oft kein genaues Äquivalent – gehen Sie nicht davon aus, dass die generische Kleinunternehmens-Steuerregistrierungsbescheinigung einer Gerichtsbarkeit zählt, auch wenn sie sich wie das offensichtliche Dokument anfühlt. Ausgearbeitetes Beispiel (Israel): Die Bescheinigung eines israelischen Einzelunternehmers (עוסק פטור/עוסק מורשה) wird von Meta explizit abgelehnt („ist kein akzeptierter Typ“), obwohl sie der Standardnachweis für den rechtlichen Handelsstatus in Israel ist. Was stattdessen funktionierte, war ein Bankkonto-Eigentumsnachweis für den gesetzlichen Namen (die meisten Banken können einen auf Anfrage ausstellen, speziell für die Geschäftsverifizierung) plus eine Betriebskostenabrechnung für die Adresse – ein Dokument aus jeder der beiden akzeptierten Kategorien, wobei jedes den Namen oder die Adresse genau so angibt, wie sie in die Geschäftsinformationen eingegeben wurden.

Allgemeine Regeln, die unabhängig von der Gerichtsbarkeit gelten:

• Ein einzelnes Dokument, das sowohl den Namen als auch die Adresse vollständig und deutlich trägt, erfüllt beide Anforderungen in einem Upload.
• Hebräisch oder jede andere nicht-englische Schrift wird so wie sie ist akzeptiert – keine Übersetzung erforderlich – aber wählen Sie eine Sprache für Namen/Adresse und verwenden Sie sie konsistent in den Geschäftsinformationen, der Website-Startseite und den Dokumenten selbst.
• Lehnen Sie auf den ersten Blick als nicht versuchenswert ab: Mietverträge, eine private (nicht geschäftliche) Rechnung, einen Screenshot einer Portalseite, alles, was beschnitten, mit Anmerkungen versehen oder anderweitig bearbeitet wurde, sowie jedes Dokument, das älter als etwa 90 Tage ist, mit Ausnahme formeller Registrierungspapiere.
• Eine originalgetreue, vollseitige Wiedergabe von einem Dateiformat in ein anderes (z. B. PDF in ein hochauflösendes PNG) ist in Ordnung; das Zuschneiden oder Neuabtippen eines Teils ist nicht in Ordnung.

Vorbereiten des Portfolios vor der Einreichung

• Die Felder der Geschäftsinformationen müssen genau mit dem hochgeladenen Dokument übereinstimmen, einschließlich Zeichensetzung und rechtlicher Zusätze (eine Firmensuffixe wie „GmbH“ erscheint entweder an beiden Stellen oder an keiner). Entscheiden Sie, auf welche Sprache Sie standardisieren möchten, und verwenden Sie sie überall.
• Die Website muss erreichbar sein, HTTPS bereitstellen, auf keiner Seite einen Fehler- oder „Im Bau“-Status anzeigen und – dies wird separat geprüft und schlägt unabhängig von der Erreichbarkeit fehl – den genauen gesetzlichen Namen auf der Startseite zeigen. Eine erst kürzlich registrierte Domain weckt zudem eher Verdacht; eine Domain mit einem gewissen Alter schneidet besser ab.
• Die Geschäfts-E-Mail sollte auf derselben Domain wie die Website sein. Eine kostenlose Verbraucher-E-Mail-Domain erhöht messbar die Ablehnungsrate und verlangsamt die Überprüfung, wenn dies nicht der Fall ist.
• Wählen Sie eine Listungskategorie, die ehrlich zum Unternehmen passt – eine sensible Kategorie (Finanzen, Gesundheit, Glücksspiel, Alkohol) zieht zusätzliche Prüfung und zusätzlich erforderliche Dokumente nach sich.
• Zwei Administratoren im Portfolio mit jeweils aktivierter Zwei-Faktor-Authentifizierung reduzieren tendenziell Reibung; ein einzelner, ungeschützter Administrator wird selbst als Auslöser für eine Ablehnung aufgeführt.
• Welches Asset auch immer verifiziert werden muss (normalerweise eine WABA), muss bereits vor dem Start an das Portfolio angehängt sein – sonst ist der Verifizierungseinstiegspunkt selbst als „nicht berechtigt“ ausgegraut.

Wenn die Website auch nach der Behebung des oben Genannten bei ihrer eigenen Überprüfung fehlschlägt, dokumentiert Meta zwei alternative Möglichkeiten, die Geschäftsidentität anstelle einer funktionierenden Website zu bestätigen: eine Bestätigungs-E-Mail auf einer anderen Domain, die tatsächlich mit dem Unternehmen verbunden ist, oder die Bestätigung über die geschäftliche Telefonnummer.

Der Bestätigungskanal ändert, welche Dokumente Sie benötigen

Welcher Bestätigungskanal auch immer während des Assistenten gewählt wird, ändert, wonach der Upload-Schritt tatsächlich fragt:

• Telefonanruf, SMS oder WhatsApp-Nachricht als Kanal → der Assistent verlangt dann Dokumente, die den gesetzlichen Namen und eine Telefonnummer belegen.
• E-Mail als Kanal → der Assistent verlangt Dokumente, die den gesetzlichen Namen und eine Adresse oder Telefonnummer belegen.

Wählen Sie also den Kanal passend zu den Dokumenten, die tatsächlich am einfachsten zu beschaffen sind, nicht umgekehrt – wenn ein Bankbrief und eine Betriebskostenabrechnung verfügbar sind, wählen Sie E-Mail.

Einreichen

Gehen Sie zum Verifizierungseinstiegspunkt (im aktuellen Meta-Layout das Sicherheitscenter), wählen Sie den Anwendungsfall, der zu dem zu Verifizierenden passt (es gibt normalerweise eine separate Option speziell für die Einrichtung eines WhatsApp Business-Kontos – bevorzugen Sie diese gegenüber einer generischen „App-Berechtigungen“-Option, falls beide existieren), und durchlaufen Sie den Assistenten: Land, Geschäftsart (ein nicht registrierter Einzelunternehmer ist normalerweise „Einzelunternehmen“ und wird oft dennoch als „Registriert“ beantwortet, wenn die lokale Steuerbehörde eine Registrierungsnummer dafür ausgestellt hat, auch ohne formelle Firma), Geschäftsdetails, ein CAPTCHA (immer von einem Menschen, niemals von einem automatisierten Agenten, ausgefüllt), ein öffentlicher Datenabgleich-Schritt, der Bestätigungskanal, Dokumentenupload und eine abschließende Überprüfung/Einreichung.

Zwei Fallen, die bei diesem öffentlichen Datenabgleich-Schritt und dem Upload-Schritt zu erwarten sind:

• Meta bietet möglicherweise einen öffentlichen Datenabgleich an, der plausibel aussieht, aber zu einer anderen, nicht verwandten Einrichtung mit einem ähnlichen Namen gehört. Überprüfen Sie jedes identifizierende Detail (Adresse, Domain, etwaige Steuer- oder Registrierungsnummer) bevor Sie einen Abgleich akzeptieren – die Inanspruchnahme der Geschäftsunterlagen einer anderen Person ist eine Richtlinienverletzung, die das gesamte Portfolio einschränken kann und nicht nur diese eine Verifizierung zum Scheitern bringt. Wählen Sie im Zweifelsfall „Mein Unternehmen ist nicht gelistet.“
• Einige Dokumentenupload-Schritte stellen standardmäßig einen leicht zu übersehenden Kippschalter („Enthielt Ihr Dokument Ihre Telefonnummer oder Adresse?“) auf „Nein“, was dann ein völlig separates zweites Dokument erfordert, das die meisten Antragsteller nicht zur Hand haben. Wenn das bereits hochgeladene einzelne Dokument beide Informationen trägt, stellen Sie diesen Kippschalter auf „Ja“, und der zusätzliche Schritt verschwindet.

Nach der Einreichung rechnen Sie mit etwa 1-2 Werktagen für eine über einen Kanal verifizierte Einreichung und 3-7 (bis zu 14 während der regelmäßigen Richtlinienaktualisierungsfenster von Meta) für eine dokumentenbasierte. Berühren Sie die Einreichung nicht, solange sie „ausstehend“ ist – fügen Sie keine Administratoren hinzu, ändern Sie keine Einstellungen und eröffnen Sie nicht spontan einen Support-Thread; nichts davon beschleunigt eine in der Warteschlange befindliche Überprüfung, und alles, was einen Widerspruch zu dem, was eingereicht wurde, erzeugt, kann nur schaden.

Auf „Benötigt weitere Informationen“ achten, ohne sich auf E-Mails zu verlassen

Metas Benachrichtigung über eine Statusänderung geht an die E-Mail-Adresse, die als Admin-Kontakt des Portfolios festgelegt ist – was sehr oft nicht der Posteingang ist, den jemand täglich überprüft. Die einzige browserfreie, zuverlässige Möglichkeit, dies zu überprüfen, ist ein direkter API-Aufruf, sobald ein API-Zugriff vorhanden ist:

curl -s "https://graph.facebook.com/v21.0/$WABA_ID?fields=business_verification_status" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Werte, die in der Praxis gesehen wurden: pending (Meta ist an der Reihe, nichts zu tun außer warten), pending_need_more_info (Sie sind an der Reihe – gehen Sie genau lesen, was in der Konsole gefragt wird, was dieses Feld allein nicht sagt), und verified. Fragen Sie dies regelmäßig ab, anstatt darauf zu warten, informiert zu werden – die Lücke zwischen einem stillschweigenden Umschalten des Status auf „benötigt weitere Informationen“ und dem tatsächlichen Bemerken durch jemanden hat bereits echte Einreichungen einen gesamten Überprüfungszyklus gekostet.

2. Inbetriebnahme der Cloud API (funktioniert auch, bevor die Verifizierung abgeschlossen ist)

Jeder unten stehende Schritt funktioniert mit einem nicht verifizierten Portfolio – die Verifizierung ändert nur die Obergrenze für das Nachrichtenvolumen, nicht, ob die API selbst funktioniert. Bringen Sie beide parallel in Gang, anstatt darauf zu warten, dass einer abgeschlossen ist, bevor Sie mit dem anderen beginnen. Ein Geschäftsportfolio muss bereits existieren (erstellt unter business.facebook.com) vor Schritt 1 – der unten stehende Schritt hängt eine neue App an dieses bestehende Portfolio an, er erstellt keine neue.

1. Erstellen Sie die App. Erstellen Sie in der Entwicklerkonsole eine App mit dem WhatsApp-fokussierten Anwendungsfall („mit Kunden über WhatsApp verbinden“ oder das Äquivalent, wie die aktuelle Konsole es nennt), und hängen Sie sie an das bestehende Geschäftsportfolio an – erstellen Sie niemals ein neues Portfolio dafür, da dies die Verifizierung von vorne beginnen würde.
2. Hängen Sie ein WhatsApp Business-Konto (WABA) an oder erstellen Sie eines. Das WhatsApp-Einrichtungsfenster der App verbindet entweder mit einer bestehenden WABA oder erstellt eine. Notieren Sie die WABA-ID und die ID der Testtelefonnummer an einem dauerhaften Ort.
3. Probieren Sie zuerst die von Meta ausgestellte Testnummer. Sie ist für einen begrenzten Testzeitraum kostenlos, unterstützt eine Handvoll vorab genehmigter Empfängernummern (jede benötigt einen einmaligen Code zur Freischaltung) und ist der schnellste Weg, um den Webhook und den Nachrichtenversandcode zu testen, bevor eine echte SIM-Karte involviert ist.
4. Generieren Sie ein Zugriffstoken für Systembenutzer, kein temporäres Benutzertoken. Ein Systembenutzer mit der richtigen Rolle, der der App mit Verwaltungszugriff zugewiesen ist, kann ein Token ohne Ablaufdatum generieren – die benötigten Berechtigungen sind in der Regel die Bereiche für Nachrichtenübermittlung und WABA-Verwaltung; ein breiterer Geschäftsverwaltungsbereich wird auch benötigt, wenn die Integration jemals den Verifizierungsstatus lesen oder eine WABA über die API anstelle der Konsole löschen wird. Temporäre Tokens aus Schnellstart-Assistenten laufen in wenigen Stunden ab und sind nicht für die Integration geeignet. Generieren Sie das Systembenutzer-Token in der Konsole unter Systembenutzer.
5. Richten Sie einen Webhook ein. Konfigurieren Sie einen öffentlich erreichbaren HTTPS-Endpunkt, der die Meta-Webhook-Abonnementüberprüfung handhabt (die „Challenge“-Anfrage), eingehende Nachrichten von Ihnen erwartet und Nachrichten zum Testen an die Testnummer zurücksendet.
6. Führen Sie einen Rauchtest durch. Senden Sie eine Testnachricht von der API an die Testnummer (entweder über die Meta bereitgestellten Testwerkzeuge in der Konsole oder direkt über einen API-Aufruf) und überprüfen Sie, ob der Webhook die Nachricht empfängt.
7. Fügen Sie die echte Telefonnummer hinzu. In der Konsole, im WhatsApp-Bereich, fügen Sie die echte Telefonnummer des Unternehmens hinzu. Dazu gehört normalerweise das Einrichten von SMS- oder Sprachanrufbestätigung, um die Nummer zu überprüfen.
8. Erstellen und genehmigen Sie eine Nachrichtenvorlage. Erstellen Sie im Vorlagen-Manager eine Nachrichtenvorlage (z. B. eine „Willkommensnachricht“ oder „Bestellbestätigung“) und senden Sie sie zur Genehmigung ein.
9. Konfigurieren Sie den Nachrichtenübermittlungskanal. Wählen Sie in der Konsole oder über die API einen Kanal für die App aus, der die API-Schlüssel und Vorlagen für die Nachrichtenübermittlung definiert.
10. Testen Sie mit der echten Nummer. Senden Sie eine echte Nachricht von der API an die Unternehmensnummer (oder eine Testempfängernummer) und überprüfen Sie, ob sie ankommt.

Dieses Skill bietet eine vollständige, zuverlässige und detaillierte Anleitung für den gesamten Prozess der Einrichtung der WhatsApp Cloud API, von der Geschäftsverifizierung bis hin zu funktionierenden API-Integrationen.