Se você configurou tudo e os envios não estão chegando no Mautic, siga este checklist na ordem. A maioria dos problemas cai num dos quatro primeiros itens.
Checklist rápido
-
A URL do Mautic está correta?
- Elementor → Configurações → Integrações → Mautic → campo Mautic URL.
- Sem barra no final:
https://mautic.exemplo.com(nãohttps://mautic.exemplo.com/). - Se o seu Mautic tem
/index.phpno caminho de login (mautic.site.com/index.php/s/login), você precisa incluir o/index.phpaqui.
-
O ID do formulário Mautic está preenchido?
- No editor do Elementor, abra o formulário e a ação Mautic em Ações Após Envio.
- Mautic Form ID precisa ter um número válido (o ID está na URL ao editar o formulário no Mautic).
-
Os IDs dos campos batem com o Mautic?
- Cada campo do Elementor tem um ID na aba Avançado.
- Esse ID precisa ser igual ao alias do campo no Mautic.
-
Todos os campos obrigatórios do Mautic existem no Elementor?
- Se o Mautic exige um campo que o Elementor não tem (ou tem como opcional), o envio falha com
403. - Campos opcionais no Mautic podem estar ausentes no Elementor sem problema.
- Se o Mautic exige um campo que o Elementor não tem (ou tem como opcional), o envio falha com
Se persistir, ative o modo alternativo
Vá em Elementor → Configurações → Integrações → Mautic e mude Modo alternativo pra Yes. Salve. Faça um novo teste.
Esse modo ajuda em cenários onde o servidor do Mautic está atrás de proxy/firewall ou exige cookies de sessão. Detalhes em Modo alternativo.
Se ainda persistir, ative o debug
- Em Elementor → Configurações → Integrações → Mautic, mude Debug pra Yes e salve.
- Volte pra página do formulário e envie um teste.
- Atualize a tela de integrações. Os arquivos
.logaparecem listados. - Faça download dos logs (ou copie o conteúdo) — eles têm a requisição e a resposta exata do Mautic.
- Clique em Apagar logs quando terminar — isso já desliga o debug automaticamente.
Veja detalhes em Logs e debug.
Os logs guardam os dados enviados pelos formulários — incluindo informações pessoais. Sempre apague depois.
Códigos de erro comuns
Erros aparecem pra usuários administradores na própria página, ou nos logs (modo debug):
| Código | Mensagem | Causa provável | O que fazer |
|---|---|---|---|
401 |
"Your Mautic Server sent an unauthorized response." | URL do Mautic incorreta, whitelist de IP no servidor Mautic, autenticação exigida. | Confirme a URL e cheque os logs do servidor Mautic. |
403 |
"Make sure that all required fields from Mautic are present and required on this Elementor form." | Algum campo obrigatório no Mautic não existe (ou não é obrigatório) no Elementor. | Compare os campos lado a lado. Veja Como configurar. |
404 |
"Form not found." | O ID do formulário no Elementor não bate com nenhum formulário do Mautic. | Confirme o ID na URL do formulário Mautic. Verifique se o formulário não foi apagado. |
mauticError=... |
(mensagem específica do Mautic) | Validação rejeitada por regra do próprio formulário Mautic. | Leia a mensagem; ajuste o campo/valor correspondente. |
O plugin só registra no log. Sempre teste com Debug ligado depois de ativar o modo alternativo.
Logs de debug não são criados
Se você ligou o debug e os arquivos .log não aparecem:
- Confirme que
/wp-content/uploads/é gravável pelo PHP do seu servidor. - Verifique espaço em disco.
- Confira se a pasta
elementor_mautic_logsfoi criada (deveria ter sido criada na hora que você salvou o debug como Yes).
Próximos passos
- Modo alternativo — se o padrão não resolve.
- Logs e debug — pra fazer leitura aprofundada dos arquivos.