WhatsApp - Histórico de Mensagens

O que é

O Histórico de Mensagens é o registro completo de tudo que o sistema enviou (ou tentou enviar) pelo WhatsApp da empresa: mensagens automáticas de reserva, cobranças, lembretes de viagem, aniversários, pesquisas de satisfação e também os testes manuais feitos pelos atendentes. Cada linha mostra o destinatário (com card do cliente quando o telefone bate com um cliente cadastrado), o trecho da mensagem, o tipo, o status atual de entrega e a data.

O usuário normalmente chega aqui em duas situações: para confirmar que uma mensagem importante chegou (status "Entregue" ou "Lida") ou para investigar por que um cliente reclamou que não recebeu uma notificação. Mensagens com status "Falha" mostram a causa do erro logo abaixo do status e ganham um botão de reenvio direto na linha.

Como usar

1. Vá em Modulos > WhatsApp Mensagens no sidebar e abra o link Histórico de Mensagens (ou acesse direto /admin/whatsapp/messages).
2. No topo da tabela, três cartões mostram o total filtrado, quantas foram enviadas com sucesso e quantas falharam - esses números respeitam os filtros aplicados.
3. Para refinar a lista, use os filtros logo acima da tabela:
   • Buscar por telefone - digita parte ou todo o número do destinatário.
   • Status - Pendente, Enviada, Entregue, Lida ou Falha.
   • Tipo - Notificação, Lembrete, Verificação ou Manual.
   • Categoria - Reserva, Pagamento, Lembrete, Cliente ou Sistema.
   • Data início e Data fim - limita o intervalo pela data de criação.
4. Clique em Filtrar para aplicar. Para zerar a busca, clique no botão Limpar (aparece em vermelho ao lado quando há filtro ativo).
5. Para ver o conteúdo completo de uma mensagem, clique no ícone de olho na coluna Ações - abre um modal com o texto formatado (negrito, itálico, links clicáveis, blocos de código no padrão WhatsApp), os dados do cliente vinculado e a hora exata de envio.
6. Para reenviar uma mensagem que falhou, clique no ícone de seta circular (só aparece em linhas com status Falha) e confirme no modal. Uma nova linha é criada no histórico mantendo o registro da tentativa original.

Casos especiais

Cliente identificado automaticamente pelo telefone

Quando o número da mensagem bate com celular ou telefone de um cliente cadastrado, a coluna Destinatário mostra o avatar, o nome clicável (vai para a ficha do cliente), os selos de Verificado/Ativo e o e-mail. O match aceita variações com ou sem o prefixo 55 e ignora formatação (parênteses, traços, espaços). Se não houver cliente vinculado, aparece apenas o telefone formatado.

Mensagem com erro "número não possui WhatsApp"

Quando a API responde que o destinatário não tem WhatsApp ativo, a linha mostra um alerta laranja "Número inválido" em vez do texto técnico. Nesse caso, reenviar não resolve - corrija o número na ficha do cliente antes de tentar de novo.

Reenvio de mensagem antiga (template Meta)

empresas no provider Meta Cloud API precisam usar templates aprovados fora da janela de 24 horas. Ao reenviar, o sistema reconstrói os dados originais (nome do passageiro, código da reserva, data, destino, valor) a partir dos IDs guardados na mensagem original e tenta enviar pelo template correto. Se a mensagem antiga estava com um tipo genérico (ex: "confirmação", "financeiro"), uma heurística pelo conteúdo decide o template específico (reserva confirmada, pagamento confirmado, cobrança, etc.).

Filtros por URL

Para compartilhar uma visão filtrada (ex: "todas as falhas dos últimos 7 dias"), basta passar os parâmetros na URL: /admin/whatsapp/messages?status=failed&date_from={data-inicio}&date_to={data-fim}. Os mesmos parâmetros aceitos no formulário (status, type, category, phone, date_from, date_to) funcionam direto no link.

Erros comuns e como resolver

• "WhatsApp não está conectado." - Causa: a instância do WhatsApp da empresa caiu (desconexão por inatividade, celular fora de área ou sessão expirada). Solução: vá em Modulos > WhatsApp Mensagens e reescaneie o QR Code para reconectar antes de tentar reenviar.
• "Erro ao reenviar: ..." seguido de mensagem técnica - Causa: a Evolution API ou Meta Cloud API recusou o envio (número inexistente, template não mapeado, janela de 24h expirada sem template aprovado). Solução: clique em Ver Detalhes para ler o erro completo no card de Erro do modal e ajustar conforme o motivo (corrigir número, aprovar template no Meta ou aguardar nova interação do cliente).
• "Número inválido" (alerta laranja na linha) - Causa: o destinatário não tem WhatsApp ativo no número informado. Solução: confirme o número correto com o cliente e atualize a ficha; o reenvio só faz sentido após a correção.
• "Nenhuma mensagem encontrada" - Causa: nenhum registro bate com os filtros aplicados. Solução: clique em Limpar para resetar tudo e confirme se o período cobre datas reais de envio.

Onde encontrar

• URL: /admin/whatsapp/messages
• Caminho no menu: Modulos > WhatsApp Mensagens > Histórico de Mensagens
• Permissão necessária: ver o WhatsApp
• Módulo necessário: WhatsApp Mensagens (whatsapp-mensagens)

Veja também

• Conectar seu WhatsApp
• Configurações do WhatsApp
• Personalizar Templates
• Configurar Automações