Registro chiamate

Il leg log in Voice > Legs elenca ogni connessione effettuata o ricevuta dal tuo spazio di lavoro, dalla più recente. Una chiamata può contenere più leg, ad esempio la connessione in ingresso e quella inoltrata. Ogni voce è un call detail record (CDR), comprese le connessioni senza risposta o rifiutate. Usalo per verificare durata, la risposta SIP finale e il costo.

Bird scrive ogni record alla fine del segmento, quindi ogni voce nel log ha un esito finale. La scheda Live accanto contiene i segmenti ancora attivi.

Per l'interazione completa, apri Voice > Calls. Una chiamata raggruppa leg e partecipanti correlati. Conserva il Call ID per la correlazione e il Leg ID quando indaghi su una singola connessione: identificano record diversi.

L'elenco chiamate

Ogni riga è un segmento. Una chiamata con più segmenti ha più righe:

Colonna	Cosa mostra
Status	Come è terminato il segmento (vedi Stati)
From	Il numero chiamante, il caller ID presentato dal tuo apparato
To	Il numero chiamato
Direction	Outbound per i segmenti originati dal tuo apparato, inbound per quelli arrivati sui tuoi numeri
Duration	Durata totale del segmento, dal momento in cui Bird lo ha ricevuto fino al riaggancio
Started	Quando Bird ha ricevuto il segmento

La lista è paginata, 25 segmenti per pagina. Seleziona una riga per aprire il record del segmento.

Chiamate in corso

La scheda Live elenca i segmenti attivi in questo momento e riporta un contatore, così puoi vedere quanti ce ne sono senza aprirla. Un segmento live ha uno di due stati:

Stato	Cosa sta succedendo
Ringing	Un tentativo di chiamata attivo è in attesa di risposta; questo non conferma che la destinazione abbia squillato
In progress	La destinazione ha risposto e la chiamata è connessa

Le colonne corrispondono a quelle del leg log, tranne Elapsed, che sostituisce Duration. Conta dal momento della risposta per un segmento connesso e dall'inizio per uno in squillo. La scheda si aggiorna ogni pochi secondi. Quando un segmento termina, passa nel leg log 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 di stato più un intervallo di date restringe ai segmenti che soddisfano entrambi i criteri.

Ricerca per numero. La casella di ricerca confronta un numero con entrambi i lati del segmento, così una sola query trova i segmenti verso e da quel numero.

Direction. Filtra per segmenti 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 conta
Legs	Record di segmenti completati nel mese, inclusi quelli senza risposta e rifiutati
Total duration	La durata complessiva di ogni segmento sommata, dal momento in cui Bird lo ha ricevuto fino al riaggancio
Billable time	Il tempo con risposta di ogni segmento sommato

La differenza tra durata totale e tempo fatturabile è il tempo di squillo senza risposta. Un segmento 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

Un segmento nel log è terminato con uno di questi esiti:

Stato	Cosa è successo
Answered	La destinazione ha risposto. Il tempo fatturabile va dalla risposta al riaggancio
No answer	Il tentativo è scaduto senza risposta; questo non dimostra che il telefono di destinazione abbia squillato
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 un segmento si vede cosa Bird ha registrato per quella connessione:

Campo	Cosa indica
Status	L'esito del segmento (vedi Stati). Un segmento rifiutato da Bird mostra anche il motivo e come intervenire
SIP response	Il codice SIP finale del segmento, ad esempio `200` o `486`. Un segmento rifiutato da Bird riporta `503`, senza coinvolgimento del carrier
From / To	Entrambi i numeri, ciascuno copiabile
Inbound route	Per una chiamata in ingresso, la rotta selezionata per il numero, ad esempio trunk, inoltro, sequenza o rifiuto. 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 il segmento
Answered	Quando il segmento ha ricevuto risposta, oppure Not answered
Ended	Quando il segmento è stato abbattuto
Leg ID	L'ID proprio del record di connessione (`vcl_…`). Usalo con `GET /v1/voice/legs/{leg_id}` e comunicalo al supporto.
Call ID	Condiviso da ogni leg di una stessa chiamata (`vcs_…`). Usa il filtro `call_id` per trovare i leg correlati. Una chiamata inoltrata ha due leg che ne condividono uno.
Billing	Tempo fatturabile, durata totale e costo del segmento una volta tariffato

Inbound route compare sulle chiamate in ingresso e registra la rotta selezionata. Un instradamento trunk su una chiamata rifiutata significa che la chiamata non ha raggiunto una risposta funzionante. Ricevere chiamate descrive le rotte 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 è né un numero Bird idoneo né un caller ID esterno verificato in questo spazio di lavoro	Usa un numero Bird idoneo oppure verifica il numero esterno
`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 nella configurazione. Contatta il supporto e indica il Leg ID dal 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 leg 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 piuttosto che 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 Leg log esporta i record corrispondenti ai filtri attivi su tutte le pagine, fino a 10.000 segmenti. Una selezione più ampia restituisce un errore senza file; restringi l'intervallo di date o i filtri ed esporta ogni selezione separatamente. Usalo per la riconciliazione e la reportistica ad hoc.
Leggili tramite la API. GET /v1/voice/legs restituisce l'elenco filtrato e GET /v1/voice/legs/{leg_id} restituisce un singolo record. Entrambi richiedono una chiave API con lo scope voice a livello read. Consulta il riferimento API per le operazioni pubblicate su altre risorse Voice e i relativi scope richiesti.
Leggili dal terminale. La Bird CLI fornisce bird voice legs list, bird voice legs get e bird voice stats. Il server MCP espone le stesse letture agli agenti.
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

Continua con la documentazione, le guide e gli esempi per questo argomento.

Ottieni un brief di implementazione

Risorse correlate