null. Para uma linha por categoria, use a exportação em CSV do detalhamento. Uma exportação de um número específico omite os totais de requisições de API de todo o projeto e o resumo combinado; a exportação de todos os números preserva a resposta completa. Medições ausentes aparecem como —.
A Linha do tempo de atividade usa linhas com preenchimento claro. Selecione um item da legenda para ocultar ou restaurar a série dele e isolar um sinal. Pelo menos uma série continua visível. Trocar a visualização de atividade restaura as duas séries. A linha do tempo de respostas e os Intervalos do celular usam os mesmos controles; intervalos sem observações continuam como lacunas. As dicas mostram zeros medidos como 0 e valores não medidos como —.
A tabela de números compara atividade, leituras, respostas, tempo de resposta, taxas de
atendimento de chamadas, chamadas recebidas perdidas e problemas de conexão. Créditos, limites e dias de sessão faturáveis ficam em
Uso.
O que os números significam
Uma conversa começa com um envio direto bem-sucedido. Outros envios para essa conversa
em até 24 horas pertencem à mesma conversa. Os resultados são contados juntos
quando essa janela fecha. Um envio posterior inicia outra conversa. Grupos
e recibos da sua própria conta não entram nas taxas. Edições,
reações e atualizações de protocolo não contam como respostas nem abrem a fila de respostas.
Taxa de leitura significa que um recibo de leitura do WhatsApp foi observado. Ela não mede aberturas
do app. Pessoas que desativam os recibos de leitura podem ler uma mensagem sem gerar
um recibo. A ausência de recibo não prova que a mensagem não foi lida.
As contagens cobrem a atividade registrada. Traços e taxas
null na API significam que não existe
denominador concluído ou que a cobertura de acompanhamento está incompleta. A atividade de mensagens em
números não observados e da API oficial aparece como Não medido. Os resultados de chamadas
continuam disponíveis quando as chamadas foram registradas. Números de teste ficam excluídos. As taxas
agregadas ficam indisponíveis quando algum número do escopo selecionado não tem medições;
selecione um número medido para ver os resultados dele.
Os agregados não contêm conteúdo de mensagens nem identidades de contatos. Ativar as
Análises não ativa o armazenamento hospedado de mensagens. As medições operacionais de segurança
continuam de forma independente da configuração de exibição das Análises.
Explorar conversas e detalhamentos por público
As abas horizontais no topo selecionam Conversas, Destinatários, Atividade do número ou Chamadas. Cada visualização usa o mesmo gráfico principal. Em Conversas, selecione Conversas, Lidas, Respondidas ou Tempo de resposta do cliente acima dele. Lidas e Respondidas mostram contagens absolutas de conversas observadas. Atividade do número seleciona mensagens enviadas e recebidas, respostas pelo celular e pela API ou a presença dos destinatários; Chamadas mostra os resultados das chamadas. Arraste pelo gráfico para reduzir o intervalo de datas compartilhado, ou use o seletor de datas. Os resultados são agrupados pelo momento em que cada janela de conversa de 24 horas foi concluída. Os detalhamentos por país, mensagem e dispositivo seguem a métrica selecionada no gráfico. O nome dela aparece no canto superior direito de cada painel. Cada categoria tem uma contagem absoluta ou um tempo de resposta com uma barra horizontal; a visualização compacta não tem colunas de porcentagem. Clique em qualquer ponto da linha de uma categoria ou use o botão Filtrar dela para filtrar o gráfico de conversas e todos os detalhamentos de conversas. Os filtros se cruzam: escolher Brasil e Imagem seleciona apenas as conversas concluídas com os dois valores. Remover filtro × aparece abaixo do cabeçalho do painel afetado. Os chips acima da linha do tempo também removem filtros individuais; Limpar filtros remove todos. O gráfico e os detalhamentos usam as mesmas conversas filtradas. As abas sublinhadas Tipo, Tamanho e Origem alternam entre o tipo, a faixa de tamanho e a origem da primeira mensagem enviada. As ações de divisão, expansão e exportação seguem a aba selecionada. Use as teclas de seta para a esquerda e para a direita para passar de uma aba para outra. As faixas de tamanho são sem texto, 1–160, 161–500, 501–1.500 e mais de 1.500 caracteres, com Desconhecido à parte. O país do destinatário é inferido a partir da numeração telefônica completa, não da localização nem da nacionalidade. Códigos de chamada compartilhados não são tratados como países únicos. Intervalos antigos sem metadados de país continuam como Desconhecido. As faixas de quantidade de dispositivos do destinatário são Só principal, 1 dispositivo vinculado, 2+ dispositivos vinculados e Desconhecido. A contagem de vinculados exclui o dispositivo principal. Uma lista observada completa estabelece uma contagem; uma lista ausente, desatualizada ou invalidada continua como Desconhecido. Cada detalhamento tem uma faixa de ações. No desktop, passe o cursor ou coloque o foco dentro do painel para expandir os controles; telas de celular e de toque os mantêm visíveis. Expandir todos abre uma tabela com busca de todas as categorias retornadas, com a contagem de conversas concluídas, a parcela, as contagens de entregues/lidas/respondidas e o tempo de resposta. A tabela herda os filtros ativos. Dividir por nomeia a dimensão desse detalhamento e compara as categorias dele na linha do tempo principal de conversas. Selecione de novo para remover a divisão. O menu Dividir por da linha do tempo também permite escolher outra dimensão ou Sem divisão sem adicionar outra linha do tempo. Abra o menu … de um detalhamento e selecione Exportar como CSV para ter uma linha agregada por categoria. As exportações por país usam códigos de país. As exportações incluem todas as categorias retornadas no projeto, número, intervalo de datas e filtros ativos selecionados, inclusive as categorias além das seis primeiras linhas da tabela compacta. A busca na tabela expandida muda a lista visível; ela não restringe a exportação. O nome do arquivo inclui o intervalo de datas UTC selecionado. Contagens, parcelas, numeradores de resultado, porcentagens de leitura/resposta e o tempo de resposta ponderado ficam em colunas separadas. Taxas e tempos de resposta indisponíveis são campos vazios, não zeros. Para dados conjuntos por hora, abra o menu … da linha do tempo e selecione Exportar linhas de conversas como CSV. Essa exportação preserva cada linha de conversa correspondente, com o intervalo de conclusão, as dimensões e os numeradores brutos de resultado. Exportar todos os dados baixa como CSV todos os campos do escopo. A resposta da API continua em JSON. As taxas de leitura e de resposta dividem as contagens de resultado pelas conversas concluídas. O tempo de resposta divide o atraso total até a primeira resposta pelas conversas respondidas; ele não faz a média das médias das categorias. Cobertura parcial, conversas descartadas e resultados truncados ocultam as taxas de resultado e o tempo médio de resposta; as contagens observadas continuam disponíveis. Intervalos medidos sabidamente vazios mostram contagens zero; intervalos não observados continuam como lacunas. São associações observadas, não evidência de que um formato de mensagem causou uma resposta. Os filtros de país e de quantidade de dispositivos também se aplicam aos sinais dos destinatários. Mudar para os sinais dos destinatários limpa os filtros de tipo de mensagem, tamanho e origem do envio, porque esses atributos pertencem aos resultados das conversas. Selecionar as operações do número limpa os filtros de destinatários. Os dados de conexão, de celulares próprios, de plataforma e de chamadas seguem o escopo de projeto/número/data.Atividade dos destinatários e horário comercial
Abra Destinatários para ver mensagens recebidas, recibos de entrega, recibos de leitura e sinais observados de online/offline/digitando. Sinais dos destinatários sobrepõe as seis séries de sinais no mesmo gráfico. Os quatro controles acima do gráfico principal selecionam mensagens recebidas, recibos de entrega, recibos de leitura e atividade. O controle de atividade inclui as horas locais, os sinais de online/offline/digitando e os intervalos médios sem sinais. Essas medições usam um único gráfico; os painéis compartilhados de país, uso dos dispositivos e quantidade de dispositivos mostram a medição selecionada e filtram ou dividem esse gráfico. Selecione um sinal individual acima do gráfico ou clique em uma entrada da legenda do gráfico para isolá-lo. As linhas de país, de quantidade de dispositivos e de Uso dos dispositivos filtram os sinais observados. Cada painel oferece Expandir todos, Dividir por e Exportar como CSV. Dividir a visualização combinada de sinais muda para mensagens recebidas; selecione outro sinal para compará-lo pelas mesmas categorias. As tabelas expandidas e as exportações em CSV incluem as contagens de presença, os intervalos sem sinais concluídos e a média ponderada deles; médias indisponíveis continuam como campos vazios no CSV. Selecione Intervalo médio sem sinais para ver no gráfico o comportamento dos dispositivos ao longo do tempo e, depois, Dividir por Uso dos dispositivos para comparar dispositivos principais e vinculados no mesmo gráfico. Uso dos dispositivos separa os sinais atribuídos a um dispositivo principal, a um dispositivo vinculado ou a uma origem Desconhecida. Um índice de dispositivo remetente diferente de zero é uma observação de dispositivo vinculado. Um recibo de entrega significa que a mensagem chegou a um dispositivo, independentemente de um recibo de leitura. Vários dispositivos podem gerar recibo para a mesma mensagem; as contagens de recibos não são pessoas nem mensagens únicas. Intervalo médio sem sinais usa intervalos concluídos de pelo menos 15 minutos entre sinais do mesmo dispositivo observado. Ele exclui intervalos em aberto e não estabelece tempo online/offline, estado de energia nem capacidade de resposta. A presença no nível do usuário tem uma origem de dispositivo Desconhecida. A presença continua sujeita às suas configurações de presença existentes. Um envio pretendido reutiliza uma inscrição permitida no destinatário dentro de limites definidos; as Análises não ativam a presença, não colocam o seu número online e não consultam todos os contatos. Abra o controle de Atividade e selecione Mensagens recebidas por hora local. Depois, escolha um Fuso horário comercial com busca. Isso substitui o gráfico principal em vez de adicionar outro. O gráfico combina as contagens por hora observadas em horas locais do relógio ao longo do período selecionado, incluindo as mudanças de horário de verão. Horas não observadas continuam como lacunas. Hora observada com mais mensagens compara o volume recebido nas linhas observadas, incluindo a cobertura parcial indicada no painel. Ela não estabelece a hora de maior movimento considerando os dados ausentes nem prevê conversão. As contagens por hora descrevem quando a atividade foi coletada, então a chegada atrasada de uma mensagem pode deslocá-la para uma hora de observação posterior. A API retorna o campo opcionalrecipientActivity no resumo e em cada número:
rows inclui a hora UTC, o país, a faixa de quantidade de dispositivos, a origem do dispositivo, as contagens de
mensagens recebidas e de recibos, as contagens de presença, o último sinal, a contagem de intervalos sem sinais concluídos e a soma
bruta das durações. Verifique measured, complete, observedBuckets, droppedSignals e
truncated. A falta de cobertura histórica deixa taxas ou médias indisponíveis.
Esses agregados não contêm identidades de destinatários nem índices de dispositivos.
O Linked Devices fornece as observações de mensagens dos destinatários. As Análises de mensagens
oficiais não são medidas, incluindo as conversas endereçadas por BSUID. A cobertura
de chamadas é separada.
Observações de dispositivos
Dispositivos separa as plataformas estimadas das mensagens recebidas de clientes das mensagens enviadas pela sua conta. As contagens descrevem mensagens diretas, não pessoas únicas nem dispositivos físicos. Os prefixos dos IDs de mensagem do WhatsApp fornecem a estimativa: Web, Android, iPhone, iPad, macOS, Windows, wearables, dispositivos de RA ou Desconhecido. Os prefixos podem ser falsificados e não verificam fabricante, modelo, versão do sistema operacional nem a propriedade do dispositivo. Desconhecido entra no denominador. Pesquise e expanda um número conectado para ver os índices observados dos dispositivos dele, a classe informada aproximada, a plataforma de envio estimada e a última mensagem observada. Uma lista completa observada pode ter até 25 entradas. Mudanças incrementais nos dispositivos deixam a lista completa desatualizada: a composição atual e a quantidade de dispositivos ficam desconhecidas até que outra lista completa seja observada. Um índice não é um identificador permanente de hardware; a última atividade é uma mensagem observada, não tempo de conexão ativa. A API expõe essas medições emdeviceAnalytics, e as linhas de conversa correspondentes em conversationBreakdown. Esses campos e recipientActivity são incluídos nas exportações JSON completas e nos destinos de análises por hora. Consulte análises de dispositivos no TypeScript para ler esses agregados e a API de Contatos ao vivo existente para a lista de dispositivos vinculados de um destinatário. As Análises não retêm identidades de dispositivos por destinatário, IDs brutos de mensagens nem conteúdo de mensagens.
Atividade do celular, da Polymorfa e dos clientes
Operação de respostas compara as mensagens e respostas observadas a partir do celular principal, de outros dispositivos vinculados e da Polymorfa em uma tabela ao lado da linha do tempo de respostas. Ela também mostra o tempo médio de resposta do celular principal e a última atividade observada. O tempo de resposta da Polymorfa começa na mensagem direta mais recente sem resposta e termina com um envio bem-sucedido; envios com falha não contam como respostas. Um período ativo do celular principal começa com um sinal depois de pelo menos 15 minutos sem sinal observado. Isso mede evidências de atividade, não ciclos de energia do celular, tempo de conexão contínuo nem estado offline verificado. A atividade não observada continua desconhecida. Período médio de atividade mede o tempo entre o primeiro e o último sinal em períodos de atividade concluídos. Um período com um único sinal tem duração zero. Intervalo médio sem atividade mede os intervalos concluídos de pelo menos 15 minutos entre sinais sucessivos. A visualização mostra o número de amostras de cada média; intervalos em aberto e reinícios não entram nessas médias. Escolha Intervalos do celular para ver as médias ao longo do tempo no gráfico. Um período concluído é contabilizado quando fecha; um intervalo é contabilizado quando o próximo sinal chega. Por isso, um período pode incluir intervalos que começaram antes do intervalo de datas selecionado. A API JSON expõecompletedPhoneActivityPeriods, phoneActivityMs,
averagePhoneActivityMs, phoneQuietGaps, phoneQuietMs e averagePhoneQuietMs
em accountActivity. As linhas de série incluem somas de duração e contagens de amostras para que você
possa calcular médias ponderadas entre números.
Aguardando sua resposta e Maior espera são um retrato das conversas diretas
acompanhadas na última medição. Não são somas de retratos históricos e
ficam limitados à janela de conversas observada. O horário indica a idade
do retrato.
As contagens de clientes online, offline e digitando vêm de inscrições de presença
existentes. As Análises não se inscrevem em todos os clientes nem inferem a
disponibilidade deles quando faltam sinais. O gráfico de atividade pode comparar
a atividade de mensagens, respostas pelo celular e pela Polymorfa, sinais de clientes online e
digitando, ou chamadas atendidas e não atendidas. Selecionar um número filtra a atividade, o engajamento, os detalhes de chamadas e o gráfico. A tabela de números mantém disponíveis para comparação os números do escopo do projeto.
Chamadas
Chamadas mostra as chamadas registradas, a taxa de atendimento, as chamadas recebidas perdidas e as falhas. As linhas de chamadas recebidas e feitas comparam volume, taxa de atendimento, tempo médio até atender, duração mediana das chamadas e tempo total de conversa. Selecione Histórico de chamadas para ver registros individuais. O filtro de número também se aplica aos resumos de chamadas e ao gráfico diário de chamadas em UTC. A taxa de atendimento é o número de chamadas atendidas dividido por todas as chamadas registradas, exceto as que ainda estão tocando. O tempo de conversa exclui o tempo tocando. As estatísticas de duração incluem as chamadas atendidas com duração registrada; o tempo até atender inclui as chamadas com horário de atendimento registrado. A API retorna as contagens de observações de tempo, a média, a mediana e o percentil 95. Atendidas com menos de 10 segundos conta chamadas curtas com duração conhecida; isso não indica uma venda perdida. A taxa de retorno conta as chamadas recebidas perdidas seguidas de uma chamada feita e atendida para o mesmo contato correspondente, no mesmo número, em até 24 horas. O denominador contém apenas chamadas perdidas com um contato correspondente conhecido e uma janela completa de 24 horas. Janelas pendentes e contatos sem correspondência aparecem separadamente. Um retorno pode acontecer depois do fim do período selecionado. Trata-se de uma sequência de chamadas observada, não de prova de intenção de retorno nem de uma conversão de negócio. Expanda Detalhes de áudio e conexão para ver as medições informadas de mídia e do app, os motivos de encerramento das chamadas, os erros do app, os transportes de conexão, as chamadas de vídeo e as chamadas com vários participantes de app. Os campos de qualidade continuam desconhecidos quando não há medições. A qualidade do app usa o relatório cumulativo mais recente de cada conexão; o atraso e a variação de tempo do áudio são calculados em média por chamada antes da média geral. A taxa de perda de pacotes usa os pacotes perdidos e recebidos informados juntos. As contagens de erros e de transportes são chamadas distintas por categoria e podem se sobrepor. As contagens de participantes de app não descrevem os dispositivos de WhatsApp do cliente. As contagens de chamadas cobrem os registros retidos atribuídos ao número e ao projeto originais, incluindo as chamadas registradas da API oficial. Números recriados não herdam chamadas antigas por terem o mesmo nome. Números excluídos, números de teste e chamadas sem um proprietário original ficam excluídos. Chamadas feitas fora da Polymorfa não são inferidas. As configurações de histórico e retenção de chamadas existentes continuam separadas das Análises.Exemplos de API e configuração do coletor
Selecione o botão Análises API ao lado do seletor de datas para ver exemplos HTTP. Os exemplos usam o projeto, o número e o intervalo de datas selecionados. Eles leem as análises; a configuração de ativação da equipe continua sendo uma ação de proprietário ou administrador no Console. Abra o menu … e selecione Conectar um coletor para copiar uma configuração do OpenTelemetry com destaque de sintaxe para o projeto e o número selecionados. Escolha um período móvel de 1, 24 ou 168 horas e se quer incluir os detalhamentos de mensagens e de público. O período do coletor é independente do intervalo do calendário na página. Monte a sua chave de API no coletor; o Console não coleta nem salva essa chave. Consulte configuração do coletor para a configuração do backend e as definições das métricas.Ler as análises pela API
O botão de API do Console aparece depois que uma leitura das Análises ativadas é bem-sucedida e fica oculto enquanto essa leitura é atualizada ou falha. UseGET /platform/analytics com uma chave que tenha sessions:read. Uma chave da
organização lê a equipe dela, ou um projeto com projectId. Uma credencial de projeto fica
dentro do projeto dela. A rota específica de projeto é
GET /platform/projects/{projectId}/analytics.
sessionId opcional é o UUID do registro do número, não o nome nem o número de telefone dele.
start e end são milissegundos Unix. Quando você os omite, a API usa por padrão os
30 dias anteriores. O máximo é 366 dias. A atividade usa intervalos de medição de horas inteiras
cujo início está em start ou depois dele e antes de end; horas parciais não são
proporcionalizadas. As séries diárias usam UTC. Os resultados de conversas pertencem ao intervalo
em que a janela concluída deles é registrada, e não à data do primeiro envio.
O data da resposta contém:
enabledeperiod;requestVitals, com as requisições autenticadas de API/MCP registradas, as falhas e a taxa de erros da equipe ou do projeto selecionado; um filtro de número não restringe esses totais de requisições;summary, com a atividade agregada, a cobertura de números e o engajamento;numbers, com as mesmas métricas para cada número, além do status de conexão atual e do projeto dele;series, com atividade, respostas pelo celular, somas de intervalos do celular e contagens de amostras, atividade dos clientes e contagens de conexão de cada número. Os intervalos são por hora para períodos de até 48 horas e diários para períodos maiores, em UTC;calls, dentro do resumo e de cada número, com detalhamentos por direção, contagens de observações de tempo, qualidade informada, categorias de falha e retorno de chamadas perdidas;callSeries, com os resultados e tempos diários das chamadas de cada número, agrupados pelo horário de início da chamada em UTC. A seleção pelo início da chamada usa os timestamps exatos solicitados.
summary: null, numbers: [], series: [] e
callSeries: [].
measured, observedHours e lastObservedAt identificam a cobertura da telemetria
de mensagens; eles não descrevem a cobertura dos registros de chamadas.
O engajamento inclui o denominador de conversas concluídas, as contagens de recibos e de
respostas, as taxas anuláveis e as contagens de conversas, registros e junções de recibos descartados.
Não substitua taxas nulas por zero.
A taxa de erros da API conta as falhas em requisições autenticadas registradas
para o escopo selecionado. Recusas anteriores ao estabelecimento da identidade da equipe não são
incluídas. O status de conexão é um retrato atual, independente das datas.
O status de cada número é o status da sessão dele, como CONNECTED.
summary.connectedNumbers conta os números cujo status é CONNECTED. O
Console mostra CONNECTED e DISCONNECTED como Conectado e
Desconectado e exibe os outros status como foram informados.
Cada resumo e cada número incluem messageAnalysis.segments, customerActivity,
accountActivity e responseQueue. As linhas de segmento retornam contagens, parcelas,
taxas anuláveis, diferenças entre taxas e intervalos de 95%. messageAnalysis.complete
identifica a cobertura de metadados; categorias desconhecidas e cobertura ausente não devem
ser tratadas como zeros medidos. A fila inclui o próprio horário de observação e um
indicador de cobertura.
Use a referência da API da equipe ou a
referência da API do projeto para
ver todos os campos da resposta. O guia de Analytics do TypeScript
e o comando da CLI leem os mesmos agregados.