> ## 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.

# ID utente WhatsApp: numeri di telefono, BSUID e username

> Come WhatsApp identifica i clienti tramite numero di telefono, wa_id, BSUID e username, quando Meta omette il numero e cosa serve a Flowella.

WhatsApp ora identifica ogni cliente in un massimo di quattro modi: il **numero di telefono**, il **WhatsApp ID** (`wa_id`, di solito il numero senza il segno più), un **ID utente con ambito aziendale** (BSUID) univoco per la vostra azienda e uno **username** facoltativo. Man mano che i clienti adottano gli username, Meta smette di inviare alle aziende il numero di telefono di alcuni clienti. Il BSUID diventa allora l'unico identificativo che ricevete, quindi tutto ciò che si basa sui numeri di telefono deve funzionare anche senza.

> [!NOTE]
>
> **In Flowella.** Supportato in parte. Flowella identifica ogni contatto tramite il numero di telefono e invia solo a numeri di telefono. Se Meta invia il messaggio di un cliente senza numero di telefono, Flowella non riesce ad associarlo a un contatto e il messaggio non compare in Flowella né arriva a HubSpot. La maggior parte dei clienti non è ancora interessata: Meta include ancora il numero per chiunque abbiate contattato di recente.

## I quattro identificativi

| Identificativo | Campo nei dati di Meta | Ambito | Note |
| - | - | - | - |
| Numero di telefono | `wa_id`, `from` | Globale | Può mancare per i clienti con uno username |
| ID utente con ambito aziendale | `user_id` | Un portfolio aziendale | Sempre presente nei messaggi, per ogni cliente, da aprile 2026 |
| Parent BSUID | `parent_user_id` | Più portfolio che Meta ha registrato insieme | Solo per grandi aziende con più portfolio, su richiesta |
| Username | `username` | Globale | Facoltativo. I clienti possono cambiarlo. In WhatsApp compare al posto del numero di telefono. |

### Com'è fatto un BSUID

Un BSUID inizia con il codice paese di due lettere del cliente e un punto, seguiti da un massimo di 128 lettere e numeri, ad esempio `GB.13491208655302741918`. Un parent BSUID ha `ENT` dopo il codice paese, ad esempio `GB.ENT.11815799212886844830`. Usate sempre il valore completo.

* Appartiene a un solo **portfolio aziendale**. Qualsiasi numero di quel portfolio può scrivergli, ma un numero di un altro portfolio no.
* Viene creato automaticamente e non cambia quando il cliente cambia username.
* **Cambia** quando il cliente cambia numero di telefono. In quel caso Meta invia un messaggio di sistema.

## Quando Meta omette il numero di telefono

Un cliente che adotta uno username ha il numero nascosto. Meta lo include comunque nei vostri webhook quando vale una di queste condizioni:

| Condizione | Ambito |
| - | - |
| Quel numero aziendale ha scritto o telefonato al numero del cliente negli ultimi 30 giorni | Ogni numero aziendale separatamente |
| Quel numero aziendale ha ricevuto un messaggio o una chiamata dal numero del cliente negli ultimi 30 giorni | Ogni numero aziendale separatamente |
| Il cliente è nel **contact book** del vostro portfolio aziendale | Tutti i numeri del portfolio |
| Il cliente vi ha condiviso il suo numero, ad esempio con un pulsante di richiesta dei dati di contatto | Da quel momento in poi, tramite il contact book |

I clienti senza username arrivano sempre con il loro numero di telefono.

### Il contact book

Meta tiene un contact book per ogni portfolio aziendale. Quando uno qualsiasi dei vostri numeri scrive o telefona al numero di un cliente, o riceve suoi messaggi o chiamate, Meta registra il numero insieme al BSUID e continua a includere il numero nei vostri webhook. Registra i contatti solo dall'avvio della funzione, non le conversazioni precedenti. Potete disattivarlo in Meta Business Suite da **Business settings** > **Business info**. La disattivazione elimina definitivamente tutto ciò che ha memorizzato.

## Inviare a un BSUID

Da luglio 2026 potete inviare messaggi a un BSUID invece che a un numero di telefono. Se una richiesta contiene entrambi, Meta usa il numero di telefono. I template Authentication con pulsanti copy code, one-tap o zero-tap richiedono ancora il numero di telefono. Gli invii che non supportano i BSUID falliscono con l'errore `131062`.

## Chiedere il numero

Meta offre un pulsante di **richiesta dei dati di contatto**, nei template Utility e Marketing o in un messaggio interattivo. Quando il cliente lo tocca, il suo numero di telefono viene condiviso nella chat e aggiunto al vostro contact book. Il testo del pulsante non si può modificare.

> [!NOTE]
>
> **In Flowella.** L'editor dei template di Flowella non offre il pulsante di richiesta dei dati di contatto e Flowella non può inviare a un BSUID. Quando un processo richiede il numero, come una consegna o una richiamata, chiedetelo in un Flow o nella conversazione.

## Cosa fare ora

* **Mantenete il contatto con i clienti.** I clienti con cui avete scambiato messaggi negli ultimi 30 giorni, o che sono nel vostro contact book, continuano ad arrivare con il loro numero.
* **Lasciate attivo il contact book**, così i numeri continuano ad arrivare anche dopo 30 giorni.
* **Raccogliete il numero di telefono nei vostri moduli e Flows** per i processi che ne dipendono.
* **Controllate le vostre integrazioni.** Tutto ciò che riceve i webhook di Flowella o legge direttamente i dati di Meta non deve presumere che ogni cliente abbia un numero di telefono.

## Correlati

> [card] [Username aziendale](https://knowledge.flowella.io/it/whatsapp/accounts/business-username.md)
>
> Riservate lo username della vostra azienda.

> [card] [Tipi di messaggio](https://knowledge.flowella.io/it/whatsapp/messaging/message-types.md)
>
> Cosa possono inviare clienti e aziende.

> [card] [Privacy e residenza dei dati](https://knowledge.flowella.io/it/whatsapp/messaging/data-privacy-and-residency.md)
>
> Come Meta conserva i dati dei messaggi.

> [card] [Modifiche alla piattaforma](https://knowledge.flowella.io/it/whatsapp/platform-changes.md)
>
> Quando gli username arrivano ai clienti.

Verificato rispetto alla documentazione [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids) di Meta il 18 novembre 2026.


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