wicloud

n8n nodes for WiCloud: send WhatsApp messages, manage contacts, lists and campaigns, and trigger workflows on WiCloud events.

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

  1. 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).
  2. En n8n, crea la credencial WiCloud API con la dirección de tu panel (por ejemplo https://wicloud.site) y la clave wic_….

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.

License

MIT

Discussion