Recursos · Integración n8n

Integración Agile CRM n8nAutomatiza Agile CRM con n8n.

El CRM debería llenarse solo mientras el equipo vende. La integración Agile CRM n8n coloca las 15 operaciones del nodo, repartidas en tres recursos, dentro de cualquier flujo de trabajo. Este conector no tiene nodo trigger, así que la ejecución arranca con un Schedule Trigger o un Webhook.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración Agile CRM n8n?

El nodo Agile CRM viene incluido en n8n y habla con la API de Agile CRM por ti. Cubre tres recursos, Company, Contact y Deal, con 15 operaciones en total: crear, leer una ficha, leer un listado, actualizar y borrar en cada uno de ellos.

El credential se guarda una vez y, a partir de ahí, cualquier flujo escribe en el CRM o lee de él sin escribir código.

El caso más repetido en una empresa que vende a otras empresas es el alta manual. Llega un pedido, alguien abre el CRM y teclea los mismos datos que ya están en el pedido. Con Create a contact el flujo los escribe solo, con nombre, correo y una puntuación inicial, y la ficha queda lista antes de que nadie la busque.

El segundo caso es el control del embudo. Get many deals devuelve la cartera completa, con Return All activado para que n8n recorra todas las páginas de la API en lugar de detenerse en Limit. Después el flujo suma los importes previstos y publica el resumen en Slack, o lo escribe en Google Sheets para la reunión del lunes.

El tercero mira al marketing y al mantenimiento de la base. Get many contacts arma el segmento con condiciones de búsqueda, SendGrid o Gmail se encarga del envío, y Update a contact devuelve la nueva puntuación cuando termina la campaña. En paralelo, Get a company lee la ficha de empresa, una fuente externa completa lo que falta y Update a company escribe la dirección y el teléfono donde el equipo comercial los ve.

El nodo cubre 15 operaciones sobre Company, Contact y Deal. Lo que queda fuera de ese catálogo se hace con el nodo HTTP Request, que llama a cualquier endpoint de la API de Agile CRM reutilizando el mismo credential mediante la autenticación predefinida. Una necesidad que no figura en la lista del nodo sigue teniendo camino.

Hay un detalle de arquitectura que conviene tener claro desde el principio: Agile CRM no tiene nodo trigger en n8n. Cada flujo empieza en otro sitio, con un Schedule Trigger que se ejecuta cada cierto intervalo, un Webhook de n8n (una URL que un servicio externo llama cuando ocurre algo de su lado) o el disparador de otra herramienta que ya automatizas. Si todavía estás comparando plataformas, la Reseña n8n entra en ese debate y el Curso n8n enseña a montar estos flujos de principio a fin.

Conexión

¿Cómo conectar Agile CRM con n8n?

  1. 01

    Obtener la clave API REST

    Entra en tu cuenta de Agile CRM, abre Admin Settings y después Developers & API. La pantalla REST API key guarda la clave que usará n8n. Cópiala y aprovecha para anotar otros dos datos: el correo electrónico registrado en la cuenta de Agile CRM y el subdominio con el que responde esa cuenta, ese prefijo corto que la documentación ilustra con n8n.

  2. 02

    Crear el credential en n8n

    Abre el menú Credentials de n8n y añade un credential de Agile CRM. Un credential es el conjunto de datos de acceso que n8n guarda una vez y reutiliza para firmar sus llamadas. Este funciona por clave API y pide tres campos: Email Address, API Key y Subdomain. Pega los valores del paso anterior, guarda, y cada nodo Agile CRM lo ofrecerá en su desplegable.

  3. 03

    Elegir recurso y operación

    Coloca el nodo Agile CRM en un flujo, selecciona el credential y elige uno de los tres recursos, Company, Contact o Deal, y una de las 15 operaciones. Un campo marcado como obligatorio detiene la ejecución si se queda vacío, así que rellénalo o mapéalo. Una expresión como {{ $json.email }} recupera un valor que produjo el nodo anterior.

Acciones

Qué hace cada operación del nodo Agile CRM

El nodo Agile CRM expone 15 operaciones en 3 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDelete
Company✓✓✓✓✓
Contact✓✓✓✓✓
Deal✓✓✓✓✓

Company

5 operaciones
01

Create a company

company.create

Lo que ves en n8n

Notas y casos de uso

Da de alta una ficha de empresa y devuelve el objeto creado, identificador incluido. Ningún campo es obligatorio: la forma de la ficha depende de la colección opcional, que reúne 8 campos.

Parámetros clave

  • Name: el nombre de la empresa, casi siempre {{ $json.company }} tomado del formulario que inició la ejecución.
  • Website: la colección de sitios web, útil cuando el dominio hace de clave para cruzar datos más adelante.
  • Star Value: una valoración de 0 a 5 para marcar las cuentas que merecen atención.
Casos de uso
un alta de distribuidor llega con su dominio corporativo y el flujo crea la empresa una sola vez.
02

Delete a company

company.delete

Lo que ves en n8n

Notas y casos de uso

Elimina una empresa del CRM. La llamada apunta a una sola ficha y no toca nada más, por eso encaja al final de una rama de deduplicación y no en medio de una sincronización.

Parámetros clave

  • Company ID: el identificador de la empresa que se va a borrar, no su nombre. Recupéralo con un company.getAll previo y {{ $json.id }}.
Casos de uso
dos importaciones distintas crearon la misma empresa, alguien decide cuál se queda y la operación retira la otra.
03

Get a company

company.get

Lo que ves en n8n

Notas y casos de uso

Recupera una empresa y entrega sus campos guardados al siguiente nodo, de modo que el resto del flujo decide con lo que el CRM tiene de verdad y no con una suposición.

Parámetros clave

  • Company ID: el identificador único de esa empresa concreta. Ni el nombre ni el dominio funcionan aquí, conviene buscar el ID antes.
Casos de uso
antes de renovar un contrato anual, el flujo lee la ficha, la contrasta con los datos de facturación y solo avisa al responsable si algo no cuadra.
04

Get many companies

company.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve las empresas en forma de listado. Es la lectura indicada cuando el flujo necesita toda la cartera y no una ficha suelta.

Parámetros clave

  • Return All: activado, n8n recorre todas las páginas de la API hasta la última empresa; desactivado, Limit fija cuántas vuelven.
  • Filter: none, manual para construir condiciones desde la interfaz, o json para pegarlas.
  • Must Match: anyFilter abre el resultado, allFilters lo estrecha.
  • Simplify: devuelve una versión reducida de la respuesta en lugar de los datos en bruto.
Casos de uso
una exportación semanal vuelca la cartera en una hoja de cálculo para que dirección ordene cuentas sin entrar en el CRM.
05

Update a company

company.update

Lo que ves en n8n

Notas y casos de uso

Escribe valores nuevos sobre una empresa que ya existe. La colección opcional trae 8 campos, de Phone a Custom Properties, y tú envías los que el flujo conoce de verdad.

Parámetros clave

  • Company ID: el identificador único de la empresa afectada, el ancla de la actualización.
  • Email: el correo de la empresa, con el formato que sugiere el propio campo, name@email.com.
  • Tags: identificadores únicos añadidos a la empresa para mantener la base ordenada.
Casos de uso
un paso de enriquecimiento devuelve la dirección de la sede y el teléfono de centralita, y la operación los deja donde el equipo comercial los consulta.

Contact

5 operaciones
06

Create a contact

contact.create

Lo que ves en n8n

Notas y casos de uso

Crea un contacto en Agile CRM con lo que haya producido el nodo anterior. Igual que con las empresas, no hay campos impuestos, y la colección opcional ofrece 12.

Parámetros clave

  • First Name y Last Name: el nombre del contacto, normalmente {{ $json.first_name }} mapeado desde el formulario.
  • Email: la colección de correos del contacto, el campo con el que se cruzan casi todos los flujos después.
  • Lead Score: la puntuación de partida, para que una solicitud de demo no entre al mismo nivel que un alta en la newsletter.
  • Title: el cargo profesional, útil para dirigir la ficha a la persona correcta.
Casos de uso
una descarga de catálogo crea el contacto esa misma tarde, con puntuación y empresa ya rellenadas.
07

Delete a contact

contact.delete

Lo que ves en n8n

Notas y casos de uso

Borra un contacto de la base. Una ficha, una llamada, algo fácil de colocar detrás de una validación humana en lugar de dejarlo correr sobre un listado entero.

Parámetros clave

  • Contact ID: el identificador del contacto que se va a borrar. Resuélvelo antes con contact.getAll, porque este campo no acepta una dirección de correo.
Casos de uso
llega una solicitud de baja al buzón compartido, el flujo localiza la ficha, espera la confirmación de una persona y después la elimina.
08

Get a contact

contact.get

Lo que ves en n8n

Notas y casos de uso

Lee una ficha de contacto y baja sus campos al resto del flujo. Todo lo almacenado viaja con el item, así que los pasos siguientes trabajan con valores reales y no con lo que traía el disparador.

Parámetros clave

  • Contact ID: el identificador único del contacto buscado, la única entrada de la operación.
Casos de uso
un ticket de soporte incluye el identificador de CRM, el flujo relee el contacto y el aviso al comercial ya dice quién escribe y qué puntuación tiene.
09

Get many contacts

contact.getAll

Lo que ves en n8n

Notas y casos de uso

Trae un listado de contactos con las mismas herramientas de filtrado que el listado de empresas. Aquí es donde se construye un segmento sin abrir la interfaz de Agile CRM.

Parámetros clave

  • Return All: activado, se recuperan todas las páginas; desactivado, Limit marca el número máximo de contactos devueltos.
  • Field y Condition Type: cualquier campo buscable comparado con EQUALS, BEFORE, BETWEEN y el resto, frente a Value y Value 2.
  • Sort: ordena el resultado antes de que llegue al nodo siguiente.
Casos de uso
una campaña mensual selecciona los contactos cuya puntuación superó un umbral y los pasa a un nodo de envío.
10

Update a contact

contact.update

Lo que ves en n8n

Notas y casos de uso

Sustituye los valores de un contacto por lo que el flujo acaba de calcular. Los 12 campos opcionales son los mismos de la creación, así que el mapeo no cambia entre la rama que crea y la que actualiza.

Parámetros clave

  • Contact ID: el identificador único del contacto afectado.
  • Lead Score: la nueva puntuación, a menudo {{ $json.score }} procedente de un paso de scoring anterior.
  • Company: el nombre de la empresa asociada, que conviene refrescar cuando la persona cambia de trabajo.
Casos de uso
un evento de producto sube la puntuación de una cuenta en prueba y el comercial ve el valor nuevo antes de la llamada.

Deal

5 operaciones
11

Create a deal

deal.create

Lo que ves en n8n

Notas y casos de uso

Abre una oportunidad en el embudo. Es la única operación del nodo con una base realmente obligatoria: hay 5 campos que deben ir rellenos o la ejecución se detiene.

Parámetros clave

  • Name: el nombre del negocio, la etiqueta que el equipo leerá en el embudo.
  • Close Date: la fecha de cierre, en formato dateTime, así que una fecha calculada antes encaja directamente.
  • Expected Value y Probability: el valor esperado y la probabilidad esperada, ambos numéricos.
  • Milestone: la etapa del embudo en la que entra.
  • Contact IDs: opcional, enlaza el negocio con los contactos que hay detrás.
Casos de uso
un presupuesto aceptado abre el negocio, con la fecha de cierre según las condiciones de pago.
12

Delete a deal

deal.delete

Lo que ves en n8n

Notas y casos de uso

Retira una oportunidad del embudo. Su sitio está en una rutina de limpieza, cuando un negocio se registró por error y la previsión no debería seguir arrastrándolo.

Parámetros clave

  • Deal ID: el identificador del negocio que se va a borrar, tomado del paso que lo creó o de una lectura deal.getAll.
Casos de uso
dos comerciales registran la misma operación el mismo día y un flujo programado quita la copia que nadie ha movido.
13

Get a deal

deal.get

Lo que ves en n8n

Notas y casos de uso

Un negocio vuelve con sus valores actuales. Así es como un flujo comprueba en qué punto está una oportunidad antes de hacer nada con ella.

Parámetros clave

  • Deal ID: el identificador único del negocio buscado, que conviene guardar desde el paso que lo creó o lo listó.
Casos de uso
un flujo de seguimiento relee el negocio, compara su fecha de cierre con la de hoy y solo entonces avisa al responsable.
14

Get many deals

deal.getAll

Lo que ves en n8n

Notas y casos de uso

Lista los negocios del embudo. Admite dos parámetros, los dos relacionados con el volumen que vuelve, lo que la convierte en la lectura más sencilla del nodo.

Parámetros clave

  • Return All: activado, n8n recorre las páginas de la API hasta recoger el último negocio.
  • Limit: el número máximo de negocios devueltos mientras Return All siga desactivado, práctico para una prueba rápida.
Casos de uso
un flujo de los lunes recoge el embudo abierto, suma los valores esperados y publica el total antes de la reunión semanal.
15

Update a deal

deal.update

Lo que ves en n8n

Notas y casos de uso

Modifica los valores de un negocio ya abierto. El identificador del negocio es lo único que la operación exige, y por encima hay 5 campos opcionales.

Parámetros clave

  • Deal ID: el identificador del negocio que se va a actualizar.
  • Probability: la nueva probabilidad esperada, el campo del que depende la previsión.
  • Expected Value: el importe revisado, por ejemplo {{ $json.amount }} después de una renegociación.
  • Custom Data: tus propias claves y valores, para lo que el equipo controla además de los campos estándar.
Casos de uso
tras una visita, el comercial rellena una hoja compartida y el flujo empuja la nueva probabilidad y el nuevo importe al negocio.
Necesitas ayuda

¿Necesitas ayuda para automatizar Agile CRM con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Agile CRM y n8n, las dudas que vienen después

01¿La integración Agile CRM n8n es gratuita?
Sí por el lado de n8n. El nodo Agile CRM viene incluido con n8n, así que no hay nada que instalar ni ningún coste adicional por el conector en sí. Vale igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada instalada con Docker o npm bajo la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en los dos escenarios, de manera que puedes prototipar en uno y llevarlo al otro sin reescribir nada. Lo que cueste la cuenta de Agile CRM es otro asunto, y esta página no lo trata.
02¿Qué credenciales pide el nodo Agile CRM?
Tres datos, todos de la misma cuenta de Agile CRM. El credential funciona por clave API y pide un correo electrónico registrado en Agile CRM, una clave API REST y el subdominio de la cuenta, que la documentación ilustra con el ejemplo n8n. La clave está en Admin Settings, dentro de Developers and API, en la pantalla REST API key. El credential se crea una sola vez desde el menú Credentials de n8n y, a partir de ahí, cada nodo Agile CRM lo encuentra en su desplegable. No hay que pegar la clave flujo a flujo ni mantener un segundo sitio actualizado.
03¿Qué límites tiene el nodo Agile CRM en n8n?
Depende de lo que le pidas. El nodo expone 15 operaciones sobre tres recursos, Company, Contact y Deal. Lo que queda fuera de ese catálogo pasa por el nodo HTTP Request, que llama a cualquier endpoint de la API de Agile CRM reutilizando el mismo credential mediante la autenticación predefinida. En las lecturas conviene vigilar Return All: si se queda desactivado, es Limit quien pone el techo de resultados, algo razonable en una prueba y equivocado en una exportación. Y los identificadores importan: Delete a company, Get a contact o Update a deal esperan un ID, así que añade un paso de búsqueda si tus datos solo traen un nombre.
04¿El nodo Agile CRM reacciona en tiempo real?
No, porque en n8n no existe un nodo trigger de Agile CRM. Un flujo que toque este CRM arranca en otro punto: un Schedule Trigger que se ejecuta cada cierto intervalo, un Webhook de n8n al que llama un servicio externo, o el disparador de otra herramienta que ya tengas automatizada. Un webhook, aquí, es simplemente una URL que un servicio de fuera llama cuando pasa algo de su lado. El montaje más habitual combina un Schedule Trigger con Get many contacts o Get many deals: se relee el listado, se compara con el de la ejecución anterior y el flujo se bifurca según la diferencia.
05¿n8n o Make para Agile CRM?
Depende de dónde quieras que vivan los flujos. n8n se puede autoalojar con Docker o npm, así que las fichas del CRM se quedan en una infraestructura que controlas, y también existe como n8n Cloud cuando administrar un servidor no aporta nada. Make solo funciona alojado, sin opción de autoalojamiento, y factura por operación, lo que cambia la forma de plantear un bucle que recorre miles de contactos o negocios. Los dos ofrecen un lienzo visual y los dos conectan con Agile CRM. La decisión se juega en el alojamiento, el control de los datos, el modelo de coste y la soltura del equipo con las expresiones.