n8n-nodes-ycloud

Community node para integrar YCloud WhatsApp API en n8n.

Compatibilidad

• n8n: >= 1.0.0
• Node.js: >= 18.17

Estado actual

MVP implementado con operaciones:

• message.sendDirectly
• message.enqueue
• message.retrieve
• inboundMessage.markAsRead
• inboundMessage.typingIndicator
• contact.list
• template.list
• template.retrieve

Además, message ahora incluye:

• selección dinámica de templates desde YCloud (Template Source: From YCloud)
• validación opcional de cantidad de placeholders del body
• Template Body Variables para mapear {{1}}, {{2}}, ...
• Template Components JSON (Advanced) para payloads complejos (header/buttons/carousel, etc.)
• contextMessageId para replies (context.message_id)
• filterUnsubscribed y filterBlocked (solo en enqueue)

Credenciales

El nodo incluye credencial YCloud API con:

• baseUrl (por defecto: https://api.ycloud.com)
• apiKey (usada en header X-API-Key)

El test de credencial consulta GET /v2/balance.

Desarrollo local

1. Instala dependencias: npm install
2. Compila: npm run build
3. Verifica tipos: npm run lint

Cargarlo en n8n local

1. Compila el paquete con npm run build.
2. Desde este proyecto ejecuta npm link.
3. En tu instalación local de n8n ejecuta npm link n8n-nodes-ycloud.

Release y despliegue

Consulta DEPLOY.md para el checklist de publicación (npm) y despliegue en n8n self-hosted (incluido Hetzner). 4. Reinicia n8n y busca el nodo YCloud en el editor.

Notas de implementación

• Validación E.164 para from y to.
• Manejo explícito de errores HTTP (401, 403, 404, 429, 5xx).
• Retries automáticos para 429 usando Retry-After o backoff exponencial con jitter.
• En continueOnFail, devuelve error estructurado por item.