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 geöffnet, wenn Sie WhatsApp zum ersten Mal in Ihren Braze-Workspace integrieren und wenn Sie einer bestehenden Integration ein WhatsApp Business-Konto oder eine Telefonnummer 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 starten.
- 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.
Der eingebettete Registrierungsablauf von Meta ist derselbe, unabhängig davon, über welchen Einstiegspunkt 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 vor dem Start den Tab aus, der zu Ihrem Setup passt.
Registrierung vorbereiten
Wenn Sie Begin Integration auswählen, öffnet Braze ein Onboarding-Fenster. Sehen Sie sich jede Folie an und wählen Sie dann erneut Begin Integration aus, um die eingebettete Registrierung von Meta zu starten.
Bereiten Sie vor dem Start Folgendes vor:
- Zugriff auf den Meta Business Manager: Die meisten Unternehmen verwalten Facebook-Seiten, Anzeigen und zugehörige Business-Assets über den Meta Business Manager. Wenn Sie keinen Zugriff haben, bitten Sie eine:n Administrator:in, Ihnen Berechtigungen zu erteilen, oder erstellen Sie während der Registrierung ein Business-Manager-Konto.
- 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 pro Integrationspfad nur einmal 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 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-Portfolio, dem das WhatsApp Business-Konto gehören soll. Wenn Sie das erwartete Portfolio nicht sehen, überprüfen Sie Ihre Meta-Berechtigungen.
- Ein WhatsApp-Konto verbinden oder erstellen. Erstellen Sie ein neues Konto oder wählen Sie das WhatsApp-Konto aus, dem Ihre Telefonnummer bereits zugeordnet ist. Wenn die Nummer bereits bei einem anderen Anbieter verwendet wird, können Sie dieses WhatsApp-Konto mit Braze teilen, anstatt die Nummer umzuziehen.
- 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 die Braze-Systemnutzer:in 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 WhatsApp-Einrichtung für allgemeine Hinweise.
Fehlerbehebung
Auswahl nicht zulässiger Telefonnummern
Bei der eingebetteten Registrierung über Meta kann eine Telefonnummer als Ineligible (nicht zulässig) angezeigt werden. Meta sperrt die Auswahl einer Telefonnummer, bis die Nummer für eine Verbindung mit Braze frei ist. In der folgenden Tabelle finden Sie die möglichen Gründe für eine Sperrung und wie Sie die Nummer wieder freigeben.
| Ursache | Lösung |
|---|---|
| Nummer ist noch bei einer anderen Meta-Entwickler:innen-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-Konto wird mit einem anderen Lösungsanbieter geteilt | Das Teilen eines WhatsApp-Kontos mit einem anderen Anbieter wird im neueren Kontomodell von Meta unterstützt. Stellen Sie sicher, dass Braze Zugriff auf das Messaging-Konto für Ihre Verbindung hat, und wiederholen Sie dann die Auswahl der Telefonnummer. Weitere Informationen finden Sie unter Vorhandene WhatsApp-Telefonnummer verwenden. |
| Partnerzugriff für Braze fehlt | Wenn das WhatsApp-Konto noch nicht mit Braze geteilt wird, weisen Sie Braze als Partner zu, sobald Meta Sie während der Registrierung dazu auffordert, und wiederholen Sie dann die Auswahl der Telefonnummer. |
Nachdem Sie die konfliktverursachende Registrierung oder Partnerfreigabe entfernt haben, starten Sie die eingebettete Registrierung erneut aus Braze und wählen Sie die Nummer noch einmal aus.