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

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 illustra l'intero ciclo di vita tramite API.
• Riferimento API dei numeri documenta ogni operazione e campo.
• Idempotenza spiega come rendere sicuro un ordine riprovato.