# Métricas de voz

A página **Metrics** no painel Bird agrega os trechos de chamada que seu espaço de trabalho realizou e recebeu: quantos conectaram, quanto duraram, como terminaram e para onde foram. Use-a para relatórios de chamadas ao longo de um período. Para acompanhar uma chamada específica, abra o [registro de chamadas](/docs/guides/voice/call-log).

Uma chamada pode conter vários trechos, como as conexões criadas pelo encaminhamento ou ao ligar para outro participante. Cada trecho é contado separadamente nessas métricas.

Um trecho é contabilizado no horário em que começou e agregado quando termina, então o intervalo mais recente continua sendo preenchido enquanto houver chamadas ativas. A página exige acesso de leitura tanto de voz quanto de análises na sua função do espaço de trabalho.

## Consulte suas métricas

Abra **Voice** > [**Metrics**](https://bird.com/dashboard/w/voice/metrics). Quatro abas compartilham um seletor de período e uma linha de filtros: **Overview**, **Call quality**, **Numbers and routing** e **Traffic patterns**. Trocar de aba mantém o período e os filtros.

O seletor de período oferece as últimas 24 horas ou 7, 30 ou 90 dias, e começa em 7 dias. Períodos em dias agrupam pelo seu dia de calendário local; o período de 24 horas é uma janela móvel de 24 intervalos de uma hora. Arrastar sobre um gráfico de tempo restringe todos os cards da página àquele intervalo.

Quatro filtros se combinam: **Your number** (sua ponta do trecho), **Destination** (o país de destino do trecho), **trunk SIP** e **Outcome**. Cada filtro aplicado ganha um marcador que você pode remover, e a maioria dos cartões tem um controle que aplica o filtro da linha que você está consultando.

### Taxa de atendimento e duração da chamada

A aba **Overview** começa com cinco blocos. Os quatro primeiros mostram a variação em relação à janela anterior de mesmo tamanho:

- **Answer-seizure ratio**: trechos atendidos divididos por todas as tentativas no período. Tentativas que terminaram sem atendimento permanecem no denominador, então o ASR cai tanto quando uma rota para de completar quanto quando os números discados não atendem. A variação é uma diferença em pontos percentuais.
- **Average call duration**: a duração faturável média dos trechos atendidos. Trechos não atendidos ficam de fora, então o ACD não informa a frequência com que você conecta chamadas. Poucos trechos muito longos elevam a média acima da mediana; a distribuição de duração na aba **Call quality** mostra essa dispersão.
- **Total legs** e **Answered legs**: as duas contagens usadas para calcular o ASR.
- **Distinct numbers**: quantos números diferentes estavam na outra ponta, contando cada um apenas uma vez, independentemente do número de trechos associados. Comparado ao total de trechos, separa o tráfego distribuído entre muitos participantes do tráfego concentrado em poucos.

### Volume de chamadas e taxa de atendimento ao longo do tempo

O gráfico de tendência empilha trechos atendidos e outros trechos até o volume total do período no eixo esquerdo e mostra o ASR como uma linha no eixo direito, de 0 a 100%. A granularidade acompanha o intervalo: por hora para 24 horas, por dia para os demais. Ler os dois juntos separa crescimento de degradação: uma linha estável com barras em alta indica mais tráfego em uma rota que continua completando chamadas; uma linha em queda com barras estáveis indica uma rota que parou de completá-las. **View all legs**, abaixo do cartão, abre o registro de trechos para a mesma janela.

### Como as chamadas terminaram

Um gráfico de rosca e sua legenda dividem as tentativas de trechos no intervalo por resultado final, com uma contagem e uma participação no total para cada um:

| Resultado     | O que significa                                       |
| ------------- | ----------------------------------------------------- |
| **Answered**  | O trecho conectou                                     |
| **No answer** | Expirou o tempo, o que não prova que o telefone tocou |
| **Failed**    | Recusada pela outra ponta ou pela rede                |
| **Rejected**  | Recusada pela outra ponta ou por Bird                 |
| **Unknown**   | O resultado não pôde ser determinado                  |
| **Other**     | Um resultado que esta lista ainda não nomeia          |

Um resultado sem trechos no intervalo não aparece. Para descobrir por que houve uma recusa, além da frequência, abra os próprios trechos: [Chamadas rejeitadas](/docs/guides/voice/call-log#rejected-calls) explica o motivo que o Bird registra em cada um.

### Principais países

A tabela de países classifica os 10 principais países de destino por volume de trechos, e o rodapé informa quantos países tiveram atividade no intervalo. O país é o destino do trecho: o país para o qual você ligou em um trecho de saída e o país do seu próprio número em um trecho de entrada.

Em um intervalo de dias, o rodapé também informa a parcela dos seus trechos coberta pela tabela, e cada linha mostra sua participação em uma barra. O intervalo de 24 horas omite ambos: a distribuição considera dias completos do calendário local, enquanto os indicadores acima cobrem uma janela móvel de 24 horas. Os dois totais representam quantidades diferentes, e calcular uma participação entre eles seria enganoso. Mude para 7 dias ou mais quando precisar da cobertura.

Cada linha mostra a contagem de trechos, a divisão **Out / In** daquele país e seu ASR. Um ASR por país muito abaixo do ASR da página costuma ser o primeiro sinal de um problema de roteamento restrito a um destino. A divisão aparece como um traço quando não foi possível determiná-la.

### Qualidade da chamada

A aba **Call quality** traz as medidas de conexão e a distribuição de duração. Uma medida aparece quando Bird a registrou no período, e uma medida ausente significa que Bird não registrou nada, o que é diferente de uma pontuação ruim:

- **Ring delay**, mediana e percentil 95: quanto tempo o chamador esperou entre discar e ouvir o toque. Uma diferença entre os dois indica uma rota que normalmente conecta rápido e às vezes não.
- **Audio quality**: a pontuação média de opinião, a avaliação padrão de 1 a 5 de como o áudio da chamada soou, calculada nos trechos em que foi medida. Uma conexão normal pontua acima de 4. Abaixo disso, filtre por um trunk ou destino para descobrir se a queda está restrita a uma rota. Verifique também os trechos curtos na mesma aba, pois uma rota que conecta sem transmitir áudio afeta as duas métricas.
- **Short legs**: trechos atendidos que terminaram em menos de 30 segundos, mostrados como uma parcela dos trechos atendidos. No tráfego de saída, uma parcela crescente costuma indicar uma rota que conecta, mas não transmite áudio.

**How long legs run** distribui os trechos atendidos em seis faixas de duração faturável, de menos de 30 segundos a 10 minutos ou mais, com a duração média acima. A duração faturável é o tempo após o atendimento, portanto essa é a distribuição por trás das suas cobranças de voz.

### Tráfego de entrada e saída

A aba **Numbers and routing** separa as duas direções que uma visão combinada esconde. Os indicadores contam **Outbound legs** e **Inbound legs**, com sua variação em relação à janela anterior, ao lado de **Active numbers** e **Active trunks**, para os números e trunks que transportaram tráfego. **Direction over time** empilha as duas direções por intervalo, tornando visível uma mudança restrita ao tráfego de entrada que a tendência combinada atenua.

Abaixo do gráfico, uma tabela divide o período por seu número, país do seu número, trunk SIP ou direção, com trechos, trechos atendidos, ASR e ACD em colunas ordenáveis. O país do seu número é a sua ponta do trecho, um eixo diferente do país de destino na aba **Overview**. As linhas de trunks mostram qual trunk está degradado, então compare o ASR entre eles em vez de analisar um isoladamente. Os rótulos de números e trunks levam ao registro, e os resumos de números abrem uma lista paginada e pesquisável de todos os números que tiveram trechos.

### Padrões de tráfego

A aba **Traffic patterns** traça o perfil de quando as chamadas chegam, no seu fuso horário local: seu dia da semana e hora de pico, uma grade de dia da semana por hora e um perfil por hora do dia. A grade e o perfil por hora precisam de um período maior que um dia, e a grade lê no máximo os últimos 30 dias, então em um período de 90 dias ela avisa. O perfil por dia da semana aparece quando o período abrange 14 dias; abaixo disso, cada dia da semana contém apenas uma observação.

## Acesso programático

Use as operações de estatísticas CLI ou MCP para obter os agregados por trás do painel. Essas operações de agregação ainda não têm um contrato público HTTP ou SDK publicado. Para relatórios HTTP ou SDK, use os registros públicos de trechos descritos abaixo para calcular seus próprios agregados.

- **O CLI.** [`bird voice stats summary`](/docs/cli/reference/voice-stats-summary) retorna o agregado do período que os blocos mostram, e [`bird voice stats daily`](/docs/cli/reference/voice-stats-daily) e [`bird voice stats hourly`](/docs/cli/reference/voice-stats-hourly) retornam as séries por trás do gráfico de tendência. Os detalhamentos são [`by-country`](/docs/cli/reference/voice-stats-by-country), [`by-trunk`](/docs/cli/reference/voice-stats-by-trunk), [`by-number`](/docs/cli/reference/voice-stats-by-number), [`by-number-country`](/docs/cli/reference/voice-stats-by-number-country), [`by-weekday`](/docs/cli/reference/voice-stats-by-weekday), [`by-hour-of-day`](/docs/cli/reference/voice-stats-by-hour-of-day) e [`by-response-code`](/docs/cli/reference/voice-stats-by-response-code), que agrupa chamadas pelo código SIP final e não é exibido no painel. Os comandos aceitam a mesma janela, fuso horário e os filtros de destino, número, trunk e resultado que a página aplica, com uma exceção: `by-response-code` aceita apenas a janela, o fuso horário e `--direction`, e sua janela é em dias de calendário em vez de instantes, então responde sobre uma população mais ampla do que uma página filtrada. O acesso somente leitura que um `bird auth login` simples concede é suficiente para todos. Consulte o guia [Bird CLI](/docs/cli) para instalar e autenticar.
- **Agentes.** O [servidor MCP](/docs/ai/mcp-server) expõe as mesmas leituras de estatísticas como ferramentas.
- **Seus próprios agregados.** Para relatórios personalizados ou um data warehouse, [`GET /v1/voice/legs`](/docs/api/reference/list-voice-legs) retorna registros de trechos filtrados, e a [exportação CSV](/docs/guides/voice/call-log#getting-the-records-out) do registro de trechos cobre os registros que correspondem aos seus filtros atuais. [Eventos de voz](/docs/guides/voice/events) enviam transições de chamada para o seu endpoint. Reconcilie-os com os registros de trechos concluídos porque eventos podem estar ausentes ou chegar fora de ordem.

Os números do CLI e do painel coincidem para a mesma janela quando usam o mesmo fuso horário. O painel envia o fuso horário armazenado em cada leitura; um comando sem `--timezone` agrupa em UTC.

## Próximos passos

| Página                                                     | O que cobre                                                                     |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [Registro de chamadas](/docs/guides/voice/call-log)        | Os trechos individuais por trás desses agregados, e por que um foi recusado     |
| [Eventos de voz](/docs/guides/voice/events)                | Os eventos de chamada para consumir nos seus próprios relatórios                |
| [Realizar chamadas](/docs/guides/voice/placing-calls)      | O que Bird lê de um `INVITE`, e como uma chamada é tarifada                     |
| [Solução de problemas](/docs/guides/voice/troubleshooting) | Partindo de um sintoma até a causa quando uma métrica se move na direção errada |

## Related resources

- [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer)
- [Voice](/voice-api) (product)
- [Voice overview](/docs/guides/voice/overview) (docs)

[Get an implementation brief](/learn/workspace?topic=voice)