¿Cómo armo un bot de atención por WhatsApp en n8n?

Cómo funciona

1. Llega el webhook de Connect
2. Firma y token
3. ¿Ya lo procesé?
4. Estado del contacto
5. Decidir
6. IA · persona · horario · media · baja
7. POST /v1/messages

Y aparte: message.echo (contestaste desde el celular) → el bot se calla en esa conversación · message.status fallido → registro y aviso, sin reintento.

Qué hace, uno por uno

• Verifica que el mensaje viene de Connect: el token del encabezado (lo chequea n8n antes de correr nada) y la firma HMAC X-Connect-Signature-256 sobre timestamp.cuerpo, con 5 minutos de tolerancia. Una firma mala recibe 401.
• Nunca contesta dos veces. Connect reintenta si no recibe 2xx, y Meta a veces reentrega el mismo mensaje (Connect lo reenvía con otro id de evento pero el mismo id de WhatsApp). El workflow anota el id de WhatsApp y además manda Idempotency-Key atado a él: aunque algo se repita, Connect no manda otra respuesta.
• Contesta con IA leyendo las instrucciones de tu negocio (qué vendés, horarios, tono) de un solo campo, con memoria por contacto. El modelo es un nodo aparte: viene OpenAI y hay uno de Claude listo para cambiar.
• Pasa a una persona si el cliente lo pide o si la IA no sabe (contesta una marca que el cliente nunca ve): le dice que lo atiende alguien, te avisa y se calla en esa conversación por las horas que elijas.
• 🔑 Si contestás vos desde el celular, el bot se calla en esa conversación por el rato que elijas. Es lo que permite la convivencia: Connect te manda message.echo con lo que escribiste en la app. Cuando el bot vuelve, la IA sabe qué le dijiste.
• Horario de atención: fuera de hora manda un mensaje y nada más (no repite en cada mensaje).
• Audio, imagen, video, sticker, ubicación: una respuesta honesta («sólo leo texto, ¿me lo escribís?»), no silencio.
• Baja: si escriben «baja» o «stop», confirma una vez y no les escribe más; «alta» o «start» los vuelve a sumar.
• Errores: si Connect rechaza un envío (clave mal, prueba vencida, número desconectado, cupo) o Meta lo rechaza después (por ejemplo la ventana de 24 h), lo anota en una tabla y te avisa. Nunca reintenta y un aviso que falla no genera otro aviso: no hay bucle posible.

Descargalo

Descargar el workflow (JSON)

Ponerlo a andar en 5 pasos

1. Importalo. En n8n: Workflows → ⋮ → Import from File y elegí el JSON. Apretá ▶ en el nodo Run once: create tables (crea las 3 tablas que usa: duplicados, contactos, errores).
2. Credenciales (el workflow no trae ningún secreto): Connect webhook token — tipo *Header Auth*, Name X-Connect-Token, Value tu token wct_…; Connect API key — *Header Auth*, Name Authorization, Value Bearer wc_live_… (en el panel: API → Crear API key); OpenAI (o Anthropic); y SMTP si querés los avisos por correo.
3. Config. Abrí el nodo Config y escribí tu negocio en businessInstructions, tu horario en openingHours, tu correo en ownerEmail. Si querés verificar la firma, pegá tu whsec_… en signingSecret.
4. Activalo (el interruptor de arriba) y copiá la Production URL del nodo Connect webhook. ⚠ La de prueba (Test URL) escucha una sola vez.
5. En Connect → Webhooks → Agregar endpoint: esa URL, eventos message.received, message.echo y message.status, y generá el token estático. Apretá Probar: tiene que dar 200. Después mandate un WhatsApp desde otro teléfono.

¿Alcanza con el nodo de WhatsApp que ya trae n8n?

n8n trae su propio nodo de WhatsApp, que habla directo con Meta. Muchas veces alcanza, y es gratis: si ya tenés una app de Meta, tu número está en la Cloud API y no usás la app de WhatsApp Business en el teléfono, usá ese.

Lo que cambia con Connect, dicho sin vueltas (lo del nodo de n8n sale de su código, versión 2.40.7):

Si nada de la columna de la derecha te hace falta, quedate con el nodo de n8n. El workflow igual te sirve de ejemplo: las ideas (anotar el id de WhatsApp, contestar 200 antes de la IA, no mandar texto libre fuera de las 24 h, no reintentar a ciegas) valen para cualquier proveedor.

Lo que conviene saber antes

• Necesita un n8n con Data tables (lo probamos en 2.40.7). Ahí guarda los duplicados, el estado de cada contacto y los errores; los ves en Data tables.
• La memoria de la IA vive en n8n: se borra si n8n se reinicia y no sirve en modo cola (queue mode). Para algo duradero, cambiá el nodo de memoria por el de Postgres o Redis con la misma clave.
• El secreto de firma queda dentro del workflow (nodo Config): n8n no deja que un nodo lea una credencial. Si exportás o compartís el workflow, borralo antes. El token del encabezado y la API key sí van en credenciales.
• El nodo Code de n8n no puede usar crypto en una instalación propia (viene prohibido por defecto): por eso la firma se calcula con el nodo Crypto.
• El aviso a tu WhatsApp va por plantilla, nunca como texto libre: fuera de la ventana de 24 h Meta lo rechaza. Si no tenés una plantilla aprobada, usá el correo.
• Los mensajes automáticos de la app (bienvenida, ausencia) también salen del teléfono. No lo pudimos medir: si los tenés activos, pueden contar como respuesta tuya y callar al bot.
• Desde el 1 de octubre de 2026, Meta cobra también las respuestas dentro de la ventana de 24 h, por mensaje. Cada respuesta del bot tiene ese costo de Meta; Connect no le suma nada.

¿Tu bot vive en una hoja de Google?

Si no usás n8n y armaste tu bot sobre una planilla, está la guía con Google Sheets. La forma exacta de cada evento está en Recibir el webhook.

Fuentes (consultadas el 29/09/2026)

• n8n: el disparador de WhatsApp
• n8n: el nodo de WhatsApp
• n8n: módulos permitidos en el nodo Code (NODE_FUNCTION_ALLOW_BUILTIN)
• n8n: Data tables
• n8n: Simple Memory y el modo cola