Registro chiamate

Il registro chiamate in Voice > Calls elenca ogni chiamata effettuata dal tuo spazio di lavoro e ogni chiamata arrivata su uno dei suoi numeri, dalla più recente. Ogni voce è un call detail record (CDR) e include le chiamate connesse, quelle senza risposta e quelle rifiutate. Usalo per controllare la durata, la risposta SIP finale e il costo.

Bird scrive ogni record alla fine della chiamata, quindi ogni chiamata nel registro ha un esito finale. La scheda Live accanto contiene le chiamate ancora in corso.

L'elenco chiamate

Ogni riga corrisponde a una chiamata:

Colonna	Cosa mostra
Status	Come si è conclusa la chiamata (vedi Stati)
From	Il numero chiamante, il caller ID presentato dal tuo apparato
To	Il numero chiamato
Direction	Outbound per le chiamate effettuate dal tuo apparato, inbound per quelle arrivate sui tuoi numeri
Duration	Durata totale della chiamata, dal momento in cui Bird l'ha ricevuta fino al riaggancio
Started	Quando Bird ha ricevuto la chiamata

L'elenco è paginato, 25 chiamate per pagina. Seleziona una riga qualsiasi per aprire la chiamata.

Chiamate in corso

La scheda Live elenca le chiamate attive in questo momento e mostra un contatore per sapere quante ce ne sono senza doverla aprire. Una chiamata in corso ha uno di due stati:

Stato	Cosa sta succedendo
Ringing	La chiamata ha raggiunto la destinazione, che non ha ancora risposto
In progress	La destinazione ha risposto e la chiamata è connessa

Le colonne corrispondono a quelle del registro chiamate tranne Elapsed, che sostituisce Duration. Per una chiamata connessa il conteggio parte dalla risposta, per una in squillo dall'inizio. La scheda si aggiorna ogni pochi secondi. Quando una chiamata termina, passa nel registro chiamate con il suo esito finale.

Ricerca e filtri

La pagina apre con una ricerca per numero e i relativi filtri. Si combinano tra loro: un filtro per stato più un intervallo di date restringe il risultato alle chiamate che soddisfano entrambi.

Ricerca per numero. La casella di ricerca confronta un numero con entrambi i lati della chiamata, quindi una sola query trova sia le chiamate verso quel numero sia quelle da quel numero.

Direction. Filtra per chiamate outbound o inbound.

Status. Filtra per answered, no answer, failed, rejected o unknown. Ognuno è definito in Stati. Nella scheda Live le scelte sono ringing e in progress.

Date. Nel registro chiamate, scegli un intervallo predefinito (ultime 24 ore, 7 giorni o 30 giorni) oppure seleziona un intervallo personalizzato dal calendario.

Utilizzo del mese

Il riepilogo mensile contiene tre riquadri per il mese di calendario corrente in UTC:

Riquadro	Cosa conteggia
Calls	Record di chiamate completate nel mese, incluse quelle senza risposta e rifiutate
Total duration	Somma della durata completa di ogni chiamata, dal momento in cui Bird l'ha ricevuta fino al riaggancio
Billable time	Somma del tempo con risposta di ogni chiamata

La differenza tra durata totale e tempo fatturabile è il tempo di squillo senza risposta. Una chiamata senza risposta non ha tempo fatturabile.

Ogni tariffa di destinazione arrotonda il tempo fatturabile al proprio incremento di fatturazione. Vedi Costi e fatturazione per i dettagli sui prezzi.

Questi riquadri coprono l'intero mese indipendentemente dai filtri applicati all'elenco.

Stati

Una chiamata nel registro si è conclusa con uno di questi esiti:

Stato	Cosa è successo
Answered	La destinazione ha risposto. Il tempo fatturabile va dalla risposta al riaggancio
No answer	La chiamata ha squillato alla destinazione e non ha ricevuto risposta prima del timeout
Rejected	La chiamata è stata rifiutata anziché instradata
Failed	La chiamata è stata tentata ma non è riuscita, e SIP response è ciò che è stato restituito
Unknown	L'esito non è stato determinabile, per esempio quando non è mai arrivata una risposta finale

Rejected copre due tipi di rifiuto, e il motivo del rifiuto li distingue. O Bird ha rifiutato la chiamata prima del coinvolgimento di un operatore, nel qual caso il motivo indica il controllo non superato, oppure l'estremo remoto l'ha declinata direttamente, nel qual caso SIP response contiene la sua risposta e non c'è alcun motivo. Anche una chiamata in ingresso rifiutata dal numero chiamato risulta Rejected senza motivo, perché non ha fallito alcun controllo: il campo Inbound route indica cosa il numero era configurato per fare. Vedi Chiamate rifiutate.

Failed non è un rifiuto. Significa che la chiamata è stata tentata ma non è riuscita: un numero occupato risulta Failed con risposta dell'operatore 486, e un numero non assegnato risulta Failed con 404.

Se leggi questi valori dai tuoi strumenti, gestisci quelli che riconosci e tratta qualsiasi altro come uno stato non gestito anziché come un errore. L'elenco include anche busy e canceled, riservati alle chiamate in ingresso consegnate ai tuoi numeri. Nessuno dei due è ancora emesso, ed entrambi gli esiti sono riportati come failed.

Dettaglio di una chiamata

Aprendo una chiamata si visualizza ciò che Bird ha registrato:

Campo	Cosa indica
Status	L'esito della chiamata (vedi Stati). Una chiamata rifiutata da Bird mostra anche il motivo e cosa fare
SIP response	Il codice SIP finale della chiamata, per esempio 200 o 486. Una chiamata rifiutata da Bird riporta 503, senza coinvolgimento dell'operatore
From / To	Entrambi i numeri, ciascuno copiabile
Inbound route	Per una chiamata in ingresso, cosa il numero chiamato era configurato per fare: consegnare a un trunk, inoltrare o rifiutare. Contiene un link a quel numero
Trunk	Il trunk SIP su cui è arrivata la chiamata, o a cui è stata consegnata; utile quando più sedi condividono uno spazio di lavoro
Started	Quando Bird ha ricevuto la chiamata
Answered	Quando è stata data risposta alla chiamata, oppure Not answered
Ended	Quando la chiamata è stata abbattuta
Call ID	L'id del record (vcl_…). Citalo al supporto e usalo per correlare con i tuoi log
Session ID	Condiviso da ogni tratta di una chiamata (vcs_…), per raggruppare i record correlati. Una chiamata inoltrata ha due tratte che condividono lo stesso valore
Billing	Tempo fatturabile, durata totale e costo della chiamata una volta tariffata

Inbound route compare solo sulle chiamate in ingresso e indica cosa il numero era configurato per fare, non che abbia funzionato: un instradamento trunk su una chiamata rifiutata significa che il numero puntava a un trunk che non ha accettato la chiamata. Ricevere chiamate descrive le tre risposte e cosa registra ciascuna.

Chiamate rifiutate

Una chiamata rifiutata è stata respinta anziché instradata, e due cause diverse producono questo esito.

Bird l'ha rifiutata prima del coinvolgimento di un operatore. Prima di effettuare la chiamata, Bird verifica il caller ID, la destinazione, i limiti dell'account e il saldo del wallet, e rifiuta una chiamata che non supera uno di questi controlli. Il tuo sistema telefonico riceve SIP 503, mentre il record della chiamata autenticata memorizza il motivo specifico. Questo impedisce a chiamanti non autenticati di ottenere dettagli sull'account. Apri la chiamata per vedere la causa e un link all'impostazione pertinente.

Il numero chiamato ha respinto la chiamata. Una chiamata in ingresso verso un numero configurato per rifiutare, o verso un numero non configurato, viene rifiutata senza alcun motivo: non ha fallito alcun controllo. Inbound route è il campo che lo indica. Ricevere chiamate descrive questi rifiuti nel dettaglio.

I motivi elencati di seguito sono del primo tipo. Si applicano sia alle chiamate in ingresso sia a quelle in uscita, perché i limiti dell'account e il wallet sono verificati in entrambi i casi.

Motivi risolvibili da te

Motivo	Cosa è successo	Cosa fare
source_not_allowed	La chiamata è arrivata da un indirizzo non presente nella lista IP consentiti del trunk	Aggiungi l'indirizzo da cui invia il tuo sistema telefonico al trunk
caller_id_not_verified	Il numero nell'header From non è un caller ID verificato per questo spazio di lavoro	Verifica quel numero oppure presenta un numero già verificato
destination_not_enabled	Le chiamate verso quel paese sono disattivate per il tuo spazio di lavoro	Attiva il paese in Destinations
insufficient_balance	Il tuo wallet non copriva la chiamata, quindi Bird l'ha rifiutata a priori	Ricarica, oppure attiva le ricariche automatiche per evitare che un saldo basso interrompa le chiamate
daily_spend_exceeded	La chiamata avrebbe superato il tetto giornaliero di spesa vocale della tua organizzazione	Attendi che il tetto si azzeri all'inizio del giorno UTC successivo, oppure chiedi a Bird di alzarlo
concurrent_calls_exceeded	Hai raggiunto il numero massimo di chiamate simultanee consentite dal tuo account	Attendi che una chiamata termini, oppure contatta il supporto per alzare il limite
calls_per_second_exceeded	Hai effettuato nuove chiamate più velocemente di quanto consentito dal tuo account	Rallenta la frequenza di composizione e riprova. Riprovare immediatamente produce la stessa risposta
number_ownership_not_verified	Hai acquistato questo numero, ma il paese che lo ha emesso non ha ancora accettato la documentazione che ne prova la titolarità	Completa quanto richiesto dal campo ownership del numero, poi riprova la chiamata

Un dialer per campagne può ricevere calls_per_second_exceeded senza essere minimamente vicino al limite di chiamate simultanee: verifica quale dei due motivi hai ottenuto prima di modificare qualsiasi impostazione.

Motivi che Bird risolve per te

Questi dipendono dal lato di Bird. Contatta il supporto e cita il Call ID del record:

Motivo	Cosa è successo
routing_not_configured	L'instradamento del tuo spazio di lavoro è ancora in fase di collegamento, come previsto durante il completamento di una nuova configurazione vocale
no_route_found	L'instradamento è collegato, ma non copre il numero che hai chiamato. Contatta il supporto con il Call ID per verificare la rotta
destination_blocked	La configurazione di instradamento di Bird blocca le chiamate verso quella destinazione
call_not_permitted	Bird non è riuscito a completare la chiamata per il tuo account, quindi l'ha rifiutata anziché effettuarla a condizioni sconosciute

Come si legge un rifiuto

Leggi lo stato e il motivo del rifiuto insieme:

Rejected con motivo di rifiuto. Bird ha rifiutato la chiamata, e il motivo identifica il controllo non superato. Il SIP response è il 503 ricevuto dal tuo sistema telefonico. Segui la risoluzione indicata per il motivo specifico.
Rejected senza motivo di rifiuto. Per una chiamata in uscita, l'estremo remoto l'ha declinata direttamente e SIP response contiene il suo codice. Per una chiamata in ingresso, il numero chiamato l'ha respinta, e Inbound route indica cosa quel numero era configurato per fare.
Failed. La chiamata è stata tentata ma non è riuscita, e SIP response contiene il codice restituito. 486 indica occupato, mentre 404 indica numero non assegnato. Questo in genere dipende dal numero e non dalla tua configurazione.

Una chiamata che Bird non può ammettere viene respinta prima che esista un record, quindi non compare nel registro. Risoluzione problemi vocali tratta queste chiamate.

Esportare i record

Quattro modi per utilizzare questi record fuori dalla dashboard:

Esporta CSV. Download CSV nella scheda Call log esporta tutti i record che corrispondono ai filtri correnti su tutte le pagine. Usalo per riconciliazione e reportistica ad-hoc.
Leggili tramite API. GET /v1/voice/calls restituisce l'elenco filtrato e GET /v1/voice/calls/{call_id} restituisce un singolo record. Entrambi richiedono una chiave API con lo scope voice a livello read. Le impostazioni di trunk, caller ID e destinazione non fanno parte della API pubblica.
Leggili dal terminale. La Bird CLI fornisce bird voice list, bird voice get e bird voice stats. Il server MCP espone le stesse letture agli agent.
Sottoscrivi gli eventi. voice_call.initiated, voice_call.answered e voice_call.ended vengono inviati al tuo endpoint durante le chiamate, così i tuoi sistemi restano aggiornati senza polling. Vedi Eventi vocali.

Prossimi passi

Pagina	Cosa tratta
Eventi vocali	I tre eventi di chiamata, i relativi payload e come consumarli
Effettuare chiamate	Cosa si aspetta Bird sul INVITE e come viene tariffata una chiamata
Ricevere chiamate	Associare un numero a un trunk o a un inoltro e cosa viene registrato
Trunk SIP	La lista IP consentiti, le chiavi API consentite e le impostazioni Digest
Destinazioni vocali	Abilitare i paesi e cosa significa la disponibilità
Errori	La risposta di errore API e i relativi campi di ripristino

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Comprendi il concettoWhat is a voice API?Esplora la funzionalitàVoice Guida all'implementazioneVoice overview

Ottieni un brief di implementazione