Métricas de SMS
A página Metrics no painel do Bird mostra quanto do tráfego SMS chegou aos aparelhos e como sua taxa de falha varia. Este guia explica cada valor e quando investigá-lo.
Métricas são a visão agregada de tudo que seu espaço de trabalho envia. As contagens usam agregação aproximada de mensagens distintas, então use registros de mensagens e de cobrança quando for necessária uma reconciliação exata. Para o ciclo de vida de uma única mensagem (se este número a recebeu), consulte o log de SMS e os eventos.
Leia suas métricas
Abra SMS > Metrics no painel. O seletor de período oferece as últimas 24 horas ou 7, 30 ou 90 dias. Os valores são atualizados à medida que envios e confirmações de entrega chegam.
As taxas usam o horário de envio de cada mensagem. Uma confirmação de entrega que chega hoje para uma mensagem aceita ontem conta para ontem, junto com o próprio accepted dessa mensagem. Cada período, portanto, descreve as mensagens que você enviou nele, do início ao fim. accepted é o denominador dos dois cartões de taxa; é a contagem de mensagens que admitimos no período, e toda taxa é calculada sobre ele.
Um período que inclui envios recentes pode temporariamente sub-reportar delivered enquanto as confirmações ainda estão chegando. A contagem se estabiliza conforme essas mensagens são concluídas.
Os blocos de resumo
A fileira de blocos no topo é sua verificação rápida de saúde:
- Delivery rate: mensagens entregues como proporção das aceitas. Ela exibe Healthy acima de 95%; igual ou abaixo disso, algo está falhando em alcançar os aparelhos (números inválidos, conteúdo bloqueado ou problemas de roteamento), e o detalhamento de falhas indica qual. O bloco também mostra a variação em relação ao período anterior.
- Failure rate: a proporção de mensagens aceitas com um resultado registrado de
undelivered,failedouexpired. As métricas contam todos os resultados que a operadora reportou, então uma falha substituída por um relatório de entrega posterior continua contando aqui e também na taxa de entrega. O bloco mostra sua taxa em relação a um limite de 5% com uma barra de progresso; ao atingi-lo, o bloco muda para Risk. Uma taxa de falha alta e sustentada geralmente indica problemas de qualidade da lista ou de conteúdo. - Accepted: a contagem bruta de mensagens aceitas no período, com o número repassado às operadoras (
sent) e a variação em relação ao período anterior.
O painel usa os limites de 95% e 5% para os rótulos Healthy e Risk. Um rótulo Healthy não significa que todas as mensagens foram entregues.
Entrega ao longo do tempo
O gráfico de entrega plota o volume de mensagens aceitas, entregues e com falha ao longo do período para que você identifique tendências e picos isolados: uma campanha ruim, uma importação de lista de números que deu errado, uma rota que se degradou. A série failed aqui agrupa todos os resultados de não entrega (não entregue, com falha e expirada) em uma única linha. O tamanho do intervalo segue o período (por hora para 24 horas, por dia para janelas mais longas).
Taxa de falha e suas causas
A página Metrics também plota a taxa de falha por intervalo e agrupa as não entregas por causa em um histograma de resultados:
- Undelivered: uma falha de entrega não permanente. O aparelho estava desligado ou inacessível.
- Failed: uma falha que não deve se resolver. O Bird não tenta entregá-la novamente, mas um relatório da operadora com outro resultado, ocorrido depois, ainda pode substituí-la.
- Expired: a operadora parou de tentar e reportou a mensagem como expirada. O Bird não define uma janela de validade própria.
- Rejected: a mensagem foi recusada (por uma verificação de política, uma cobrança que falhou ou uma operadora que a rejeitou), em vez de ter sido tentada e perdida.
Cada intervalo mostra sua contagem, e todos exceto rejected mostram sua proporção das mensagens aceitas. Ao reconciliar os números: o bloco Failure rate conta undelivered, failed e expired, enquanto rejected aparece neste histograma, mas fica fora do cálculo da taxa de falha. Uma mensagem rejeitada foi recusada, e não perdida na entrega, por isso é rastreada separadamente das falhas de entrega.
Latência de entrega
A tabela de latência divide o tempo em Processing, Delivery e Total. O processamento vai da aceitação até o repasse à operadora; a entrega vai do repasse até o resultado de entrega reportado; o total abrange da aceitação até esse resultado. Cada estágio inclui os percentis p50, p95 e p99. Use p95 e p99 para identificar uma operadora ou um destino lento. A latência cobre a janela completa, e um percentil sem dados mostra um traço.

Acesso programático
A API de estatísticas expõe o mesmo resumo, as mesmas séries e os mesmos detalhamentos do painel. Os detalhamentos cobrem país, operadora, remetente, categoria, status, código de erro e mensagens recebidas. Os valores correspondem aos do painel para o mesmo período.
Para reconciliação por mensagem em vez de agregados, consuma eventos de webhook conforme eles acontecem, ou pagine pelos GET /v1/sms/messages.
Próximos passos
Use as análises de SMS para conectar os relatórios de entrega ao fluxo mais amplo da campanha ou da aplicação.
- API de estatísticas: recupere todos os valores desta página via código.
- Log de SMS: inspecione as mensagens por trás dos agregados.
- Eventos: consuma os eventos por trás das métricas.
- Envio de SMS: revise categorias, tags, segmentos e gastos.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.