Flujo de IA en n8n con WhatsApp: nodo, webhook y plantillas

Paso a paso

1. 1

   Instala el nodo de la comunidad

   En n8n, abre Settings > Community Nodes > Install, escribe n8n-nodes-zapzap y acepta. Es un nodo de la comunidad, publicado en npm (versión 0.1.3, del 27/10/2026) y de código abierto en GitHub. En n8n Cloud, revisa en la documentación de n8n si tu cuenta acepta nodos de la comunidad; si no, usa HTTP Request en el último paso.

2. 2

   Crea la credencial con API key y secret

   En el panel de ZapZap, abre Settings > API y copia la API Key y el API Secret. En n8n, crea una credencial ZapZap API, pega los dos valores y guarda: n8n prueba la credencial al guardar y muestra un mensaje verde si salió bien. Deja la Base URL como está. Default Country Code es opcional: con 55, el número 11 99999-0001 pasa a 5511999990001.

3. 3

   Envía el primer mensaje

   Agrega el nodo ZapZap, deja Resource = Message y Operation = Send Text, elige la instancia en la lista (una instancia es un número de WhatsApp conectado; si la lista viene vacía, crea y conecta uno en el panel antes), indica número y texto y ejecuta. Para varios elementos, activa Continue On Fail.

4. 4

   Recibe mensajes con el ZapZap Trigger

   Agrega el ZapZap Trigger, elige la credencial y la instancia y activa el workflow: el nodo registra la URL en la instancia y la elimina cuando lo desactivas. n8n necesita una dirección pública en HTTPS (define WEBHOOK_URL). La salida trae campos listos como from, text, type, chatId, isGroup, fromMe y messageId. Cada entrega llega firmada (X-ZapZap-Signature, HMAC-SHA256 con marca de tiempo) y el nodo rechaza las falsificadas o con más de 5 minutos.

5. 5

   Arma el flujo de IA

   Conecta el ZapZap Trigger a un nodo AI Agent de n8n (con el modelo que elijas allí) y su salida a un nodo ZapZap en Send Text. Activa Ignore My Own Messages en el Trigger para que la respuesta automática no dispare el flujo otra vez. El nodo ZapZap también puede usarse como herramienta de un agente de IA de n8n.

6. 6

   O usa HTTP Request y Webhook, sin instalar nada

   En HTTP Request, haz POST a https://api.zapzapapi.com/api/v1/{instanceId}/send/text con los encabezados x-api-key y x-api-secret y un cuerpo JSON con number y text. Para recibir, crea un nodo Webhook, copia la Production URL y regístrala en la instancia con el endpoint webhook (POST /{instanceId}/webhook, con los eventos que quieras). Activa el workflow para que la Production URL responda.

// Ejemplo ILUSTRATIVO del nodo HTTP Request en n8n (POST), si no usas el nodo de la comunidad
// Campos y ruta exactos: https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
  x-api-key: TU_API_KEY
  x-api-secret: TU_API_SECRET
  Content-Type: application/json
Body:
{
  "number": "5511999999999",
  "text": "¡Hola! Tu cita fue confirmada."
}