# WhatsApp Analytics (new report)

{% hint style="info" %}
Esta página é dedicada para clientes que estão utilizando a nossa API chamada Conversation API (também chamada de **ConvAPI**).
{% endhint %}

O Whatsapp Analytics tem um novo layout, mais moderno e atualizado. Ao contrário do relatório legado, que se encontra no Menu Lateral > Mensageria > Reports, o **novo relatório** você vai encontrar no **Menu Lateral > Whatsapp > WhatsApp Analytics**:

<figure><img src="/files/u5VF8i6TnjQfJqIQW7G6" alt="" width="334"><figcaption></figcaption></figure>

Importante reforçar que dados enviados pelo Legado vão continuar disponíveis para consulta na visualização aqui: **Menu Lateral > Mensageria > Reports** .

#### Novo layout, novo design! <a href="#novo-layout-novo-design" id="novo-layout-novo-design"></a>

Atualizamos a interface do novo relatório, pensando na melhor experiência que podemos proporcionar aos nossos clientes.

#### Relatório Consolidado <a href="#relatorio-consolidado" id="relatorio-consolidado"></a>

<figure><img src="/files/Sr9evVqbjwoJSmIPr3pT" alt=""><figcaption></figcaption></figure>

Na área do **relatório Consolidado**, temos algumas mudanças. \
\
1\. filtro de **Campanhas:** agora é possível selecionar mais de uma campanha.\
2\. filtro de **Templates**: temos esse filtro disponível para ajudar nas buscas!\
3\. outra mudança é na **Periodicidade**. Você consegue selecionar períodos mensais, como visualizar os últimos 60 dias (2 meses), 90 dias (3 meses), 120 dias (4 meses) e até 180 dias (6 meses). \
\
Uma vez que realiza a busca, o novo layout está assim:<br>

<figure><img src="/files/vL1w2daJMtTID8cO0C4Q" alt=""><figcaption></figcaption></figure>

A exportação tem 3 tipos: CSV, XLSX e PDF da página.

#### Relatório Detalhado <a href="#relatorio-detalhado" id="relatorio-detalhado"></a>

Já a visualização do relatório Detalhado, temos os seguintes filtros:<br>

<figure><img src="/files/HOZIyz1lS6vlFX9LxQBH" alt=""><figcaption></figcaption></figure>

Agora é possível personalizar ainda mais seu relatório: selecione as colunas que deseja visualizar, e arraste-as na ordem que quiser.

Outra mudança é no filtro de **Status**. Agora disponibilizamos apenas estes status:<br>

* Mensagem enviada
* Erro no envio
* Entregue
* Não entregue
* Lido<br>

Eles são simplificados para deixar a experiência mais fluída no universo das Campanhas. Caso tenha o interesse em saber mais informações, se atente ao campo de **Status Description** (ou descrição do status). É aqui que vai obter maiores informações do que pode ter acontecido com suas mensagens.&#x20;

Aqui trouxemos alguns exemplos de status descriptions mais comuns que podem aparecer, para uma **mensagem não ter sido entregue**:

<table><thead><tr><th width="332.8125" align="center">Status Description</th><th width="334" align="center">Significado e possível ação a ser tomada</th></tr></thead><tbody><tr><td align="center">Mensagem não entregue: envio não foi feito propositalmente para garantir  um ecossistema saudável e evitar spam. </td><td align="center">Sua mensagem está com baixo quality rating pela Meta ou houve muitos bloqueios por parte dos usuários. Por conta disso, a Meta bloqueou o envio. A sugestão é que você colete o opt-in dos seus usuários antes de enviar novas mensagens!</td></tr><tr><td align="center">Mensagem não entregue: erro desconhecido.</td><td align="center">Erro desconhecido, com possibilidade de ter alguma intermitência de origem desconhecida. Tente enviar novamente a sua mensagem.</td></tr><tr><td align="center">Mensagem não entregue: formato do template incorreto.</td><td align="center">Verifique a estrutura do template e o que foi preenchido e enviado. Há inconsistência nesse envio.</td></tr><tr><td align="center">Mensagem não entregue: erro de entrega desconhecido.</td><td align="center">Pode ter várias causas, como telefone desativado, bloqueio permanente da operadora, número incompatível, etc</td></tr><tr><td align="center">The underlying channel reported: Message: (#132012) Parameter format does not match format in the created template (type: OAuthException, code: 132012, details: header component parameter should not be empty)</td><td align="center">Quando encontrar um <strong>status description</strong> similar a este, somente em inglês, significa que o erro está trazendo uma variável. O significado varia muito dependendo do caso.<br>Para este cenário, por exemplo, significa que a mensagem falhou por falta de uma variável no cabeçalho do template.</td></tr><tr><td align="center">Mensagem não entregue: O remetente do WhatsApp está desativado. Reative-o para voltar a enviar e receber mensagens.</td><td align="center">O Whatsapp do remetente está desativado, tente acioná-lo por outro canal.</td></tr><tr><td align="center">Mensagem não entregue: Esta mensagem foi bloqueada para manter uma experiência saudável no canal.</td><td align="center">Sua mensagem está com baixo quality rating pela Meta ou houve muitos bloqueios por parte dos usuários. Por conta disso, a Meta bloqueou o envio. A sugestão é que você colete o opt-in dos seus usuários antes de enviar novas mensagens!</td></tr></tbody></table>

Aqui listamos algumas das **principais causas comuns** para o seu usuário **não receber** sua **mensagem**:\
\
**1. Usuário desinstalou o WhatsApp:** a pessoa pode ter parado de usar o WhatsApp ou trocado de aparelho sem reinstalar o aplicativo.\
**2. Bloqueio pelo usuário (causa mais comum de falha):** o cliente bloqueou o número da sua empresa\
**3. Falta de Conexão com a Internet:** usuário offline\
**4. Bloqueio pela Meta por reputação:** se sua conta tiver uma baixa classificação de qualidade, a Meta pode proativamente impedir a entrega de suas mensagens, a fim de proteger a experiência do usuário final.\
**5. O Número Não Possui uma Conta de WhatsApp:** o número de telefone cadastrado pode ser de um telefone fixo ou de um celular que nunca ativou o WhatsApp\
\
Por isso, valide sua base de tempos em tempos, faça uma limpeza e tente mantê-la sempre atualizada!

#### Área de Relatórios Exportados <a href="#relatorio-detalhado" id="relatorio-detalhado"></a>

<figure><img src="/files/U4kqK6LhqesjVDVGXLz0" alt=""><figcaption></figcaption></figure>

A nova área traz uma experiência que vai ajudar a saber quando o relatório estiver pronto para download. Deixamos uma notificação em vermelho, além de deixarmos em destaque a linha com o relatório pronto!

\ <br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-pt.sinch.com/whatsapp/introducao-ao-messaging-whatsapp/whatsapp-analytics-new-report.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
