Métricas do WhatsApp

A página Metrics em WhatsApp → Metrics mostra o desempenho dos seus envios WhatsApp em todo o espaço de trabalho. Para verificar uma mensagem individual, use o log de WhatsApp. A página exige acesso de leitura a WhatsApp e acesso de leitura a analytics na sua função do espaço de trabalho.

Leia suas métricas

Período, escopo e abas

• Outbound / Inbound: a aba Outbound cobre as mensagens que você enviou. A aba Inbound conta as mensagens que os seus números receberam, no total e por número.
• Período: últimas 24 horas, 7, 30 (padrão) ou 90 dias. Você também pode arrastar sobre um gráfico para ampliar.
• Escopo: somente na aba Outbound, restrinja a página a um número, template, categoria de template ou tag, um de cada vez. Duas partes da página ignoram o escopo e sempre cobrem todo o espaço de trabalho: a lista de códigos de erro e o painel Breakdowns.

As mensagens contam no período em que Bird as aceitou, então um recibo de entrega que chega hoje atualiza os números de ontem. As horas mais recentes podem mostrar menos entregas do que exibirão quando todos os recibos chegarem.

Cards resumo

Um card fora da faixa saudável exibe Needs attention. Verifique as causas de falha para entender o motivo.

Entregas ao longo do tempo

O gráfico mostra as mensagens aceitas, entregues e com falha por hora (período de 24 horas) ou por dia (períodos mais longos). Use-o para identificar um pico, por exemplo depois que uma campanha é disparada ou um template começa a ser rejeitado.

Causas de falha

O gráfico de taxa de falha acompanha a taxa de falha ao longo do período. Abaixo dele, as falhas são agrupadas por código de erro, com as mais comuns primeiro. A lista mostra até 50 códigos que ocorreram no período, então um código raro pode ficar de fora de uma lista longa. Os códigos de erro sempre abrangem todo o espaço de trabalho, mesmo quando você restringe o escopo da página. A última linha, Rejected, conta as mensagens que Bird recusou antes de aceitá-las. Elas não fazem parte da taxa de falha, por isso a linha mostra uma contagem sem proporção.

Latência

A tabela de latência mostra os tempos p50, p95 e p99 para três estágios:

• Processamento: da aceitação da mensagem por Bird até o repasse para WhatsApp.
• Entrega: do repasse para WhatsApp até WhatsApp confirmar a entrega ao dispositivo do destinatário.
• Total: os dois estágios juntos.

Um estágio Delivery lento geralmente significa que os telefones dos destinatários estavam offline, algo que Bird não controla. Um estágio Processing lento merece investigação. Se o p50 parece normal, mas o p99 está lento, a causa costuma ser um único template ou destino.

Detalhamentos

O painel Breakdowns divide mensagens aceitas, entregues e com falha por número, template, categoria de template, tag ou país. Cada linha é marcada como Healthy ou Needs attention com base nos mesmos limites dos cards resumo. Cada aba lista as 50 primeiras linhas do período.

As tags são aquelas que você define ao enviar. Uma mensagem com várias tags aparece na linha de cada uma delas. Destinatários cujo país não pode ser identificado aparecem em ZZ, e envios em grupo ficam fora da aba de país.

Acesso programático

Os mesmos números estão disponíveis pela API, pelos SDKs (bird.whatsapp.stats), pela CLI (bird whatsapp stats) e pelo servidor MCP. Comece por estes endpoints:

• Estatísticas de resumo, diárias e por hora
• Detalhamentos por número, template, categoria de template, tag, país e código de erro
• Estatísticas de entrada: resumo, diárias, por hora e por número

Cada página de referência lista os intervalos de tempo aceitos, os filtros e os campos de resposta.

Próximos passos

• Log do WhatsApp: consulte uma mensagem individual
• Eventos de status de mensagem: os eventos a partir dos quais estas métricas são construídas
• Webhooks de status de mensagem: receba cada mudança de status no momento em que acontece