Eingebettete WhatsApp-Anmeldung
Verwenden Sie die eingebettete Anmeldung, um Braze über den von Meta gehosteten Anmeldeablauf mit einem WhatsApp Business-Konto (WABA) zu verbinden.
Der Workflow für die eingebettete WhatsApp-Anmeldung wird aufgerufen, wenn Sie WhatsApp zum ersten Mal in Ihren Braze-Workspace integrieren und wenn Sie ein WhatsApp Business-Konto oder eine Telefonnummer zu einer bestehenden Integration hinzufügen.
Sie können mehrere WhatsApp Business-Konten zu einem Braze-Workspace hinzufügen. Jedes einzelne WhatsApp Business-Konto kann jedoch nur einem einzigen Braze-Workspace hinzugefügt werden.
Zugriff auf den Workflow
- Gehen Sie zu Partnerintegrationen > Technologie-Partner.
- Suchen Sie nach WhatsApp und wählen Sie es aus.
- Wählen Sie die Option aus, die zu Ihrem Anwendungsfall passt:
- Erstmalige Integration: Wählen Sie Integration beginnen aus.
- Zusätzliches Konto oder zusätzliche Nummer: Wählen Sie auf der Seite WhatsApp Messaging-Integration die Option Konto oder Nummer hinzufügen oder WhatsApp Business-Konto hinzufügen aus.
Der Embedded-Signup-Flow von Meta ist identisch, unabhängig davon, von welchem Einstiegspunkt aus Sie ihn starten. Je nach Konfiguration werden in Ihrem Workspace möglicherweise auch Integrations-Tabs angezeigt, z. B. Native Integration oder BYO Connector - Infobip. Wählen Sie den Tab aus, der zu Ihrem Setup passt, bevor Sie beginnen.
Registrierung vorbereiten
Wenn Sie Integration starten auswählen, öffnet Braze ein Onboarding-Fenster. Sehen Sie sich alle Folien an und wählen Sie dann erneut Integration starten aus, um die eingebettete Registrierung von Meta zu starten.
Bereiten Sie vorab Folgendes vor:
- Zugriff auf den Meta Business Manager: Die meisten Unternehmen verwalten Facebook-Seiten, Anzeigen und zugehörige Geschäftsressourcen über den Meta Business Manager. Falls Sie keinen Zugriff haben, bitten Sie eine:n Admin, Ihnen die nötigen Berechtigungen zu erteilen. Alternativ können Sie während der Registrierung ein Business-Manager-Konto erstellen.
- Telefonnummer: Verwenden Sie eine Nummer, die die Anforderungen von Meta an WhatsApp-Telefonnummern erfüllt. Während der Registrierung erhalten Sie einen einmaligen Verifizierungscode per SMS oder Anruf.
Sie schließen die erste eingebettete Registrierung nur einmal pro Integrationspfad ab. Geben Sie Ihre Unternehmensdaten daher so genau wie möglich ein.
Workflow für die eingebettete WhatsApp-Anmeldung
Nachdem Braze die eingebettete Meta-Anmeldung gestartet hat, melden Sie sich mit einem Meta-Konto an, das Zugriff auf den Business Manager:in Ihres Unternehmens hat. Meta hostet die Anmeldebildschirme; Braze hat keinen Einfluss auf deren Layout oder Beschriftungen.
Meta kann die eingebetteten Anmeldebildschirme ohne Vorankündigung ändern. Wenn der Workflow von diesem Artikel abweicht, folgen Sie den Aufforderungen von Meta und lesen Sie die Dokumentation zur eingebetteten Anmeldung von Meta.
Im Allgemeinen führt Meta Sie durch folgende Schritte:
- Anmelden und Berechtigungen erteilen. Authentifizieren Sie sich bei Meta und erlauben Sie Braze, eine Verbindung zu Ihrem WhatsApp Business-Konto herzustellen.
- Ihr Unternehmensportfolio auswählen. Verbinden Sie das Business-Manager:in-Portfolio, das Eigentümer des WhatsApp Business-Kontos sein soll. Wenn Sie das erwartete Portfolio nicht sehen, überprüfen Sie Ihre Meta-Berechtigungen.
- Ein WhatsApp Business-Konto verbinden oder erstellen. Erstellen Sie ein neues Konto oder wählen Sie ein unbenutztes Konto aus, wenn Sie dazu aufgefordert werden. Wählen Sie kein WhatsApp Business-Konto aus, das aktiv mit einem anderen Messaging-Anbieter verbunden ist – diese Verbindung wird in Braze nicht funktionieren. Um eine Nummer von einem anderen Anbieter zu migrieren, kontaktieren Sie Ihr Braze-Konto-Team, bevor Sie beginnen.
- Geschäfts- und Anzeigedetails angeben. Geben Sie den Kontonamen, den Anzeigenamen und die Kategorie ein, die Meta für Ihr WhatsApp Business-Konto anfordert.
- Ihre Telefonnummer verifizieren. Fügen Sie die Nummer hinzu, die Sie für WhatsApp-Messaging verwenden möchten, und schließen Sie die Verifizierung per SMS oder Telefonanruf ab.
Wenn Meta die eingebettete Anmeldung abgeschlossen hat, wird die Steuerung an Braze zurückgegeben.
Braze-Integration abschließen
Nach der eingebetteten Registrierung führt Braze die Einrichtungsschritte automatisch aus. Auf der Seite WhatsApp Messaging Integration sehen Sie möglicherweise Fortschrittsmeldungen wie Sign-up flow completed, integration with WhatsApp in progress, während Braze Folgendes erledigt:
- Ruft Ihre WhatsApp Business Account ID und Telefonnummern von Meta ab
- Fügt den Braze-Systemnutzer zu Ihrem WhatsApp Business Account hinzu
- Registriert Telefonnummern und abonniert Webhook-Events
- Erstellt für jede verbundene Nummer eine Braze-Abo-Gruppe
Warten Sie, bis die Integration abgeschlossen ist, bevor Sie Nachrichten versenden. Wenn die Einrichtung fehlschlägt, prüfen Sie die Fehlermeldung auf der Integrationsseite und lesen Sie die allgemeinen Hinweise unter WhatsApp-Einrichtung.
Fehlerbehebung
Auswahl einer nicht berechtigten Telefonnummer
Während der Meta Embedded Signup kann eine Telefonnummer als Ineligible angezeigt werden. Meta sperrt eine Telefonnummer für die Auswahl, bis die Nummer frei ist, um mit Braze verbunden zu werden. In der folgenden Tabelle finden Sie die verschiedenen Gründe, aus denen eine Nummer gesperrt sein kann, und wie Sie die Sperre aufheben.
| Ursache | Lösung |
|---|---|
| Nummer ist noch bei einer anderen Meta-Entwickler-App registriert | Öffnen Sie im Dashboard von Meta for Developers die App, in der die WhatsApp API zuvor eingerichtet wurde. Gehen Sie zu WhatsApp > API Setup (oder Getting Started), suchen Sie die Telefonnummer und entfernen Sie sie aus dieser App. Wenn die Nummer für ein anderes WhatsApp Business Account (WABA) aktiv ist, müssen Sie sie möglicherweise auch im WhatsApp Manager aus diesem Konto entfernen, bevor sie verfügbar wird. |
| WhatsApp Business Account wird mit einem anderen Lösungsanbieter geteilt | Überprüfen Sie in den Einstellungen des WhatsApp Managers, dass das WABA, zu dem die Nummer gehört, nur mit Braze geteilt wird oder nicht mit anderen Messaging-Anbietern geteilt wird. Wenn ein anderer Anbieter Zugriff hat, entfernen Sie diese Partnerfreigabe oder migrieren Sie die Nummer zu einem mit Braze verbundenen WABA. |
| Partnerzugriff für Braze fehlt | Wenn das WABA noch nicht mit Braze geteilt wird, weisen Sie Braze als Partner mit Vollzugriff zu, wenn Meta Sie während der Registrierung dazu auffordert, und versuchen Sie dann erneut, die Telefonnummer auszuwählen. |
Nachdem Sie die widersprüchliche Registrierung oder Partnerfreigabe entfernt haben, starten Sie die Embedded Signup erneut über Braze und wählen Sie die Nummer noch einmal aus.