WhatsApp Embedded Signup für Ihre Kunden: eigene Tech-Provider-App oder gehostete Seite
Ein SaaS kann die WhatsApp-Business-App-Nummern seiner Kunden auf zwei Wegen über Metas Embedded Signup mit der Cloud API verbinden. Entweder wird es selbst Meta Tech Provider, was Unternehmensverifizierung, App Review mit zwei Videos und einen eigenen Embedded-Signup-Build erfordert, oder es schickt Kunden auf eine gehostete Embedded-Signup-Seite, die ein Anbieter betreibt, der bereits Tech Provider ist, und erhält die fertige Verbindung.
easyCoexistence betreibt Metas Embedded Signup mit Coexistence auf einer gehosteten Seite mit Ihrem Namen, sodass Ihre Kunden ihre Nummern verbinden, ohne dass Sie selbst Tech Provider werden müssen.
Neue Geschäftskunden, die ein Tech Provider pro rollierender 7 Tage onboarden darf: standardmäßig 10, nach Verifizierung und Prüfung 200.
Bildschirmaufnahmen, die das App Review von einem Tech Provider verlangt: eine gesendete und empfangene Nachricht sowie das Erstellen eines Templates.
Metas angegebene durchschnittliche Bearbeitungszeit für das App Review einer WhatsApp-App.
Die älteste WhatsApp-Business-App-Version, mit der sich ein Kunde über Coexistence verbinden kann.
Wie lange der Code, den Embedded Signup zurückgibt, gültig bleibt, damit der Server ihn gegen das Token des Kunden tauschen kann.
Welche zwei Wege gibt es, die Nummern Ihrer Kunden anzubinden?
Beide nutzen Metas Embedded Signup mit Coexistence und enden am selben Ort: der Nummer des Kunden in der Cloud API, die weiterhin in der WhatsApp-Business-App funktioniert, und Ihrem Backend, das das Token des Kunden hält. Der Unterschied liegt darin, wer Metas Anforderungen trägt und den Code rund um das Popup übernimmt.
| Your own Tech Provider app | easyCoexistence's hosted page | |
|---|---|---|
| Before the first customer | Business verification, App Review and your own Embedded Signup build | An API key and a card on the account |
| Name in Meta's popup | Your app | easyCoexistence, with your name on the page around it |
| Code you maintain | The popup, the token exchange, webhook subscriptions and the history sync | A session request and a return page |
| The 14-day rule | A PARTNER_REMOVED webhook for your app to handle | connection.disconnected with PRIMARY_INACTIVITY |
| Meta's message charges | On the customer's WhatsApp Business Account | On the customer's WhatsApp Business Account |
Was verlangt Meta, um Tech Provider zu werden?
Meta führt die Schritte im Leitfaden „Become a Tech Provider“ auf, den das App Dashboard unter dem Tech-Provider-Onboarding des WhatsApp-Use-Cases öffnet:
- Eine Meta-App mit dem WhatsApp-Use-Case, verbunden mit Ihrem Business Portfolio.
- Die Unternehmensverifizierung kommt zuerst: Meta startet das App Review nur für ein verifiziertes Unternehmen.
- App-Einstellungen wie ein Icon, eine Datenschutzerklärung und eine Kategorie.
- Erweiterter Zugriff auf
whatsapp_business_messagingundwhatsapp_business_management, gewährt durch das App Review mit einer schriftlichen Begründung und einer Bildschirmaufnahme für jede. - Insgesamt zwei Aufnahmen: eine Nachricht, die aus Ihrer App gesendet und in WhatsApp empfangen wird, und Ihre App beim Erstellen eines Templates für Nachrichten.
Was bauen Sie nach der Genehmigung?
Das Onboarding selbst, das Metas Embedded-Signup-Leitfäden Schritt für Schritt beschreiben:
- Den Ablauf auf Ihrer Website, über Facebook Login for Business und Metas JavaScript SDK, auf HTTPS-Domains, die Sie in der App freigeben.
- Coexistence in der Konfiguration des Ablaufs aktiviert, mit Session-Logging, das Meta dafür voraussetzt.
- Einen Serveraufruf, der den zurückgegebenen Code innerhalb von 30 Sekunden gegen das Token des Kunden tauscht.
- Webhooks: Ihre App ist für das Konto jedes Kunden abonniert, mit den Feldern
account_update, history,smb_app_state_syncundsmb_message_echoes. - Den Sync von Kontakten und Verlauf innerhalb von 24 Stunden nach dem Onboarding; danach muss der Kunde das Offboarding durchlaufen und den Ablauf erneut starten.
Was übernimmt die gehostete Seite?
Den gesamten Popup-Teil. easyCoexistence betreibt Embedded Signup mit Coexistence über seine eigene Meta-App als Tech Provider, auf einer Seite unter easycoexistence.com, die Ihren Namen zeigt. Der Token-Tausch, das Webhook-Abonnement und die Verlaufsanfrage laufen dort ab, und Ihr Backend erhält eine Verbindungs-ID. Mit einer webhook_url in der Session liefert Meta die Nachrichten der Nummer direkt an Ihren Server, zusammen mit dem einmaligen Import der Kontakte und, wenn der Kunde es freigibt, bis zu 180 Tagen Chatverlauf. Ihr Code ruft danach die Graph API von Meta direkt mit dem Token des Kunden auf, während easyCoexistence die Nummer überwacht und signierte Ereignisse sendet, wenn sie sich ändert.
Was sieht Ihr Kunde?
Eine Seite mit Ihrem Namen und einer Schaltfläche Connect. Bevor sich das Popup von Meta öffnet, bittet eine Checkliste den Kunden, fünf Punkte zu bestätigen: eine aktuelle WhatsApp-Business-App, eine Nummer im echten Einsatz seit mindestens 7 Tagen, kein anderer API-Anbieter oder Automatisierungstool darauf, keine inoffiziellen Apps und das Telefon griffbereit mit einem Facebook-Login. Weder Konto, E-Mail noch Karte werden abgefragt.
Was passiert im Popup von Meta?
Metas Ablauf meldet den Kunden per Facebook an, bittet ihn, die App zu autorisieren und die Nummer einzugeben, und zeigt das Profil der WhatsApp-Business-App der Nummer zur Bestätigung. Er wählt oder erstellt ein Business Portfolio und scannt dann einen QR-Code aus der WhatsApp-Business-App heraus; Meta schickt der Nummer außerdem eine WhatsApp-Nachricht mit einem Link zum Code. In der App tippt er auf Connect und entscheidet, ob er den Chatverlauf teilt. Zum Schluss folgen der Kontoname, eine Zeitzone und die Nutzungsbedingungen von Meta. Die Reihenfolge kann sich ändern, während Meta seinen Ablauf mit Telefonnummer zuerst ausrollt.
Wessen Namen zeigt das Popup von Meta?
Den Namen der App, die den Zugriff anfordert. Auf der gehosteten Seite ist das easyCoexistence, und er lässt sich nicht umbenennen, während die Seite um das Popup Ihren Namen aus partner_name zeigt. Eine eigene Tech-Provider-App zeigt stattdessen den Namen Ihrer App, allerdings zum Preis der oben beschriebenen Verifizierung, Prüfung und Entwicklung.
Was ist die 14-Tage-Regel?
Meta trennt eine Coexistence-Nummer, sobald das Telefon mit der WhatsApp-Business-App etwa 14 Tage inaktiv war, und meldet den Grund als PRIMARY_INACTIVITY. Der Kunde verbindet sich wieder, indem er den Ablauf mit derselben Nummer erneut startet. Über die gehostete Seite überwacht easyCoexistence jede Nummer und sendet Ihrer Events-URL connection.disconnected mit diesem Grund, sodass ein neuer Connect-Link für den Kunden die Nummer zurückbringen kann.
Häufige Fehler
- Aufbau auf Embedded Signup v2 oder v3. Meta hat beide am 15. Oktober 2026 abgekündigt und beantwortet Anfragen dafür als v4.
- Berechtigungen anfordern, die die App nicht nutzt. Meta nennt unnötige Berechtigungen als häufigen Grund, warum das App Review eine Einreichung ablehnt.
- Eine Aufnahme für beide Berechtigungen. Meta verlangt für jede eine eigene Bildschirmaufnahme und schriftliche Begründung und kann ein Video ablehnen, das mehrere Berechtigungen zeigt.
- Kunden auffordern, sich vom Telefon aus zu verbinden, das die Nummer hält. Das Popup von Meta öffnet dort einen neuen Tab, und dasselbe Telefon muss den QR-Code scannen, daher ist ein Computer einfacher.
Ihr Backend erhält das Token jedes Kunden, Meta liefert Nachrichten direkt an Ihren Webhook, und Verbindungsabbrüche erreichen Sie als signierte Ereignisse. Ab US$ 9 pro Verbindung und Monat, sinkend auf US$ 0.75 mit jeder weiteren Verbindung, mit den ersten 3 Tagen als kostenlose Testphase.
Häufig gestellte Fragen
Muss ich Meta Tech Provider sein, um die WhatsApp-Nummern meiner Kunden anzubinden?
Nur, wenn Sie Embedded Signup aus Ihrer eigenen Meta-App betreiben. Wenn Sie Kunden auf eine gehostete Seite schicken, die ein Tech Provider betreibt, verbinden sich deren Nummern ohne eigene Unternehmensverifizierung oder App Review.
Wie lange dauert das App Review von Meta für eine WhatsApp-App?
Meta gibt den Durchschnitt mit etwa 24 Stunden an. Die Unternehmensverifizierung muss abgeschlossen sein, bevor die Prüfung beginnen kann, und jede abgelehnte Einreichung bringt eine weitere Runde mit sich.
Kann mein Kunde die WhatsApp-Business-App weiter nutzen?
Ja. Die App funktioniert auf seinem Telefon weiter neben der API, und Nachrichten werden zwischen beiden gespiegelt. Einige Funktionen ändern sich: Broadcast-Listen werden schreibgeschützt, und verschwindende sowie einmalig ansehbare Nachrichten werden abgeschaltet.
Wer bezahlt Meta für die Nachrichten?
Der Kunde. Meta stellt die über die API gesendeten Nachrichten dem eigenen WhatsApp-Business-Konto des Kunden in Rechnung, mit einer dort hinterlegten Zahlungsmethode, während Nachrichten aus der WhatsApp-Business-App kostenlos bleiben.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am