Documentação / Canal WhatsApp / Logs e analytics

Logs e analytics

Cada evento vira uma linha no log, com um código que diz exatamente o que aconteceu — e a maioria dos motivos de falha já vem traduzida em português.

Os códigos do log

CódigoSignificadoO que fazer
Enviado (200)A API aceitou a mensagem.Nada 🙂
ErroFalha no envio. O motivo aparece traduzido (ex.: “Token expirado”, “Fora da janela de 24h”).Corrija conforme a mensagem. Falhas temporárias são re-tentadas automaticamente 1× após 5 minutos.
Pulado (skip)O envio foi pulado de propósito — ex.: nenhum template mapeado para aquele status.Configure o mapeamento se o envio era esperado.
RecebidaMensagem recebida de um cliente.Verifique o e-mail de encaminhamento, se ativo.
Auto-respostaO canal respondeu automaticamente a um cliente.Nada.
Falha de entregaA Meta reportou falha ao entregar uma mensagem já aceita (ex.: número inexistente).Verifique o telefone do cliente no pedido.

O botão Reenviar em uma linha refaz o disparo daquele pedido+status.

Erros comuns e como resolver

MensagemSolução
Token de acesso inválido ou expiradoCredencial vencida — a equipe da Pixel Partners renova.
Fora da janela de 24hUse um template aprovado para iniciar a conversa.
Parâmetros do template não batemO número de variáveis é diferente do número de {{n}} — ajuste a lista de variáveis no mapeamento.
Template não existe / não aprovadoSincronize os templates e confira se o status está aprovado.

Erros ligados a credenciais, permissões e webhook (token, App Secret, links permanentes) são resolvidos pela equipe da Pixel Partners — se o log apontar um desses, é só acionar o suporte com o print da linha.

Analytics

A aba Analytics consolida os números por período — volume, taxa de sucesso e falhas — para você acompanhar a saúde do canal sem abrir linha por linha. É o termômetro rápido: se a taxa de sucesso cair, vale abrir os Logs para ver o motivo predominante.

Documentação do Canal WhatsApp · escrita com base na versão 1.4.0. As telas ilustradas podem variar conforme a versão instalada na sua loja.