aivencerealtycrm

Nodo n8n para integrar el CRM inmobiliario AivenceRealty

Package Information

Downloads: 186 weekly / 532 monthly
Latest Version: 2.1.0
Author: Federico Aivence

Documentation

n8n-nodes-aivence-realty

Nodo n8n para AivenceRealty CRM (Laravel).

Este paquete añade nodos para interactuar con el CRM inmobiliario AivenceRealty. Permite operaciones completas sobre Properties, Leads, Maintenance Orders, Contractors, y más.

📦 Instalación

npm install n8n-nodes-aivence-realty

O desde la interfaz de n8n: Community Nodes → Install y escribir n8n-nodes-aivence-realty.

🔐 Configuración

  1. Obtén un Bearer Token desde tu panel de AivenceRealty
  2. En n8n, ve a Credentials y crea credenciales de tipo AivenceRealty API
  3. Introduce:
    • URL Base: https://realty.aivence.com (o tu dominio)
    • Bearer Token: Tu token de API
  4. Guarda las credenciales

📋 Recursos Disponibles

1. Property (Propiedades)

  • list - Listar todas las propiedades
  • getSimilar - Obtener propiedades similares
  • getStatistics - Estadísticas de propiedades

2. Lead (Leads)

  • list - Listar leads
  • create - Crear nuevo lead (campos: nombre, telefono, mensaje)

3. Tenant (Inquilinos)

  • list - Listar inquilinos

4. Maintenance Order (Órdenes de Mantenimiento)

  • checkDuplicate - Verificar si existe orden duplicada
  • create - Crear nueva orden
  • get - Obtener orden por ID
  • update - Actualizar orden
  • list - Listar órdenes

5. Contractor (Contratistas)

  • findByCategory - Buscar por categoría (fontanería, electricidad, etc.)
  • findAlternatives - Buscar contratistas alternativos

6. Monthly Cost (Costos Mensuales)

  • track - Registrar costo mensual

7. WhatsApp

  • sendMessage - Enviar mensaje por WhatsApp (Evolution API)

🎯 Ejemplos de Uso

Crear un Lead

{
  "resource": "lead",
  "operation": "create",
  "nombre": "Juan Pérez",
  "telefono": "5491112345678",
  "mensaje": "Busco departamento 2 ambientes en Palermo"
}

Crear Orden de Mantenimiento

{
  "resource": "maintenanceOrder",
  "operation": "create",
  "clienteId": 123,
  "propiedadId": 456,
  "contratistaId": 789,
  "categoria": "fontanería",
  "urgencia": "alta",
  "descripcionCorta": "Fuga de agua",
  "descripcionDetallada": "Fuga en baño principal..."
}

🔧 Desarrollo Local

# Clonar repositorio
git clone https://github.com/aivence/n8n-nodes-aivence-realty.git
cd n8n-nodes-aivence-realty

# Instalar dependencias
npm install

# Compilar
npm run build

# Vincular localmente
npm link
cd ~/.n8n
npm link n8n-nodes-aivence-realty

# Iniciar n8n
n8n start

📝 Changelog

v0.1.0 (2025-10-09)

  • 🎉 Versión inicial
  • ✅ 7 recursos implementados
  • ✅ 15 operaciones totales
  • ✅ Integración completa con API Laravel

📄 Licencia

MIT

👨‍💻 Autor

Federico Aivence - federico@aivence.com

🔗 Links

Discussion