Logs e debug

O modo de Debug liga o registro de cada envio do plugin pro Mautic — requisição, resposta e erros — em arquivos diários dentro de /wp-content/uploads/. Use sempre que um formulário não chegar no Mautic e você precisar entender o porquê.

Ativar o debug

Vá em Elementor → Configurações → Integrações → Mautic e mude Debug de No pra Yes. Salve.

A partir desse momento:

O plugin cria automaticamente a pasta /wp-content/uploads/elementor_mautic_logs/ (se ainda não existir).
Coloca um .htaccess dentro dela com Options -Indexes + deny from all — ninguém consegue listar nem baixar os arquivos via web.
Cada envio é gravado num arquivo com nome YYYY-MM-DD.log (um arquivo por dia, aberto em append).

Onde estão os logs

Diretamente em Elementor → Configurações → Integrações → Mautic, com o debug ligado, os arquivos .log aparecem listados como links clicáveis logo abaixo das opções. Clique pra abrir e ver o conteúdo no navegador.

Se preferir acessar pelo servidor:

Caminho: /wp-content/uploads/elementor_mautic_logs/
Formato: um arquivo por dia (2026-04-28.log, 2026-04-29.log, etc), com cada linha contendo dados da requisição + resposta do Mautic.

Apagar logs

Na tela de integrações, clique em Apagar logs. O plugin:

Apaga todos os arquivos .log da pasta.
Desativa o Debug automaticamente (volta pra No).

É a forma recomendada de fazer cleanup depois do troubleshooting — você não precisa lembrar de desligar o debug separado.

Não deixe o debug ligado em produção

Os logs podem conter dados sensíveis enviados nos formulários (nomes, e-mails, telefones, mensagens). Além disso, abrem o disco do servidor a um arquivo crescendo todo dia. Sempre desligue depois de resolver o problema — o botão Apagar logs já faz isso pra você.

O que esperar nos logs

Cada envio gera um bloco com:

A requisição que foi pro Mautic — método, URL, payload.
A resposta — status HTTP e corpo.
Erros capturados pelo plugin (mensagens de validação do Mautic, falhas de rede, etc).

Se o status é 200/302 o envio funcionou. Códigos comuns de problema:

401 — Mautic rejeitou a chamada (geralmente URL incorreta ou whitelist de IP).
403 — campos obrigatórios do Mautic não estão presentes/preenchidos no Elementor.
404 — ID do formulário Mautic está errado ou o formulário foi apagado.

Pra um checklist completo, veja Formulário não é enviado.

E no modo alternativo?

No Modo alternativo, o plugin não retorna mensagens de erro ao admin — só grava no log. Por isso, se você está no modo alternativo, ligar o debug é praticamente obrigatório quando algo dá errado: é a única forma de ver o que o Mautic respondeu.

Próximos passos

Formulário não é enviado — checklist passo-a-passo.
Modo alternativo — quando o debug é especialmente importante.