Conecte o Mautic ao n8n pelo Node nativo

O n8n possui um Node Mautic embutido. Você pode criar e atualizar contatos, associá-los a campanhas ou segmentos e trabalhar com empresas. A conexão exige a API habilitada no Mautic e uma credencial com Basic auth ou OAuth2.

Habilite a API no Mautic

No Mautic, abra Settings > Configuration, selecione API Settings e ajuste API enabled? para Yes. Grave a alteração antes de configurar a credencial no n8n.

Para Basic auth, habilite também Enable HTTP basic auth? em Configuration > API Settings. No n8n, informe a URL base do Mautic nos campos da credencial, junto de Username e Password.

A URL precisa identificar a instância que você pretende automatizar. Confira esse endereço antes de executar qualquer alteração em contatos para evitar gravar informações em outro ambiente Mautic.

Configure OAuth2 como alternativa

A documentação também oferece autenticação OAuth2. No Mautic, abra Configuration > Settings > API Credentials e crie um cliente com OAuth 2 em Authorization Protocol.

Copie a OAuth Callback URL exibida no n8n para Redirect URI no Mautic. Depois, transfira Client ID e Client Secret para a credencial do n8n e informe a URL base. Se o menu de credenciais não aparecer, confira primeiro se a API está habilitada.

Escolha o recurso conforme a tarefa

Recurso documentado	Exemplos de ações
Contact	Criar, consultar, atualizar e alterar pontos
Campaign Contact	Adicionar ou remover um contato de uma campanha
Contact Segment	Adicionar ou remover um contato de um segmento
Company	Criar, consultar e atualizar uma empresa
Company Contact	Associar ou remover um contato de uma empresa

Comece consultando um contato de teste. Confira o identificador retornado antes de usar ações que alteram pontos ou associações. Para adicionar um contato a uma campanha ou segmento, selecione o recurso correspondente e use os identificadores desses registros.

Confira no Mautic

Execute a ação com um registro destinado ao teste. Abra o contato no Mautic e confira os campos ou a associação modificada. Uma execução sem erro confirma a resposta da API. A leitura do registro mostra se o workflow alterou o contato esperado.

Para uma função ausente no Node, a documentação orienta usar HTTP Request com Predefined Credential Type e a credencial Mautic já configurada. Consulte o endpoint oficial antes de montar essa chamada.