novoprospect

n8n nodes for NovoProspect, the real estate CRM: create leads and tasks, move deals and trigger workflows on CRM events.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: NovoProspect

Documentation

n8n-nodes-novoprospect

Nodos de n8n para NovoProspect, el CRM inmobiliario. Crean leads y tareas, mueven negocios de etapa y arrancan flujos cuando pasa algo en el CRM.

English: n8n community nodes for NovoProspect, the real estate CRM. Create leads and tasks, move deals and trigger workflows on CRM events.

Instalación

En n8n con servidor propio: Settings → Community Nodes → Install y escribe n8n-nodes-novoprospect. Más detalles en la guía de n8n.

Credencial: NovoProspect API

  1. En NovoProspect entra a Configuración → Integraciones → n8n y API (solo administradores) y crea una llave.

  2. Dale los permisos que vayas a usar:

    Permiso Para
    contacts:read, contacts:write Buscar, ver, crear y editar contactos
    tasks:write Crear tareas
    deals:read, deals:write Lista de embudos y mover negocios
    users:read Lista de agentes
    webhooks:manage El nodo NovoProspect Trigger
  3. En n8n crea la credencial NovoProspect API: pega la llave (np_…) y elige el servidor: producción, pruebas o uno propio. n8n la comprueba con GET /api/v1/me.

NovoProspect (acciones)

Recurso Operación API
Contact Create POST /contactos: no duplica. Si ya existe un contacto con el mismo teléfono o correo lo devuelve con isNew: false.
Contact Get GET /contactos/{id}
Contact Get Many GET /contactos con filtros (texto, correo, teléfono, tipo, agente), límite o todos
Contact Update PATCH /contactos/{id}
Task Create POST /tareas (fecha YYYY-MM-DD, hora HH:MM de RD)
Deal Move to Stage POST /negocios/{id}/mover: las etapas que confirman la venta no aparecen. La venta se confirma en NovoProspect.

Los agentes, embudos y etapas salen en listas. También se puede usar como herramienta de un agente de IA.

NovoProspect Trigger

Elige uno o varios eventos: lead nuevo, contacto editado, negocio nuevo, cambio de etapa, ganado, perdido, venta confirmada, factura cobrada, tareas, actividades, mensajes y conversaciones de la Bandeja.

  • Al activar el flujo, el nodo registra su dirección con POST /api/v1/webhooks. Al desactivarlo la borra.
  • Cada aviso llega firmado (X-NovoProspect-Signature, HMAC-SHA256 de timestamp.cuerpo). El nodo comprueba la firma con el secreto que dio NovoProspect al crear el webhook. También rechaza los avisos con más de 5 minutos.
  • La salida es el aviso tal cual: { id, event, createdAt, data }.

Desarrollo

npm ci
npm run build
npm run lint
npm run dev   # n8n local en http://localhost:5678 con estos nodos

Compatibilidad

Probado con n8n 2.45.7 y @n8n/node-cli 0.54.6.

Discussion