{"id":2255,"date":"2026-10-01T11:38:35","date_gmt":"2026-10-01T11:38:35","guid":{"rendered":"https:\/\/360dialog.com\/blog\/?p=2255"},"modified":"2026-10-01T11:38:35","modified_gmt":"2026-10-01T11:38:35","slug":"embedded-signup-versionen-migration","status":"publish","type":"post","link":"https:\/\/360dialog.com\/blog\/de\/embedded-signup-versionen-migration\/","title":{"rendered":"WhatsApp Embedded Signup f\u00fcr SaaS-Plattformen: Versionen, Migration und die Frist f\u00fcr v2 und v3"},"content":{"rendered":"\n

WhatsApp Embedded Signup ist der Anmeldeablauf, den eine SaaS-Plattform in ihr eigenes Produkt einbaut, damit Gesch\u00e4ftskunden ihre WhatsApp-Konten und Telefonnummern in einem Pop-up-Fenster mit der Plattform verbinden k\u00f6nnen.<\/strong> Meta stellt Version 2 (v2), Version 3 (v3) und ihre Public-Preview-Versionen am 15. Oktober 2026 ein.[1] F\u00fcr Version 4 (v4) ist kein Enddatum angek\u00fcndigt, sie unterst\u00fctzt weiterhin die Marketing Messages API for WhatsApp und bringt Unterst\u00fctzung f\u00fcr Click to WhatsApp Ads und die Conversions API. Dieser Leitfaden zeigt dir, wie du pr\u00fcfst, welche Version du nutzt, was sich mit v4 \u00e4ndert und wie du vor der Frist migrierst.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Das Wichtigste auf einen Blick<\/h2>\n\n\n\n
    \n
  1. Das extras-Objekt in deinem Embedded-Signup-Startcode zeigt, welche Version du nutzt, und das Auslesen dauert nur wenige Minuten.<\/li>\n\n\n\n
  2. Embedded Signup v2, v3 und ihre Public Previews erreichen am 15. Oktober 2026 ihr Einstellungsdatum, w\u00e4hrend f\u00fcr v4 und seine Public Preview kein Enddatum angek\u00fcndigt ist.<\/li>\n\n\n\n
  3. Meta sch\u00e4tzt den Entwicklungsaufwand f\u00fcr den Umstieg auf v4 auf bis zu eine Woche, Tests eingeschlossen.<\/li>\n\n\n\n
  4. 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.<\/li>\n\n\n\n
  5. Eine Plattform braucht den Status Solution Partner oder Tech Provider und Advanced Access aus dem App Review, bevor sie Gesch\u00e4ftskunden onboarden kann.<\/li>\n<\/ol>\n\n\n\n

    <\/p>\n\n\n\n

    Was ist WhatsApp Embedded Signup?<\/h2>\n\n\n\n

    Embedded Signup ist eine Authentifizierungs- und Autorisierungsoberfl\u00e4che f\u00fcr Desktop und Mobilger\u00e4te, mit der Gesch\u00e4ftskunden die WhatsApp-Assets erzeugen, die ein Partner braucht, um sie auf der WhatsApp Business Platform zu onboarden.[2] Ein SaaS-Unternehmen startet sie \u00fcber einen Link oder Button, und sie \u00f6ffnet sich in einem neuen Fenster. Der Flow erfasst Unternehmensinformationen, legt die Assets an und gew\u00e4hrt deiner Meta-App Zugriff darauf. Er l\u00e4uft auf Facebook Login for Business und dem Facebook JavaScript SDK, und die Kunden bleiben Eigent\u00fcmer aller Assets und behalten vollen Zugriff auf den WhatsApp Manager.<\/p>\n\n\n\n

    Zwei Partnertypen k\u00f6nnen den Flow betreiben. Solution Partner m\u00fcssen bereits eine Kreditlinie haben, die sie f\u00fcr die Abrechnung mit ihren Kunden teilen. Tech Provider sind die Softwareplattformen, die \u00fcber Metas App Review Advanced Access f\u00fcr die Berechtigungen whatsapp_business_messaging und whatsapp_business_management erhalten, und ihre Kunden hinterlegen eine Zahlungsmethode in ihrem eigenen Messaging Account.<\/p>\n\n\n\n

    Metas Kontobegriffe \u00e4ndern sich: \u00c4ltere Dokumentation und viele Codebeispiele sprechen vom WhatsApp Business-Konto (WABA), dem Container f\u00fcr 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\u00e4rt, dass bestehende IDs, Endpoints und Zugriffstoken w\u00e4hrend des gesamten Rollouts weiter funktionieren, und Metas \u00dcbersicht zu Embedded Signup bezeichnet die \u00c4nderung als Beta, die sich noch \u00e4ndern kann. Dieser Leitfaden verwendet ab hier die neuen Begriffe.<\/p>\n\n\n\n

    360Dialog, ein Official Meta Solution Partner, bietet SaaS-Partnern Embedded Signup \u00fcber 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\u00e4ngig) und Partner-Hosted Embedded Signup (High-Code, f\u00fcr von Meta zugelassene Tech Provider).[4] Das 360Dialog Embedded Signup wird im gesamten Integrated Onboarding automatisch ausgel\u00f6st, und Partner k\u00f6nnen ihren eigenen Flow hosten, sobald sie Metas Anforderungen erf\u00fcllen. Die gesch\u00e4ftliche Seite der Entscheidung, darunter Make-or-buy-Abw\u00e4gungen, Monetarisierung und Partnerwahl, behandeln wir in unserem Artikel zum SaaS-Integrationskontext<\/a>.<\/p>\n\n\n\n

    Wenn deine Plattform Kunden WhatsApp-Onboarding anbieten muss, bevor Meta v2 und v3 am 15. Oktober 2026 abschaltet, sprich mit uns<\/a> dar\u00fcber, welche Integrated-Onboarding-Methode zu deinem Produkt passt.<\/strong><\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Welche Embedded-Signup-Versionen sind noch verf\u00fcgbar?<\/h2>\n\n\n\n

    Meta f\u00fchrt 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\u00fcr v4 und die v4 Public Preview noch kein Enddatum angek\u00fcndigt. Eine Public Preview ist eine Opt-in-Version, die du \u00fcber den version-Wert im extras-Objekt ausw\u00e4hlst.<\/p>\n\n\n\n

    Das extras-Objekt ist die Options-Eigenschaft, die du in deinem Startcode an FB.login \u00fcbergibst, und seine Form verr\u00e4t dir die Version. Meta zeigt diese Formen f\u00fcr v2, v3 und v4:<\/p>\n\n\n\n

    \/\/ v2: no version field; sessionInfoVersion turns session logging on (possible value: 3)\nextras: {\n    setup: \"<SETUP_DATA>\",\n    features: [ { name: \"<FEATURE_NAME>\" } ],\n    featureType: \"<FEATURE_TYPE>\",\n    sessionInfoVersion: \"<SESSION_INFO_VERSION>\"\n}\n\/\/ v3\nextras: {\n    setup: \"<SETUP_DATA>\",\n    features: [ { name: \"<FEATURE_NAME>\" } ],\n    featureType: \"<FEATURE_TYPE>\",\n    version: \"v3\"\n}\n\/\/ v4: the extras object is purposely empty\nextras: {}<\/code><\/pre>\n\n\n\n
    Eine Facebook-Login-for-Business-Konfiguration ist ein gespeichertes Set von Login-Optionen im App Dashboard deiner Meta-App, das \u00fcber eine Konfigurations-ID identifiziert wird und festlegt, welche Produkte der Flow enth\u00e4lt. Meta dokumentiert, dass du automatisch auf v4 umgestellt wirst, wenn du eine neue Konfiguration erstellst und Produkte ausw\u00e4hlst.[5] Damit geh\u00f6rt die Konfiguration zur Versionspr\u00fcfung jeder Integration, deren Startcode keinen version-Wert enth\u00e4lt. Um zuerst die v4 Preview zu nutzen, setze den version-Wert:<\/p>\n\n\n\n
    extras: { version: \"v4-public-preview\" }<\/code><\/pre>\n\n\n\n
    Metas Versionsseite nennt diese Daten:<\/p>\n\n\n\n
    Version<\/th>Eingef\u00fchrt am<\/th>Verf\u00fcgbar bis<\/th><\/tr><\/thead>
    v4 public preview<\/td>12. Mai 2026<\/td>Nicht angek\u00fcndigt<\/td><\/tr>
    v4<\/td>8. Oktober 2025<\/td>Nicht angek\u00fcndigt<\/td><\/tr>
    v3 public preview<\/td>14. August 2025<\/td>15. Oktober 2026<\/td><\/tr>
    v2 public preview<\/td>14. August 2025<\/td>15. Oktober 2026<\/td><\/tr>
    v3<\/td>29. Mai 2025<\/td>15. Oktober 2026<\/td><\/tr>
    v2<\/td>Januar 2023<\/td>15. Oktober 2026<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    Wenn du einsch\u00e4tzen willst, wie viele Kundenkan\u00e4le deine Plattform vor der Frist am 15. Oktober 2026 auf v4 umstellt, sprich mit uns<\/a> \u00fcber Tarife und Preise.<\/strong><\/p>\n\n\n\n
    <\/p>\n\n\n\n
    Was \u00e4ndert sich beim Umstieg auf v4?<\/h2>\n\n\n\n
    v4 w\u00e4hlt Produkte \u00fcber eine Facebook-Login-for-Business-Konfiguration aus und kann ein Unternehmen in einem einzigen Flow f\u00fcr 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\u00e4tzlich unterst\u00fctzte Produkte und erkl\u00e4rt, dass v4 weiterhin Cloud API, die Marketing Messages API for WhatsApp, das Onboarding der WhatsApp Business App, die partnergef\u00fchrte Business Verification und die Automatic Events API unterst\u00fctzt.<\/p>\n\n\n\n
    Cloud API ist Metas gehostete WhatsApp Business API. Die Marketing Messages API for WhatsApp ist Metas API f\u00fcr den Versand von Marketingnachrichten. Click to WhatsApp Ads (CTWA) sind Meta-Anzeigen, die eine WhatsApp-Unterhaltung \u00f6ffnen, und die Conversions API sendet Conversion Events zur Anzeigenmessung an Meta zur\u00fcck. Metas Versionstabelle f\u00fchrt die Marketing Messages API for WhatsApp, Click to WhatsApp Ads und Conversions API (WhatsApp) als Produkte, die nur in v4 \u00fcber die Login-Konfiguration ausw\u00e4hlbar sind, w\u00e4hrend v2- und v3-Integrationen die Marketing Messages API \u00fcber den Feature-Namen marketing_messages_lite erreichen.<\/p>\n\n\n\n
    Der Flow selbst \u00e4ndert sich in mehreren Punkten:<\/p>\n\n\n\n