WhatsApp Embedded Signup ist der Anmeldeablauf, den eine SaaS-Plattform in ihr eigenes Produkt einbaut, damit Geschäftskunden ihre WhatsApp-Konten und Telefonnummern in einem Pop-up-Fenster mit der Plattform verbinden können. Meta stellt Version 2 (v2), Version 3 (v3) und ihre Public-Preview-Versionen am 15. Oktober 2026 ein.[1] Für Version 4 (v4) ist kein Enddatum angekündigt, sie unterstützt weiterhin die Marketing Messages API for WhatsApp und bringt Unterstützung für Click to WhatsApp Ads und die Conversions API. Dieser Leitfaden zeigt dir, wie du prüfst, welche Version du nutzt, was sich mit v4 ändert und wie du vor der Frist migrierst.
Das Wichtigste auf einen Blick
- Das extras-Objekt in deinem Embedded-Signup-Startcode zeigt, welche Version du nutzt, und das Auslesen dauert nur wenige Minuten.
- Embedded Signup v2, v3 und ihre Public Previews erreichen am 15. Oktober 2026 ihr Einstellungsdatum, während für v4 und seine Public Preview kein Enddatum angekündigt ist.
- Meta schätzt den Entwicklungsaufwand für den Umstieg auf v4 auf bis zu eine Woche, Tests eingeschlossen.
- Meta aktualisiert die meisten verbleibenden v2- und v3-Integrationen automatisch, aber v2-Integrationen mit only_waba_sharing, marketing_messages_lite oder coex brauchen vor dem 15. Oktober 2026 Anpassungen durch Entwickler.
- Eine Plattform braucht den Status Solution Partner oder Tech Provider und Advanced Access aus dem App Review, bevor sie Geschäftskunden onboarden kann.
Was ist WhatsApp Embedded Signup?
Embedded Signup ist eine Authentifizierungs- und Autorisierungsoberfläche für Desktop und Mobilgeräte, mit der Geschäftskunden die WhatsApp-Assets erzeugen, die ein Partner braucht, um sie auf der WhatsApp Business Platform zu onboarden.[2] Ein SaaS-Unternehmen startet sie über einen Link oder Button, und sie öffnet sich in einem neuen Fenster. Der Flow erfasst Unternehmensinformationen, legt die Assets an und gewährt deiner Meta-App Zugriff darauf. Er läuft auf Facebook Login for Business und dem Facebook JavaScript SDK, und die Kunden bleiben Eigentümer aller Assets und behalten vollen Zugriff auf den WhatsApp Manager.
Zwei Partnertypen können den Flow betreiben. Solution Partner müssen bereits eine Kreditlinie haben, die sie für die Abrechnung mit ihren Kunden teilen. Tech Provider sind die Softwareplattformen, die über Metas App Review Advanced Access für die Berechtigungen whatsapp_business_messaging und whatsapp_business_management erhalten, und ihre Kunden hinterlegen eine Zahlungsmethode in ihrem eigenen Messaging Account.
Metas Kontobegriffe ändern sich: Ältere Dokumentation und viele Codebeispiele sprechen vom WhatsApp Business-Konto (WABA), dem Container für die WhatsApp-Assets eines Unternehmens. Meta teilt es in einen WhatsApp Account und einen Messaging Account auf, mit einem Rollout, der am 23. September 2026 beginnt und bis Mitte Oktober 2026 alle Unternehmen erreicht, und bestehende waba_id-Werte bezeichnen jetzt Messaging-Account-IDs.[3] Meta erklärt, dass bestehende IDs, Endpoints und Zugriffstoken während des gesamten Rollouts weiter funktionieren, und Metas Übersicht zu Embedded Signup bezeichnet die Änderung als Beta, die sich noch ändern kann. Dieser Leitfaden verwendet ab hier die neuen Begriffe.
360Dialog, ein Official Meta Solution Partner, bietet SaaS-Partnern Embedded Signup über die Partner Platform an. Integrated Onboarding umfasst dort vier Methoden: Direct Link (No-Code), Connect Button (ein React-NPM-Paket, Low-Code), Custom IO (Framework-unabhängig) und Partner-Hosted Embedded Signup (High-Code, für von Meta zugelassene Tech Provider).[4] Das 360Dialog Embedded Signup wird im gesamten Integrated Onboarding automatisch ausgelöst, und Partner können ihren eigenen Flow hosten, sobald sie Metas Anforderungen erfüllen. Die geschäftliche Seite der Entscheidung, darunter Make-or-buy-Abwägungen, Monetarisierung und Partnerwahl, behandeln wir in unserem Artikel zum SaaS-Integrationskontext.
Wenn deine Plattform Kunden WhatsApp-Onboarding anbieten muss, bevor Meta v2 und v3 am 15. Oktober 2026 abschaltet, sprich mit uns darüber, welche Integrated-Onboarding-Methode zu deinem Produkt passt.
Welche Embedded-Signup-Versionen sind noch verfügbar?
Meta führt sechs Embedded-Signup-Versionen: v2, v3, v4 und jeweils eine Public Preview. Meta stellt v2 und v3 zusammen mit ihren Public Previews am 15. Oktober 2026 ein und hat für v4 und die v4 Public Preview noch kein Enddatum angekündigt. Eine Public Preview ist eine Opt-in-Version, die du über den version-Wert im extras-Objekt auswählst.
Das extras-Objekt ist die Options-Eigenschaft, die du in deinem Startcode an FB.login übergibst, und seine Form verrät dir die Version. Meta zeigt diese Formen für v2, v3 und v4:
// v2: no version field; sessionInfoVersion turns session logging on (possible value: 3)
extras: {
setup: "<SETUP_DATA>",
features: [ { name: "<FEATURE_NAME>" } ],
featureType: "<FEATURE_TYPE>",
sessionInfoVersion: "<SESSION_INFO_VERSION>"
}
// v3
extras: {
setup: "<SETUP_DATA>",
features: [ { name: "<FEATURE_NAME>" } ],
featureType: "<FEATURE_TYPE>",
version: "v3"
}
// v4: the extras object is purposely empty
extras: {}Eine Facebook-Login-for-Business-Konfiguration ist ein gespeichertes Set von Login-Optionen im App Dashboard deiner Meta-App, das über eine Konfigurations-ID identifiziert wird und festlegt, welche Produkte der Flow enthält. Meta dokumentiert, dass du automatisch auf v4 umgestellt wirst, wenn du eine neue Konfiguration erstellst und Produkte auswählst.[5] Damit gehört die Konfiguration zur Versionsprüfung jeder Integration, deren Startcode keinen version-Wert enthält. Um zuerst die v4 Preview zu nutzen, setze den version-Wert:
extras: { version: "v4-public-preview" }Metas Versionsseite nennt diese Daten:
| Version | Eingeführt am | Verfügbar bis |
|---|---|---|
| v4 public preview | 12. Mai 2026 | Nicht angekündigt |
| v4 | 8. Oktober 2025 | Nicht angekündigt |
| v3 public preview | 14. August 2025 | 15. Oktober 2026 |
| v2 public preview | 14. August 2025 | 15. Oktober 2026 |
| v3 | 29. Mai 2025 | 15. Oktober 2026 |
| v2 | Januar 2023 | 15. Oktober 2026 |
Wenn du einschätzen willst, wie viele Kundenkanäle deine Plattform vor der Frist am 15. Oktober 2026 auf v4 umstellt, sprich mit uns über Tarife und Preise.
Was ändert sich beim Umstieg auf v4?
v4 wählt Produkte über eine Facebook-Login-for-Business-Konfiguration aus und kann ein Unternehmen in einem einzigen Flow für mehrere Messaging-Produkte von Meta onboarden. Metas v4-Seite nennt Conversions API, Click to WhatsApp Ads, Click to Messenger Ads und Click to Direct Ads als zusätzlich unterstützte Produkte und erklärt, dass v4 weiterhin Cloud API, die Marketing Messages API for WhatsApp, das Onboarding der WhatsApp Business App, die partnergeführte Business Verification und die Automatic Events API unterstützt.
Cloud API ist Metas gehostete WhatsApp Business API. Die Marketing Messages API for WhatsApp ist Metas API für den Versand von Marketingnachrichten. Click to WhatsApp Ads (CTWA) sind Meta-Anzeigen, die eine WhatsApp-Unterhaltung öffnen, und die Conversions API sendet Conversion Events zur Anzeigenmessung an Meta zurück. Metas Versionstabelle führt die Marketing Messages API for WhatsApp, Click to WhatsApp Ads und Conversions API (WhatsApp) als Produkte, die nur in v4 über die Login-Konfiguration auswählbar sind, während v2- und v3-Integrationen die Marketing Messages API über den Feature-Namen marketing_messages_lite erreichen.
Der Flow selbst ändert sich in mehreren Punkten:
- Phone Number First: Kunden geben ihre geschäftliche Telefonnummer gleich zu Beginn ein und verifizieren sie, bevor sie Business-Assets anlegen oder auswählen, sodass Probleme mit Berechtigung und Verifizierung früher sichtbar werden. Laut Meta läuft der Rollout noch, daher sehen manche Kunden weiterhin die bisherige Reihenfolge der Bildschirme.
- Zusammengefasste Seiten: Asset-Auswahl, Unternehmensinformationen und Berechtigungen liegen jeweils auf einer einzigen Seite.
- Geteilte Assets: Asset-Admins können Assets aus anderen Business-Portfolios teilen, also aus den Meta-Geschäftskonten, die die Assets eines Unternehmens enthalten.
- Seitenverknüpfung: Telefonnummern werden automatisch mit Facebook-Seiten verknüpft, wenn ein Kunde über die Marketing API für Anzeigen mit Klick auf WhatsApp onboardet.
- Multi-Produkt-Onboarding: Ein Flow kann WhatsApp, Instagram und Messenger abdecken, und das Onboarding für eine einzelne API wird weiterhin voll unterstützt.
Die v4 Public Preview entspricht v4 im Funktionsumfang, und Meta nennt die vereinfachte Oberfläche und den Phone-Number-First-Flow als wichtigste Unterschiede.[6] Bei den Berechtigungen wählt v4 alle nötigen Berechtigungen und Assets für die Produkte aus, die du auswählst, und du brauchst für jede davon Advanced Access. Advanced Access ist die Berechtigungsstufe, die Meta über das App Review vergibt, damit deine App eine Berechtigung mit den Assets von Geschäftskunden nutzen kann. Cloud API und die Marketing Messages API for WhatsApp brauchen whatsapp_business_management und whatsapp_business_messaging, die Conversions API für CTWA braucht whatsapp_business_manage_events, und CTWA braucht ads_read, ads_management, pages_manage_ads, pages_read_engagement und pages_show_list.
Wie unterscheiden sich Abschlussstatus und Session Logging je nach Version?
Abschlussstatus und Session Logging sind die beiden versionsabhängigen Verhaltensweisen, die bestimmen, was dein Backend empfängt. Der Abschlussstatus ist der Telefonnummernstatus, mit dem ein Geschäftskunde den Flow abschließen kann, und Session Logging ist das Message Event im Browser, das das Ergebnis jedes Flows meldet. Die Tabelle zeigt Metas Wert für jede Version, und die Absätze danach behandeln die Events selbst.
| Version | Feature Types | Abschlussstatus | Vorausgefüllte Infos | Session Info Logging | Produkte über die Login-Konfiguration |
|---|---|---|---|---|---|
| v4 | whatsapp_business_app_onboarding | Verifizierte, nicht verifizierte oder keine Telefonnummer | Kann Unternehmensinformationen ausfüllen, es werden keine Bildschirme übersprungen | Wird für alle Flows zurückgesendet | Marketing Messages API for WhatsApp, Click to WhatsApp Ads, Conversions API (WhatsApp) |
| v3 | whatsapp_business_app_onboarding | Verifizierte, nicht verifizierte oder keine Telefonnummer | Kann Unternehmensinformationen ausfüllen, es werden keine Bildschirme übersprungen | Wird für alle Flows zurückgesendet | Nicht unterstützt |
| v3 public preview | whatsapp_business_app_onboarding | Verifizierte, nicht verifizierte oder keine Telefonnummer | Kann Unternehmensinformationen ausfüllen, es werden keine Bildschirme übersprungen | Wird für alle Flows zurückgesendet | Nicht unterstützt |
| v2 | only_waba_sharing, whatsapp_business_app_onboarding, marketing_messages_lite | Verifizierte Telefonnummer | Kann Unternehmensinformationen ausfüllen und Bildschirme überspringen | Partner müssen eine sessionInfoVersion hinzufügen, um den Callback zu erhalten | Nicht unterstützt |
| v2 public preview | only_waba_sharing, whatsapp_business_app_onboarding, marketing_messages_lite | Verifizierte Telefonnummer | Kann Unternehmensinformationen ausfüllen, es werden keine Bildschirme übersprungen | Wird für alle Flows zurückgesendet | Nicht unterstützt |
Der Listener ist ein Message-Event-Handler auf der Seite, die den Flow startet. Metas Implementierungsseite zeigt, wie er prüft, dass event.origin auf facebook.com endet und data.type gleich WA_EMBEDDED_SIGNUP ist.[7] Beim Abschluss empfängt er phone_number_id, waba_id (die die Messaging-Account-ID enthält), business_id und, sofern der Flow sie erzeugt hat, ad_account_ids, page_ids, dataset_ids, catalog_ids, instagram_account_ids sowie waba_ids für Flows mit mehreren Accounts.
Das Feld event unterscheidet die Ergebnisse. Meta nennt FINISH, FINISH_ONLY_WABA, FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING, FINISH_OBO_MIGRATION, FINISH_GRANT_ONLY_API_ACCESS und ERROR beim Abschluss. Ein abgebrochener Flow meldet CANCEL mit data.current_step, dem Bildschirm, auf dem der Kunde ausgestiegen ist. Ein vom Nutzer gemeldeter Fehler kommt als CANCEL mit data.error_message, data.error_code, data.session_id und data.timestamp an. Schließt der Kunde das Pop-up auf dem letzten Bildschirm, gilt das Onboarding als erfolgreich. Der im Response Callback zurückgegebene Code hat eine Time to Live von 30 Sekunden, daher muss dein Server ihn schnell eintauschen; Meta dokumentiert den Austausch auf seiner Seite zum Onboarding als Tech Provider.
Metas v3-Seite ergänzt, dass Partner auf v3 weiterhin einen Event Listener im selben Fenster von Embedded Signup hinzufügen müssen, um die eingehenden Informationen zu verarbeiten.[8] Da v3 und v4 Kunden den Abschluss ohne verifizierte Nummer erlauben, verweist dieselbe Seite auf die Dokumentation zum Session Logging, um den Telefonnummernstatus eines abgeschlossenen Flows zu ermitteln.
Wie funktioniert Coexistence-Onboarding mit Embedded Signup?
Mit Coexistence kann ein Unternehmen die WhatsApp Business App weiter auf einer Telefonnummer nutzen, die auch auf der Cloud API läuft. Embedded Signup unterstützt das über den featureType-Wert whatsapp_business_app_onboarding, und Meta verlangt für diesen Flow Embedded Signup mit Session Logging.[9] Meta nennt diese Voraussetzungen:
- Der Kunde nutzt die WhatsApp Business App in Version 2.24.17 oder höher.
- Du bist bereits Solution Partner oder Tech Provider und kennst die Cloud API.
- Dein Webhook Callback, die Webadresse, an die WhatsApp Events an deinen Server liefert, nimmt Webhooks an und verarbeitet sie.
Metas Coexistence-Seite zeigt ein einziges Start-Snippet, in Schritt 2, „Customize Embedded Signup“:
// Launch method and callback registration
{
"config_id": "<CONFIGURATION_ID>",
"response_type": "code",
"override_default_response_type": true,
"extras": {
setup: {},
"featureType": "whatsapp_business_app_onboarding", // set to 'whatsapp_business_app_onboarding'
"sessionInfoVersion": "3"
}
}Das Snippet kombiniert featureType mit sessionInfoVersion und enthält kein version-Feld. Meta veröffentlicht keine eigene v4-spezifische Coexistence-Syntax: Die v4-Seite sagt, dass das Onboarding von Nutzern der WhatsApp Business App weiterhin über den Parameter feature_type unterstützt wird, und verlinkt auf genau diesen Schritt. Metas Seite zur App-Only-Installation beschreibt app_only_install als Weg, mit Business Tokens auf Kunden-Assets zuzugreifen, und stellt fest: „App-Only Install can’t be used to onboard WhatsApp Business app users.“[10]
Metas Changelog vom 3. September 2026 erklärt, was die Phone-Number-First-Änderung hier bedeutet. Weil die Telefonnummer zuerst erfasst wird, wechselt Embedded Signup jetzt automatisch in den Coexistence-Flow, wenn Coexistence aktiviert ist und die Nummer bereits mit der WhatsApp Business App genutzt wird, ohne dass der Kunde die App-Option auswählt. Die von Meta veröffentlichten Seiten lassen offen, wie Coexistence in einer v4-Konfiguration aktiviert wird.
Im Betrieb prägen drei Regeln von Meta die Integration:
- Durchsatz: Nummern, die sowohl mit der App als auch mit der Cloud API genutzt werden, senden mit einem festen Durchsatz, also einer festen Senderate, von 20 Nachrichten pro Sekunde.
- History Sync: Nach dem Onboarding hast du 24 Stunden Zeit, den Nachrichtenverlauf des Kunden zu synchronisieren, sonst muss der Kunde wieder offboardet werden.
- Webhook-Felder: Abonniere account_update, history, smb_app_state_sync und smb_message_echoes. Das Session Event für diesen Flow setzt event auf FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING.
Beim Onboarding wandelt Meta das bestehende WhatsApp Business-Konto des Kunden in einen abwärtskompatiblen Messaging Account um, und die waba_id behält dieselbe ID.
Wie migrierst du vor der Frist auf v4?
Metas Entwicklerblog vom 14. Mai 2026 erklärt, dass „most integrations that are still on v2 or v3 after the deprecation deadline will be automatically upgraded to v4.“[11] Integrationen, die die Feature Types only_waba_sharing, marketing_messages_lite oder coex mit v2 nutzen, lassen sich nicht automatisch aktualisieren und brauchen vor dem 15. Oktober Anpassungen durch Entwickler. Nach diesem Datum funktionieren diese eingestellten Feature Types laut Meta nicht mehr und fallen auf den Standard-Flow von Embedded Signup zurück.
Die Dokumentationsseiten tragen einen einzeiligen Hinweis zur Einstellung, und der Blogbeitrag lässt offen, was mit bereits onboardeten Unternehmen passiert, also kläre vor dem Stichtag mit Meta, wie sich die Änderung auf deine bestehenden Kunden auswirkt. Meta schätzt den Entwicklungsaufwand für das Upgrade auf bis zu eine Woche, Tests eingeschlossen, und sagt, dass das Upgrade in vielen Fällen nur wenige Minuten Konfiguration plus Testzeit dauert.
Die Migrations-Checkliste folgt Metas v4-Seite und Blog:
- Startcode inventarisieren. Lies das extras-Objekt aus und liste jeden featureType und jeden Feature-Namen auf, den du nutzt. Alles, was only_waba_sharing, marketing_messages_lite oder coex entspricht, braucht eine Änderung durch Entwickler.
- Domains prüfen. Füge erlaubte Domains unter Facebook Login for Business, Settings, Client OAuth settings hinzu, wie es Metas Implementierungsseite vorgibt.
- Neue Konfiguration erstellen. Öffne App Dashboard, Facebook Login for Business, Configurations, und wähle Embedded Signup als Login-Variante.
- Produkte auswählen. Wähle die Produkte aus, die enthalten sein sollen; mehr als eines auszuwählen ist optional. Mit der Produktauswahl wirst du automatisch auf v4 umgestellt.
- Das extras-Objekt ersetzen. Kopiere die Konfigurations-ID in den Aufruf des Facebook Login SDK. Metas Versionsseite zeigt extras: {} für v4, und die Implementierungsseite zeigt extras: { setup: {} } im Startaufruf; beides ist Metas aktueller Text, also nimm den Startaufruf der Implementierungsseite als Arbeitsreferenz.
- Den Flow testen. Wähle im Embedded Signup Builder die neue Konfiguration aus und öffne den Flow. Metas Blog sagt: „You don’t need to select a version, since the configuration now drives that logic.“ Klicke auf Login with Facebook, um v4 in der Vorschau zu sehen, und teste auch die typischen Fehlerquellen des Pop-ups in den Browsern, die deine Kunden nutzen.
Measurement Partners brauchen eine eigene Prüfung: Metas v3-Seite stellt fest, dass „Measurement product onboarding will only be supported on v2 for the time being“, und ergänzt, dass Measurement Partners in einer künftigen Version unterstützt werden, ohne eine Version oder ein Datum zu nennen, während v2 am 15. Oktober 2026 sein Einstellungsdatum erreicht.
Wie bekommt dein SaaS-Produkt API-Zugang?
Ein SaaS-Produkt erhält Zugang zur WhatsApp API, indem es Meta Tech Provider wird oder mit einem Solution Partner zusammenarbeitet und dann Geschäftskunden über Embedded Signup onboardet. Metas Weg zum Tech Provider setzt eine Meta-App mit dem WhatsApp-Anwendungsfall und ein verbundenes Business-Portfolio voraus, gefolgt von diesen Schritten:[12]
- Business Verification: Verifiziere dein Unternehmen bei Meta vor dem App Review.
- App Review: Reiche zwei Videos ein, eines mit einer Nachricht, die aus deiner App gesendet und in WhatsApp empfangen wird, und eines, das die Erstellung eines Templates zeigt, also des vorab genehmigten Formats für Nachrichten, die das Unternehmen initiiert, dazu eine Dokumentation.
- Advanced Access: Das App Review gewährt Advanced Access für whatsapp_business_messaging und whatsapp_business_management, und Meta verlangt beides, um Tech Provider zu werden.
Tech Provider können Messaging eigenständig anbieten oder diese Services gemeinsam mit einem Solution Partner anbieten, und in diesem Fall wird die App-ID des Partners benötigt. Der Server, der den Flow hostet, braucht ein gültiges SSL-Zertifikat, und Metas Übersicht stellt klar, dass du Geschäftskunden erst onboarden kannst, wenn deine App Advanced Access für jede benötigte Berechtigung hat. Meta bietet außerdem Hosted Embedded Signup an, einen von Meta gehosteten Link aus dem App Dashboard, als Alternative dazu, den Code selbst zu hosten.
Meta begrenzt, wie viele neue Geschäftskunden du onboarden kannst:
| Phase | Neue Geschäftskunden pro gleitendem 7-Tage-Zeitraum |
|---|---|
| Standard | 10 |
| Nach Business Verification, App Review und Access Verification | 200 |
Partner, die mehr als 200 Onboardings pro Woche brauchen, sollen laut Meta bei Meta einen Partnerstatus beantragen. Metas Changelog vom 3. Oktober 2025 stellt fest, dass Access Verification nicht mehr erforderlich ist, um Tech Provider zu werden, auch wenn der Übersichtstext sie für das höhere Limit noch nennt.
Für Plattformen, die sich über 360Dialog verbinden, können zugelassene Meta Tech Provider mit Partner-Hosted Embedded Signup einen eigenen Flow hosten. Voraussetzung ist der Tech-Provider-Status mit einer live geschalteten, in 360Dialog integrierten Lösung im Meta-Status ACTIVE sowie Advanced Access für die Berechtigung public_profile.[13] 360Dialog empfiehlt dort Embedded Signup v4, weil sich die Marketing Messages API dann schon beim Onboarding für den Kunden aktivieren lässt. Die Registrierung der Telefonnummer übernimmt vollständig 360Dialog, sodass Metas Registrierungsschritte entfallen, und die Fehlerbehebung eigener Embedded-Signup-Skripte liegt außerhalb des technischen Supports von 360Dialog. Wie sich so onboardete Nummern zu Meta Business Agent verhalten, behandeln wir in unserem vollständigen Leitfaden zu Meta Business Agent, und was du pro Tenant speichern solltest, liegt außerhalb dieses Leitfadens.
Sobald die Konfiguration live ist, durchläuft jeder neue Kunde dasselbe Pop-up, dieselben Listener Events und denselben Austausch des Business Tokens. Welche Produkte du zuerst anbietest und in welcher Reihenfolge deine Kunden sie übernehmen, wird zu einer Produktentscheidung, die die Konfiguration jetzt sichtbar macht.
Mit API starten und deinen ersten Kunden über die v4-Konfiguration verbinden, die du mit diesem Leitfaden aufgebaut hast.
Häufig gestellte Fragen
Was ist WhatsApp Embedded Signup?
WhatsApp Embedded Signup ist eine Authentifizierungs- und Autorisierungsoberfläche, mit der Geschäftskunden die WhatsApp-Assets erzeugen, die ein Partner braucht, um sie auf der WhatsApp Business Platform zu onboarden. Ein SaaS-Unternehmen baut sie in sein eigenes Produkt ein, wo ein Link oder Button sie in einem neuen Fenster startet und der Meta-App des Unternehmens Zugriff auf die Assets gewährt, die der Flow erzeugt.
Kann ich Unternehmen über Embedded Signup onboarden?
Ja, ein Unternehmen mit dem Status Solution Partner oder Tech Provider kann Geschäftskunden über Embedded Signup onboarden, sofern seine Meta-App Advanced Access für die Berechtigungen hat, die der Flow braucht. Laut Meta kann ein Unternehmen Kunden erst onboarden, wenn seine App für diese Berechtigungen freigegeben ist, und das Standardlimit liegt bei 10 neuen Geschäftskunden in einem gleitenden 7-Tage-Zeitraum.
Wann stellt Meta Embedded Signup v2 und v3 ein?
Meta stellt Embedded Signup v2 und v3 einschließlich ihrer Public-Preview-Versionen am 15. Oktober 2026 ein. Metas Versionsseite nennt für v4 und die v4 Public Preview bisher kein Enddatum. Eine genaue Uhrzeit für die Einstellung am Stichtag gibt Meta nicht an.
Wie prüfe ich, welche Embedded-Signup-Version ich nutze?
Das extras-Objekt in deinem Embedded-Signup-Startcode zeigt die Version. Ein version-Wert v3 kennzeichnet v3, ein version-Wert v4-public-preview aktiviert diese Preview, und für v2 zeigt Meta kein version-Feld, dort steht stattdessen sessionInfoVersion. Ein v4-Flow entsteht durch die Produktauswahl in einer Facebook-Login-for-Business-Konfiguration, daher ist sein extras-Objekt leer oder enthält nur setup.
Was passiert mit Integrationen, die nach dem 15. Oktober 2026 auf v2 oder v3 bleiben?
Metas Entwicklerblog vom 14. Mai 2026 erklärt, dass die meisten Integrationen, die nach der Frist noch auf v2 oder v3 laufen, automatisch auf v4 aktualisiert werden. Integrationen, die die Feature Types only_waba_sharing, marketing_messages_lite oder coex mit v2 nutzen, lassen sich nicht automatisch aktualisieren, und nach dem 15. Oktober 2026 funktionieren diese Feature Types nicht mehr und fallen auf den Standard-Flow zurück.
Unterstützt Embedded Signup Coexistence?
Ja, Embedded Signup unterstützt Coexistence über den featureType whatsapp_business_app_onboarding, mit dem ein Kunde die WhatsApp Business App weiter auf einer Nummer nutzen kann, die auch auf der Cloud API läuft. Meta verlangt für diesen Flow Session Logging und zeigt dafür ein einziges Start-Snippet, das den Feature Type mit sessionInfoVersion auf dem Wert 3 kombiniert.
Wie lange dauert die Migration auf v4?
Meta schätzt den Entwicklungsaufwand für das Upgrade auf v4 auf bis zu eine Woche, Tests eingeschlossen. Meta ergänzt, dass das Upgrade in vielen Fällen nur wenige Minuten Konfiguration plus Testzeit dauert. Die Arbeit besteht vor allem darin, eine neue Facebook-Login-for-Business-Konfiguration zu erstellen, Produkte auszuwählen und das extras-Objekt in deinem Startcode zu ersetzen.
Quellen
[1] Meta for Developers, Embedded Signup versions: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/versions
[2] Meta for Developers, Embedded Signup overview: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview
[3] Meta for Developers, WhatsApp Business Platform changelog: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog/
[4] 360Dialog Partner Docs, Integrated Onboarding: https://docs.360dialog.com/partner/onboarding/integrated-onboarding
[5] Meta for Developers, Embedded Signup version 4: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-4
[6] Meta for Developers, Embedded Signup version 4 public preview: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-4-public-preview
[7] Meta for Developers, Embedded Signup implementation: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/implementation
[8] Meta for Developers, Embedded Signup version 3: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/version-3
[9] Meta for Developers, Onboarding WhatsApp Business app users (Coexistence): https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users
[10] Meta for Developers, App-only install: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/app-only-install
[11] Meta for Developers blog, Embedded signup v4: Upgrade to Meta’s streamlined, unified onboarding experience before the deadline on October 15, 2026 (May 14, 2026): https://developers.facebook.com/blog/post/2026/05/14/embedded-signup-v4/
[12] Meta for Developers, Become a Tech Provider: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers
[13] 360Dialog Partner Docs, Partner-Hosted Embedded Signup: https://docs.360dialog.com/partner/onboarding/partner-hosted-embedded-signup
