n8n-nodes-clientify-dialia

Este es un nodo comunitario de n8n que permite integrar Clientify CRM en tus flujos de trabajo de n8n.

Clientify es una plataforma de CRM (Customer Relationship Management) que ayuda a las empresas a gestionar sus relaciones con clientes, contactos, empresas, oportunidades de venta y campañas de marketing.

n8n es una plataforma de automatización de flujos de trabajo con licencia fair-code.

Instalación
Operaciones
Credenciales
Compatibilidad
Uso
Recursos

Instalación

Sigue la guía de instalación de la documentación de nodos comunitarios de n8n.

Instalación manual

1. Ve a tu directorio de n8n
2. Ejecuta: npm install n8n-nodes-clientify-dialia
3. Reinicia n8n

Instalación desde la interfaz de n8n

1. Ve a Configuración > Nodos Comunitarios
2. Instala el paquete: n8n-nodes-clientify-dialia

Operaciones

Este nodo soporta las siguientes operaciones de la API de Clientify:

Contactos

• Obtener Varios: Lista todos los contactos
• Obtener Uno: Obtiene detalles de un contacto específico
• Crear: Crea un nuevo contacto
• Crear Múltiples: Crea múltiples contactos en lote
• Actualizar: Actualiza información de un contacto
• Eliminar: Elimina un contacto
• Asignar Usuario: Asigna un contacto a otro usuario
• Agregar Nota: Añade una nota al contacto
• Agregar Llamada: Registra una llamada al contacto
• Agregar Reunión: Programa o registra una reunión
• Obtener GDPR por Fecha: Lista contactos con cambios GDPR en una fecha
• Obtener GDPR entre Fechas: Lista contactos con cambios GDPR en un rango

Gestión de Tags de Contactos

• Listar Tags: Obtiene tags de un contacto
• Listar Todos los Tags: Lista todos los tags disponibles
• Agregar Tag: Añade un tag a un contacto
• Editar Tag: Modifica un tag existente
• Eliminar Tag: Remueve un tag de un contacto

Gestión de Emails de Contactos

• Listar Emails: Obtiene emails de un contacto
• Agregar Email: Añade un email al contacto
• Editar Email: Modifica un email existente
• Eliminar Email: Remueve un email del contacto

Gestión de Teléfonos de Contactos

• Listar Teléfonos: Obtiene teléfonos de un contacto
• Agregar Teléfono: Añade un teléfono al contacto
• Editar Teléfono: Modifica un teléfono existente
• Eliminar Teléfono: Remueve un teléfono del contacto

Gestión de Direcciones de Contactos

• Listar Direcciones: Obtiene direcciones de un contacto
• Agregar Dirección: Añade una dirección al contacto
• Editar Dirección: Modifica una dirección existente
• Eliminar Dirección: Remueve una dirección del contacto

Otras Empresas de Contactos

• Listar Otras Empresas: Obtiene otras empresas asociadas
• Agregar Otra Empresa: Asocia otra empresa al contacto
• Editar Otra Empresa: Modifica asociación de empresa
• Eliminar Otra Empresa: Remueve asociación de empresa

Empresas

• Obtener Varias: Lista todas las empresas
• Obtener Una: Obtiene detalles de una empresa específica
• Crear: Crea una nueva empresa
• Actualizar: Actualiza información de una empresa
• Eliminar: Elimina una empresa

Deals (Oportunidades)

• Obtener Varios: Lista todos los deals
• Obtener Uno: Obtiene detalles de un deal específico
• Crear: Crea un nuevo deal
• Crear Múltiples: Crea múltiples deals en lote
• Actualizar: Actualiza información de un deal
• Eliminar: Elimina un deal
• Cerrar Deal: Cierra un deal como ganado o perdido
• Agregar Nota: Añade una nota al deal
• Agregar Llamada: Registra una llamada relacionada
• Agregar Reunión: Programa o registra una reunión

Gestión de Productos en Deals

• Agregar Productos: Añade productos a un deal
• Actualizar Productos: Actualiza productos de un deal
• Agregar Productos en Lote: Añade productos a múltiples deals

Gestión de Pipelines

• Listar Pipelines: Obtiene todos los pipelines
• Obtener Pipeline: Detalles de un pipeline específico
• Crear Pipeline: Crea un nuevo pipeline
• Actualizar Pipeline: Modifica un pipeline existente
• Listar Razones de Pérdida: Obtiene razones disponibles

Gestión de Tags de Deals

• Listar Tags del Deal: Tags de un deal específico
• Listar Todos los Tags: Todos los tags de deals
• Agregar Tag: Añade tag a un deal
• Editar Tag: Modifica tag de un deal
• Eliminar Tag: Remueve tag de un deal

Gestión de Contactos y Empresas en Deals

• Listar Contactos del Deal: Contactos asociados
• Agregar Contacto: Asocia contacto al deal
• Eliminar Contacto: Desasocia contacto del deal
• Listar Empresas del Deal: Empresas asociadas
• Agregar Empresa: Asocia empresa al deal
• Eliminar Empresa: Desasocia empresa del deal

Tareas

• Obtener Varias: Lista todas las tareas
• Obtener Una: Obtiene detalles de una tarea específica
• Crear: Crea una nueva tarea
• Actualizar: Actualiza información de una tarea
• Marcar como Completada: Marca una tarea como terminada
• Listar Tipos de Tarea: Obtiene tipos disponibles
• Listar Etapas de Tarea: Obtiene etapas disponibles

Campañas

• Obtener Varias: Lista todas las campañas
• Obtener Una: Obtiene detalles de una campaña específica
• Enviar Campaña: Envía una campaña en estado borrador
• Programar Campaña: Programa una campaña para envío futuro
• Copiar Campaña: Duplica una campaña existente

Llamadas

• Obtener Varias: Lista todas las llamadas registradas
• Obtener Una: Obtiene detalles de una llamada específica
• Registrar Llamada: Registra una nueva llamada con detalles completos

Credenciales

Para usar este nodo, necesitas configurar las credenciales de Clientify API:

Prerequisitos

1. Tener una cuenta activa en Clientify
2. Obtener tu token de API desde la configuración de tu cuenta

Configuración de Credenciales

1. En n8n, ve a Credenciales y crea nuevas credenciales de tipo "Clientify by Dialia API"
2. Introduce los siguientes datos:
   • API Token: Tu token de API de Clientify
   • URL Base: La URL base de tu instancia de Clientify (por defecto: https://api.clientify.net)

Obtener el Token de API

1. Inicia sesión en tu cuenta de Clientify
2. Ve a Configuración > API
3. Genera o copia tu token de API existente

Compatibilidad

• Versión mínima de n8n: 1.0.0
• Versiones probadas: 1.0.0+
• Node.js: Requiere Node.js 20.15 o superior

Uso

Ejemplo Básico: Crear un Contacto

1. Añade el nodo Clientify by Dialia a tu flujo de trabajo
2. Selecciona Recurso: Contacto
3. Selecciona Operación: Crear
4. Configura las credenciales de Clientify API
5. Completa los campos requeridos:
   • Nombre
   • Apellido
   • Email
   • Teléfono (opcional)
   • Empresa (opcional)

Ejemplo Avanzado: Sincronización de Leads

{
  "nodes": [
    {
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook"
    },
    {
      "name": "Clientify - Crear Contacto",
      "type": "n8n-nodes-clientify-dialia.clientify",
      "parameters": {
        "resource": "contact",
        "operation": "create",
        "first_name": "={{$json.nombre}}",
        "last_name": "={{$json.apellido}}",
        "email": "={{$json.email}}",
        "phone": "={{$json.telefono}}"
      }
    }
  ]
}

Filtros Avanzados

El nodo soporta filtros avanzados para búsquedas:

Contactos

• Búsqueda por nombre, apellido o email
• Filtros por fecha de creación/modificación
• Filtros por fuente de contacto
• Búsqueda por campos personalizados

Deals

• Búsqueda por nombre, empresa o contacto
• Filtros por estado (abierto, ganado, perdido)
• Filtros por rango de importe
• Filtros por fecha de creación

Campañas

• Filtros por estado (borrador, enviada, programada)
• Filtros por tipo (email, SMS, WhatsApp)
• Filtros por métricas de rendimiento
• Filtros por fecha de envío

Casos de Uso Comunes

1. Sincronización de CRM: Sincroniza leads desde formularios web
2. Automatización de Seguimiento: Crea tareas automáticas para nuevos contactos
3. Reporting de Ventas: Extrae datos de deals para reportes
4. Gestión de Campañas: Automatiza el envío de campañas basado en segmentación
5. Actualización Masiva: Actualiza contactos en lote desde fuentes externas

Recursos

• Documentación de nodos comunitarios de n8n
• Documentación de API de Clientify
• Sitio web de Clientify
• Repositorio del proyecto

Funcionalidades Destacadas

Routing Automático

El nodo utiliza el sistema de routing automático de n8n, lo que significa que los parámetros se envían automáticamente a la API sin necesidad de código adicional.

Manejo de Errores

• Soporte para continueOnFail para manejo robusto de errores
• Mensajes de error descriptivos
• Preservación del contexto de errores

Paginación

Soporte completo para paginación en operaciones que devuelven listas:

• Opción "Devolver Todos" para obtener todos los resultados
• Control de límite para optimizar rendimiento

Filtros Avanzados

Filtros sofisticados para todas las operaciones de listado:

• Búsqueda por texto
• Filtros por fecha con operadores (mayor que, menor que, etc.)
• Filtros por campos específicos
• Combinación de múltiples filtros

Gestión de Relaciones

Soporte completo para gestionar relaciones entre entidades:

• Asociar contactos con empresas
• Vincular deals con contactos y empresas
• Gestionar tags y campos personalizados

Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el repositorio
2. Crea una rama para tu feature
3. Realiza tus cambios
4. Añade tests si es necesario
5. Envía un pull request

Licencia

MIT License - ver LICENSE.md para más detalles.

Soporte

Para soporte técnico:

• Crea un issue en GitHub
• Contacta a: carlos.presa@dialia.com

Autor

Carlos Presa by Dialia

• Email: carlos.presa@dialia.com
• GitHub: @dialia

---

Este nodo ha sido desarrollado por Dialia para facilitar la integración entre n8n y Clientify CRM.