Integración Mautic n8nAutomatiza Mautic con n8n.
¿Tus contactos de Mautic siguen moviéndose a mano? La integración Mautic n8n trae dos nodos: el nodo Mautic, con 20 operaciones repartidas en 6 recursos, y el Mautic Trigger, que recibe por webhook los eventos de tu instancia en cuanto ocurren.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué cubre en realidad la integración Mautic n8n?
Mautic es un software open source de automatización de marketing: captación de contactos, puntuación, segmentación y campañas, sobre una instancia que alojas tú. La integración Mautic n8n pone esa instancia detrás de dos nodos. El nodo Mautic reúne 20 operaciones repartidas en 6 recursos, desde contactos y empresas hasta segmentos, campañas y emails. El Mautic Trigger escucha la instancia por webhook, una URL que Mautic llama cuando ocurre un evento.
Primer escenario, altas que caen en el segmento correcto. Un formulario de un sitio Wordpress manda su respuesta a n8n, contact.create escribe a la persona en Mautic con su email y su nombre, y contactSegment.add la coloca en el segmento que corresponde a ese formulario. Se acabó el CSV del viernes por la tarde.
Segundo escenario, una puntuación que sigue lo que hace la gente. Un evento de producto entra en el flujo, contact.editContactPoint suma o resta puntos al contacto y campaignContact.add mete en una campaña a quien pasa el umbral. La misma ejecución avisa al equipo en Slack cuando el contacto merece una llamada.
Tercer escenario, emails que salen de Mautic pero se deciden fuera. contact.sendEmail manda a un contacto concreto un email de campaña ya montado en Mautic, y segmentEmail.send lanza el mismo mensaje a un segmento entero. Quien viene de SendGrid suele mantener este reparto: el diseño se queda en la herramienta de marketing y el disparo se muda al flujo.
El nodo cubre 6 recursos. Todo lo demás de la API de Mautic pasa por el nodo HTTP Request, que llama a cualquier endpoint reutilizando el mismo credential, el acceso que guardas una sola vez en n8n, con su autenticación predefinida. Esa es la salida cuando falta una operación, y no obliga a configurar nada de nuevo.
Dos límites conviene tenerlos claros antes de montar nada. Varias operaciones no marcan su identificador como obligatorio, Company ID o Contact ID por ejemplo, aunque la llamada no apunta a nada sin él: trátalos como obligatorios. Y el trigger no tiene comodín, los eventos que escucha se marcan uno a uno en Event Names or IDs, o se pasan por identificador con una expresión. La Reseña n8n cuenta en qué destaca la plataforma, y el Curso n8n recorre paso a paso la construcción de estos flujos.
¿Cómo se conecta Mautic con n8n?
- 01
Activar la API en Mautic
Nada funciona mientras la API siga cerrada. En Mautic, abre Settings > Configuration, entra en API Settings, pon API enabled? en Yes y guarda. Ese ajuste manda sobre los dos métodos de autenticación y saca a la luz el menú API Credentials que necesita OAuth2.
- 02
Elegir entre basic auth y OAuth2
El camino corto es basic auth: el credential pide la URL de tu instancia, un Username y un Password, y Mautic quiere Enable HTTP basic auth? en Yes dentro de Configuration > API Settings. OAuth2 pide en cambio un Client ID, un Client Secret y esa misma URL base.
- 03
Crear el cliente y guardar el credential
Para OAuth2, entra en Configuration > Settings, abre API Credentials, elige Create new client, marca OAuth 2 como Authorization Protocol y ponle un nombre como
n8n integration. Copia la OAuth Callback URL de n8n en el campo Redirect URI, aplica y pega luego el Client ID y el Client Secret en n8n.
¿Qué dispara un flujo desde Mautic ?
Mautic Trigger es el nodo que arranca un workflow cuando Mautic llama a n8n. Activas el workflow: n8n te da la URL del webhook que registras en Mautic, y cada llamada se convierte en una ejecución.
Lo que ves en n8n
Notas de configuración
01Configure the Mautic Trigger
El nodo trigger registra un webhook, es decir una URL que Mautic llama por su cuenta cada vez que ocurre un evento marcado. n8n registra esa URL al activar el flujo, y cada evento llega en unos segundos: nada consulta la instancia cada cierto tiempo.
Parámetros clave
- Event Names or IDs: obligatorio, y el único ajuste que el trigger necesita de verdad. Marca los eventos en la lista, o pasa sus identificadores con una expresión, la fórmula
{{ $json.campo }}que busca un valor en el item que entra. - Events Order: DESC o ASC, el sentido de lectura cuando Mautic pone varios eventos en cola y los entrega en una sola llamada.
02Follow Up With the Mautic Node
Un trigger solo avisa de que ha pasado algo. Lo interesante viene justo después, cuando el nodo Mautic retoma el hilo: contact.get lee la ficha completa, contact.editContactPoint mueve la puntuación, contactSegment.add coloca el contacto en otra lista. Cada una de esas operaciones saca su Contact ID del item que produjo el trigger, con una expresión, sin escribir nada a mano.
¿Qué sabe hacer el nodo Mautic ?
El nodo Mautic expone 20 operaciones en 6 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get | Get Many | Update | Delete | Add | Remove | Edit Contact Points | Edit Do Not Contact List | Send | Send Email |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign Contact | ✓ | ✓ | |||||||||
| Company | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
| Company Contact | ✓ | ✓ | |||||||||
| Contact | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| Contact Segment | ✓ | ✓ | |||||||||
| Segment Email | ✓ |
Índice de operaciones
Campaign Contact
2 operacionesAdd a campaign contact
campaignContact.addLo que ves en n8n
Notas y casos de uso
Mete en una campaña a un contacto que ya existe en Mautic: los pasos de esa campaña empiezan a ejecutarse para él.
Parámetros clave
- Contact ID: el identificador del contacto en Mautic, casi siempre heredado del nodo anterior con una expresión como
{{ $json.id }}. - Campaign Name or ID: también obligatorio. Las campañas salen en una lista desplegable, y una expresión aporta el identificador cuando la campaña depende del item que llega.
Remove a campaign contact
campaignContact.removeLo que ves en n8n
Notas y casos de uso
Saca al contacto de una campaña. La ficha sigue en la instancia con su historial, lo único que termina es su pertenencia a esa campaña.
Parámetros clave
- Contact ID: quién sale. Casi siempre es el identificador que trae el paso anterior, nunca un valor escrito a mano dentro del nodo.
- Campaign Name or ID: la campaña que abandona, elegida en la lista desplegable o resuelta por expresión cuando el flujo decide sobre la marcha.
Company
5 operacionesCreate a company
company.createLo que ves en n8n
Notas y casos de uso
Aparece una ficha de empresa en Mautic, lista para reunir a los contactos que trabajan allí. Ningún campo es obligatorio, así que rellena Company Name si quieres reconocer la ficha más adelante.
Parámetros clave
- Company Name: el nombre con el que la empresa aparece en Mautic.
- Additional Fields: 12 entradas opcionales, entre ellas Company Email, Phone, Website, Industry Name or ID, Annual Revenue y Number of Employees, más Custom Fields para lo que defina tu instancia.
- Simplify: activado, n8n devuelve una versión reducida de la respuesta en lugar de los datos en bruto de la API.
Delete a company
company.deleteLo que ves en n8n
Notas y casos de uso
Borra una empresa de la instancia. n8n no marca Company ID como obligatorio, pero sin él la operación no apunta a nada.
Parámetros clave
- Company ID: el identificador de la empresa que se elimina, heredado de una búsqueda o de una lista de duplicados.
- Simplify: deja la respuesta corta cuando el flujo solo espera una confirmación.
Get a company
company.getLo que ves en n8n
Notas y casos de uso
Lee una sola empresa y pasa sus datos al nodo siguiente. No escribe nada, así que sirve de prueba para un credential recién guardado.
Parámetros clave
- Company ID: la ficha que se lee. Una expresión mantiene el campo dinámico cuando el identificador llega del item anterior.
- Simplify: la respuesta corta basta casi siempre; desactívalo si un nodo posterior necesita un campo que la versión reducida deja fuera.
Get many companies
company.getAllLo que ves en n8n
Notas y casos de uso
La operación de listado para empresas: un item por cada una, listo para recorrer en el resto del flujo.
Parámetros clave
- Return All: activado, n8n encadena las páginas de la API de Mautic hasta la última empresa; desactivado, Limit fija cuántas vuelven.
- Search: una cadena o un comando de búsqueda de Mautic, para filtrar antes de que la lista entre en n8n.
- Order By Name or ID y Order Direction: la columna por la que ordenar, y el sentido asc o desc.
Update a company
company.updateLo que ves en n8n
Notas y casos de uso
Escribe valores nuevos sobre una empresa que ya existe. Solo viajan a Mautic los campos que rellenas, el resto de la ficha se queda como está.
Parámetros clave
- Company ID: la empresa que se modifica, salida de un
company.getAllanterior o de tu propia base. - Update Fields: 13 entradas, el mismo terreno que en la creación más Company Name, así que renombrar una empresa es una sola llamada.
- Overwrite With Blank: activado, los valores vacíos se escriben en los campos; desactivado, se omiten, lo que protege los datos ya guardados.
Company Contact
2 operacionesAdd a company contact
companyContact.addLo que ves en n8n
Notas y casos de uso
Dos identificadores, un vínculo: el contacto queda unido a la empresa y Mautic sabe quién trabaja dónde.
Parámetros clave
- Contact ID: el identificador del contacto que se une.
- Company ID: el de la empresa. Ninguno de los dos aparece como obligatorio en la interfaz, así que en la práctica los dos llegan de nodos anteriores.
Remove a company contact
companyContact.removeLo que ves en n8n
Notas y casos de uso
El vínculo desaparece, las dos fichas siguen. Sirve cuando la relación cambia y el historial tiene que quedarse donde está.
Parámetros clave
- Contact ID: la persona que se desvincula.
- Company ID: la empresa de la que se separa, indicada por su identificador y nunca por su nombre.
Contact
8 operacionesCreate a contact
contact.createLo que ves en n8n
Notas y casos de uso
Crea el contacto en Mautic. Dos maneras de rellenarlo: campo a campo, o con un cuerpo JSON cuando el dato llega ya estructurado.
Parámetros clave
- Email, First Name, Last Name: los campos de identidad, tomados del item entrante.
- Primary Company Name or ID: une el contacto nuevo a una empresa.
- JSON Parameters y Body: activa el primero y los parámetros del contacto viajan en JSON.
- Additional Fields: 23 entradas, entre ellas Tag Names or IDs, Stage Name or ID, B2B or B2C, Prospect or Customer y Custom Fields.
Delete a contact
contact.deleteLo que ves en n8n
Notas y casos de uso
Elimina un contacto de Mautic. El nodo no pide confirmación: un identificador equivocado elimina a la persona equivocada.
Parámetros clave
- Contact ID: el único campo que cuenta aquí, y el que conviene revisar dos veces antes de activar el flujo.
Edit a contact's points
contact.editContactPointLo que ves en n8n
Notas y casos de uso
Mautic puntúa a sus contactos, y esta operación sube o baja esa puntuación desde un flujo, con las señales que generan tus propias herramientas.
Parámetros clave
- Contact ID: el contacto cuya puntuación se mueve.
- Action: add o remove, el sentido del cambio.
- Points: cuántos puntos aplica esa acción.
Add/remove contacts from/to the do not contact list
contact.editDoNotContactListLo que ves en n8n
Notas y casos de uso
Marca a un contacto como no contactable en un canal, o le quita esa marca. El consentimiento vive en Mautic y esta operación lo respeta desde el flujo.
Parámetros clave
- Channel: obligatorio, email o sms.
- Action: add lo pone en la lista, remove lo saca.
- Contact ID: el contacto afectado.
- Reason To Do Not Contact: Unsubscribed, Bounced o Manual, con Comments para el detalle que leerá un compañero meses después.
Get a contact
contact.getLo que ves en n8n
Notas y casos de uso
Recupera un contacto y sus campos. Es el paso que suele seguir a un evento que avisa de que alguien se ha movido.
Parámetros clave
- Contact ID: el contacto que se lee, normalmente una expresión que apunta al identificador que trae el nodo anterior.
- Options: Minimal devuelve la entidad sin sus listas anexas, y RAW Data devuelve la respuesta completa de la API en lugar de solo los valores de los campos.
Get many contacts
contact.getAllLo que ves en n8n
Notas y casos de uso
Devuelve los contactos de la instancia como una lista de items. Aquí empiezan casi todas las exportaciones y todas las auditorías de una base Mautic.
Parámetros clave
- Return All: activado, n8n sigue la paginación de la API hasta el final; desactivado, Limit decide cuántos contactos vuelven.
- Search: un comando de búsqueda de Mautic recorta la lista, mejor que filtrar miles de items más adelante.
- Published Only: se queda solo con las entidades publicadas.
Send email to a contact
contact.sendEmailLo que ves en n8n
Notas y casos de uso
Envía a un solo contacto un email de campaña que ya existe en Mautic. El mensaje sigue siendo el que preparó marketing, el flujo elige quién lo recibe y cuándo.
Parámetros clave
- Campaign Email Name or ID: obligatorio, elegido entre los emails de campaña de la instancia o resuelto por expresión.
- Contact ID: obligatorio también, el destinatario único de ese envío.
Update a contact
contact.updateLo que ves en n8n
Notas y casos de uso
Actualiza un contacto que ya existe. Update Fields es la colección más amplia del nodo, 31 entradas, y ahí acaba casi todo el trabajo de enriquecimiento.
Parámetros clave
- Contact ID: el contacto que se modifica.
- Update Fields: los campos de identidad más Tag Names or IDs, Stage Name or ID, Owner ID, Has Purchased, Last Active y los Custom Fields.
- JSON Parameters: activado, los parámetros viajan en Body como JSON, útil cuando el contenido ya viene montado de antes.
Contact Segment
2 operacionesAdd a contact to a segment
contactSegment.addLo que ves en n8n
Notas y casos de uso
Coloca un contacto dentro de un segmento. Los segmentos son las listas a las que Mautic envía, así que aquí una decisión del flujo se convierte en audiencia.
Parámetros clave
- Contact ID: obligatorio, el contacto que entra en la lista.
- Segment Name or ID: obligatorio, elegido entre los segmentos de la instancia o dado por su identificador con una expresión, útil cuando el segmento depende de un campo del item.
Remove a contact from a segment
contactSegment.removeLo que ves en n8n
Notas y casos de uso
Quita al contacto de la lista. Lanzarla justo antes de un alta evita que la misma persona acabe en dos segmentos que se contradicen.
Parámetros clave
- Contact ID: obligatorio, el contacto que sale.
- Segment Name or ID: obligatorio, el segmento que abandona.
Segment Email
1 operaciónSend an email to a segment
segmentEmail.sendLo que ves en n8n
Notas y casos de uso
Un campo, un envío: el email de segmento sale hacia toda la lista a la que apunta. Es la versión en lote del envío a un contacto suelto.
Parámetros clave
- Segment Email Name or ID: obligatorio, y el único parámetro de la operación. Elige el email de segmento en la lista, o pasa su identificador con una expresión cuando el envío se decide antes.
¿Necesitas ayuda para automatizar Mautic con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
