O Modo alternativo é um caminho alternativo de envio que o plugin oferece quando o modo padrão não funciona com o seu Mautic — ou quando você precisa que o tracking do Mautic identifique a sessão do visitante.
Quando ativar
Use o modo alternativo se:
- O modo padrão simplesmente não envia o formulário (e os logs não ajudam a entender o porquê).
- O seu Mautic está atrás de proxy, CDN ou firewall que altera headers ou bloqueia chamadas de API.
- Você quer que o tracking do Mautic (campanhas baseadas em visitas anteriores) reconheça que o lead já navegava no site antes de enviar o formulário.
- Você quer que o IP real do visitante seja registrado no contato do Mautic.
Pra a maioria dos casos, o modo padrão é suficiente. O alternativo é útil em cenários específicos.
Como ativar
Vá em Elementor → Configurações → Integrações → Mautic e mude Modo alternativo de No pra Yes. Salve.
O que muda
| Padrão | Alternativo | |
|---|---|---|
| Endpoint | API oficial via biblioteca PHP do Mautic | POST {mautic_url}/form/submit?formId={id} |
| Cookies do Mautic | Não preserva | Envia mautic_session_id e mautic_device_id |
| Headers extras | — | Client-Ip, X-Forwarded-For, referer |
| IP do visitante | — | Capturado e enviado |
| Tracking de sessão | — | Sim, integra com a navegação prévia |
Hook connect_elementor_mautic_before_send_form |
Dispara | Não dispara |
| Mensagens de erro ao usuário | Sim (401, 403, 404, validação) | Não — só registra no log |
Limitações importantes
A action connect_elementor_mautic_before_send_form só executa no modo padrão. Se o seu fluxo customizado depende desse hook (ex: enriquecer o contato antes do envio), precisa rodar no padrão. Detalhes em Hook before_send_form.
No modo padrão, se o Mautic responde com 401, 403 ou 404, o plugin mostra a mensagem específica pro admin. No modo alternativo, o resultado é apenas gravado no log — o usuário não vê erro algum. Sempre teste com o Debug ligado depois de ativar. Veja Logs e debug.
Quando voltar pro padrão
Se o problema que motivou o modo alternativo for resolvido (ex: você ajustou a URL do Mautic, o firewall foi liberado, ou você passou a usar um Mautic em domínio direto), volte pro modo padrão. Você ganha de volta:
- Mensagens de erro úteis no admin.
- O hook
connect_elementor_mautic_before_send_form. - Validação completa via biblioteca oficial.
Próximos passos
- Logs e debug — pra investigar envios no modo alternativo.
- Formulário não é enviado — checklist quando a integração para de funcionar.