> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Análises do WhatsApp

> Acompanhe o engajamento das mensagens, os resultados das chamadas e os sinais de conexão dos seus números de WhatsApp.

Abra **Análises** na barra lateral principal do Console e selecione **Ativar análises**. Um proprietário ou administrador da equipe controla
essa configuração única para a equipe. Abra o menu **…** no canto superior direito e selecione **Desativar e apagar análises** para desativá-la. Confirme **Desativar e apagar histórico** para remover os agregados de mensagens e de engajamento armazenados da equipe e as entregas de destinos de análises na fila. Isso oculta as análises de negócio no Console e na API.

O banner de erros do Console mostra as falhas de API e de webhook das últimas 24 horas e leva a **Logs → Erros**. Ele segue o projeto selecionado e continua disponível quando as Análises estão desativadas. Escolher um número não filtra essas contagens operacionais. O acompanhamento começa depois da ativação; os metadados de conversas anteriores
não são reconstruídos. A visualização de chamadas usa os registros operacionais de chamadas retidos;
desativar as Análises não exclui esse histórico de chamadas separado.

Use o seletor de projeto no cabeçalho do Console para escolher um projeto ou **Todos os projetos**. As Análises abrem em **Últimas 24 horas**, o primeiro intervalo relativo predefinido. Ele cobre as 24 horas anteriores até o momento em que você o seleciona. Selecione as datas e um número com os controles no topo. **Todos os números** combina os números nesse escopo de projeto.

Em **Números**, abra as ações de um número de produção e selecione **Ver análises** para abrir as Análises com esse número selecionado. A seleção do número fica na URL da página. Selecione **Atualizar análises** para ler os dados mais recentes do período escolhido.

Abra **Todos os números** para pesquisar nomes de números, nomes de projetos ou IDs de registro. Selecione um número para filtrar a página, ou selecione a linha separada **Todos os números** para voltar à visualização combinada. O seletor agrupa os números por projeto em seções expansíveis com busca.

O intervalo de datas, os exemplos de API, **Exportar todos os dados**, a atualização e as ações do menu **…** ficam acima dos dados. Exportar todos os dados baixa um CSV do escopo de projeto e de número selecionado. O CSV preserva todos os campos retornados em formato longo: conjunto de dados, registro, ID do número, data e hora em UTC, métrica, valor e tipo do valor. Cada medição escalar tem a própria linha; valores ausentes ficam vazios com o tipo `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](/pt-br/console/usage-and-credits).

## O que os números significam

| Métrica | Medição |
| - | - |
| Mensagens enviadas | Envios bem-sucedidos observados pela sua conexão Linked Devices, incluindo envios para grupos |
| Mensagens recebidas | Eventos observados de mensagens diretas recebidas, incluindo reações; grupos excluídos |
| Taxas de entrega, leitura e resposta | Parcela das conversas diretas de 24 horas concluídas com o recibo correspondente ou com resposta do cliente |
| Seu tempo médio de resposta | Tempo entre a mensagem direta recebida mais recente sem resposta e o seu próximo envio bem-sucedido nessa conversa |
| Tempo de resposta do cliente | Tempo entre o primeiro envio bem-sucedido da conversa e a primeira resposta recebida em até 24 horas |
| Tempo de presença online | Tempo em que o seu número se anunciou como disponível; não é a presença do cliente nem o tempo de conexão ativa |
| Taxa de falha de envio | Envios com falha divididos pelas tentativas de envio observadas |
| Problemas de conexão | Desconexões, falhas de conexão, erros de stream e timeouts de keepalive observados |

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 opcional `recipientActivity` 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 em `deviceAnalytics`, 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](/pt-br/sdks/typescript/devices) 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õe `completedPhoneActivityPeriods`, `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](/pt-br/console/calls) 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](/pt-br/console/analytics-collectors) 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.

Use `GET /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`.

```bash theme={null}
curl --get "$POLYMORFA_API_URL/platform/analytics" \
  --header "Authorization: Bearer $POLYMORFA_API_KEY" \
  --data-urlencode "projectId=$PROJECT_ID" \
  --data-urlencode "start=1790812800000" \
  --data-urlencode "end=1790985600000"
```

O `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:

* `enabled` e `period`;
* `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.

As respostas desativadas têm `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](/api-reference/platform/analytics/read-team-analytics) ou a
[referência da API do projeto](/api-reference/platform/analytics/read-project-analytics) para
ver todos os campos da resposta. O [guia de Analytics do TypeScript](/pt-br/sdks/typescript/analytics)
e o [comando da CLI](/pt-br/tools/cli-api#leia-as-análises-do-whatsapp) leem os mesmos agregados.

## Conectar um coletor

Use a [exportação de métricas para coletores](/pt-br/console/analytics-collectors) para ler os gauges de engajamento,
conexão e chamadas com Prometheus ou OpenTelemetry. Ela usa a mesma
ativação das Análises e os mesmos escopos de projeto/número.

## Enviar análises para o seu endpoint

Abra **Configurações do projeto → Destinos** para gerenciar juntos os destinos de logs e de análises. Selecione **Adicionar destino → Análises**, ou abra **Destinos de análises** no menu **…** das Análises. Escolha todos os números do projeto ou um único número, um período móvel e um endpoint HTTPS público. Consulte [configuração de destinos de análises](/pt-br/console/analytics-collectors#enviar-retratos-json-por-hora) para a carga e o comportamento de entrega.

Consulte a [visão geral do produto](https://www.polymorfa.com/observability#analytics) para uma introdução visual.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.