Erste Schritte

In diesem Dokument werden die Schritte und Voraussetzungen zur Integration des Embedded Signup-Ablaufs in deine Website bzw. dein Kund*innenportal erläutert.

Bevor du beginnst

Um mit der Integration des Embedded Signup-Ablaufs beginnen zu können, musst du zuerst einen Business Manager und eine Meta-App eingerichtet haben.

Business Manager

Du benötigst ein Business Manager-Konto, um deine Kreditlinie und die WhatsApp Business-Konten (WABA) der Kund*innen zu verwalten. Weitere Informationen zur Erstellung eines Business-Kontos findest du unter Ein Business Manager-Konto erstellen. Sobald du ein Business Manager-Konto eingerichtet hast, kannst du dein Unternehmen verifizieren lassen.

Meta-App

Erstelle in deinem Meta-Entwicklerkonto eine -App des TypsBusiness. Im App-Bereich kannst du auf deine Meta-Apps zugreifen, App-Einstellungen vornehmen und Berechtigungen anfordern.

Business-Apps erhalten automatisch die Genehmigung für den Standardzugriff bei allen für Business-Apps verfügbaren Berechtigungen und Funktionen. Du kannst also deine App auf dieser Zugriffsebene entwickeln und testen.

Beim Standardzugriff können Business-Apps effektiv nur auf Daten zugreifen, die im Besitz von App-Nutzer*innen mit einer Rolle in der App oder dem Unternehmen sind. Damit deine Meta-App veröffentlicht werden kann, muss sie die App-Review durchlaufen. Außerdem ist erweiterter Zugriff auf die Berechtigung whatsapp_business_management erforderlich. Du solltest den Vorgang so schnell wie möglich beginnen. Dieser Prozess kann schon vor der vollständigen Implementierung von Embedded Signup gestartet werden.

Du musst auch die whatsapp_business_messaging-Berechtigung für die WhatsApp Cloud API anfordern, da sie für API-Aufrufe erforderlich ist.

Es wird dringend empfohlen, neben diesen beiden keine zusätzlichen Berechtigungen anzufordern, da dies deinen Registrierungsprozess unnötig verlangsamen wird.

Zugriffsschlüssel

Sowohl Business-Integration-Systemnutzer-Zugriffsschlüssel als auch Systemnutzer-Zugriffsschlüssel können für den Zugriff Daten von Freigeschalteten Kund*innen verwendet werden. Die Art des Schlüssels, den du verwendest, hängt davon ab, ob du Embedded Signup mit Facebook Login oder mit Facebook Login for Business konfigurierst und ob du ein Tech-Anbieter oder ein Lösungsanbieter bist.

Tech-Anbieter

Der bevorzugte Schlüssel für Tech-Anbieter ist ein Business-Integration-Systemnutzer-Zugriffsschlüssel, da diese Schlüssel auf einzelne Kund*innen übertragen werden. Du kannst einen dieser Schlüssel abrufen, indem du den Code austauschst, wenn ein*e Kund*in das mit Facebook Login for Business konfigurierte Embedded Signup abgeschlossen hat. Wenn du das mit Facebook Login konfigurierte Embedded Signup verwendest (was nicht empfohlen wird), musst du stattdessen einen Systemnutzer-Zugriffsschlüssel verwenden.

Wenn du einen Systemnutzer-Zugriffsschlüssel verwendest, muss der Systemnutzer deiner App die Berechtigung whatsapp_business_management gewähren.

Lösungspartner

Du musst einen Systemnutzer-Zugriffsschlüssel verwenden, um deine Kreditlinie mit freigeschalteten Kund*innen zu teilen. Für alle anderen Anfragen ist die bevorzugte Lösung die Verwendung eines Business-Integration-Systemnutzer-Zugriffsschlüssels.

Du kannst einen Business-Integration-Systemnutzer-Zugriffsschlüssel abrufen, indem du den Code austauschst, wenn ein*e Kund*in das mit Facebook Login for Business konfigurierte Embedded Registup abgeschlossen hat. Wenn du das mit Facebook Login konfigurierte Embedded Signup verwendest (was nicht empfohlen wird), musst du stattdessen einen Systemnutzer-Zugriffsschlüssel verwenden.

Beachte, dass dein Systemnutzer für Systemnutzer-Zugriffsschlüssel deiner App die Berechtigung whatsapp_business_management erteilt haben muss (die du bei der Erstellung des Schlüssels gewähren kannst), und dass dein Systemnutzer über die Rolle Zahlungseditor verfügen muss, damit du deine Kreditlinie mit freigeschalteten Kund*innen teilen kannst.

So gewährst du deinem Systemnutzer die Rolle Zahlungseditor:

Melde dich bei der Meta Business Suite an.
Suche dein Unternehmenskonto im Dropdown-Menü oben links und klicke auf das zugehörige Einstellungen-Symbol (Zahnrad).
Klicke auf Unternehmenseinstellungen.
Navigiere zu Nutzer > Systemnutzer.
Bearbeite den Nutzer und gewähre ihm die Rolle Zahlungseditor.

Kreditlinie

Du musst eine Kreditlinie einrichten, um Nachrichten mit der WhatsApp Business-Plattform senden zu können. Dies ist die Kreditlinie, die du deinen Kund*innen mitteilst. Akzeptiere die Bedingungen der Gutschriftenzuordnungs-API unter Unternehmenseinstellungen > Zahlungen im Business Manager.

Informationen zur Mitteilung der Kreditlinie über den Business Manager statt über die API findest du unter Zugriff auf die monatliche Abrechnung teilen.

WhatsApp Business Platform On-Premises API-Client

Wenn du die On-Premises API verwendest, vergewissere dich, dass du eine nicht abgelaufene Version des WhatsApp Business API-Clients verwendest.

Integrationsprozess

Als Teil des Integrationsprozesses muss deine Meta-App die App-Review durchlaufen. Außerdem ist erweiterter Zugriff auf die Berechtigung whatsapp_business_management erforderlich. Du solltest den Vorgang so schnell wie möglich beginnen. Dieser Vorgang kann schon vor der vollständigen Implementierung von Embedded Signup gestartet werden.

1: Signup-Ablauf einbetten

Richte das Facebook JavaScript-SDK und Facebook Login so ein, dass der Signup-Ablauf in deine Website bzw. dein Kund*innenportal eingebettet ist. Du kannst den Ablauf in mehrere deiner Webseiten oder Portale einbetten.

2: In erforderliche Endpunkte integrieren

Nachdem du den Signup-Ablauf eingebettet hast, musst du eine Integration in die API-Endpunkte, die für den Abschluss des Integrationsprozesses erforderlich sind, vornehmen. Um mit dem nächsten Schritt fortzufahren, musst du zu Folgendem in der Lage sein:

Rufe nach Abschluss der Registrierung mit dem message_templates-Endpunkt vorab genehmigte Nachrichtenvorlagen und Namespaces ab, damit die Unternehmen mit dem Senden von Nachrichten beginnen können.

Du benötigst einen sicheren Endpunkt (HTTPS). Weitere Informationen findest du unter Anmeldesicherheit.

3: WABAs für den Empfang von Webhooks abonnieren

Sobald Unternehmen die Anmeldung abgeschlossen haben, kannst du jedes WhatsApp Business-Konto abonnieren, für das du Webhooks empfangen möchtest. Du kannst deine Webhooks so einrichten, dass du in den folgenden Fällen benachrichtigt wirst:

wenn der Name einer Telefonnummer aktualisiert wurde
wenn der Qualitätsstatus einer Telefonnummer aktualisiert wurde
wenn ein Account geprüft oder gesperrt bzw. ein Upgrade daran vorgenommen wurde

Optional

Dir stehen folgende Optionen zur Verfügung: