Embedded Signup

Embedded Signup ist eine Authentifizierungs- und Autorisierungsschnittstelle, die mit Desktop- und Mobilgeräten kompatibel ist und es deinen Business-Kund*innen leicht macht, die Assets zu generieren, die du brauchst, um sie erfolgreich in die WhatsApp Business Platform einzubinden.

Etwas ist schiefgelaufen

Leider kann dieses Video nicht richtig abgespielt werden.

Mehr dazu

Der Embedded Signup Flow sammelt geschäftsrelevante Informationen von deinen Business-Kund*innen, generiert automatisch alle WhatsApp-Assets, die von der Plattform benötigt werden, und gewährt deiner App Zugriff auf diese Assets, damit du deinen Business-Kund*innen schnell WhatsApp-Messaging-Services anbieten kannst.

Kund*innen, die über Embedded Signup eingebunden wurden, sind Eigentümer*innen aller ihrer WhatsApp-Assets und können diese Assets mit anderen Meta-Lösungen nutzen, wie z. B. Click-to-WhatsApp-Ads.

So funktioniert‘s

Embedded Signup nutzt das Facebook Login for Business-Produkt und unser JavaScript SDK. Nach der Konfiguration kannst du einen Link oder einen Button zu deiner Website oder deinem Portal hinzufügen, um den Flow zu starten.

Business-Kund*innen, die auf den Link oder Button klicken, wird ein neues Fenster angezeigt, in dem sie Folgendes tun können:

• ihre Identität mit ihren Facebook oder Meta Business-Anmeldedaten authentifizieren
• deiner App Zugriff auf ihre WhatsApp-Assets gewähren
• ein bestehendes Business-Portfolio auswählen oder ein neues erstellen
• ein bestehendes WhatsApp-Unternehmenskonto (WABA) auswählen oder ein neues erstellen
• ihre geschäftliche Telefonnummer eingeben und verifizieren (ihre eigene oder eine, die du zur Verfügung gestellt hast)
• einen Display-Namen eingeben, der im WhatsApp-Client anstelle der eigentlichen Nummer angezeigt wird

Nach erfolgreichem Abschluss gibt Embedded Signup im Fenster, das den Flow ausgelöst hat, die WABA-ID des*der Kund*in, die ID der geschäftlichen Telefonnummer und einen austauschbaren Token-Code zurück. Du musst diese Daten an einen Server senden und in einem Server-zu-Server-Aufruf verwenden, um Folgendes zu tun:

• den Code gegen ein kund*innen-spezifisches Business-Token tauschen
• die geschäftliche Telefonnummer des*der Kund*in für die Cloud API-Verwendung registrieren
• Im WABA des*der Kund*in Webhooks für deine App abonnieren
• deinen Kreditrahmen mit deiner*deinem Kund*in teilen (nur Lösungspartner)

Wenn diese Schritte abgeschlossen sind und du ein Lösungspartner bist oder mit einem solchen zusammenarbeitest, kann der*die Kund*in sofort deine oder die App deines Partners für Messaging nutzen. Wenn du kein Lösungspartner bist oder nicht mit einem solchen zusammenarbeitest, muss der*die Kund*in zuerst mit dem eigenen WABA eine Zahlungsmethode verknüpfen, bevor er*sie mit dem Senden von Nachrichten beginnen kann.

Einschränkungen

Begrenzung für das Onboarding

Du kannst standardmäßig bis zu zehn neue Business-Kund*innen in einem fortlaufenden 7-Tage-Zeitfenster einbinden. Nur neu eingebundene Kund*innen werden auf diese Begrenzung angerechnet. Du kannst die Anzahl deiner aktuell eingebundenen Kund*innen im Bereich WhatsApp Manager > Partnerübersicht prüfen. Du erhältst eine Benachrichtigung per E-Mail, wenn du dich dieser Begrenzung näherst.

Wenn du die Unternehmensverifizierung, die App-Review und die Zugriffsverifizierung abschließt, wird deine Begrenzung automatisch auf 200 neue Business-Kund*innen in einem fortlaufenden 7-Tage-Zeitfenster erhöht. Wenn du mehr als 200 Kund*innen pro Woche einbinden musst, bewirb dich als Meta Business-Partner.

Messaging-Begrenzungen für Business-Kund*innen

Über Embedded Signup eingebundene Business-Kund*innen starten mit standardmäßigen Messaging-Begrenzungen, die durch die API-Nutzung erhöht werden können.

Business-Kund*innen: Begrenzungen für Telefonnummern

• Geschäftliche Telefonnummern können nur zur Verwendung mit der Cloud API registriert werden.
• Geschäftliche Telefonnummern, die bereits für die Verwendung mit der On-Premises API registriert sind oder mit WhatsApp oder der WhatsApp Business-App verwendet werden, werden nicht unterstützt.
• Über Embedded Signup eingebundene Business-Kund*innen starten mit standardmäßigen Begrenzungen für geschäftliche Telefonnummern.

Standardablauf

Beschreibungen aller Bildschirme, die deinen Business-Kund*innen als Teil der Standardimplementierung von Embedded Signup angezeigt werden, findest du unter Standardablauf.

Hinweis: Wenn dir Informationen zum Unternehmen deines*deiner Kund*in vorliegen, kannst du diese Daten einfügen. So kannst du die Anzahl der Bildschirme, mit denen deine Kund*innen interagieren müssen, erheblich reduzieren.

Zugriffstoken

Embedded Signup generiert Business-Integration-Systemnutzer-Zugriffstoken („Business-Token“). Wenn ein*e Business-Kund*in den Embedded Signup Flow abschließt, wird ein austauschbarer Token-Code als Nachrichten-Event zurückgegeben und vom JavaScript SDK erfasst. Du musst diesen Code mit einem Server-zu-Server-Aufruf gegen ein Business-Token tauschen.

Wenn du ein Tech-Anbieter bist, verwendest du ausschließlich Business-Token.

Wenn du ein Lösungspartner bist, verwendest du dein Systemnutzer-Zugriffstoken („Systemtoken“), um deine Kreditlinie mit neu eingebundenen Business-Kund*innen und zu teilen, und Business-Token für alles andere. Beachte, dass der Systemnutzer, den das Token repräsentiert, deiner App die Berechtigung business_management gewährt haben muss, und in deinem Business-Portfolio die Rolle Admin oder Zahlungseditor*in haben muss, um deine Kreditlinie teilen zu können.

Berechtigungen

Embedded Signup kann so konfiguriert werden, dass die meisten Berechtigungen von deinen Business-Kund*innen angefordert werden. Wahrscheinlich brauchst du aber nur folgende:

• whatsapp_business_management: erforderlich, wenn deine App Zugriff auf die Einstellungen des WhatsApp-Unternehmenskontos für den*die eingebunde*n Kund*in und die Nachrichtenvorlagen benötigt.
• whatsapp_business_messaging: erforderlich, wenn deine App Zugriff auf die Einstellungen der geschäftlichen Telefonnummer des*der eingebundenen Kund*in benötigt oder wenn deine App von Kund*innen zum Senden und Empfangen von Nachrichten verwendet wird.

Bei der Implementierung kannst du angeben, welche Berechtigungen deine App benötigt.

Beachte: Auch wenn sich deine App im Entwicklungsmodus befindet, werden diese Berechtigungen jeder Person, die in deiner App über die Rolle Admin, Entwickler*in oder Tester*in verfügt, auf dem Autorisierungsbildschirm angezeigt. Sobald du deine App aber in den Live-Modus schaltest, werden im Flow nur Berechtigungen angezeigt, die über die App-Review für erweiterten Zugriff genehmigt wurden.

Abrechnung

Lösungspartner

Wenn du ein Lösungspartner bist, musst du bereits über eine Kreditlinie verfügen und den Nutzungsbedingungen der Credit Allocation API im Bereich Unternehmenseinstellungen > Zahlungen in der Meta Business Suite zugestimmt haben. Darüber hinaus musst du deine Kreditlinie im Rahmen des Onboarding-Prozesses mit jedem*jeder Kund*in teilen.

Tech-Anbieter und Tech-Partner

Wenn du Tech-Anbieter oder Tech-Partner ist, müssen deine eingebundenen Business-Kund*innen zu ihrem WhatsApp-Unternehmenskonto eine Zahlungsmethode hinzufügen. Sie können dazu die Schritte in unserem Hilfebereichsartikel Eine Kreditkarte zu deinem WhatsApp Business Platform-Konto hinzufügen befolgen.

Geschäftliche Telefonnummern mit der Vorwahl 555

Business-Kund*innen mit verifizierten Unternehmen, deren Cloud API-Nachrichtenlimits erhöht wurden, haben Anspruch auf bis zu zwei geschäftliche Telefonnummern mit der Vorwahl 555.

Diese Nummern verhalten sich genauso wie gewöhnliche geschäftliche Telefonnummern (Display-Namen müssen überprüft und genehmigt werden, unterliegen den Regeln der unterhaltungsbasierten Preisgestaltung, werden von Qualitätsbewertungen beeinflusst usw.), mit der Ausnahme folgender wesentlicher Unterschiede:

• Die Nummern haben die Landesvorwahl der USA (+1).
• Sie verfügen über die Ortsvorwahl 555.
• Sie werden automatisch verifiziert.
• Sie können nicht auf ein anderes WhatsApp-Unternehmenskonto migriert oder außerhalb der WhatsApp Business Platform verwendet werden.

Wenn deine Unternehmenskunden Anspruch auf Nummern mit der Vorwahl 555 haben und eine als zusätzliche Nummer registrieren möchten, weise sie an, deine Implementierung des Embedded Signup erneut zu durchlaufen. Wenn sie aufgefordert werden, eine geschäftliche Telefonnummer auszuwählen, wird ihnen automatisch die Option angeboten, eine Nummer mit der Vorwahl 555 auszuwählen:

App-Review

Du kannst erst dann Business-Kund*innen einbinden, wenn deine App für jede der Berechtigungen, die sie benötigt, für erweiterten Zugriff genehmigt wurde.

Unter App-Review findest du nähere Informationen zum App-Review und erfährst, welche Angaben du machen musst, um den Prozess erfolgreich abzuschließen.

Integrationshilfstool

Das Integrationshilfstool des Embedded Signup ist ein Einrichtungs- und Testtool im App-Dashboard. Mit dem Tool kannst du:

• Embedded Signup in verschiedenen Vorgangskonfigurationen starten.
• Daten anzeigen, die zurückgegeben werden, wenn ein Unternehmenskunde den Vorgang abschließt.
• Implementierungscode und Onboarding-Abfragen generieren, die du kopieren und in deine Website, dein Unternehmenskundenportal und deinen Server einfügen kannst.
• API-Abfragen an Endpunkte senden, die du beim Onboarding von Kunden verwenden musst, die den Vorgang abschließen.

Du kannst auf das Integrationshilfstool zugreifen, indem du zu App-Dashboard > WhatsApp > ES-Integration navigierst.

Webhooks

Im Rahmen des Onboarding-Prozesses muss deine App im WABA jeder Business-Kund*in, der*die den Embedded Signup Flow durchläuft, Webhooks abonnieren.

Webhooks werden ausgelöst und an die in deiner App konfigurierte Callback-URL gesendet, entsprechend den Webhook-Feldern, die du abonniert hast. Das bedeutet, dass alle Webhooks für alle deine eingebundenen Business-Kund*innen an die Callback-URL deiner App gesendet werden. Du kannst die Rückruf-URL jedoch für ein einzelnes WhatsApp Business-Konto oder eine geschäftliche Telefonnummer außer Kraft setzen. Wie das geht, erfährst du unter Webhook-Überschreibungen.

Lokalisierung

Der Embedded Signup-Flow ist in 30 Sprachen verfügbar. Der lokalisierte Flow wird automatisch in Abhängigkeit von der Sprache ausgelöst, in der die*der Business-Kund*in Facebook nutzt.

Arabisch, Tschechisch, Dänisch, Griechisch, Englisch (UK), Spanisch (Spanien), Spanisch, Finnisch, Französisch (Frankreich), Hebräisch, Hindi, Ungarisch, Indonesisch, Italienisch, Japanisch, Koreanisch, Norwegisch (bokmal), Niederländisch, Polnisch, Portugiesisch (Brasilien), Portugiesisch (Portugal), Rumänisch, Russisch, Schwedisch, Thailändisch, Türkisch, Vietnamesisch, Vereinfachtes Chinesisch (China), Traditionelles Chinesisch (Hong Kong), Traditionelles Chinesisch (Taiwan).

Nächste Schritte

Erfahre, wie du Embedded Signup in deiner Website oder deinem Portal implementieren kannst.