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

# Riservate il vostro username WhatsApp Business

> Riservate il vostro username WhatsApp Business in WhatsApp Manager prima di altri: requisiti, passaggi, regole, errori e impatto su Flowella.

WhatsApp sta introducendo gli **username**. Invece di un numero di telefono, la vostra azienda riceve un handle come `@yourbrand` che i clienti possono digitare in WhatsApp per avviare una conversazione. Le prenotazioni degli username aziendali sono state aperte il **29 giugno 2026** e la funzionalità viene attivata paese per paese nei mesi successivi. Gli username vengono assegnati in ordine di arrivo, quindi questa pagina vi guida nella prenotazione del vostro sulla WhatsApp Business Platform fin da ora, anche se la funzionalità non è ancora attiva nel vostro paese.

Questa guida copre solo il percorso della **WhatsApp Business Platform**, che è quello in cui vi trovate se WhatsApp funziona tramite Flowella o qualsiasi altro sistema anziché tramite l'app WhatsApp Business su un telefono.

> [!NOTE]
>
> **Ultima verifica il 13 settembre 2026** rispetto al Centro assistenza WhatsApp e alla documentazione per sviluppatori di Meta. Meta sta ancora completando il rilascio, quindi consultate le [fonti](#sources) se qualcosa sullo schermo non corrisponde.

## Perché riservarlo ora

* **Gli username sono unici e assegnati in ordine di arrivo.** Una volta che un handle viene preso da un qualsiasi account WhatsApp, consumer o aziendale, nessun altro può usarlo.
* **Gli handle corrispondenti di Facebook e Instagram sono riservati ai loro proprietari, ma solo per un periodo limitato.** Meta riserva lo username che usate già sulla vostra Pagina Facebook o sul vostro account Instagram, così potete rivendicarlo su WhatsApp. WhatsApp indica che esiste un periodo limitato per farlo e non ha pubblicato una data di scadenza. Dopo quel periodo, non c'è garanzia che l'handle sia ancora disponibile.
* **Non costa nulla.** Riservare uno username non prevede alcuna tariffa e potete modificarlo o eliminarlo in seguito.
* **Protegge il vostro marchio anche se non avete ancora progetti su WhatsApp.** Uno username riservato è associato al vostro numero di telefono e non può essere rivendicato da nessun altro.

## Cosa fa uno username aziendale e cosa non fa

Uno username aziendale permette ai clienti di contattarvi **senza bisogno del vostro numero di telefono**. Una volta attivo, i clienti che non hanno salvato il vostro numero vedono il vostro username al posto del numero nelle chat, nei gruppi e nelle chiamate.

È bene chiarirne i limiti:

* **Non nasconde il numero di telefono aziendale.** Il vostro numero resta sul profilo aziendale. La documentazione di Meta afferma esplicitamente che gli username aziendali non sono una funzionalità per la privacy: a questo servono gli username dei consumatori.
* **Non esiste una directory.** Nessuno può sfogliare o cercare la vostra azienda. I clienti devono digitare il vostro username esatto, quindi inseritelo sul sito web, sulla segnaletica, nelle firme email e sui profili social non appena è attivo.
* **Uno username per numero di telefono.** Se il vostro WhatsApp Business Account ha più numeri, ognuno ha bisogno del proprio username.
* **Lo username è separato dal nome visualizzato.** Il nome visualizzato passa comunque per la revisione di Meta e continua a essere mostrato ai clienti. Consultate [Nome visualizzato e profilo](https://knowledge.flowella.io/it/whatsapp/accounts/profile-setup.md).

### Come viene mostrato il vostro nome in una chat

Meta mostra l'identità dell'azienda secondo questo ordine di priorità. Il primo elemento applicabile è quello che vede il cliente.

1. Il nome con cui il cliente vi ha salvato nei suoi contatti
2. Il vostro nome aziendale verificato, o il nome dell'Official Business Account
3. Il vostro username
4. Il vostro numero di telefono

Quindi, una volta che Meta approva il vostro nome visualizzato, i clienti che non hanno salvato il vostro numero vedono quel nome anziché il vostro username. Consultate [Nomi visualizzati](https://knowledge.flowella.io/it/whatsapp/accounts/display-names.md#how-meta-reviews-a-name).

## Prima di iniziare

Vi servono tutti i seguenti elementi. Se ne manca qualcuno, seguite prima la [Sequenza di configurazione](https://knowledge.flowella.io/it/whatsapp/accounts/setup-sequence.md).

**1. Un portfolio aziendale Meta con un WhatsApp Business Account**

Lo username viene impostato su un numero di telefono che appartiene a un WhatsApp Business Account (WABA) all'interno del vostro portfolio. Consultate [Portfolio aziendale](https://knowledge.flowella.io/it/whatsapp/accounts/business-portfolio.md) e [WhatsApp Business Account](https://knowledge.flowella.io/it/whatsapp/accounts/whatsapp-business-account.md).

**2. Un numero di telefono registrato sulla Platform**

Il numero deve essere registrato per l'uso tramite API sul WABA. Un numero aggiunto ma non ancora registrato restituisce l'errore `133010` quando provate a impostare uno username. Consultate [Numeri di telefono](https://knowledge.flowella.io/it/whatsapp/accounts/phone-numbers.md).

**3. Un limite di messaggistica superiore al livello iniziale**

Meta richiede che il portfolio aziendale abbia un **limite di messaggistica più alto** di quello con cui parte ogni nuovo portfolio (250 destinatari unici in un periodo mobile di 24 ore). In caso contrario, WhatsApp Manager mostra **Account not eligible** e l'API restituisce l'errore `147002`. Il modo più rapido per superare questo ostacolo è completare la [verifica dell'azienda](https://knowledge.flowella.io/it/whatsapp/accounts/business-verification.md), dopo la quale Meta può aumentare il limite a 2.000. Funziona anche inviare 2.000 messaggi di alta qualità a destinatari unici in 30 giorni, ma richiede più tempo. Consultate [Limiti di messaggistica](https://knowledge.flowella.io/it/whatsapp/limits/messaging-limits.md).

**4. Le autorizzazioni corrette**

Per impostare uno username vi serve un accesso di livello amministratore al WABA o al numero di telefono. Se volete rivendicare un handle già in uso sulla vostra Pagina Facebook o sul vostro account Instagram, vi serve anche il **full control** di quella Pagina o di quell'account, oppure un **partial access con l'autorizzazione manage phone**, perché Meta richiede di collegare prima il numero di telefono.

> [!TIP]
>
> Se non siete sicuri di quale sia il vostro limite di messaggistica, aprite **WhatsApp Manager → Account tools → Messaging limits**. Qualsiasi valore superiore a 250 è sufficiente.

## Riservate il vostro username in WhatsApp Manager

Questo è il percorso consigliato.

**1. Aprite WhatsApp Manager**

Andate su [business.facebook.com/latest/whatsapp\_manager/phone\_numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers/) e, se richiesto, selezionate il portfolio aziendale che possiede il vostro WABA.

**2. Selezionate il numero di telefono**

Nel menu a sinistra, in **Account tools**, fate clic su **Phone numbers**, poi sul numero a cui volete assegnare uno username. Il pannello dei dettagli del numero si apre a destra.

**3. Aprite la scheda Profile**

Nella parte superiore del pannello dei dettagli, fate clic su **Profile**. Scorrete oltre **Profile picture** e **Display name** fino alla sezione **Username**.

**4. Fate clic su Create (o Edit)**

Se il numero non ha ancora uno username, fate clic su **Create**. Se ne esiste già uno, fate clic su **Edit**. Si apre la finestra di dialogo **Edit username**.

**5. Scegliete un suggerimento o digitate il vostro**

La finestra mostra una riga **Suggested**. Sono gli username che Meta ha già riservato per la vostra azienda in base alla vostra Pagina Facebook, al vostro account Instagram e al dominio del vostro sito web, e hanno maggiori probabilità di approvazione. Fate clic su uno di essi oppure digitate il vostro handle nel campo. Un segno di spunta verde indica che è disponibile; **This username is not available** indica che è già preso o non supera i controlli di Meta.

**6. Salvate**

Fate clic su **Save**. La sezione Username ora mostra **Current username: @yourhandle** con un badge di stato e la data dell'aggiornamento.

> [!WARNING]
>
> Se avete scelto un handle in uso sulla vostra Pagina Facebook o sul vostro account Instagram, Meta vi chiederà di **collegare il numero di telefono** a quella Pagina o a quell'account prima di salvare. Potete farlo dalla stessa finestra di dialogo oppure aggiungendo direttamente il numero WhatsApp alla Pagina o all'account Instagram. Senza il collegamento la richiesta non va a buon fine con l'errore `147003` (Facebook) o `147004` (Instagram).

### Cosa significa il badge di stato

| Badge | Significato |
| - | - |
| **Reserved** | Approvato e riservato al vostro numero di telefono, ma non ancora visibile agli utenti WhatsApp. Diventa attivo automaticamente quando Meta rende disponibili gli username nel vostro paese. Nel frattempo nessuno può rivendicarlo. |
| **Approved** | Attivo e visibile. I clienti che non hanno salvato il vostro numero vedono lo username e possono avviare una chat digitandolo. |

WhatsApp invia una notifica quando uno username riservato diventa attivo. Non dovete fare nulla.

## Altri modi per riservarlo

> [accordion] Meta Business Suite
>
> Andate su **Settings → Accounts → WhatsApp accounts**, aprite la scheda **Phone numbers**, fate clic sul numero, scorrete fino a **Username** e fate clic su **Create**. È la stessa finestra di dialogo di WhatsApp Manager.

> [accordion] API Username
>
> Per sviluppatori e solution provider, Meta espone lo username sul numero di telefono aziendale. Il token di accesso deve avere l'autorizzazione `whatsapp_business_management` con Full control o Partial access ai numeri di telefono del WABA.
>
> Impostare o modificare uno username:
>
> ```bash theme={null}
> curl -X POST "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username" \
>   -H "Content-Type: application/json" \
>   -H "Authorization: Bearer <ACCESS_TOKEN>" \
>   -d '{ "username": "yourbrand" }'
> ```
>
> Una risposta positiva restituisce `{ "status": "reserved" }` o `{ "status": "approved" }`.
>
> Elencare gli username che Meta ha riservato per il vostro portfolio:
>
> ```bash theme={null}
> curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username_suggestions" \
>   -H "Authorization: Bearer <ACCESS_TOKEN>"
> ```
>
> Leggete lo username attuale e il suo stato con `GET .../username` e rimuovetelo con `DELETE .../username`. Il riferimento completo è nella documentazione [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) di Meta.

## Regole per gli username

* Da 3 a 35 caratteri
* Solo lettere inglesi (dalla a alla z), cifre (da 0 a 9), punti (.) e trattini bassi (\_); i caratteri accentati come ñ, é o ü vengono rifiutati
* Almeno una lettera; uno username non può essere composto solo da numeri
* Nessun punto all'inizio o alla fine e nessun doppio punto consecutivo
* Non può iniziare con `www.`
* Non può terminare con un'estensione di dominio elencata come `.com`, `.org`, `.net`, `.edu`, `.gov` o `.html`
* Le maiuscole e minuscole vengono ignorate nel controllo di unicità, ma punti e trattini bassi no: `myid`, `my.id` e `my_id` sono tre username diversi
* Alcuni username sono riservati da Meta ad aziende, enti governativi e personaggi pubblici e non possono essere rivendicati

## Errori che potreste vedere

| Errore | Cosa significa | Cosa fare |
| - | - | - |
| **Account not eligible** / `147002` | Il portfolio aziendale è ancora al limite di messaggistica iniziale. | Completate la [verifica dell'azienda](https://knowledge.flowella.io/it/whatsapp/accounts/business-verification.md), oppure attendete di aver superato i 250 grazie al volume di invii, poi riprovate. |
| **This username is not available** / `147001` | L'handle è già preso, non supera i controlli interni di Meta o è riservato a qualcun altro. | Scegliete un handle diverso. Se è il vostro marchio registrato e lo detiene qualcun altro, consultate le [domande frequenti](#faq) qui sotto. |
| **FB account not linked** / `147003` | L'handle è in uso su una Pagina Facebook che non avete collegato a questo numero di telefono. | Collegate il numero di telefono alla Pagina (full control, oppure partial access con manage phone), poi riprovate. |
| **IG account not linked** / `147004` | L'handle è in uso su un account Instagram che non avete collegato a questo numero di telefono. | Collegate il numero di telefono all'account Instagram, poi riprovate. |
| **Username transfer required** / `147005` | L'handle è già su un altro numero di telefono del vostro portfolio. | Spostatelo: nell'API, inviate di nuovo la richiesta con `"transfer_action": "force_transfer"`. |
| **Account not registered** / `133010` | Il numero di telefono non è stato registrato per l'uso tramite API. | Completate la registrazione del numero sul WABA, poi riprovate. |
| `100` Param invalid | L'handle viola le regole di formato. | Controllate le [regole](#username-rules) qui sopra. |

## Modificare, spostare o eliminare uno username

* Potete **modificare** il vostro username dalla stessa finestra Edit. Esiste un limite al numero di modifiche possibili e, una volta rilasciato un handle, potrebbe diventare disponibile per altri.
* Sulla Platform uno username può essere **trasferito tra numeri di telefono dello stesso portfolio aziendale**, ad esempio da un numero di test a un numero di produzione, o quando consolidate i numeri. L'handle resta invariato.
* **Delete** rimuove lo username dal numero. Fatelo solo se ne siete sicuri: l'handle torna disponibile per tutti.

## Quando i clienti nascondono i loro numeri

Gli username dei consumatori sono una funzionalità per la privacy. Quando un cliente ne adotta uno, il suo numero di telefono viene **nascosto a chiunque non lo abbia già salvato**, aziende comprese. Questa è la parte del rilascio che conta per tutto ciò che è collegato a un CRM.

La risposta di Meta è il **business-scoped user ID (BSUID)**, un identificatore stabile per ogni cliente, univoco per la vostra azienda. Da aprile 2026 compare in ogni webhook in entrata. Per un cliente con uno username, Meta include anche il numero di telefono solo quando si verifica una di queste condizioni: quel numero aziendale ha scambiato un messaggio o una chiamata con il cliente negli ultimi 30 giorni, il cliente è nella vostra rubrica Meta, oppure il cliente ha condiviso i propri dati di contatto. Altrimenti Meta invia solo il BSUID. Meta offre anche un pulsante **Request contact info** che chiede al cliente di condividere il proprio numero nella chat, ma l'editor dei template di Flowella non offre questo pulsante.

Cosa significa per Flowella:

* **Flowella identifica ogni contatto tramite il numero di telefono.** Se Meta invia il messaggio di un cliente senza il suo numero di telefono, Flowella non può associarlo a un contatto e il messaggio non compare in Flowella né arriva a HubSpot.
* **Le conversazioni in corso continuano a funzionare.** Meta include il numero per i clienti che hanno scritto a quel numero aziendale, o hanno ricevuto da esso un messaggio o una chiamata, negli ultimi 30 giorni.
* **Chiedete il numero quando vi serve.** Quando un processo dipende dal numero, ad esempio una spedizione o una richiamata, chiedetelo nella conversazione anziché dare per scontato che arrivi con ogni messaggio.

Per tutti gli identificativi, per sapere quando Meta include il numero di telefono e come funziona il contact book, consultate [Identificativi degli utenti](https://knowledge.flowella.io/it/whatsapp/messaging/user-identifiers.md).

## Domande frequenti

> [accordion] Qualcuno ha preso il mio marchio come username. Cosa posso fare?
>
> Meta prevede due percorsi. Per i casi di impersonificazione, usate il canale **Report Abuse** in Meta Direct Support. Per la violazione del marchio, usate il modulo di contatto per la proprietà intellettuale di WhatsApp. Avere la Pagina Facebook e l'account Instagram collegati al numero e la verifica dell'azienda completata rafforza la vostra richiesta.

> [accordion] Mi serve la spunta blu (Official Business Account) per ottenere uno username?
>
> No. Il badge Official Business Account è una richiesta separata nella stessa scheda Profile e non è obbligatorio. Gli username richiedono la condizione sul limite di messaggistica indicata sopra, non la spunta blu.

> [accordion] Sono Meta Verified con un indirizzo web personalizzato. Devo fare qualcosa?
>
> WhatsApp indica che, per le aziende Meta Verified con un indirizzo di pagina web personalizzato, lo username aziendale corrisponde automaticamente a quell'indirizzo ed è già riservato. Controllate la sezione Username in WhatsApp Manager per conferma.

> [accordion] Uso l'app WhatsApp Business su un telefono, non la Platform
>
> Questa pagina non tratta l'app. Nell'app, gli username si riservano dal profilo aziendale sul telefono (non da WhatsApp Web) e non serve la verifica dell'azienda. Se usate l'app insieme a Flowella, consultate [Coesistenza](https://knowledge.flowella.io/it/whatsapp/accounts/co-existence.md).

> [accordion] Il mio username funzionerà con gli entry point di Flowella e i link click-to-chat?
>
> Sì. I link tracciati e i codici QR di Flowella (entry point, in accesso anticipato) aprono una chat con il vostro numero di telefono aziendale, quindi uno username non li modifica. Una volta attivo il vostro username, potete anche condividerlo ovunque condividete il vostro numero. Consultate [Entry point](https://knowledge.flowella.io/it/app/entry-points.md) e [Click-to-chat](https://knowledge.flowella.io/it/campaigns/click-to-chat.md).

## Fonti

* Centro assistenza WhatsApp: [About usernames on WhatsApp Business](https://faq.whatsapp.com/1131753190029163/)
* Centro assistenza WhatsApp: *About username reservations on WhatsApp Business*, collegato dall'articolo precedente
* Meta for Developers: [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) (username riservati, API Username, codici di errore, regole di formato, priorità di visualizzazione)
* Meta for Developers: [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)

## Pagine correlate

> [card] [Verifica dell'azienda](https://knowledge.flowella.io/it/whatsapp/accounts/business-verification.md)
>
> Il modo più rapido per superare "Account not eligible".

> [card] [Limiti di messaggistica](https://knowledge.flowella.io/it/whatsapp/limits/messaging-limits.md)
>
> Come funziona il livello iniziale e come superarlo.

> [card] [Nome visualizzato e profilo](https://knowledge.flowella.io/it/whatsapp/accounts/profile-setup.md)
>
> Il nome che i clienti vedono al posto del vostro username.

> [card] [Sequenza di configurazione](https://knowledge.flowella.io/it/whatsapp/accounts/setup-sequence.md)
>
> Tutto ciò che deve essere pronto prima di questo passaggio.


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