Package Information
Documentation
n8n-nodes-wicloud
Nodos de n8n para WiCloud: envía WhatsApp, gestiona contactos, listas y campañas, y arranca flujos cuando pasa algo en tu cuenta.
English below.
Qué trae
WiCloud (acciones)
| Recurso | Operaciones |
|---|---|
| Message | Send (texto, imagen, video, audio o documento; opcionalmente programado) · Get · Cancel |
| Contact | Create or Update (por número, no duplica) · Get · Get Many · Update · Add to List · Remove From List |
| List | Get Many · Create |
| Campaign | Create (a una lista o a números sueltos) · Get · Get Many · Send Draft |
| WhatsApp Number | Get · Get Many |
| Account | Get |
WiCloud Trigger (disparador)
| Evento | Cuándo |
|---|---|
| Message Received | Alguien le escribe a uno de tus números |
| Campaign Reply | La primera respuesta de un contacto a una campaña (últimos 7 días) |
| Campaign Finished | Termina una campaña, con sus resultados |
| Number Disconnected / Connected | Un número pierde o recupera la conexión |
Al activar el flujo, el disparador crea su webhook en WiCloud; al desactivarlo, lo borra. Cada aviso se verifica con su firma (HMAC-SHA256) y se rechazan los que tienen más de 5 minutos.
Instalación
En n8n: Settings → Community Nodes → Install y escribe n8n-nodes-wicloud.
Si tu n8n trabaja en modo cola (con un contenedor worker), reinicia también el worker después de instalar o actualizar el plugin; si no, las ejecuciones fallan con Unrecognized node type: n8n-nodes-wicloud.wiCloud.
Conexión
- En tu panel de WiCloud: Integraciones → API e integraciones → Nueva clave. Marca los permisos que vaya a usar el flujo (para el disparador: Recibir eventos).
- En n8n, crea la credencial WiCloud API con la dirección de tu panel (por ejemplo
https://wicloud.site) y la clavewic_….
Protección anti-bloqueo
Todo pasa por las mismas protecciones del panel:
- Mensajes: salen de a uno por número, con pausas humanas.
- Campañas:
- respetan las pausas mínimas y tu horario;
- quedan como borrador salvo que la clave tenga Enviar campañas directamente y actives Send Directly.
- Reintentos: cada envío lleva una clave de idempotencia automática, así un reintento de n8n nunca manda dos veces el mismo mensaje.
Plantillas listas
Seis flujos para importar en n8n (Import from File), en https://<tu-wicloud>/plantillas-n8n/:
| Archivo | Qué hace |
|---|---|
pedido-woocommerce-whatsapp.json |
Pedido nuevo en WooCommerce → guarda al cliente → WhatsApp de confirmación |
formulario-contacto-saludo.json |
Formulario → contacto en una lista → saludo por WhatsApp |
campana-desde-google-sheets.json |
Hoja de Google Sheets → campaña personalizada (borrador) |
responder-con-ia.json |
Llega un mensaje → agente de IA → respuesta por el mismo número |
recordatorio-citas.json |
Todos los días → citas de mañana → recordatorio por WhatsApp |
aviso-numero-desconectado.json |
Se desconecta un número → aviso por correo |
Documentación de la API
https://<tu-wicloud>/desarrolladores/api
English
n8n nodes for WiCloud: send WhatsApp messages, manage contacts, lists and campaigns, and start workflows when something happens in your account.
- WiCloud node: messages, contacts, lists, campaigns, numbers and account (see the table above).
- WiCloud Trigger:
- Events: message received, first reply to a campaign, campaign finished, number disconnected or connected.
- Webhook lifecycle: it registers its webhook in WiCloud on activation and removes it on deactivation.
- Signatures: every notification is verified with HMAC-SHA256, and those older than 5 minutes are rejected.
Credentials: create an API key in your WiCloud panel (Integraciones → API e integraciones) and use it with your panel URL in the WiCloud API credential.
Messages are queued one at a time per number with human-like pauses. Campaigns respect the account's safety pauses and schedule, and are created as drafts unless the key allows direct sending. Each send carries an automatic idempotency key, so n8n retries never duplicate messages.