Metriche vocali
La pagina Metrics nella dashboard Bird aggrega i leg di chiamata che il tuo spazio di lavoro ha effettuato e ricevuto: quanti si sono connessi, quanto sono durati, come si sono conclusi e verso dove erano diretti. Usala per i report sulle chiamate in un determinato periodo. Per seguire una singola chiamata, apri il registro chiamate.
Una chiamata può contenere più leg, ad esempio le connessioni create dall'inoltro o dalla chiamata a un altro partecipante. Ogni leg viene conteggiato separatamente in queste metriche.
Un leg è conteggiato in base al momento in cui è iniziato e viene aggregato quando termina, quindi il bucket più recente continua ad aggiornarsi finché ci sono chiamate ancora attive. La pagina richiede sia l'accesso in lettura voice sia quello analytics nel ruolo del tuo spazio di lavoro.
Consultare le metriche
Apri Voice > Metrics. Quattro schede condividono un selettore di intervallo e una riga di filtri: Overview, Call quality, Numbers and routing e Traffic patterns. Cambiare scheda mantiene l'intervallo e i filtri selezionati.
Il selettore di intervallo offre le ultime 24 ore oppure 7, 30 o 90 giorni, e parte da 7 giorni. Gli intervalli in giorni raggruppano per giorno di calendario locale; l'intervallo di 24 ore è una finestra mobile di 24 bucket orari. Trascinando su un grafico temporale si restringe ogni card della pagina a quell'intervallo.
Quattro filtri si combinano: Your number (il tuo lato del leg), Destination (il paese di destinazione del leg), SIP trunk e Outcome. Ogni filtro applicato ha un'etichetta rimovibile e la maggior parte delle schede include un controllo che applica il filtro per la riga che stai visualizzando.
Tasso di risposta e durata delle chiamate
La scheda Overview inizia con cinque riquadri. I primi quattro riportano la variazione rispetto alla finestra precedente di pari durata:
- Answer-seizure ratio: leg con risposta divisi per tutti i tentativi nell'intervallo. I tentativi terminati senza risposta restano nel denominatore, quindi l'ASR cala sia quando una rotta smette di completarsi sia quando i numeri chiamati non rispondono. La variazione è espressa in punti percentuali.
- Average call duration: la durata media fatturabile dei leg con risposta. I leg senza risposta sono esclusi, quindi l'ACD non indica quanto spesso riesci a connetterti. Pochi leg molto lunghi portano la media sopra la mediana; la distribuzione della durata nella scheda Call quality mostra questa dispersione.
- Total legs e Answered legs: i due conteggi da cui si calcola l'ASR.
- Distinct numbers: quanti numeri diversi erano presenti all'altro capo, contando ciascuno una sola volta indipendentemente dal numero di leg in cui compare. Confrontato con il totale dei leg, distingue il traffico distribuito tra molti partecipanti da quello concentrato su pochi.
Volume di chiamate e tasso di risposta nel tempo
Il grafico dell'andamento impila i leg con risposta e gli altri leg fino al volume totale del periodo sull'asse sinistro e mostra l'ASR come linea su un asse destro da 0 a 100%. La granularità segue l'intervallo: oraria per le 24 ore, giornaliera per gli altri. La lettura congiunta distingue la crescita dal peggioramento: una linea piatta sotto una pila crescente indica più traffico su una rotta che continua a connettere, mentre una linea in calo sotto una pila stabile indica una rotta che non completa più le connessioni. View all legs sotto la scheda apre il registro dei leg per la stessa finestra temporale.
Come si sono concluse le chiamate
Un grafico ad anello con legenda suddivide i tentativi dei leg nell'intervallo per esito finale, mostrando per ciascuno un conteggio e una quota del totale dei leg:
| Esito | Significato |
|---|---|
| Answered | Il leg si è connesso |
| No answer | È scaduta, il che non prova che il telefono abbia squillato |
| Failed | Rifiutata dall'altro capo o dalla rete |
| Rejected | Declinata dall'altro capo, o rifiutata da Bird |
| Unknown | L'esito non è stato determinabile |
| Other | Un esito non ancora presente in questo elenco |
Un esito senza leg nell'intervallo viene omesso. Per capire perché si è verificato un rifiuto, anziché quanto spesso, apri i leg stessi: Chiamate rifiutate descrive il motivo che Bird registra per ciascuno.
Paesi principali
La tabella dei paesi ordina i primi 10 paesi di destinazione per volume di leg e il piè di pagina indica quanti paesi hanno avuto attività nell'intervallo. Il paese è la destinazione del leg: il paese chiamato per un leg in uscita e il paese del tuo numero per uno in entrata.
Per un intervallo in giorni, il piè di pagina indica anche la quota dei tuoi leg coperta dalla tabella e ogni riga mostra la propria quota come barra. L'intervallo di 24 ore omette entrambe: la suddivisione considera interi giorni di calendario locali, mentre i riquadri sopra coprono 24 ore mobili. I due totali sono quindi quantità diverse e una quota calcolata tra loro sarebbe fuorviante. Passa a 7 giorni o più quando ti serve il valore di copertura.
Ogni riga mostra il conteggio dei leg, la ripartizione Out / In per quel paese e il relativo ASR. Un ASR per paese molto inferiore a quello della pagina è di solito il primo segnale di un problema di instradamento limitato a una destinazione. La ripartizione mostra un trattino quando non è stato possibile determinarla.
Qualità delle chiamate
La scheda Call quality contiene le misure di connessione e la distribuzione della durata. Una misura compare quando Bird l'ha rilevata nell'intervallo; l'assenza di una misura significa che Bird non ha rilevato nulla, il che è diverso da un punteggio scarso:
- Ring delay, mediana e 95° percentile: quanto il chiamante ha atteso tra la composizione e l'inizio dello squillo. Un divario tra i due valori indica una rotta che di solito si connette rapidamente e talvolta no.
- Audio quality: il mean opinion score, la valutazione standard da 1 a 5 di come suonava una chiamata, mediata sui leg per cui è stata misurata. Una connessione normale ottiene un valore superiore a 4. Al di sotto, filtra per un trunk o una destinazione per capire se il calo è limitato a una rotta e controlla i leg brevi nella stessa scheda, poiché una rotta che si connette senza trasportare audio influisce su entrambi.
- Short legs: leg con risposta terminati in meno di 30 secondi, mostrati come quota dei leg con risposta. Nel traffico in uscita, una quota crescente indica di solito una rotta che si connette ma non trasporta audio.
How long legs run distribuisce i leg con risposta in sei fasce di durata fatturabile, da meno di 30 secondi a 10 minuti e oltre, con la durata media indicata sopra. La durata fatturabile è il tempo dopo la risposta, quindi questa è la distribuzione alla base dei costi Voice.
Traffico in entrata e in uscita
La scheda Numbers and routing separa le due direzioni che una vista combinata nasconde. I riquadri conteggiano Outbound legs e Inbound legs con la variazione rispetto alla finestra precedente, accanto ad Active numbers e Active trunks per i numeri e i trunk che hanno gestito traffico. Direction over time impila le due direzioni per intervallo, rendendo visibile una variazione limitata al traffico in entrata che l'andamento combinato appiattisce.
Sotto il grafico, una tabella suddivide il periodo per tuo numero, paese del tuo numero, trunk SIP o direzione, con leg, leg con risposta, ASR e ACD in colonne ordinabili. Il paese del tuo numero è il tuo lato del leg, una dimensione diversa dal paese di destinazione nella scheda Overview. Le righe dei trunk mostrano quale trunk è peggiorato: confronta quindi l'ASR tra le righe invece di leggerne una sola. Le etichette di numeri e trunk rimandano al record e i riepiloghi dei numeri aprono una vista ricercabile e paginata di ogni numero che ha gestito leg.
Schemi di traffico
La scheda Traffic patterns profila quando le chiamate arrivano, nel tuo fuso orario locale: il giorno della settimana e l'ora di maggiore attività, una griglia giorno-per-ora e un profilo orario giornaliero. La griglia e il profilo orario richiedono un intervallo superiore a un giorno, e la griglia copre al massimo gli ultimi 30 giorni, quindi su un intervallo di 90 giorni lo segnala. Il profilo settimanale compare quando l'intervallo copre 14 giorni; al di sotto, ogni giorno della settimana contiene una sola osservazione.
Accesso programmatico
Usa le operazioni statistiche CLI o MCP per recuperare gli aggregati dietro la dashboard. Queste operazioni di aggregazione non hanno ancora un contratto pubblico HTTP o SDK. Per reportistica HTTP o SDK, usa i record pubblici dei leg descritti di seguito per calcolare i tuoi aggregati.
- CLI. bird voice stats summary restituisce l'aggregato di periodo mostrato nei riquadri, e bird voice stats daily e bird voice stats hourly restituiscono le serie dietro il grafico di tendenza. Le suddivisioni sono by-country, by-trunk, by-number, by-number-country, by-weekday, by-hour-of-day e by-response-code, che raggruppa le chiamate per codice SIP finale e non è rappresentata nella dashboard. I comandi accettano la stessa finestra, fuso orario e i filtri per destinazione, numero, trunk ed esito che la pagina applica, con un'eccezione: by-response-code accetta solo la finestra, il fuso orario e --direction, e la sua finestra è in giorni di calendario anziché istanti, quindi risponde su una popolazione più ampia rispetto a una pagina filtrata. L'accesso in sola lettura concesso da un semplice bird auth login è sufficiente per tutti. Consulta la guida Bird CLI per installazione e autenticazione.
- Agenti. Il server MCP espone le stesse letture statistiche come strumenti.
- Aggregati personalizzati. Per reportistica custom o un data warehouse, GET /v1/voice/legs restituisce record dei leg filtrati, e l'esportazione CSV del registro dei leg copre i record corrispondenti ai filtri correnti. Gli eventi vocali inviano le transizioni di chiamata al tuo endpoint. Riconciliali con i record dei leg completati perché gli eventi possono mancare o arrivare fuori ordine.
I numeri provenienti da CLI e dalla dashboard coincidono per la stessa finestra quando usano lo stesso fuso orario. La dashboard invia il fuso orario memorizzato a ogni lettura; un comando senza --timezone raggruppa in UTC.
Prossimi passi
| Pagina | Argomento trattato |
|---|---|
| Registro chiamate | I singoli leg dietro questi aggregati e il motivo di un rifiuto |
| Eventi vocali | Gli eventi di chiamata da consumare per la tua reportistica |
| Effettuare chiamate | Cosa legge Bird da un INVITE e come viene tariffata una chiamata |
| Risoluzione dei problemi | Risalire da un sintomo a una causa quando una metrica si muove nella direzione sbagliata |
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àVoiceGuida all'implementazioneVoice overview
Ottieni un brief di implementazione