Logs do WhatsApp
A seção de Logs do WhatsApp fornece um registro abrangente de todas as interações automatizadas processadas pelo módulo WhatsApp Cloud API Chat & Marketing. Isso inclui entregas de campanhas, respostas acionadas por bots e mensagens baseadas em templates. Use esta seção para monitorar atividade, solucionar problemas de entrega e manter uma trilha de auditoria completa das suas comunicações WhatsApp.
Acessando os Logs do WhatsApp
Navegue até WhatsApp Module > WhatsApp Logs na barra lateral do Perfex CRM. Os logs são exibidos em uma tabela ordenável e pesquisável que mostra toda a atividade de mensagens automatizadas.
Colunas da Tabela de Logs
Cada entrada de log contém as seguintes informações:
| Coluna | Descrição |
|---|---|
| # | Um ID auto-incrementado único para cada entrada de log |
| Category | O tipo de interação automatizada — ex.: Marketing Campaign, Template Bot |
| Name | O nome da campanha, bot ou automação que gerou a entrada de log |
| Template Name | O template de mensagem WhatsApp usado para a interação |
| Response Code | O código de resposta HTTP retornado pela WhatsApp Cloud API (ex.: 200 para sucesso, 400 para requisição inválida) |
| Type | O tipo de destinatário — ex.: Leads, Customers, Contacts |
| Recorded On | A data e hora em que a interação foi registrada |
| Actions | Ações disponíveis para cada entrada: View detalhes ou Delete o registro de log |
Entendendo os Códigos de Resposta
A coluna de código de resposta ajuda a identificar rapidamente se as mensagens foram entregues com sucesso ou encontraram erros.
| Código de Resposta | Significado | Ação Necessária |
|---|---|---|
| 200 | Sucesso — mensagem aceita pela API do WhatsApp | Nenhuma ação necessária |
| 400 | Bad Request — parâmetros inválidos ou problema com template | Revise o template e os parâmetros |
| 401 | Unauthorized — token de acesso inválido ou expirado | Regenere seu token de acesso nas configurações do Meta Business |
| 403 | Forbidden — permissões insuficientes | Verifique as permissões do System User |
| 404 | Not Found — ID de número de telefone ou endpoint inválido | Verifique o Phone Number ID nas configurações do módulo |
| 429 | Rate Limited — muitas requisições enviadas | Reduza a frequência de envio; tente novamente após o cooldown |
| 500 | Internal Server Error — problema na API do WhatsApp | Tente novamente mais tarde; verifique a página de status da Meta se persistir |
Um código de resposta de sucesso (200) confirma que a WhatsApp Cloud API aceitou a mensagem para entrega. Isso não garante a entrega final no dispositivo do destinatário — a confirmação de entrega vem através de atualizações de status via webhook visíveis na interface de chat.
Filtrando Logs
Use os filtros integrados para restringir as entradas de log e encontrar registros específicos rapidamente:
- Category — filtrar por tipo de interação (Marketing Campaign, Template Bot, etc.)
- Response Code — filtrar por sucesso (
200) ou códigos de erro específicos - Type — filtrar por tipo de destinatário (Leads, Customers, Contacts)
- Date Range — selecionar data de início e término para visualizar logs dentro de um período específico
- Search — pesquisa de texto livre em nomes de campanhas, nomes de templates e outros campos
Visualizando Detalhes do Log
Clique na ação View em qualquer entrada de log para ver os detalhes completos da interação, incluindo:
- Payload completo da requisição enviada à API do WhatsApp
- Corpo completo da resposta da API
- Número de telefone e referência do contato do destinatário
- Parâmetros do template e valores das variáveis utilizadas
- Carimbo de data/hora com informação de fuso horário
Esta visualização detalhada é inestimável para solucionar falhas de entrega ou auditar conteúdo específico de mensagens.
Excluindo Registros de Log
Para remover entradas de log individuais:
- Clique na ação Delete na linha do log desejado.
- Confirme a exclusão quando solicitado.
Para exclusão em massa de logs, use a seleção de caixas de marcação para selecionar múltiplas entradas e clique em Delete Selected.
Registros de log excluídos não podem ser recuperados. Se você precisa reter registros para fins de conformidade ou auditoria, considere exportar os dados antes da exclusão.
Boas Práticas
- Revise os logs regularmente — verifique se há falhas de entrega (códigos de resposta diferentes de 200) e resolva problemas prontamente para manter a eficácia das campanhas
- Monitore limites de taxa — se você vê respostas
429frequentes, reduza a taxa de envio da campanha ou distribua as entregas em janelas de tempo mais longas - Mantenha os tokens atualizados — erros
401indicam que seu token de acesso expirou ou foi revogado; atualize-o imediatamente para restaurar a funcionalidade - Arquive antes da limpeza — antes de excluir logs antigos, exporte ou documente quaisquer registros necessários para conformidade, relatórios ou resolução de disputas
- Use filtros para auditoria — ao investigar uma campanha ou bot específico, use os filtros de Category e Name para isolar as entradas de log relevantes rapidamente
Os Logs do WhatsApp capturam apenas interações automatizadas (campanhas, bots, envios de templates). Mensagens de chat manuais entre equipe e clientes são armazenadas no histórico de chat e não são duplicadas nesta seção de logs.