n8n-nodes-dialia-witei

Este paquete contiene nodos n8n para integrar la funcionalidad WITEI con los servicios de Dialia.

Desarrollador

Desarrollado por Carlos Presa del equipo de Dialia.

Fecha de creación: 25 de junio de 2025

Contacto: Si tienes alguna duda o consulta, puedes escribir a carlos.presa@dialia.ai

Requisitos del sistema

• Node.js: Versión 14.0.0 o superior
• n8n: Última versión estable
• npm: 6.x o superior

Solución de problemas

Si encuentras errores durante la instalación o ejecución como:

• Error: Cannot find module 'xxx'
• Unexpected token '?'
• Otros errores de dependencias

Solución rápida

Ejecuta el script de reparación incluido:

# Dar permisos de ejecución al script
chmod +x scripts/fix-dependencies.sh

# Ejecutar el script
./scripts/fix-dependencies.sh

Solución manual

1. Asegúrate de tener la versión correcta de Node.js (14+):

node --version

2. Si la versión es incorrecta, instala Node.js 14:

# En Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt update
sudo apt install -y nodejs

# En CentOS/RHEL/Fedora
curl -fsSL https://rpm.nodesource.com/setup_14.x | sudo -E bash -
sudo yum install -y nodejs

# Con nvm
nvm install 14
nvm use 14

3. Limpia la caché de npm e instala dependencias:

npm cache clean --force
npm install

4. Si tienes problemas con TypeScript:

npm install -g typescript

Características

• Integración WITEI: Integra fácilmente servicios WITEI utilizando flujos de trabajo n8n
• Creación de Contactos: Crea contactos enviando emails a través de SendGrid a un WITEI SmartBox
• Datos de Inmuebles: Recupera datos de propiedades desde XML en formato Kyero
• Búsqueda de Inmuebles: Busca propiedades específicas por referencia

Credenciales

API WITEI

Para utilizar el nodo WITEI, necesitas configurar las siguientes credenciales:

• Email de SmartBox: La dirección de correo electrónico de tu SmartBox de WITEI
• URL del XML de Propiedades: URL donde se encuentra el archivo XML con los datos de propiedades en formato Kyero

API SendGrid

Para el envío de emails a través de la función de creación de contactos:

• Clave API: Tu clave de API de SendGrid
• Email del Remitente: La dirección de correo electrónico que se usará como remitente (predeterminado: reportes@dialia.ai)

Nodos

WITEI

Este nodo permite la interacción con servicios WITEI:

Operaciones de Contacto:

• Crear Contacto: Crea un contacto enviando un email a un SmartBox de WITEI con información detallada

Operaciones de Inmuebles:

• Obtener Todos los Inmuebles: Recupera todas las propiedades desde los datos XML
• Obtener Inmueble por Referencia: Recupera una propiedad específica por su número de referencia
• Buscar por Precio Aproximado: Encuentra inmuebles dentro de un rango de precios específico
• Buscar por Ubicación: Encuentra inmuebles por su ubicación (ciudad, provincia, código postal, etc.)

Cada operación de propiedades admite opciones de filtrado:

• Incluir o excluir imágenes
• Incluir o excluir descripciones
• Incluir o excluir características
• Seleccionar un idioma específico para las descripciones

Instalación y Compilación

Requisitos previos

Antes de compilar el proyecto, asegúrate de tener instalados:

• Node.js 14 o superior
• npm 6.x o superior

Instalación de herramientas

Ejecuta el script de configuración para instalar todas las herramientas necesarias:

# Dar permisos de ejecución al script
chmod +x scripts/setup.sh

# Ejecutar el script de configuración
./scripts/setup.sh

Este script instalará globalmente TypeScript, Gulp CLI y otras dependencias necesarias.

Compilación manual

Si prefieres instalar manualmente las dependencias, ejecuta:

# Instalar TypeScript y otras herramientas globalmente
npm install -g typescript gulp-cli rimraf

# Instalar dependencias del proyecto
npm install

# Compilar el proyecto
npm run build

Scripts de Prueba

El paquete incluye scripts para probar la funcionalidad sin necesidad de n8n:

Procesar XML desde URL

Para probar el procesamiento de datos XML de propiedades:

node scripts/test-xml.js --url https://ejemplo.com/feed.xml

Opciones:

• --url: URL del archivo XML de propiedades en formato Kyero
• --reference: (Opcional) Filtra por referencia específica
• --limit: (Opcional) Limita el número de resultados

Enviar Email a SmartBox

Para probar el envío de emails a través de SendGrid:

node scripts/test-email.js --apikey TU_API_KEY --from email@ejemplo.com --to smartbox@witei.com

Opciones:

• --apikey: Tu clave API de SendGrid
• --from: Email del remitente
• --to: Email del SmartBox de WITEI
• --subject: (Opcional) Asunto del email
• --name: Nombre del contacto
• --phone: Teléfono del contacto
• --email: Email del contacto
• --reference: Referencia del inmueble
• --message: Mensaje del contacto

Licencia

MIT