> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp-Nutzer-IDs: Telefonnummern, BSUIDs, Nutzernamen

> Wie WhatsApp Kunden per Telefonnummer, wa_id, BSUID und Nutzername erkennt, wann Meta die Telefonnummer weglässt und was Flowella braucht.

WhatsApp erkennt jeden Kunden inzwischen auf bis zu vier Arten: an seiner **Telefonnummer**, seiner **WhatsApp-ID** (`wa_id`, meist die Nummer ohne Pluszeichen), einer **unternehmensbezogenen Nutzer-ID** (BSUID), die für Ihr Unternehmen eindeutig ist, und einem optionalen **Nutzernamen**. Je mehr Kunden Nutzernamen verwenden, desto häufiger sendet Meta die Telefonnummern mancher Kunden nicht mehr an Unternehmen. Die BSUID ist dann die einzige Kennung, die Sie erhalten. Alles, was auf Telefonnummern basiert, muss also auch ohne sie funktionieren.

> [!NOTE]
>
> **In Flowella.** Teilweise unterstützt. Flowella erkennt jeden Kontakt an der Telefonnummer und sendet nur an Telefonnummern. Sendet Meta die Nachricht eines Kunden ohne Telefonnummer, kann Flowella sie keinem Kontakt zuordnen. Die Nachricht erscheint dann nicht in Flowella und gelangt nicht zu HubSpot. Die meisten Kunden sind noch nicht betroffen: Meta liefert die Nummer weiterhin für alle, mit denen Sie kürzlich in Kontakt waren.

## Die vier Kennungen

| Kennung | Feld in den Daten von Meta | Geltungsbereich | Hinweise |
| - | - | - | - |
| Telefonnummer | `wa_id`, `from` | Global | Kann bei Kunden mit Nutzernamen fehlen |
| Unternehmensbezogene Nutzer-ID | `user_id` | Ein Business portfolio | Seit April 2026 in Nachrichten immer vorhanden, für jeden Kunden |
| Parent BSUID | `parent_user_id` | Mehrere Portfolios, die Meta zusammengeschlossen hat | Nur für große Unternehmen mit mehreren Portfolios, auf Anfrage |
| Nutzername | `username` | Global | Optional. Kunden können ihn ändern. Wird in WhatsApp statt der Telefonnummer angezeigt. |

### So sieht eine BSUID aus

Eine BSUID beginnt mit dem zweistelligen Ländercode des Kunden und einem Punkt, gefolgt von bis zu 128 Buchstaben und Ziffern, zum Beispiel `GB.13491208655302741918`. Eine Parent BSUID hat `ENT` nach dem Ländercode, zum Beispiel `GB.ENT.11815799212886844830`. Verwenden Sie immer den vollständigen Wert.

* Sie gehört zu einem **Business portfolio**. Jede Nummer dieses Portfolios kann ihr schreiben, eine Nummer in einem anderen Portfolio jedoch nicht.
* Sie wird automatisch erstellt und ändert sich nicht, wenn der Kunde seinen Nutzernamen ändert.
* Sie **ändert sich**, wenn der Kunde seine Telefonnummer ändert. Meta sendet dann eine Systemnachricht.

## Wann Meta die Telefonnummer weglässt

Bei einem Kunden, der einen Nutzernamen verwendet, ist die Nummer verborgen. Meta liefert sie trotzdem in Ihren Webhooks, wenn eine dieser Bedingungen zutrifft:

| Bedingung | Geltungsbereich |
| - | - |
| Diese Unternehmensnummer hat der Nummer des Kunden in den letzten 30 Tagen geschrieben oder sie angerufen | Jede Unternehmensnummer einzeln |
| Diese Unternehmensnummer hat in den letzten 30 Tagen eine Nachricht oder einen Anruf von der Nummer des Kunden erhalten | Jede Unternehmensnummer einzeln |
| Der Kunde steht im **Adressbuch** Ihres Business portfolio | Jede Nummer im Portfolio |
| Der Kunde hat Ihnen seine Nummer mitgeteilt, etwa über eine Schaltfläche zum Anfragen der Kontaktdaten | Ab diesem Zeitpunkt, über das Adressbuch |

Kunden ohne Nutzernamen kommen immer mit ihrer Telefonnummer an.

### Das Adressbuch

Meta führt für jedes Business portfolio ein Adressbuch. Wenn eine Ihrer Nummern der Telefonnummer eines Kunden schreibt, sie anruft oder von ihr kontaktiert wird, speichert Meta die Nummer zusammen mit der BSUID und liefert die Nummer weiterhin in Ihren Webhooks. Es werden nur Kontakte ab dem Start der Funktion erfasst, keine früheren Konversationen. Sie können das Adressbuch in der Meta Business Suite unter **Business settings** > **Business info** ausschalten. Dabei wird alles, was es gespeichert hat, endgültig gelöscht.

## An eine BSUID senden

Seit Juli 2026 können Sie Nachrichten an eine BSUID statt an eine Telefonnummer senden. Enthält eine Anfrage beides, verwendet Meta die Telefonnummer. Authentication-Vorlagen mit Schaltflächen für Code kopieren, One-Tap oder Zero-Tap brauchen weiterhin die Telefonnummer. Sendungen, die keine BSUIDs unterstützen, schlagen mit dem Fehler `131062` fehl.

## Nach der Nummer fragen

Meta bietet eine Schaltfläche zum **Anfragen der Kontaktdaten** an, in Utility- und Marketingvorlagen oder in einer interaktiven Nachricht. Tippt der Kunde darauf, wird seine Telefonnummer im Chat geteilt und Ihrem Adressbuch hinzugefügt. Der Schaltflächentext lässt sich nicht ändern.

> [!NOTE]
>
> **In Flowella.** Der Vorlageneditor von Flowella bietet die Schaltfläche zum Anfragen der Kontaktdaten nicht an, und Flowella kann nicht an eine BSUID senden. Wenn ein Prozess die Nummer braucht, etwa für eine Lieferung oder einen Rückruf, fragen Sie in einem Flow oder in der Konversation danach.

## Was Sie jetzt tun sollten

* **Bleiben Sie mit Kunden in Kontakt.** Kunden, mit denen Sie in den letzten 30 Tagen Nachrichten ausgetauscht haben oder die in Ihrem Adressbuch stehen, kommen weiterhin mit ihrer Nummer an.
* **Lassen Sie das Adressbuch eingeschaltet**, damit Nummern auch nach 30 Tagen weiter ankommen.
* **Erfassen Sie die Telefonnummer in Ihren Formularen und Flows** für Prozesse, die davon abhängen.
* **Prüfen Sie Ihre eigenen Integrationen.** Alles, was Webhooks von Flowella empfängt oder Daten von Meta direkt liest, sollte nicht davon ausgehen, dass jeder Kunde eine Telefonnummer hat.

## Verwandt

> [card] [Business-Nutzername](https://knowledge.flowella.io/de/whatsapp/accounts/business-username.md)
>
> Reservieren Sie den Nutzernamen Ihres Unternehmens.

> [card] [Nachrichtentypen](https://knowledge.flowella.io/de/whatsapp/messaging/message-types.md)
>
> Was Kunden und Unternehmen senden können.

> [card] [Datenschutz und Datenstandort](https://knowledge.flowella.io/de/whatsapp/messaging/data-privacy-and-residency.md)
>
> Wie Meta Nachrichtendaten speichert.

> [card] [Plattformänderungen](https://knowledge.flowella.io/de/whatsapp/platform-changes.md)
>
> Wann Nutzernamen bei Kunden ankommen.

Abgeglichen mit der Meta-Dokumentation [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids) am 18. November 2026.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.