WhatsApp-Benutzernamen und BSUIDs verstehen
Was sind WhatsApp-Benutzernamen?
Ein WhatsApp-Benutzername ist eine optionale, eindeutige Kennung, die entweder von einem WhatsApp-Nutzer (der in der WhatsApp-App für Privatanwender angemeldet ist) oder von einem Unternehmen (das in der WhatsApp Business-App oder auf der WhatsApp Business API-Plattform angemeldet ist) festgelegt werden kann, um sie in der App anstelle einer Telefonnummer anzuzeigen. Benutzernamen funktionieren ähnlich wie Handles bei Facebook Messenger oder Instagram.
Es gibt zwei unterschiedliche Akteure und Anwendungsfälle:
| Schauspieler | Warum sie sich einen Benutzernamen zulegen | Auswirkungen auf die Sichtbarkeit der Telefonnummer |
|---|---|---|
| WhatsApp-Nutzer (der in der WhatsApp-App für Privatanwender angemeldet ist) | Datenschutz: um zu vermeiden, dass ihre Telefonnummer an Unternehmen oder andere Nutzer weitergegeben wird | Die Telefonnummer wird in Webhooks vor Unternehmen verborgen (es sei denn, bestimmte Bedingungen sind erfüllt) |
| Unternehmen (angemeldet bei der WhatsApp Business App oder der WhatsApp Business API-Plattform) | Markenaufbau: Damit Nutzer die Marke leichter finden und wiedererkennen können | Die Telefonnummer ist nicht verborgen; der Benutzername dient lediglich als zusätzliche Kennung. |
Benutzernamen sind eine Ergänzung zu Telefonnummern, kein Ersatz. Für jeden WhatsApp-Account ist nach wie vor eine Telefonnummer erforderlich.
Was ist eine BSUID?
Eine „Business-Scoped User ID“ (BSUID) ist eine eindeutige Kennung, die von Meta jedem WhatsApp-Nutzer zugewiesen wird und speziell mit einem bestimmten Unternehmensportfolio verknüpft ist. Sie dient in erster Linie dazu, einen Nutzer zu identifizieren und ihm Nachrichten zu senden, wenn dessen Telefonnummer nicht verfügbar ist.
Wesentliche Eigenschaften einer BSUID:
- Format: ISO 3166 Alpha-2-Ländercode-Präfix, gefolgt von einem Punkt und bis zu 128 alphanumerischen Zeichen – zum Beispiel US.13491208655302741918
- Geltungsbereich: Einzigartig für jedes Paar aus Geschäftsportfolio und Benutzer. Eine BSUID aus einem Portfolio kann nicht mit einer Telefonnummer verwendet werden, die zu einem anderen Portfolio gehört.
- Verfügbarkeit: Für WhatsApp-Nutzer (Privatkunden) stets verfügbar. Für Unternehmen nicht immer verfügbar, es sei denn, sie nutzen den Dienst. Unabhängig vom Benutzernamen oder der BSUID sind die Telefonnummern von Unternehmen zudem stets verfügbar.
- Neugenerierung: Eine BSUID wird neu generiert, wenn der Nutzer seine Telefonnummer ändert.
- Einschränkungen: BSUIDs können nicht zum Versenden von Authentifizierungsvorlagen vom Typ „One-Tap“, „Zero-Tap“ oder „Code kopieren“ verwendet werden. Für diese Nachrichtentypen ist eine Telefonnummer erforderlich.
Was ist eine übergeordnete BSUID?
Eine übergeordnete BSUID ist eine spezielle Variante einer BSUID, die verwalteten Unternehmen mit mehreren verknüpften Meta-Unternehmensportfolios zur Verfügung steht. Sie ermöglicht die Verwendung einer einzigen Kennung für alle registrierten Portfolios.
- Format:
{COUNTRY_CODE}.ENT.{ALPHANUMERIC_ID}— zum Beispiel,US.ENT.11815799212886844830 - Verfügbarkeit: Nur für Unternehmen, die von Meta in einem übergeordneten BSUID-Account registriert wurden. Wenden Sie sich an Ihren Ansprechpartner bei Meta oder Vonage, um die Teilnahmeberechtigung zu prüfen.
- Geltungsbereich: Gilt für alle registrierten Portfolios. Reguläre BSUIDs funktionieren weiterhin parallel zu übergeordneten BSUIDs.
Wann erhalten Sie eine BSUID und wann eine Telefonnummer?
Die folgende Tabelle gibt einen Überblick darüber, welche Identifikatoren je nach Benutzertyp für Vonage sichtbar sind:
| Benutzertyp | Ist die Telefonnummer sichtbar? | Ist die BSUID sichtbar? | Ist der Benutzername sichtbar? |
|---|---|---|---|
| Benutzer ohne Benutzernamen | Ja | Ja (immer) | Nein |
| Benutzer mit dem Benutzernamen „adopted“ | Unter bestimmten Voraussetzungen (siehe unten) | Ja (immer) | Ja |
| Geschäft ohne Benutzernamen | Ja | Nein | Nein |
| Geschäft mit übernommenem Benutzernamen | Ja | Nein | Ja (nur Branding) |
Wann wird bei Nutzern, die einen Benutzernamen anlegen, noch eine Telefonnummer angegeben?
Meta fügt die Telefonnummer des Nutzers in Webhooks ein, wenn eine der folgenden Bedingungen erfüllt ist (die Bewertung erfolgt pro geschäftlicher Telefonnummer):
- Sie haben dem Nutzer innerhalb der letzten 30 Tage eine Nachricht gesendet oder ihn unter seiner Telefonnummer angerufen.
- Sie haben in den letzten 30 Tagen eine Nachricht oder einen Anruf von der Telefonnummer des Nutzers erhalten
- Der Nutzer ist in Ihrem Adressbuch gespeichert.
Wenn keine dieser Bedingungen erfüllt ist, wird die wa_id Das Feld wird aus der Webhook-Nutzlast weggelassen. Das from Das Feld enthält die BSUID anstelle der Telefonnummer.
Das Adressbuch
Meta bietet eine Adressbuchfunktion (verfügbar ab Anfang April 2026), die die Telefonnummer und die BSUID eines Nutzers automatisch speichert, sobald Sie eine Nachricht an dessen Telefonnummer senden oder von dieser empfangen oder einen Anruf an diese Nummer tätigen bzw. von dieser erhalten. Nach der Speicherung erscheint die Telefonnummer weiterhin in den Webhook-Payloads, unabhängig davon, ob der Nutzer einen Benutzernamen festgelegt hat.
Das Kontaktbuch ist auf die Ebene des Geschäftsportfolios beschränkt und wird von Meta gehostet. Zur Aktivierung sind keine Integrationsmaßnahmen erforderlich, da es von Meta standardmäßig aktiviert ist. Sie können es jederzeit unter Meta Business Suite > Geschäftseinstellungen > Unternehmensinformationen.
Neuer Fehlercode
Es wird ein neuer Fehlercode zurückgegeben, wenn Sie versuchen, einen Nachrichtentyp zu versenden, der BSUIDs als Empfänger nicht unterstützt:
| Fehlercode | Einzelheiten |
|---|---|
| 131062 | Empfänger mit einer Business-Scoped-Benutzer-ID (BSUID) werden für diese Nachricht nicht unterstützt. |