WhatsApp-Nutzernamen und geschäftsbezogene Nutzer-IDs
WhatsApp-Nutzernamen sind ein optionales Datenschutz-Feature, das die Telefonnummern von Nutzer:innen verbirgt, wenn sie mit Unternehmen kommunizieren. Braze handhabt dies automatisch; für die meisten Kund:innen müssen weder Campaigns noch Canvases angepasst werden.
Wenn WhatsApp-Nutzer:innen einen Nutzernamen einrichten, wird ihre Telefonnummer nicht mehr automatisch mit den Unternehmen geteilt, denen sie Nachrichten senden. Stattdessen stellt WhatsApp den Unternehmen eine geschäftsbezogene Nutzer-ID (BSUID) bereit – einen eindeutigen Bezeichner, der spezifisch für jedes Unternehmensportfolio und jede:n Nutzer:in ist.
Braze verarbeitet BSUIDs automatisch. Nutzer:innen, die einen Nutzernamen einrichten, erscheinen weiterhin in Ihrem Braze-Workspace, empfangen Nachrichten, triggern Canvases und erzeugen Events. Einige Kund:innen müssen sich möglicherweise auf die Änderung vorbereiten.
Geschäftsbezogene Nutzer-ID (BSUID)
Eine BSUID ist ein eindeutiger, persistenter Bezeichner, den WhatsApp einem/einer Nutzer:in innerhalb Ihres spezifischen Geschäftsportfolios zuweist. Sie können sie sich als eine alternative Telefonnummer für Nutzer:innen vorstellen, die ihre Telefonnummer privat halten möchten.
BSUIDs haben drei wesentliche Eigenschaften:
| Eigenschaft | Beschreibung |
|---|---|
| Eindeutig | Keine zwei Nutzer:innen teilen sich dieselbe BSUID innerhalb Ihres Geschäftsportfolios. |
| Geschäftsbezogen | Dieselbe Person hat bei jedem Unternehmen, dem sie eine Nachricht sendet, eine andere BSUID. BSUIDs können nicht über verschiedene Geschäftsportfolios hinweg geteilt oder verglichen werden. |
| In Webhooks verfügbar | BSUIDs sind in allen Webhook-Payloads enthalten, die auch die Telefonnummer der/des Nutzer:in übermitteln. |
Änderungen an WhatsApp-Nutzer:innentypen
Es gibt zwei Arten von WhatsApp-Nutzer:innen:
| Nutzer:innentyp | WhatsApp-Identifikation | Was Braze empfängt |
|---|---|---|
| Nutzer:innen ohne Benutzernamen | Telefonnummer (keine Änderung) | Telefonnummer (keine Änderung) |
| Nutzer:innen mit Benutzernamen | Benutzername (angezeigt), BSUID (Backend) | BSUID, Telefonnummer für Nutzer:innen, die bereits eine Konversation mit Ihrem Unternehmen haben |
Der wesentliche Unterschied besteht darin, dass Nutzer:innen, die einen Benutzernamen einführen, ihre Telefonnummer nur dann mit Ihrem Unternehmen teilen, wenn Sie zuvor eine Konversation mit ihnen hatten oder wenn sie in Ihrem WhatsApp-Kontaktbuch erscheinen.
So verarbeitet Braze BSUIDs
Braze speichert BSUIDs als Nutzer-Alias mit dem Label whats_app_bsuid im Nutzerprofil. Das bedeutet, dass Nutzer:innen, die nur über eine BSUID verfügen, vollständige Braze-Nutzerprofile haben und Canvases betreten, Nachrichten empfangen, Ereignisse generieren und über die API aktualisiert werden können.
Nachrichten senden
Wenn Braze eine WhatsApp-Nachricht sendet, wird die Telefonnummer verwendet, sofern eine vorhanden ist. Wenn die/der Nutzer:in nur eine BSUID hat (z. B. ein:e Nutzer:in, die/der Ihnen nach der Einführung eines Benutzernamens erstmals eine Nachricht sendet), verwendet Braze stattdessen die BSUID. Änderungen an Ihren Nachrichtentemplates, Campaigns oder Canvas-Schritten sind nicht erforderlich.
Eingehende Nachrichten und Canvas-Trigger
Wenn ein:e Nutzer:in mit Benutzernamen Ihnen eine eingehende WhatsApp-Nachricht sendet, führt Braze folgende Schritte aus:
- Sucht die/den Nutzer:in anhand der BSUID oder Telefonnummer (je nachdem, was im Webhook verfügbar ist).
- Wird kein:e passende:r Nutzer:in gefunden, erstellt Braze ein neues anonymes Nutzerprofil, in dem die BSUID als Nutzer-Alias gespeichert wird.
- Triggert alle Canvases oder Campaigns, die so konfiguriert sind, dass sie bei einer eingehenden WhatsApp-Nachricht starten.
Nutzerprofil
Sie können die BSUID von Nutzer:innen in ihrem Braze-Nutzerprofil im WhatsApp-Bereich einsehen.
Abo-Gruppen
Die Verwaltung von Abo-Gruppen funktioniert für BSUID-Nutzer:innen genauso wie für alle Nutzer:innen, die über einen Nutzer-Alias identifiziert werden. Sie können den Abo-Status für BSUID-Nutzer:innen auf folgenden Wegen aktualisieren:
- Über den users/track-Endpunkt mit
user_alias - Über den User Update-Canvas-Schritt (funktioniert automatisch)
- CSV-Upload
Der subscription/status/set-Endpunkt unterstützt kein user_alias. Verwenden Sie den users/track-Endpunkt, um den Abo-Status für Nutzer:innen zu aktualisieren, die nur über eine BSUID verfügen.
Currents und Ereignisdaten
Alle WhatsApp-Currents-Ereignisse (Senden, Zustellung, Gelesen, Fehler, Eingang empfangen, Abbruch, Wiederholungsversuch) enthalten ein BSUID-Feld. Für Nutzer:innen, die sowohl eine Telefonnummer als auch eine BSUID haben, sind beide Felder enthalten. Für Nutzer:innen, die nur über eine BSUID verfügen, ist nur das BSUID-Feld enthalten (das Telefonnummernfeld ist leer).
Vorbereitung auf die Änderung
Für die meisten Kund:innen ist keine Aktion erforderlich. Braze übernimmt automatisch das BSUID-Routing, die Erstellung von Nutzer:innen und das Event-Tracking. Wir empfehlen jedoch, das WhatsApp-Kontaktbuch zu aktivieren und Business-Portfolios zu verknüpfen, wenn Sie mehrere WhatsApp Business Accounts (WABAs) verwenden.
WhatsApp-Kontaktbuch aktivieren
Das Kontaktbuch ist ein Meta-Feature, das Telefonnummern von Nutzer:innen speichert, mit denen Sie bereits kommuniziert haben. Wenn Nutzer:innen einen Nutzernamen einrichten, bleibt ihre Telefonnummer für Ihr Unternehmen sichtbar, sofern sie in Ihrem Kontaktbuch vorhanden sind. Das bedeutet, dass Braze Nutzer:innen auch dann weiterhin anhand der Telefonnummer identifizieren kann, wenn diese einen Nutzernamen aktivieren.
So aktivieren Sie das Kontaktbuch:
- Gehen Sie zu Meta Business Suite > Business settings > Business info.
- Bestätigen Sie, dass das Kontaktbuch-Feature aktiviert ist.
Das Kontaktbuch-Feature ist standardmäßig aktiviert. Wir empfehlen jedoch, dies in Ihren Meta-Business-Einstellungen zu überprüfen. Wenn das Kontaktbuch deaktiviert ist, erscheinen Nutzer:innen, die einen Nutzernamen einrichten, als neue reine BSUID-Nutzer:innen – selbst wenn Sie ihnen zuvor Nachrichten gesendet haben.
Business-Portfolios verknüpfen, wenn Sie mehrere WABAs verwenden
BSUIDs sind auf ein einzelnes Business-Portfolio beschränkt. Wenn Ihre Organisation WABAs aus mehreren Business-Portfolios innerhalb desselben Braze-Workspace verwaltet, hat dieselbe Person eine unterschiedliche BSUID für jedes Portfolio. Dies kann zu doppelten Braze-Nutzerprofilen führen.
Um dies zu verhindern, wenden Sie sich an Ihren Meta-Ansprechpartner, um zu prüfen, ob Ihr Unternehmen berechtigt ist, Portfolios zu verknüpfen. Weitere Informationen finden Sie unter Business-Portfolios und übergeordnete BSUIDs verknüpfen.
Wenn sich alle Ihre WABAs innerhalb desselben Business-Portfolios befinden, ist keine Aktion erforderlich.
Geschäftsportfolios und übergeordnete BSUIDs verknüpfen
Wenn Ihre Organisation mehrere WhatsApp Business Accounts (WABAs) über verschiedene Geschäftsportfolios betreibt, können Sie Ihren Meta-Ansprechpartner bitten, zu prüfen, ob Ihr Unternehmen berechtigt ist, diese Portfolios miteinander zu verknüpfen. Die Berechtigung wird von Meta festgelegt und steht verwalteten Unternehmen zur Verfügung.
Verhalten verknüpfter Portfolios
Wenn Ihre Geschäftsportfolios verknüpft sind, fügt WhatsApp in allen Nachrichten-Webhooks neben der regulären BSUID eine übergeordnete BSUID hinzu. Die übergeordnete BSUID wird einer neuen parent_user_id-Eigenschaft in der Webhook-Payload zugewiesen.
Übergeordnete BSUIDs haben die gleichen Eigenschaften wie reguläre BSUIDs, werden aber über alle geschäftlichen Telefonnummern innerhalb Ihrer verknüpften Portfolios geteilt. Das bedeutet, dass derselbe Nutzer bzw. dieselbe Nutzerin einen einzigen konsistenten Bezeichner hat, unabhängig davon, welchem WABA er oder sie eine Nachricht sendet, wodurch das Risiko doppelter Nutzerprofile vermieden wird.
Eine übergeordnete BSUID enthält ENT zwischen dem Ländercode und dem alphanumerischen Bezeichner. Zum Beispiel:
US.ENT.11815799212886844830
Eine reguläre BSUID enthält kein ENT.
Wie Braze übergeordnete BSUIDs verwendet
Wenn ein Webhook sowohl eine reguläre BSUID als auch eine übergeordnete BSUID enthält, verwendet Braze die übergeordnete BSUID als primären Bezeichner. Dadurch kann ein:e Nutzer:in, der bzw. die über mehrere WABAs in Ihren verknüpften Portfolios Nachrichten sendet, konsistent demselben Braze-Nutzerprofil zugeordnet werden.
Wenn keine übergeordnete BSUID vorhanden ist (z. B. weil Ihre Portfolios nicht verknüpft sind oder die Nutzerin bzw. der Nutzer einem nicht verknüpften WABA schreibt), verwendet Braze die reguläre BSUID. Reguläre BSUIDs funktionieren in allen Fällen weiterhin normal.
Meta verwaltet den Prozess der Verknüpfung von Geschäftsportfolios. Wenden Sie sich zunächst an Ihren Meta-Ansprechpartner. Sie können Nutzer:innen weiterhin über ihre reguläre BSUID kontaktieren, auch wenn Ihre Portfolios verknüpft sind; übergeordnete BSUIDs sind ergänzend, kein Ersatz.
| Szenario | Von Braze verwendeter Bezeichner |
|---|---|
| Einzelnes Geschäftsportfolio | Reguläre BSUID |
| Mehrere verknüpfte Portfolios | Übergeordnete BSUID (bevorzugt). Falls keine übergeordnete BSUID vorhanden ist, wird die reguläre BSUID verwendet |
| Mehrere nicht verknüpfte Portfolios | Reguläre BSUID (kann zu doppelten Nutzerprofilen pro Portfolio führen) |
Häufig gestellte Fragen
Funktionieren meine bestehenden Campaigns und Canvases weiterhin?
Ja. Bestehende Campaigns und Canvases funktionieren weiterhin. Nutzer:innen, die keinen Nutzernamen annehmen, sind davon überhaupt nicht betroffen. Für Nutzer:innen, die einen Nutzernamen annehmen und bereits einen Gesprächsverlauf mit Ihrem Unternehmen haben, verwendet Braze weiterhin die Telefonnummer als primären Bezeichner.
Was passiert mit Nutzer:innen, die einen Nutzernamen annehmen, aber bereits mit meinem Unternehmen kommuniziert haben?
Wenn Ihr WhatsApp-Kontaktbuch aktiviert ist und Sie innerhalb der letzten 30 Tage eine vorherige Konversation mit den Nutzer:innen hatten (oder ihnen eine Nachricht gesendet haben), erscheint deren Telefonnummer weiterhin in den Webhook-Payloads neben der BSUID. Braze ordnet sie ihrem bestehenden Nutzerprofil zu. Es wird kein doppeltes Profil erstellt.
Was passiert, wenn Nutzer:innen einen Nutzernamen annehmen und keine vorherige Konversation mit meinem Unternehmen hatten?
Braze empfängt die BSUID der Nutzer:innen im eingehenden Webhook und ordnet sie entweder einem bestehenden Nutzerprofil zu (falls Sie deren BSUID zuvor gespeichert haben) oder erstellt ein neues anonymes Nutzerprofil, in dem die BSUID als Nutzer-Alias gespeichert wird. Diese Nutzer:innen können dann in Canvases eintreten, ausgehende Nachrichten erhalten und mithilfe der standardmäßigen Identitätsauflösungstools von Braze identifiziert oder mit anderen Profilen zusammengeführt werden.
Kann ich BSUID-Nutzer:innen in Segmenten ansprechen?
BSUID-Nutzer:innen sind vollwertige Braze-Nutzerprofile, sodass Sie sie über Standard-Zielgruppenfilter ansprechen können (z. B. „hat eine WhatsApp-Nachricht erhalten“ oder Abo-Gruppen-Zugehörigkeit). Eine spezifische Segmentierung nach BSUID-Werten (z. B. „BSUID existiert“ oder „BSUID gleich X“) wird jedoch nicht unterstützt.
Wie funktioniert die WhatsApp-Preisgestaltung für BSUID-Nutzer:innen?
Die WhatsApp-Konversationspreise werden durch das Land der Nutzer:innen bestimmt. Bei Nutzer:innen, die über eine Telefonnummer identifiziert werden, leitet Meta das Land aus der Landesvorwahl der Telefonnummer ab. Bei BSUID-identifizierten Nutzer:innen ist das Land direkt in der BSUID selbst codiert – beispielsweise steht eine BSUID, die mit US beginnt, für Nutzer:innen in den Vereinigten Staaten.
Das bedeutet, dass die Preisgestaltung konsistent ist, unabhängig davon, ob Nutzer:innen per Telefonnummer oder BSUID identifiziert werden. Das Land, das zur Berechnung der Konversationsraten verwendet wird, wird durch den von Meta bereitgestellten Bezeichner bestimmt, und Braze leitet dies ohne Änderung weiter. Sie müssen nichts anders machen, sollten sich aber bewusst sein, dass beim Versenden von Nachrichten an reine BSUID-Nutzer:innen die länderbasierte Preisgestaltung von Meta auf dem in der BSUID der Nutzer:innen codierten Land basiert und nicht auf einer Telefonnummer.
Wie referenziere ich BSUID-Nutzer:innen in API-Aufrufen?
Verwenden Sie den Parameter user_alias mit alias_label: "whats_app_bsuid" und alias_name auf den BSUID-Wert der Nutzer:innen gesetzt. Zum Beispiel:
{
"user_alias": {
"alias_label": "whats_app_bsuid",
"alias_name": "DDC91135R"
}
}
Dies funktioniert mit users/track, users/identify, CSV-Upload und dem Canvas-Schritt „User Update“.
Werden meine Currents-Datenpipelines unterbrochen?
Currents-Events für WhatsApp enthalten ein bsuid-Feld neben dem bestehenden Telefonnummernfeld. Bei Nutzer:innen, die nur eine BSUID haben, ist das Telefonnummernfeld leer. Wenn Ihre nachgelagerten Pipelines strenge Anforderungen an das Telefonnummernfeld haben, stellen Sie sicher, dass sie mit einem leeren oder Null-Wert umgehen können.
Ich habe mehrere WABAs in verschiedenen Business-Portfolios. Erscheinen dieselben Nutzer:innen als zwei verschiedene Profile in Braze?
Ohne verknüpfte Portfolios: ja. Dieselben WhatsApp-Nutzer:innen haben pro Business-Portfolio eine unterschiedliche BSUID, und Braze erstellt für jede ein separates Profil.
Um dies zu lösen, wenden Sie sich an Ihren Meta-Ansprechpartner, um die Berechtigung für die Portfolio-Verknüpfung zu prüfen. Bei verknüpften Portfolios stellt Meta eine übergeordnete BSUID bereit, die über alle Portfolios hinweg geteilt wird, und Braze nutzt diese, um die Nutzer:innen konsistent über Ihre WABAs hinweg zu identifizieren. Weitere Details finden Sie unter Business-Portfolios und übergeordnete BSUIDs verknüpfen.
Kann ich das Kontaktbuch deaktivieren?
Wir empfehlen dringend, das Kontaktbuch aktiviert zu lassen. Wenn das Kontaktbuch deaktiviert wird, gehen alle historischen Telefonnummern-Datensätze Ihrer Nutzer:innen verloren. Nutzer:innen, die Nutzernamen annehmen, erscheinen dann als neue reine BSUID-Nutzer:innen, selbst wenn Sie ihnen zuvor Nachrichten gesendet hatten.