> For the complete documentation index, see [llms.txt](https://docs.otima.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otima.io/whatsapp/guia-de-usabilidade/relatorios/monitoramento-de-disparos.md).

# Monitoramento de disparos

Acompanhe entregabilidade, falhas, criticidade e logs das mensagens.

O relatório **Monitoramento de disparos** reúne métricas e logs de mensagens, retornos da Meta, erros de API, entregabilidade e criticidade. Use-o para acompanhar campanhas e investigar falhas específicas.

### Aplicar filtros

1. Abra **Relatórios > Monitoramento de disparos**.
2. Escolha o período: **Últimas 24 horas**, **Últimos 7 dias** ou **Últimos 30 dias**.
3. Pesquise por template, número ou erro.
4. Selecione o status desejado.
5. Selecione a criticidade.
6. Quando disponível, ajuste o Business Manager e a WABA.
7. Clique em **Visualizar** para carregar ou atualizar o relatório.

Clique em **Limpar** para remover os filtros. A busca e os cartões sempre consideram o período ativo.

### Resumo dos disparos

| Indicador                 | Significado                                                                       |
| ------------------------- | --------------------------------------------------------------------------------- |
| **Disparados (total)**    | Todas as mensagens incluídas no monitoramento, independentemente do estado final. |
| **Enviadas (sent)**       | Mensagens aceitas pela Meta; ainda não confirma entrega.                          |
| **Entregues (delivered)** | Mensagens com confirmação de chegada ao destinatário.                             |
| **Lidas (read)**          | Mensagens com confirmação de leitura, quando disponível.                          |
| **Falhas (failed)**       | Mensagens cujo envio ou entrega não foi concluído.                                |

Use o botão de informação de cada cartão para consultar a definição exibida pela plataforma. Os percentuais são calculados com os filtros aplicados.

### Criticidade

As ocorrências podem ser classificadas como:

* **Baixa:** impacto pequeno ou pontual.
* **Média:** requer acompanhamento e pode afetar parte do volume.
* **Alta:** impacto relevante que deve ser investigado rapidamente.
* **Crítica:** risco elevado ou interrupção importante da operação.

Priorize ocorrências altas e críticas, principalmente quando o mesmo código, número ou template aparece repetidamente.

### Evolução dos disparos

O gráfico compara disparados, enviados, entregues, lidos e falhos. Quando disponível, altere a granularidade para visualizar por hora ou em intervalos menores.

Uma diferença grande entre enviados e entregues pode indicar atraso, indisponibilidade do destinatário, bloqueio ou outro problema de entrega. Use o gráfico para identificar o momento da alteração e depois abra os registros do mesmo intervalo.

### Logs dos disparos

A listagem detalhada pode apresentar:

* ID do disparo;
* campanha e template;
* Business Manager e WABA;
* destinatário;
* Phone Number ID;
* status interno e status Meta;
* quantidades enviadas, entregues, lidas e falhas;
* taxas de entrega, sucesso e erro;
* erro de API e erro Meta;
* score de criticidade;
* data de envio, entrega e leitura;
* linha do tempo do processamento.

Clique em **Expandir detalhes** ou **Visualizar** no registro para consultar logs e payloads de requisição, resposta e webhook, quando fornecidos pela API.

> **Privacidade:** payloads podem conter números de telefone, identificadores e conteúdo operacional. Compartilhe telas e exportações somente com pessoas autorizadas.

### Investigar uma falha

1. Filtre pelo status **Falha**, **API** ou **Meta**.
2. Pesquise o número ou template afetado.
3. Abra o registro.
4. Verifique a linha do tempo.
5. Identifique se a falha ocorreu antes da chamada, na resposta da Meta ou no processamento do webhook.
6. Anote o código, o título e a mensagem do erro.
7. Compare com outros registros do mesmo período.
8. Verifique se a ocorrência é isolada ou recorrente.

#### Como diferenciar a origem

* **Erro antes da chamada:** pode envolver validação, permissão ou dados obrigatórios.
* **Erro de API:** a solicitação chegou ao serviço, mas não foi processada como esperado.
* **Erro Meta:** o provedor recusou ou restringiu a operação.
* **Webhook ausente ou tardio:** a mensagem pode permanecer sem status final até o retorno da Meta.

### Exportar

1. Aplique os filtros necessários.
2. Confira o total de resultados.
3. Clique em **Exportar**.
4. Escolha **PDF** para leitura e impressão ou **CSV** para análise dos dados brutos.
5. Aguarde a preparação do arquivo.

O CSV pode incluir dados de requisição, resposta, webhook e logs resumidos. Proteja o arquivo conforme a política da empresa.

### Quando o relatório estiver vazio

* clique em **Visualizar** após selecionar os filtros;
* amplie o período;
* clique em **Limpar**;
* confirme Business Manager e WABA;
* pesquise sem pontuação ou tente somente parte do número;
* aguarde a chegada dos webhooks mais recentes;
* confirme a permissão de acesso ao relatório.

### Boas práticas

* comece pela visão geral e aprofunde somente nos registros relevantes;
* investigue padrões, não apenas uma mensagem isolada;
* registre filtros e horários ao abrir um chamado;
* não considere **enviada** como sinônimo de **entregue**;
* evite compartilhar payloads em canais não autorizados.