A configuração acontece em três partes: criar o formulário no Mautic, conectar o plugin nas integrações do Elementor e ligar o formulário Elementor ao formulário Mautic.
1. Criar o formulário no Mautic
No Mautic, vá até Componentes → Formulários e crie um novo. O plugin funciona com qualquer tipo — independente ou de campanha.
Adicione os campos que precisar. No primeiro campo da aba Atributos, preencha um nome amigável — esse é o identificador que vai casar com o Elementor.
Por exemplo, pra um campo "Nome Completo", use algo como nome-completo ou nomecompleto.
Salve o formulário.
Captcha não consegue ser integrado via API. Se o formulário Mautic exigir captcha, o envio do Elementor vai falhar.
Ao editar o formulário no Mautic, o ID aparece na URL. Anote — você vai precisar dele no Elementor.
Na imagem acima, o ID é 1.
2. Configurar a URL do Mautic no WordPress
No painel do WordPress, vá em Elementor → Configurações → Integrações → Mautic e preencha:
- Mautic URL — a URL base da sua instalação do Mautic, sem barra no final. Exemplo:
https://mautic.exemplo.com.
Se a URL do seu Mautic é do tipo mautic.site.com/index.php/s/login, inclua o /index.php no campo: https://mautic.site.com/index.php. Sem isso, os envios falham.
Salve. Pronto — o plugin já consegue conversar com o seu Mautic.
3. Ligar o formulário Elementor ao Mautic
Edite a página onde está o formulário Elementor PRO. Os campos do formulário Elementor precisam ter os mesmos IDs que você deu aos campos no Mautic.
Em cada campo, abra a aba Avançado e ajuste o campo ID pro nome amigável que está no Mautic — nome-completo ou nomecompleto, por exemplo.
Em Ações Após Envio, selecione Mautic. Você pode combinar com outras ações (Mailchimp, e-mail, webhook, redirect) ou usar só o Mautic.
Nas configurações específicas que aparecem, preencha Mautic Form ID com o número do formulário no Mautic.
Salve a página. O formulário já está integrado.
A partir daqui, todo envio do formulário Elementor cria/atualiza o contato no Mautic em tempo real e dispara as automações configuradas naquele formulário Mautic.
Regras de campos obrigatórios
A regra de obrigatoriedade entre Mautic e Elementor é assimétrica:
- Obrigatório no Mautic → precisa ser obrigatório no Elementor. Se não for, a validação falha do lado do Mautic e o envio é rejeitado com erro
403. - Opcional no Mautic → pode ser obrigatório no Elementor (sem problema) ou pode nem existir no Elementor (também sem problema).
Se um campo é opcional no Mautic, ele simplesmente não precisa estar presente no formulário Elementor.
Modo alternativo (opcional)
Se o envio padrão não funciona com o seu Mautic — ou se você precisa que o tracking do Mautic identifique a sessão do visitante — ative o Modo alternativo na mesma tela de integrações. Detalhes em Modo alternativo.
Próximos passos
- Modo alternativo — quando e como ativar.
- Logs e debug — pra diagnosticar problemas.
- Formulário não é enviado — troubleshooting prático.