La integración entre Clientify y N8N te permite llevar la automatización de tus procesos a otro nivel. Gracias a esta conexión, podrás integrar con múltiples herramientas externas, crear flujos personalizados y automatizar tareas complejas sin depender de desarrollos a medida.

En este artículo te explicamos cómo realizar la conexión, qué ventajas ofrece y cuáles son los casos de uso más habituales.

Antes de empezar

Necesitas tres cosas:

Una cuenta de Clientify con acceso a tu Clave API
Un espacio de n8n, en cualquiera de sus dos modalidades:
- Versión cloud (de pago): es la opción más rápida, sin configuración de servidores ni mantenimiento
- Servidor propio (self-hosted): es gratuita, pero requiere conocimientos técnicos para la instalación, el mantenimiento y la seguridad. Necesitas Node.js 20.15 o superior
Permisos para instalar nodos comunitarios en ese espacio de n8n. En self-hosted es el rol de propietario de la instancia

¿Qué se instala?

El paquete n8n-nodes-clientify añade tres elementos a tu n8n:

Elemento	Para qué sirve
Clientify	Nodo de acciones. Ejecuta operaciones sobre tu CRM (crear contactos, añadir notas, etiquetar, etc.)
Clientify Trigger	Nodo disparador. Inicia el flujo cuando ocurre algo en tu cuenta de Clientify
Credencial Clientify API	Guarda tu Clave API de forma segura y la reutiliza en todos los nodos

⚙️ Cómo realizar la conexión con N8N

Para realizar la conexión simplemente necesitas tener acceso a tu API Key de Clientify y tener un espacio de N8N. Antes de empezar, es importante tener en cuenta que N8N ofrece dos formas de uso:

Versión cloud (de pago):
Puedes utilizar su versión oficial alojada en la nube, sin necesidad de configuraciones técnicas. Es la opción más sencilla y rápida de implementar.
Servidor propio (self-hosted):
También puedes instalar N8N en tu propio servidor. Esta opción es gratuita, pero requiere conocimientos técnicos para su instalación, mantenimiento y seguridad.

Paso a paso

Obtén tu API Key de Clientify
- Ve al menú de Configuración / Mi usuario / Clave API.
- Cópiala para usarla más adelante en N8N.
Instala Clientify como nodo comunitario
1. Para versión cloud:
  - Crea un nuevo flujo de automatización desde el botón correspondiente de la parte superior y clica en un nuevo nodo. Busca Clientify en la barra de búsqueda.
  - Clica en 'Install node' y ya tendrás acceso a todas las opciones de nuestro nodo.
2. Para versión en servidor propio:
  - Dirígete a Settings / Community nodes y clica en 'Install'.
  - En el campo escribiremos el identificador n8n-nodes-clientify y clicamos nuevamente en 'Install' tras aceptar la casilla de los términos.
Utilízalo en tus flujos de trabajo
Para iniciar tus automatizaciones, tienes disponibles varios disparadores (triggers), basados en eventos que pueden ocurrir dentro de tu cuenta de Clientify:

Por otro lado, dispones de varias acciones que puedes llevar a cabo en cualquier paso intermedio de tus flujos. Están clasificadas en categorías para que te sea más fácil encontrar lo que necesitas.

Tanto para usar los lanzadores como para las acciones, deberás introducir tus credenciales para poder conectarte a tu cuenta de Clientify. Para ello simplemente clica en '+ Create new credential' en el desplegable que aparece en la parte superior al añadir una acción:

En la ventana de configuración que se muestra, en el campo 'API Key' pega la clave de Clientify que copiamos en el primer paso de la guía:

Disparadores disponibles
El nodo Clientify Trigger escucha los webhooks de tu cuenta. Hay cinco eventos:

Disparador	Evento	Se lanza cuando
Contact Saved	`contact.saved`	Se crea o se actualiza un contacto
Company Saved	`company.saved`	Se crea o se actualiza una empresa
Company Deleted	`company.deleted`	Se elimina una empresa
Deal Saved	`deal.saved`	Se crea, actualiza, gana, pierde o mueve una oportunidad
Task Saved	`task.saved`	Se crea o se actualiza una tarea

Clientify envía eventos amplios de tipo saved que agrupan la creación y la actualización. Si tu flujo necesita distinguir entre "creado" y "actualizado", o entre "ganada" y "perdida", añade un nodo IF después del disparador y evalúa los campos del propio dato.

Acciones disponibles

El nodo Clientify agrupa 81 acciones en cinco categorías:

Categoría	Acciones	Qué cubre
Contacts	33	Crear, consultar, listar y actualizar contactos. Gestionar emails, teléfonos, direcciones, etiquetas, notas, llamadas, check-ins, tareas, campos personalizados, propietario y estado de marketing
Companies	36	Lo equivalente para empresas, más la gestión de empleados vinculados, sectores y sitios web
Tasks	7	Crear, consultar, listar, actualizar y completar tareas. Consultar tipos y estados disponibles
Users	1	Listar los usuarios de tu cuenta
Misc	4	Usuario actual, campos personalizados de la cuenta y alta masiva de contactos

Importante sobre oportunidades. El nodo incluye el disparador Deal Saved, pero no incluye acciones para crear ni actualizar oportunidades. Si necesitas escribir en el módulo de oportunidades desde n8n, hazlo con el nodo genérico HTTP Request apuntando a la API de Clientify.

4. Prueba y activa el flujo

Verifica que los datos que solicitas y que envías son correctos.
Activa tu proyecto para que funcione automáticamente.

🚀 Ventajas de integrar Clientify con N8N

Esta integración abre muchas posibilidades para optimizar tu operativa diaria:

Automatización avanzada: crea flujos personalizados más allá de las automatizaciones propias del ecosistema de Clientify.
Conexión con múltiples herramientas: integra con aplicaciones como Google Sheets, Slack, Stripe, ERPs, etc.
Flexibilidad total: adapta los procesos a tu negocio sin limitaciones predefinidas.
Ahorro de tiempo: elimina tareas manuales repetitivas.
Escalabilidad: automatiza procesos a medida que tu negocio crece.
Control de datos: especialmente con la versión autoalojada, puedes tener control total sobre tu información.

🔄 Casos de uso habituales

La combinación de CRM + N8N es muy potente. Estos son algunos de los usos más comunes:

Sincronización de contactos

Crear o actualizar contactos en Clientify desde otras herramientas (formularios, bases de datos, apps externas).
Mantener sincronizados contactos entre diferentes plataformas.

Automatización de ventas

Crear oportunidades automáticamente cuando ocurre un evento (ej. un pago en Stripe o un formulario completado).
Actualizar estados de oportunidades según acciones externas.

Gestión de leads desde múltiples fuentes

Enviar leads desde herramientas externas (Typeform, Webflow, WordPress, etc.) directamente a Clientify.
Enriquecer los datos antes de guardarlos en el CRM.

Integración con sistemas de facturación o ERP

Crear contactos o empresas automáticamente al generar una factura en otras plataformas.
Sincronizar datos financieros con el CRM.

Notificaciones internas

Enviar avisos a Slack, o por email cuando se crea un nuevo lead o se cierra una venta.
Alertar al equipo comercial cuando ocurren determinados eventos.

Automatizaciones con lógica avanzada

Crear flujos con condiciones complejas (if/else).
Enviar contactos a diferentes procesos según su comportamiento o datos.

Registro y análisis de datos

Guardar información de Clientify en Google Sheets o bases de datos externas para análisis posterior con herramientas de informes.
Crear dashboards personalizados con datos del CRM.

Buenas prácticas

Prueba siempre fuera de producción. Usa una cuenta o unos registros de prueba hasta que el flujo esté validado.

Controla el ritmo de las llamadas. El nodo ejecuta una llamada a la API por cada elemento que recibe. El límite de la API de Clientify es de 1.000 peticiones por minuto. En cargas masivas conviene intercalar un nodo Wait o reducir el tamaño de los lotes.

Pide solo los campos que necesitas. Las acciones de listado admiten un parámetro fields donde indicas qué campos quieres en la respuesta, separados por comas. Cuanto más corta sea esa lista, más rápido responde la API.

Activa el control de errores. En la pestaña Settings de cada nodo tienes la opción de continuar en caso de fallo. Con ella, un registro erróneo no detiene el flujo completo.

No escribas la clave en los nodos. Usa siempre la credencial de Clientify. Así la clave queda cifrada, se reutiliza en todos los flujos y la cambias en un único sitio.

Documenta el flujo. Renombra los nodos con lo que hacen y añade notas. Dentro de seis meses lo agradecerás.

Preguntas frecuentes y errores comunes

¿El nodo usa la API v1 o v2 de Clientify?

La v2. La credencial trae como Base URL https://api-plus.clientify.com/v2. Si necesitas un endpoint que solo existe en la v1, tienes dos opciones: cambiar la Base URL en la credencial, o usar el nodo genérico HTTP Request apuntando a la ruta de la v1.

¿Por qué me devuelve un error 401?

La Clave API no es correcta, ha caducado o se ha copiado con espacios. Verifica que la has copiado completa desde Configuración → Mi usuario → Clave API y usa el botón de test de la credencial para comprobarlo antes de ejecutar el flujo.

Al actualizar un contacto, ¿se pierden los campos que no he rellenado?

No. Las acciones Update Contact y Update Company envían al CRM únicamente los campos que hayas rellenado en el nodo. El resto de la ficha se mantiene tal cual estaba.

Esto significa que puedes usar estas acciones para modificar un solo dato, por ejemplo el teléfono, sin necesidad de arrastrar el contacto completo desde un nodo anterior.

Si vas a lanzar una actualización sobre muchos registros, ejecuta el flujo primero sobre una ficha de prueba y compárala antes y después. Es un minuto de comprobación que te ahorra revisar cientos de fichas.

¿Cómo trabajo con campos personalizados?

Para consultarlos, tienes tres acciones:

List Custom Fields: los campos personalizados definidos en tu cuenta.
List Custom Field Values: los valores disponibles de esos campos.
List Contact Customfields: los campos personalizados de un contacto concreto.

También puedes añadir custom_fields al parámetro fields de un listado para que vengan incluidos en la respuesta.

Para actualizarlos, el nodo no incluye una acción específica. Utiliza el nodo HTTP Request con este formato en el cuerpo de la petición:

{   "custom_fields": [     { "field_id": 123456, "value": "nuevo_valor" }   ] }

El identificador de cada campo lo encuentras en Configuración → Campos personalizados o ejecutando la acción List Custom Fields.

¿Puedo crear oportunidades desde n8n?

Con las acciones nativas del nodo, no. El nodo cubre contactos, empresas, tareas y usuarios. Sí puedes escuchar cambios en oportunidades con el disparador Deal Saved.

Para escribir en el módulo de oportunidades, usa el nodo genérico HTTP Request con esta configuración:

Parámetro	Valor
Authentication	Predefined Credential Type → Clientify API
Method	POST
URL	La ruta del recurso de oportunidades
Send Body	Activado, formato JSON

Encontrarás la ruta exacta y los campos admitidos en la documentación de la API: https://newapi.clientify.com

Al seleccionar la credencial de Clientify que ya creaste, n8n añade la cabecera de autenticación automáticamente y no tienes que escribir la clave en el nodo. Este mismo patrón sirve para cualquier endpoint de la API que no esté cubierto por las acciones nativas.

¿Cómo recibo en n8n los cambios que ocurren en Clientify?

Con el nodo Clientify Trigger, que se apoya en los webhooks salientes de Clientify. Configúralos en Configuración → Conexiones → Webhooks apuntando a la URL que te da el nodo disparador en n8n.

El flujo no se ejecuta aunque el evento ocurre en Clientify

Repasa estos cuatro puntos:

El flujo está activo. En modo de prueba solo escucha durante la ejecución manual.
El webhook de Clientify apunta a la URL de producción del disparador, no a la de test.
El evento configurado es uno de los cinco disponibles.
Si tu n8n es autoalojado, la URL es accesible desde internet. Una instancia en red local no puede recibir webhooks.

¿Cuál es el límite de peticiones de la API?

1.000 peticiones por minuto. Es un margen amplio, así que un flujo normal no lo alcanza.

Si aun así ves timeouts o errores 504, lo más habitual es que el problema sea el peso de cada llamada y no la cantidad. Dos ajustes que suelen resolverlo:

Reduce el parámetro fields en las acciones de listado para pedir solo los campos que vas a usar. Una respuesta más ligera se genera y viaja más rápido.
Ajusta el page_size. Páginas muy grandes tardan más en construirse. Si una página de 500 registros da timeout, prueba con 100.

En cargas masivas, intercala un nodo Wait entre iteraciones para repartir las llamadas a lo largo del minuto.

Los listados solo me devuelven una parte de los registros

Las acciones de listado están paginadas y el nodo no recorre las páginas automáticamente. Usa los parámetros page y page_size, y construye un bucle que incremente page hasta que la respuesta venga vacía.

¿Qué versión de Node.js necesito en un servidor propio?

Node.js 20.15 o superior.

Conclusión

La integración con N8N convierte a Clientify en una herramienta aún más potente, permitiéndote conectar tu CRM con prácticamente cualquier aplicación y automatizar procesos a medida. Tanto si eliges la versión en la nube como si prefieres un servidor propio, tendrás la flexibilidad necesaria para adaptar la plataforma a las necesidades de tu negocio.

NEW - Integración con N8N