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 übernimmt dies automatisch; für die meisten Kund:innen müssen weder Campaigns noch Canvases angepasst werden.
Meta führt WhatsApp-Nutzernamen und BSUIDs schrittweise ein. Braze unterstützt das Messaging über BSUIDs vollständig, daher sehen Sie im Laufe der Zeit möglicherweise mehr Nutzer:innen, die nur über eine BSUID verfügen. Die neuesten Updates von Meta finden Sie unter Geschäftsbezogene Nutzer-IDs.
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 jede Kombination aus Unternehmensportfolio und 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 vergibt, um eine:n Nutzer:in innerhalb Ihres spezifischen Business-Portfolios zu repräsentieren. Stellen Sie sich die BSUID als alternative Telefonnummer für Nutzer:innen vor, die ihre Telefonnummer lieber privat halten möchten.
BSUIDs haben drei zentrale Eigenschaften:
| Eigenschaft | Beschreibung |
|---|---|
| Eindeutig | Innerhalb Ihres Business-Portfolios teilen sich keine zwei Nutzer:innen dieselbe BSUID. |
| Geschäftsbezogen | Dieselbe Person hat bei jedem Unternehmen, dem sie Nachrichten sendet, eine andere BSUID. BSUIDs können nicht zwischen verschiedenen Business-Portfolios geteilt oder verglichen werden. |
| In Webhooks verfügbar | BSUIDs sind in denselben Webhook-Payloads enthalten, die auch die Telefonnummer der Nutzer:innen übermitteln. |
Änderungen an WhatsApp-Nutzertypen
Es gibt zwei Arten von WhatsApp-Nutzer:innen:
| Nutzertyp | WhatsApp-Identifizierung | Was Braze erhält |
|---|---|---|
| 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 Unterhaltung mit Ihrem Unternehmen geführt haben |
Der wesentliche Unterschied besteht darin, dass Nutzer:innen, die einen Benutzernamen verwenden, ihre Telefonnummer nur dann mit Ihrem Unternehmen teilen, wenn Sie bereits eine Unterhaltung mit ihnen geführt haben oder wenn sie in Ihrem WhatsApp-Adressbuch erscheinen.
So verarbeitet Braze BSUIDs
Braze speichert BSUIDs als Nutzer-Alias mit dem Label whats_app_bsuid im Nutzerprofil. Nutzer:innen, die nur eine BSUID haben, verfügen daher über vollständige Braze-Nutzerprofile. Sie können in Canvases eintreten, Nachrichten empfangen, Events generieren und über die API aktualisiert werden.
Nachrichten senden
Beim Versand einer WhatsApp-Nachricht verwendet Braze die Telefonnummer, sofern eine vorhanden ist. Hat ein:e Nutzer:in nur eine BSUID (zum Beispiel jemand, der Ihnen nach der Einrichtung eines Nutzernamens zum ersten Mal schreibt), sendet Braze stattdessen über die BSUID. Sie müssen Ihre Nachrichten-Templates, Campaigns oder Canvas-Schritte nicht anpassen.
Eingehende Nachrichten und Canvas-Trigger
Wenn Ihnen ein:e Nutzer:in mit Nutzernamen eine eingehende WhatsApp-Nachricht sendet, geht Braze wie folgt vor:
- Braze sucht die Nutzer:in anhand der BSUID oder der Telefonnummer (je nachdem, was im Webhook verfügbar ist).
- Wird keine passende Nutzer:in gefunden, legt Braze ein neues anonymes Nutzerprofil an und speichert die BSUID als Nutzer-Alias.
- Braze triggert alle Canvases oder Campaigns, die so konfiguriert sind, dass sie bei einer eingehenden WhatsApp-Nachricht starten.
Nutzerprofil
Die BSUID einer Nutzer:in sehen Sie im Braze-Nutzerprofil im Abschnitt WhatsApp.
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 von BSUID-Nutzer:innen auf folgenden Wegen aktualisieren:
- Über den Endpunkt users/track mit
user_alias - Über den Canvas-Schritt Nutzer-Update (funktioniert automatisch)
- Per CSV-Upload
Der Endpunkt subscription/status/set unterstützt user_alias nicht. Verwenden Sie den Endpunkt users/track, um den Abo-Status von Nutzer:innen zu aktualisieren, die nur eine BSUID haben.
Currents und Event-Daten
Alle WhatsApp-Events in Currents (Versand, Zustellung, Lesen, Fehler, eingehende Nachricht empfangen, Abbruch, erneuter Versuch) enthalten ein BSUID-Feld. Bei Nutzer:innen, die sowohl eine Telefonnummer als auch eine BSUID haben, sind beide Felder enthalten. Bei Nutzer:innen, die nur eine BSUID haben, ist nur das BSUID-Feld enthalten (das Feld für die Telefonnummer ist leer).
So bereiten Sie sich auf die Änderung vor
Für die meisten Kund:innen sind keine Maßnahmen erforderlich. Braze übernimmt das BSUID-Routing, die Erstellung von Nutzer:innen und das Event-Tracking automatisch. Wir empfehlen jedoch, das WhatsApp-Kontaktbuch zu aktivieren und Business-Portfolios zu verknüpfen, wenn Sie mehrere WhatsApp Business Accounts (WABAs) verwenden.
Wenn Sie eingehende Nutzer:innen erwarten, die nur eine BSUID angeben, können Sie auch deren Kontaktinformationen anfragen. So können Sie eine Telefonnummer im Profil speichern und bei Bedarf Duplikate zusammenführen.
WhatsApp-Kontaktbuch aktivieren
Das Kontaktbuch ist ein Meta-Feature, das die 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 enthalten sind. Dadurch kann Braze Nutzer:innen auch dann weiterhin über ihre Telefonnummer identifizieren, wenn sie einen Nutzernamen aktiviert haben.
So aktivieren Sie das Kontaktbuch:
- Gehen Sie zu Meta Business Suite > Business settings > Business info.
- Prüfen Sie, ob das Kontaktbuch-Feature aktiviert ist.
Das Kontaktbuch-Feature ist standardmäßig aktiviert. Wir empfehlen jedoch, dies in Ihren Meta-Business-Einstellungen zu überprüfen. Ist das Kontaktbuch deaktiviert, erscheinen Nutzer:innen, die einen Nutzernamen einrichten, als neue Nutzer:innen mit ausschließlich einer BSUID – selbst wenn Sie ihnen bereits Nachrichten gesendet haben.
Business-Portfolios verknüpfen, wenn Sie mehrere WABAs verwenden
BSUIDs gelten jeweils nur für ein einzelnes Business-Portfolio. Wenn Ihre Organisation WABAs aus mehreren Business-Portfolios im selben Braze-Workspace verwaltet, hat dieselbe Person für jedes Portfolio eine andere BSUID. Das kann zu doppelten Nutzerprofilen in Braze führen.
Um dies zu verhindern, wenden Sie sich an Ihre Ansprechperson bei Meta und klären Sie, ob Ihr Unternehmen Portfolios verknüpfen kann. Weitere Informationen finden Sie unter Business-Portfolios und übergeordnete BSUIDs verknüpfen.
Wenn sich alle Ihre WABAs im selben Business-Portfolio befinden, sind keine Maßnahmen erforderlich.
Business-Portfolios und übergeordnete BSUIDs verknüpfen
Wenn Ihre Organisation mehrere WhatsApp Business Accounts (WABAs) in verschiedenen Business-Portfolios betreibt, können Sie Ihre Ansprechperson bei Meta bitten zu prüfen, ob Ihr Unternehmen diese Portfolios miteinander verknüpfen darf. Über die Berechtigung entscheidet Meta. Die Verknüpfung steht Managed Businesses zur Verfügung.
Verhalten verknüpfter Portfolios
Wenn Ihre Business-Portfolios verknüpft sind, nimmt WhatsApp in alle Nachrichten-Webhooks neben der regulären BSUID auch eine übergeordnete BSUID auf. Die übergeordnete BSUID wird der neuen Eigenschaft parent_user_id im Webhook-Payload zugewiesen.
Übergeordnete BSUIDs haben dieselben Eigenschaften wie reguläre BSUIDs, werden aber von allen geschäftlichen Telefonnummern innerhalb Ihrer verknüpften Portfolios gemeinsam genutzt. So haben Nutzer:innen einen einzigen, konsistenten Bezeichner, unabhängig davon, an welche WABA sie schreiben. Das vermeidet doppelte Nutzerprofile.
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.
So verwendet Braze übergeordnete BSUIDs
Wenn ein Webhook sowohl eine reguläre als auch eine übergeordnete BSUID enthält, verwendet Braze die übergeordnete BSUID als primären Bezeichner. Dadurch werden Nutzer:innen, die an mehrere WABAs in Ihren verknüpften Portfolios schreiben, konsistent demselben Braze-Nutzerprofil zugeordnet.
Ist keine übergeordnete BSUID vorhanden (zum Beispiel, weil Ihre Portfolios nicht verknüpft sind oder die Person an eine nicht verknüpfte WABA schreibt), verwendet Braze die reguläre BSUID. Reguläre BSUIDs funktionieren in allen Fällen weiterhin normal.
Meta verwaltet den Prozess zur Verknüpfung von Business-Portfolios. Wenden Sie sich für den Einstieg an Ihre Ansprechperson bei Meta. Sie können Nutzer:innen auch bei verknüpften Portfolios weiterhin über ihre reguläre BSUID Nachrichten senden. Übergeordnete BSUIDs sind eine Ergänzung, kein Ersatz.
| Szenario | Von Braze verwendeter Bezeichner |
|---|---|
| Einzelnes Business-Portfolio | Reguläre BSUID |
| Mehrere verknüpfte Portfolios | Übergeordnete BSUID (bevorzugt). Gibt es keine übergeordnete BSUID, 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 verwenden, sind davon überhaupt nicht betroffen. Bei Nutzer:innen, die einen Nutzernamen verwenden und bereits einen Konversationsverlauf mit Ihrem Unternehmen haben, verwendet Braze weiterhin die Telefonnummer als primären Bezeichner.
Was passiert mit Nutzer:innen, die einen Nutzernamen verwenden, aber Ihrem Unternehmen bereits eine Nachricht geschickt haben?
Wenn Ihr WhatsApp-Kontaktbuch aktiviert ist und Sie in den letzten 30 Tagen eine Konversation mit der Person hatten (oder ihr eine Nachricht gesendet haben), erscheint ihre Telefonnummer weiterhin neben der BSUID in den Webhook-Payloads. Braze ordnet sie ihrem bestehenden Nutzerprofil zu. Es wird kein doppeltes Profil angelegt.
Was passiert, wenn Nutzer:innen einen Nutzernamen verwenden und noch keine Konversation mit Ihrem Unternehmen hatten?
Braze empfängt die BSUID der Person im eingehenden Webhook und ordnet sie entweder einem bestehenden Nutzerprofil zu (wenn Sie ihre 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 mit den standardmäßigen Tools zur Identitätsauflösung von Braze identifiziert oder mit anderen Profilen zusammengeführt werden.
Wie Sie von diesen Nutzer:innen, für die nur eine BSUID vorliegt, eine Telefonnummer erhalten, erfahren Sie unter Kontaktdaten von WhatsApp-Nutzer:innen mit reiner BSUID anfordern.
Kann ich BSUID-Nutzer:innen in Segments targeten?
BSUID-Nutzer:innen haben vollständige Braze-Nutzerprofile, sodass Sie sie über die standardmäßigen Zielgruppenfilter ansprechen können (z. B. „hat eine WhatsApp-Nachricht erhalten“ oder die Mitgliedschaft in einer Abo-Gruppe). Eine Segmentierung speziell nach BSUID-Werten (z. B. „BSUID existiert“ oder „BSUID ist gleich X“) wird jedoch nicht unterstützt.
Wie funktioniert die WhatsApp-Preisgestaltung für BSUID-Nutzer:innen?
Die Preise für WhatsApp-Konversationen richten sich nach dem Land der Nutzer:innen. Bei Nutzer:innen, die über ihre Telefonnummer identifiziert werden, leitet Meta das Land aus der Ländervorwahl der Telefonnummer ab. Bei Nutzer:innen, die über ihre BSUID identifiziert werden, ist das Land direkt in der BSUID selbst kodiert. Eine BSUID, die mit US beginnt, steht beispielsweise für Nutzer:innen in den USA.
Die Preisgestaltung ist also dieselbe, unabhängig davon, ob Nutzer:innen über die Telefonnummer oder die BSUID identifiziert werden. Das Land, das zur Berechnung der Konversationspreise herangezogen wird, ergibt sich aus dem Bezeichner, den Meta bereitstellt, und Braze gibt diesen unverändert weiter. Sie müssen nichts anders machen. Beachten Sie aber, dass sich die länderbasierte Preisgestaltung von Meta beim Messaging an Nutzer:innen mit reiner BSUID nach dem in der BSUID kodierten Land richtet und nicht nach einer Telefonnummer.
Wie referenziere ich BSUID-Nutzer:innen in API-Aufrufen?
Verwenden Sie den Parameter user_alias mit alias_label: "whats_app_bsuid" und setzen Sie alias_name auf den BSUID-Wert der Person. Zum Beispiel:
{
"user_alias": {
"alias_label": "whats_app_bsuid",
"alias_name": "DDC91135R"
}
}
Das funktioniert mit users/track, users/identify, dem CSV-Upload und dem Canvas-Schritt „Nutzer-Update“.
Funktionieren meine Currents-Datenpipelines weiterhin?
Currents-Events für WhatsApp enthalten neben dem bestehenden Telefonnummernfeld ein bsuid-Feld. Bei Nutzer:innen, für die nur eine BSUID vorliegt, ist das Telefonnummernfeld leer. Wenn Ihre nachgelagerten Pipelines strenge Anforderungen an das Telefonnummernfeld stellen, prüfen Sie, ob sie mit einem Null- oder leeren Wert umgehen können.
Ich habe mehrere WABAs in verschiedenen Business-Portfolios. Erscheinen dieselben Nutzer:innen in Braze als zwei unterschiedliche Profile?
Ohne verknüpfte Portfolios ja. Dieselben WhatsApp-Nutzer:innen haben pro Business-Portfolio eine andere BSUID, und Braze erstellt für jede ein separates Profil.
Um das zu lösen, wenden Sie sich an Ihre Ansprechperson bei Meta und lassen Sie prüfen, ob Sie für die Portfolio-Verknüpfung infrage kommen. Bei verknüpften Portfolios stellt Meta eine übergeordnete BSUID bereit, die für alle Portfolios gilt. Braze verwendet diese, um die Nutzer:innen über Ihre WABAs hinweg einheitlich 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 ist, gehen alle historischen Telefonnummerndaten Ihrer Nutzer:innen verloren. Nutzer:innen, die einen Nutzernamen verwenden, erscheinen dann als neue Nutzer:innen mit reiner BSUID, auch wenn Sie ihnen zuvor bereits Nachrichten gesendet haben.
Weitere Ressourcen