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 funzionalità quando te 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 è assegnato a te e fatturato, ma un paese richiede documentazione di titolarità non ancora accettata. Il campo ownership indica cosa manca ancora e quale chiamata fa avanzare il processo. Il numero gestisce le chiamate vocali e invia SMS quando status è active e, se ownership è impostato, il suo blocked_at è null. Finché blocked_at è impostato, un ownership.status pari a approval_pending o approved indica che il blocco non è ancora stato rimosso. 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.
• Gestire i tuoi numeri di telefono spiega come trovare, etichettare e rilasciare i numeri che possiedi.
• Riferimento API dei numeri documenta ogni operazione e campo.
• Idempotenza spiega come rendere sicuro un nuovo tentativo di ordine.