# Panoramica sui numeri

Un numero di telefono è il mittente dei tuoi messaggi e delle tue chiamate. Bird vende numeri nei paesi che copre, e un numero assegnato al tuo spazio di lavoro può trasportare SMS, MMS o voce a seconda di ciò che il numero supporta. La pagina [**Numbers**](https://bird.com/dashboard/w/numbers) nella dashboard mostra i numeri assegnati a te, e lo stesso ciclo di vita è disponibile tramite API: cerca cosa è in vendita, ordinane uno, consulta quelli che hai e rilascia quelli che non ti servono più.

## Numeri dedicati e condivisi

Ogni numero assegnato a te ha un `kind`, che determina cosa puoi fare con il numero.

Un numero `dedicated` appartiene solo al tuo spazio di lavoro. Lo hai acquistato, ti viene addebitato un canone mensile e puoi rilasciarlo quando non ti serve più. È questo che ottieni ordinando un numero.

Un numero `shared` è uno short code su infrastruttura gestita da Bird. Ti viene concesso l'uso anziché l'acquisto, quindi non c'è un canone mensile a tuo carico e non puoi rilasciarlo. Tentare di rilasciarlo restituisce un errore [`E14002`](/docs/api/errors/E14002).

## Cosa può trasportare un numero

Due campi descrivono cos'è un numero e rispondono a domande diverse.

`number_type` è il tipo fisico del numero: `mobile`, `local`, `national`, `toll_free` o uno short code. Determina come il numero si comporta sulla rete e, in diversi paesi, quale documentazione richiede.

`capabilities` è ciò che il numero può effettivamente fare: `sms`, `mms`, `voice` o una combinazione. Un numero che include `voice` può gestire chiamate; uno che non lo include, no. Filtra una ricerca per capability quando ne serve una specifica e controlla il campo prima di costruire qualcosa su un numero che hai già.

Un numero assegnato non è sempre sufficiente per inviare da esso. Alcuni paesi di destinazione richiedono anche una registrazione approvata per il mittente, che è un'approvazione separata dal numero stesso.

## Lo stato di un numero assegnato

`status` indica se un numero può trasportare traffico.

`active` significa che il numero è assegnato a te e utilizzabile.

`pending_ownership_registration` indica che il numero è allocato e fatturato, ma il paese richiede documentazione di titolarità non ancora accettata. Il campo `ownership` indica cosa manca e quale chiamata fa avanzare il processo. La maggior parte dei numeri non entra mai in questo stato, perché la maggior parte dei paesi non richiede nulla: il loro `ownership` è `null`.

`released` significa che il numero non è più assegnato a te.

## L'ordine è asincrono

Ordinare un numero crea un ordine, e l'ordine è l'oggetto che monitori. La maggior parte si completa all'interno della richiesta e restituisce il numero immediatamente. Uno che deve attendere un operatore torna ancora in esecuzione, e lo interroghi finché non raggiunge `completed` o `failed`.

Questo conta per due motivi. Un numero è tuo solo quando il suo ordine è `completed`, quindi nulla dovrebbe presumere che il numero esista prima di quel momento. E una commissione di attivazione già addebitata non viene rimborsata quando un ordine fallisce: per questo la ricerca e l'ordine sono chiamate separate. La ricerca ti dice cosa è disponibile prima che ti impegni nell'acquisto.

## Prossimi passi

- [Acquistare e rilasciare un numero](/docs/guides/numbers/buying-numbers) illustra l'intero ciclo di vita tramite API.
- [Riferimento API dei numeri](/docs/api/reference/list-available-numbers) documenta ogni operazione e campo.
- [Idempotenza](/docs/guides/idempotency) spiega come rendere sicuro un ordine riprovato.

## Related resources

- [What is a virtual phone number (VMN)?](/explained/numbers/what-is-a-virtual-phone-number) (answer)
- [SMS numbers](/sms-api/features/numbers) (product)
- [Number types](/docs/guides/numbers/number-types) (docs)

[Get an implementation brief](/learn/workspace?topic=phone-numbers)