Recursos · Integración n8n

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

Por qué automatizar

¿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.

Conexión

¿Cómo se conecta Mautic con n8n?

  1. 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.

  2. 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.

  3. 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.

Disparadores

¿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 TriggerEl 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.

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.
Cuándo usarlo
siempre que la reacción tenga que seguir lo que pasa dentro de Mautic y no un reloj. El credential es el mismo del nodo Mautic, basic auth u OAuth2, así que no hay nada nuevo que crear.
02Follow Up With the Mautic NodeUn 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.

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.

Cuándo usarlo
en cuanto la reacción necesita un dato que el evento no trae, o una escritura de vuelta en Mautic. Un flujo que lee, decide y escribe se depura mejor que tres medias automatizaciones repartidas entre herramientas.
Casos de uso
recibir el evento, leer el contacto y enviarlo a la campaña que encaja con su estado, sin que nadie revise la lista a mano.
Acciones

¿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.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDeleteAddRemoveEdit Contact PointsEdit Do Not Contact ListSendSend Email
Campaign Contact✓✓
Company✓✓✓✓✓
Company Contact✓✓
Contact✓✓✓✓✓✓✓✓
Contact Segment✓✓
Segment Email✓

Campaign Contact

2 operaciones
01

Add a campaign contact

campaignContact.add

Lo 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.
Casos de uso
tras una solicitud de presupuesto, el contacto entra en la campaña de seguimiento sin que nadie abra Mautic.
02

Remove a campaign contact

campaignContact.remove

Lo 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.
Casos de uso
el contacto responde al comercial y sale de la secuencia.

Company

5 operaciones
03

Create a company

company.create

Lo 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.
Casos de uso
un cliente nuevo firma y su empresa se crea con su sector y su web.
04

Delete a company

company.delete

Lo 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.
Casos de uso
una migración duplicó fichas y un flujo de limpieza borra los identificadores sobrantes.
05

Get a company

company.get

Lo 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.
Casos de uso
recuperar los datos de una empresa antes de escribir en ella, para no pisar información correcta.
06

Get many companies

company.getAll

Lo 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.
Casos de uso
un listado semanal de empresas para revisar cuáles siguen sin teléfono ni web.
07

Update a company

company.update

Lo 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.getAll anterior 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.
Casos de uso
la web de la empresa cambia y una única ejecución actualiza la ficha.

Company Contact

2 operaciones
08

Add a company contact

companyContact.add

Lo 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.
Casos de uso
al importar un CSV de asistentes, cada persona queda unida a la empresa que puso en el formulario.
09

Remove a company contact

companyContact.remove

Lo 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.
Casos de uso
alguien cambia de trabajo y el vínculo antiguo se retira el día que el CRM lo confirma.

Contact

8 operaciones
10

Create a contact

contact.create

Lo 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.
Casos de uso
un chat de la web deja un email y el flujo crea el contacto con su etiqueta de origen.
11

Delete a contact

contact.delete

Lo 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.
Casos de uso
una baja definitiva pedida por escrito se ejecuta sola y queda registrada en un histórico aparte.
12

Edit a contact's points

contact.editContactPoint

Lo 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.
Casos de uso
abrir la demo suma 5 puntos y empuja al contacto hacia la campaña que lleva el equipo comercial.
13

Add/remove contacts from/to the do not contact list

contact.editDoNotContactList

Lo 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.
Casos de uso
alguien pide no recibir más SMS y el canal sms queda bloqueado para él con el motivo Manual.
14

Get a contact

contact.get

Lo 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.
Casos de uso
leer la ficha y dejar que un nodo If decida si el resto del flujo llega a ejecutarse.
15

Get many contacts

contact.getAll

Lo 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.
Casos de uso
sacar todos los contactos que coinciden con una búsqueda para revisarlos antes de una campaña.
16

Send email to a contact

contact.sendEmail

Lo 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.
Casos de uso
alguien termina el alta y recibe el email de bienvenida sin que nadie lo copie en otra herramienta.
17

Update a contact

contact.update

Lo 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.
Casos de uso
soporte corrige un teléfono mal escrito y el flujo lo guarda en Mautic en la misma ejecución.

Contact Segment

2 operaciones
18

Add a contact to a segment

contactSegment.add

Lo 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.
Casos de uso
quien descarga la guía entra en el segmento de esa temática y recibe la secuencia que le corresponde.
19

Remove a contact from a segment

contactSegment.remove

Lo 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.
Casos de uso
quien compra sale del segmento de posibles clientes y deja de recibir sus correos.

Segment Email

1 operación
20

Send an email to a segment

segmentEmail.send

Lo 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.
Casos de uso
un nodo Schedule lanza la newsletter del mes, preparada en Mautic, sin que nadie pulse enviar.
Necesitas ayuda

¿Necesitas ayuda para automatizar Mautic con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Mautic y n8n, preguntas frecuentes

01¿La integración Mautic n8n es gratuita?
Sí por el lado de n8n. El nodo Mautic y el Mautic Trigger vienen incluidos con n8n: nada que instalar y ningún coste añadido, tanto si el flujo corre en n8n Cloud como en una instancia autoalojada en Community Edition con licencia Sustainable Use. Un flujo se comporta igual en los dos sitios, así que una prueba montada en tu máquina pasa a Cloud sin tocar los nodos. Lo que cuesta Mautic depende de cómo lo alojes, y esta página no entra en eso. Las 20 operaciones y el trigger por webhook están disponibles en cuanto guardas el credential.
02¿Qué credentials necesita el nodo Mautic?
Dos métodos, basic auth u OAuth2, y en los dos casos hay que activar antes la API en Mautic, en Settings > Configuration > API Settings. Basic auth pide la URL de la instancia, un Username y un Password, además de Enable HTTP basic auth? en Yes en esa misma pantalla. OAuth2 pide un Client ID, un Client Secret y la misma URL base: se generan al crear un cliente nuevo en Configuration > Settings > API Credentials, pegando la OAuth Callback URL de n8n en el campo Redirect URI. El credential se crea una vez en el menú Credentials y los dos nodos lo ofrecen luego en su lista.
03¿Qué límites tiene el nodo Mautic?
Depende de lo que busques. El nodo expone 20 operaciones sobre 6 recursos: contactos, empresas, el vínculo entre ambos, segmentos, campañas y emails de segmento. Todo lo demás de la API de Mautic pasa por el nodo HTTP Request, que reutiliza el mismo credential con su autenticación predefinida. Las operaciones de listado se paran en Limit mientras Return All esté desactivado, y con Return All n8n encadena las páginas hasta el final. Un detalle que despista: Contact ID y Company ID no aparecen como obligatorios en la interfaz, aunque la operación no hace nada sin ellos.
04¿El Mautic Trigger reacciona en tiempo real?
Sí. El Mautic Trigger funciona por webhook: n8n registra una URL en la instancia al activar el flujo, Mautic llama a esa URL cuando se produce un evento marcado y la ejecución arranca en unos segundos. No hay intervalo que ajustar ni retraso que compensar. Los eventos se eligen en Event Names or IDs, un campo obligatorio, y no existe un comodín para capturarlos todos de golpe. Cuando Mautic pone varios eventos en cola y los manda en la misma llamada, Events Order decide el sentido de lectura: DESC del más reciente al más antiguo, ASC al revés.
05¿n8n o Make para Mautic?
Depende de dónde tengan que quedarse tus datos. Mautic suele estar autoalojado, y n8n acepta ese mismo terreno: autoalojamiento con Docker o npm, o n8n Cloud si prefieres no gestionar el servidor. Make no tiene opción de autoalojamiento y se factura por operación, algo que cambia las cuentas en cuanto un flujo recorre una base grande de contactos. La lógica visual también difiere: Make encadena módulos, n8n dibuja un grafo con ramas. Ninguno de los dos está mal. Eliges por alojamiento, control de los datos y modelo de coste.