WhatsApp-Benutzernamen und BSUIDs: Was sich für OTP, CRM und Webhooks ändert

Eine geschäftsbereichsspezifische Benutzer-ID (BSUID) ist der Identifikator, den Meta nun in jeden WhatsApp Webhook einfügt, damit ein Unternehmen einem Benutzer eine Nachricht senden kann, ohne dessen Telefonnummer zu kennen. Sie existiert, weil WhatsApp Benutzernamen einführt: Sobald ein Benutzer einen aktiviert, erhält ein Unternehmen, das nicht vor Kurzem Kontakt hatte, die Nummer möglicherweise nicht mehr. Dieser Leitfaden des BroadNet-Engineering-Teams erklärt das Format, den Zeitplan, was weiterhin eine Telefonnummer erfordert und wie Webhooks, CRM-Datensätze und OTP-Flows migriert werden können.

Wichtigste Erkenntnisse

• BSUIDs erscheinen seit Anfang April 2026 in WhatsApp Webhooks für jeden Benutzer, unabhängig davon, ob dieser einen Benutzernamen verwendet oder nicht.
• Ein BSUID sieht so aus US.13491208655302741918: ein ISO 3166 Alpha-2-Ländercode, ein Punkt, gefolgt von bis zu 128 alphanumerischen Zeichen.
• Es ist für jedes Business-Portfolio und jedes Benutzerpaar eindeutig und wird neu generiert, wenn der Benutzer seine Telefonnummer ändert.
• Seit Juli 2026 können Sie Nachrichten an eine BSUID senden, mit Ausnahme von One-Tap-, Zero-Tap- und Copy-Code-Authentifizierungsvorlagen, die weiterhin die Telefonnummer benötigen.
• Meta besagt, dass Partner und direkt integrierte Unternehmen BSUIDs unterstützen müssen, um nicht die Fähigkeit zu verlieren, Nachrichten von Benutzern mit Benutzernamen zu verarbeiten.
• Behalten Sie die verifizierte E.164-Telefonnummer als Identitätsanker für OTP, SMS-Fallback und Betrugsprüfungen bei. Behandeln Sie die BSUID als einen WhatsApp-Kanal-Schlüssel.

Was ist eine geschäftsbereichsspezifische Benutzer-ID?

Meta definiert eine BSUID als "eine eindeutige Benutzerkennung, die verwendet werden kann, um einem WhatsApp-Benutzer eine Nachricht zu senden, wenn Sie dessen Telefonnummer nicht kennen" (Meta, geschäftsbereichsspezifische Benutzer-IDs). Das Format ist das Land des Benutzers als ISO 3166 Alpha-2-Code, ein Punkt und bis zu 128 alphanumerische Zeichen, zum Beispiel US.13491208655302741918.

Drei Eigenschaften sind für das Systemdesign wichtig:

• Geltungsbereich. Eine BSUID ist eindeutig für ein Business-Portfolio und einen Benutzer. Dieselbe Person hat für jedes Business-Portfolio, mit dem sie kommuniziert, eine andere BSUID, sodass Sie diese nicht verwenden können, um Kunden über nicht verwandte Portfolios hinweg abzugleichen.
• Stabilität. Sie wird regeneriert, wenn der Benutzer seine Telefonnummer ändert. Meta sendet in diesem Fall einen Systemnachrichten-Webhook vom Typ user_changed_user_id und einen separaten user_id_update-Webhook.
• Übergeordnete BSUIDs. Verwaltete Unternehmen mit mehreren Portfolios können ihren Meta-Ansprechpartner bitten, sich für übergeordnete BSUIDs anzumelden, die ENT (zum Beispiel US.ENT.11815799212886844830) enthalten und über alle angemeldeten Portfolios hinweg funktionieren.

Warum führt WhatsApp Benutzernamen ein?

Zum Schutz der Privatsphäre. Meta gab am 29. Juni 2026 bekannt, dass Personen einen Benutzernamen reservieren können, um ihn "später in diesem Jahr" zu verwenden, und dass eine Person oder ein Unternehmen, das man zum ersten Mal anschreibt, die Telefonnummer des Benutzers nicht mehr sieht, sobald dieser einen aktiviert hat (Über Meta). Die Entwicklerdokumentation von Meta besagt, dass die Benutzernamen im Jahr 2026 schrittweise eingeführt werden.

Unternehmen können ebenfalls Benutzernamen haben. Ab dem 29. Juni 2026 kann ein Unternehmen einen Benutzernamen beanspruchen, den WhatsApp für es über WhatsApp Manager, Meta Business Suite oder Username API reserviert hat, und genehmigte Benutzernamen werden bei der Einführung der Funktion aktiv. Ein Unternehmens-Benutzername verbirgt die Telefonnummer des Unternehmens nicht.

Wie sieht der Zeitplan aus?

Werden Sie die Telefonnummer des Kunden verlieren?

Manchmal. Der BSUID erscheint in allen Nachrichten-Webhooks. Die Telefonnummer (wa_id und from bei eingehenden Nachrichten) wird nur dann enthalten, wenn gemäß Meta mindestens eine der folgenden Bedingungen erfüllt ist:

• Sie haben die Telefonnummer des Nutzers innerhalb der 30 Tage vor der Auslösung des Webhooks kontaktiert oder angerufen;
• Sie haben innerhalb dieser 30 Tage eine Nachricht oder einen Anruf von der Telefonnummer des Benutzers erhalten; oder
• der Benutzer befindet sich in Ihrem Kontaktbuch.

Der 30-Tage-Rückblick wird pro geschäftlicher Telefonnummer ausgewertet, sodass ein Kunde, der Ihrer Vertriebsleitung bekannt ist, Ihrer Support-Leitung unbekannt sein kann. Das Kontaktbuch ist eine von Meta gehostete Funktion, die Telefonnummern und BSUIDs nach einer ersten Interaktion speichert, sodass spätere Webhooks die Nummer auch dann weitergeben können, wenn der Benutzer einen Benutzernamen annimmt. Es ist standardmäßig aktiviert und kann in Meta Business Suite unter Business-Einstellungen, Business-Info, deaktiviert werden. Lassen Sie es aktiviert, es sei denn, Sie haben einen Grund, dies nicht zu tun.

Was benötigt weiterhin eine Telefonnummer?

Meta ist explizit: BSUIDs "können verwendet werden, um jeden Typ von Nachricht zu senden, außer One-Tap-, Zero-Tap- und Copy-Code-Authentifizierungsvorlagen, die Telefonnummern von Benutzern erfordern". Außerhalb von WhatsApp benötigt alles, was im Mobilfunknetz läuft, ebenfalls die Nummer.

Wie sieht der Webhook vorher und nachher aus?

Vor BSUIDs enthielt der Contacts-Block in einem Messages-Webhook die Telefonnummer in wa_id, und die meisten Integrationen verwendeten sie als Kunden-Key. Das Beispiel von Meta für das neue Contacts-Objekt fügt den Benutzernamen, die BSUID und, sofern aktiviert, die übergeordnete BSUID hinzu; wa_id ist nur vorhanden, wenn die Nummer geteilt werden kann:

1"contacts": [
2  {
3    "profile": {
4      "name": "<USER_DISPLAY_NAME>",
5      "username": "<USERNAME>"
6    },
7    "wa_id": "<USER_PHONE_NUMBER>",
8    "user_id": "<BSUID>",
9    "parent_user_id": "<PARENT_BSUID>"
10  }
11]

Eingehende Nachrichten enthalten ebenfalls from_user_id (und from_parent_user_id, falls aktiviert), und Status-Webhooks enthalten recipient_user_id, was Meta zufolge immer auf die BSUID des Benutzers gesetzt wird. Um zu senden, setzen Sie den BSUID in den neuen recipient-Parameter. Sie können den Parameter to (Telefonnummer), den Parameter recipient (BSUID) oder beide setzen; sind beide vorhanden, hat die Telefonnummer Vorrang:

1{
2  "messaging_product": "whatsapp",
3  "recipient_type": "individual",
4  "recipient": "<BSUID>",
5  "type": "text",
6  "text": {
7    "body": "<BODY_TEXT>"
8  }
9}

Die Sende-Antwort enthält dann user_id in ihrem Contacts-Array, und wa_id wird optional. Wenn Ihr Parser davon ausgeht, dass wa_id immer vorhanden ist, wird er beim ersten Benutzer mit Benutzernamen fehlschlagen. Sie können echte Payloads in unseren Webhook-Payload-Inspektor kopieren, um zu prüfen, welche Felder Ihre Integration tatsächlich erhält.

Was bricht für OTP?

Authentifizierungsvorlagen mit One-Tap-, Zero-Tap- oder Copy-Code-Buttons können nicht an eine BSUID gesendet werden. Wenn ein Benutzer mit Benutzernamen Sie über WhatsApp erreicht und Sie keine Telefonnummer für ihn haben, können Sie ihm keine WhatsApp OTP dieser Arten senden. Das hat zwei Konsequenzen für Verifizierungsabläufe:

• Erfassen und verifizieren Sie die Telefonnummer bei der Anmeldung im E.164-Format und speichern Sie sie als die Verifizierungsadresse des Kontos. Verlassen Sie sich nicht darauf, dass der WhatsApp-Webhook sie Ihnen später übermittelt. Siehe was E.164 ist.
• Behalten Sie einen Kanal bei, der direkt über die Nummer funktioniert. SMS OTP, Voice OTP und stille Netzwerkprüfungen laufen alle über die Telefonnummer, weshalb ein Multichannel-Design mit automatischem Fallback diese Änderung unverändert übersteht. Unser Multichannel-OTP-Leitfaden und das BroadNet OTP-Produkt behandeln dieses Muster.

Was bricht für CRM und Kundendeduplizierung?

Die meisten CRMs verwenden die Telefonnummer als Schlüssel für einen WhatsApp-Kontakt, da SMS, Voice und WhatsApp dies früher alle gemeinsam genutzt haben. Nach der Einführung von Benutzernamen kann ein neuer eingehender Kontakt möglicherweise nur mit einer BSUID eintreffen. Wenn Sie dafür einen neuen CRM-Datensatz erstellen, werden Sie allmählich Kunden duplizieren. Vier Regeln halten die Daten sauber:

1. 1Modellieren Sie die BSUID als Kanalidentität, nicht als Kunden-ID. Ein Kunde kann mehrere BSUID besitzen (einen pro Business-Portfolio) und ein neues nach einer Nummeränderung.
2. 2Führen Sie eine Mapping-Tabelle für BSUID, Portfolio, Telefonnummer (sofern bekannt), Erstsichtigkeit und Letztsichtigkeit, und aktualisieren Sie diese bei jedem Webhook, einschließlich user_id_update.
3. 3Zusammenführen auf Basis von Belegen, nicht auf Basis von Vermutungen: eine verifizierte Telefonnummer, ein Login oder eine Bestellreferenz, die der Kunde im Chat angibt.
4. 4Behandeln Sie das Fehlen von wa_id niemals als neuen Kunden. Es bedeutet lediglich, dass die Nummer bei diesem Ereignis nicht geteilt werden kann.

Wie migrieren Sie? Eine Schritt-für-Schritt-Checkliste

1. 1Aktualisieren Sie Webhook-Parser, um user_id, from_user_id, recipient_user_id und Benutzername zu lesen und um wa_id und from als optional zu behandeln.
2. 2Fügen Sie eine BSUID-Spalte hinzu (und die übergeordnete BSUID, falls Sie ein Managed Business sind), überall dort, wo Sie WhatsApp-Kontakte speichern.
3. 3Backfill: Verknüpfen Sie für jedes eingehende Ereignis seit Anfang April 2026 die BSUID mit der Telefonnummer, die Sie bereits besitzen.
4. 4Behandeln Sie die user_changed_user_id-Systemnachricht und den user_id_update-Webhook, indem Sie die neue BSUID erneut mit dem Kunden verknüpfen.
5. 5Fügen Sie den recipient-Parameter zu Ihrem Sendepfad hinzu und nutzen Sie ihn als Fallback, wenn Sie keine Telefonnummer haben.
6. 6Leiten Sie OTP an die Telefonnummer weiter, niemals an eine BSUID, und behalten Sie SMS oder Voice als Fallback-Kanal bei.
7. 7Reservieren Sie Ihren Business-Benutzernamen in WhatsApp Manager, Meta Business Suite oder über Username API.
8. 8Testen Sie mit einem Benutzernamen-aktivierten Konto, bevor Benutzernamen Ihre Kunden erreichen.

Wenn BroadNet Ihr WhatsApp-Anbieter ist, fordern Sie Testzugang an und bestätigen Sie, wie die BSUID-Felder in den Webhooks für Ihr Konto erscheinen, bevor Sie den Produktionscode ändern. Unser Entwickler-Hub und die WhatsApp Business API Seite enthalten die Details, und das Omnichannel-Routing übernimmt den SMS-Fallback, von dem Authentifizierungsabläufe nun abhängen.

Häufig gestellte Fragen

Was ist ein WhatsApp BSUID?

Eine geschäftsbereichsbezogene Benutzer-ID: ein Identifikator, den Meta jedem WhatsApp-Benutzer für jedes Business-Portfolio zuweist, sodass das Unternehmen dem Benutzer eine Nachricht senden kann, ohne dessen Telefonnummer zu kennen. Er erscheint als user_id in Webhooks.

Wie sieht ein BSUID aus?

Ein ISO 3166 Alpha-2-Ländercode, ein Punkt, dann bis zu 128 alphanumerische Zeichen, zum Beispiel US.13491208655302741918. Übergeordnete BSUIDs für verwaltete Unternehmen beinhalten ENT, zum Beispiel US.ENT.11815799212886844830.

Verliere ich die Telefonnummer des Kunden, wenn er einen Benutzernamen übernimmt?

Nur in einigen Webhooks. Die Nummer wird weiterhin enthalten, wenn Sie in den letzten 30 Tagen eine Nachricht oder einen Anruf mit dieser Nummer ausgetauscht haben oder wenn der Benutzer in Ihrem Kontaktbuch steht. Andernfalls wird wa_id weggelassen und Sie erhalten nur den BSUID.

Kann ich Nachrichten an einen BSUID senden?

Ja, seit Juli 2026, unter Verwendung des recipient-Parameters des Senden-API. Jeder Nachrichtentyp funktioniert, außer One-Tap-, Zero-Tap- und Copy-Code-Authentifizierungsvorlagen, die die Telefonnummer des Benutzers erfordern.

Kann ich Authentifizierungsvorlagen (OTP) an einen BSUID senden?

Nein. One-tap-, Zero-tap- und Copy-code-Authentifizierungsvorlagen erfordern die Telefonnummer. Behalten Sie für jedes Konto eine verifizierte Telefonnummer und nutzen Sie SMS oder Voice OTP als Fallback.

Funktionieren BSUIDs über Business-Portfolios hinweg?

Nein. Ein BSUID ist eindeutig für ein Business-Portfolio und ein Benutzerpaar. Verwaltete Unternehmen können Meta nach übergeordneten BSUIDs fragen, die über die gemeinsam angemeldeten Portfolios hinweg funktionieren.

Ändert sich ein BSUID jemals?

Ja. Es wird neu generiert, wenn der Benutzer seine Telefonnummer ändert, und Meta signalisiert dies mit einer user_changed_user_id-Systemnachricht und einem user_id_update-Webhook.

Wie reserviere ich meinen Business-Benutzernamen?

Seit dem 29. Juni 2026 über WhatsApp Manager, Meta Business Suite oder den Username API. Ein genehmigter Benutzername wird aktiv, wenn die Benutzername-Funktion startet, und er verbirgt Ihre Business-Telefonnummer nicht.

Quellen

• Meta für Entwickler, Business-bezogene Benutzer-IDs (Format, Zeitplan, Webhook-Felder, Kontaktbuch, Send-Parameter, Authentifizierungsvorlagen-Ausnahme), abgerufen am 26. September 2026.
• Über Meta, Es ist Zeit, Ihren WhatsApp-Benutzernamen zu reservieren, 29. Juni 2026, abgerufen am 26. September 2026.