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:
- Taxa de entrega: 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.
- Taxa de falha: a proporção de mensagens aceitas que terminaram como undelivered, failed ou expired. O bloco mostra sua taxa em relação a um limite de 5% com uma barra de progresso; atingi-lo muda o bloco para Risk. Uma taxa de falha alta e sustentada geralmente indica problemas de qualidade da lista ou de conteúdo.
- Aceitas: 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:
- Não entregue: uma falha de entrega não permanente. O aparelho estava desligado ou inacessível.
- Com falha: uma falha permanente; a mensagem não pode ser entregue.
- Expirada: a operadora parou de tentar e reportou a mensagem como expirada. Bird não define uma janela de validade própria.
- Rejeitada: a mensagem foi recusada (uma verificação de política, uma cobrança que falhou ou uma operadora que a rejeitou) em vez de 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 Taxa de falha 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 Processamento, Entrega 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 destino lento. A latência cobre a janela completa, e um percentil sem dados mostra um traço.
Acesso programático
A API de stats API expõe o mesmo resumo, séries e 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 o SMS analytics para conectar os relatórios de entrega ao fluxo mais amplo da campanha ou aplicação.
- Stats API: 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.
- Sending SMS: revise categorias, tags, segmentos e gastos.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Entenda o conceitoWhat does a delivery receipt tell you?Siga o percurso de aprendizagemOperate messaging reliably
Obtenha um resumo de implementação