Integración WhatsApp Business Cloud n8nAutomatiza WhatsApp Business Cloud con n8n.
Un número de WhatsApp que responde solo, sin que nadie viva pegado al móvil. Eso es la integración WhatsApp Business Cloud n8n: un nodo con 6 operaciones repartidas en 2 recursos y un trigger conectado a 10 eventos. Lo que entra y lo que sale conviven en el mismo flujo de trabajo.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Para qué sirve la integración WhatsApp Business Cloud n8n?
La integración WhatsApp Business Cloud n8n conecta un número de negocio con un flujo de trabajo de n8n a través de la Cloud API de Meta. El nodo envía mensajes, plantillas y archivos desde cualquier paso del flujo. El trigger recibe los eventos por webhook, es decir, una URL que WhatsApp llama en cuanto pasa algo en la cuenta. Alguien escribe y el flujo arranca en cuestión de segundos.
El primer montaje es el de respuesta. El trigger salta con el evento messages cuando un cliente escribe al número del negocio. El flujo lee el texto, busca el dato que hace falta y message.send devuelve la respuesta por el mismo hilo. Un paso más y la conversación queda guardada en Google Sheets, así hay historial sin montar un CRM entero.
El segundo es el aviso saliente. Una reserva se acerca, un pedido sale del almacén, una factura vence. El flujo llama a message.sendTemplate con una plantilla ya definida en la cuenta de WhatsApp Business, y las partes variables viajan en Components. Para mensajes repetitivos esta operación encaja mejor que el texto libre, que se reserva para la conversación real.
El tercero es el punto de validación. message.sendAndWait detiene el flujo, lanza la pregunta al móvil de quien decide y sigue cuando esa persona pulsa Aprobar o rellena el formulario. Sirve para autorizar un descuento antes de que salga, con copia al canal del equipo en Slack o en Discord según dónde trabaje la gente.
El nodo HTTP Request entra en juego cuando la Cloud API ofrece algo que el nodo no expone: gestionar plantillas, administrar números o consultar histórico. Llama a cualquier endpoint de la API reutilizando la misma credencial mediante la autenticación predefinida, así solo hay un token que rotar.
Quedan tres límites que conviene tener claros antes de construir. WhatsApp registra un único webhook por aplicación, de modo que la URL de pruebas y la de producción se pisan entre sí. No existe comodín en el trigger: cada evento se marca a mano. Y los archivos pasan por tres operaciones separadas, no por un adjunto dentro del mensaje. Para ver la plataforma en conjunto está la Reseña n8n, y el Curso n8n recorre estos flujos paso a paso.
¿Cómo conectar WhatsApp con n8n?
- 01
Prepara los activos de Meta
Tres piezas existen antes de n8n. Una cuenta de desarrollador de Meta, creada en Facebook Developers y verificada por teléfono. Un portafolio empresarial de Meta, el antiguo Business Manager, que los servicios de mensajería de WhatsApp exigen. Y una aplicación de empresa de Meta con el producto WhatsApp añadido desde Add products to your app. En App settings, Basic, rellena Privacy Policy URL y Terms of Service URL, y pon App Mode en Live.
- 02
Crea la credencial API key del nodo
El nodo WhatsApp Business Cloud se autentica con una clave de API formada por dos valores. El Access Token se genera dentro de la aplicación de Meta, en WhatsApp y luego API Setup: pulsa Generate access token y confirma los accesos que concedes. El Business Account ID se copia de esa misma pantalla de API Setup. Una credencial se crea una sola vez en el menú Credentials de n8n y se reutiliza en todos los flujos.
- 03
Añade la credencial OAuth2 del trigger
El WhatsApp Trigger usa otro método: OAuth2, con un Client ID y un Client Secret. Los dos salen de la misma aplicación de Meta, en App settings y luego Basic. El App ID va al campo Client ID de la credencial de n8n, y el App Secret al campo Client Secret. Para un solo montaje de WhatsApp conviven por tanto dos credenciales, una para enviar y otra para recibir. No hay que memorizarlas, cada nodo propone la suya en su lista desplegable.
¿A qué reacciona el WhatsApp Trigger?
WhatsApp Trigger es el nodo que arranca un workflow cuando algo ocurre en WhatsApp Business Cloud. Escucha 10 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que WhatsApp Business Cloud llama) en tu cuenta.
Lo que ves en n8n
Todos los eventos, por familia
Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.
account_review_update.*1account_review_ update. account_review_ update
account_update.*1account_update. account_update
business_capability_update.*1business_capability_ update. business_capability_ update
message_template_quality_update.*1message_template_ quality_ update. message_template_ quality_ update
message_template_status_update.*1message_template_ status_ update. message_template_ status_ update
messages.*1messages.messages
phone_number_name_update.*1phone_number_ name_ update. phone_number_ name_ update
phone_number_quality_update.*1phone_number_ quality_ update. phone_number_ quality_ update
security.*1security.security
template_category_update.*1template_category_ update. template_category_ update
Notas de configuración
01Set Up the WhatsApp Trigger
La configuración se reduce a un parámetro y una credencial. Trigger On contiene la lista de eventos a los que responde el flujo, y marcas los que te interesan entre los 10 disponibles. No hay valor comodín: un evento sin marcar nunca llega. El trigger se autentica con la credencial OAuth2, no con la clave de API del nodo.
Parámetros clave
- Trigger On: los eventos que WhatsApp envía a este flujo, marcados uno a uno en una lista de 10 entradas.
- Receive Message Status Updates: vive dentro de Options y filtra qué cambios de estado despiertan el flujo. WhatsApp avisa al trigger cada vez que un mensaje pasa de Sent a Delivered y de Delivered a Read, así que quedarse solo con los estados útiles evita varias ejecuciones por un mismo mensaje.
02Messages
El evento messages trae lo que los clientes escriben al número del negocio y también el estado de entrega de lo que ya enviaste. Es el evento que sostiene cualquier chatbot, cualquier reparto de consultas y cualquier acuse de recibo automático.
Parámetros clave
- Trigger On: marca
messagespara recibir el tráfico entrante del número vinculado a la cuenta. - Receive Message Status Updates: si lo dejas vacío, los cambios de estado no molestan; si eliges Delivered o Read, el mismo flujo ve además qué pasa con tus mensajes salientes.
message.send. Una consulta entra un domingo, una plantilla confirma la recepción y la petición espera al equipo el lunes.03Message Template Status Update
Tres de los diez eventos siguen la vida de las plantillas en lugar de las conversaciones: message_template_status_update, message_template_quality_update y template_category_update. Importan porque message.sendTemplate depende de que la plantilla siga siendo utilizable, y el nodo no avisa de nada cuando algo cambia del lado de Meta.
Parámetros clave
- Trigger On: marca los tres a la vez, porque una plantilla rara vez cambia de estado sin que su calidad o su categoría se muevan en algún momento.
04Account Update
Los eventos restantes describen la salud de la cuenta y de los números: account_update, account_review_update, business_capability_update, phone_number_name_update, phone_number_quality_update y security. Ninguno tiene que ver con un mensaje de cliente, y justo por eso se olvidan hasta que algo se rompe.
Parámetros clave
- Trigger On: marca los eventos de cuenta y de número que quieras ver donde alguien los lea, en vez de los 10 de golpe.
phone_number_quality_update y el flujo pausa la campaña saliente hasta que el número se recupere. Llega security y se abre un ticket. account_review_update indica que Meta ha revisado la cuenta, una noticia que conviene tener por escrito.¿Qué sabe hacer el nodo WhatsApp Business Cloud ?
El nodo WhatsApp Business Cloud expone 6 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Delete | Upload | Download | Send | Send and Wait for Response | Send Template |
|---|---|---|---|---|---|---|
| Message | ✓ | ✓ | ✓ | |||
| Media | ✓ | ✓ | ✓ |
Message
3 operacionesSend message
message.sendLo que ves en n8n
Notas y casos de uso
Envía un mensaje de WhatsApp desde el número del negocio a un destinatario. MessageType decide qué pide el formulario después, siete tipos: texto, imagen, audio, vídeo, documento, ubicación o contactos.
Parámetros clave
- Sender Phone Number (or ID): el identificador del número de empresa desde el que sale el mensaje, elegido en una lista.
- Recipient's Phone Number: el número de destino con prefijo de país, muchas veces una expresión tipo
{{ $json.phone }}del item anterior. - Text Body: el mensaje, con un tope de 4096 caracteres.
- Input Data Field Name: para un archivo de n8n, el nombre del campo binario, escrito
datay no como expresión.
Send message and wait for response
message.sendAndWaitLo que ves en n8n
Notas y casos de uso
Deja el flujo en pausa, lanza una pregunta a un móvil y solo sigue cuando esa persona responde. La ejecución queda abierta mientras tanto: es la parada humana del flujo.
Parámetros clave
- Message: el texto que lee quien tiene que decidir.
- Response Type: Approval para aprobar o rechazar desde el mensaje, Free Text para una respuesta escrita en un formulario, Custom Form para campos que defines tú.
- Type of Approval: Approve Only cuando basta un visto bueno, Approve and Disapprove cuando el rechazo debe quedar registrado.
- Limit Wait Time: pone un tope a la espera antes de que la ejecución siga sola.
Send template
message.sendTemplateLo que ves en n8n
Notas y casos de uso
Envía una plantilla registrada en la cuenta de WhatsApp Business en lugar de texto libre. Template es una lista de nombres de plantilla, y los valores variables viajan aparte.
Vigila el error Bad request - please check your parameters: casi siempre los datos no cuadran con la plantilla, por tipo o por el orden de los parámetros. Con expresiones, un nodo Edit Fields (Set) antes o un valor de reserva mantienen el formato.
Parámetros clave
- Template: el nombre de la plantilla que se envía, obligatorio y elegido de la lista.
- Components: los valores que se inyectan en la plantilla, añadidos con Add Component.
Media
3 operacionesUpload media
media.mediaUploadLo que ves en n8n
Notas y casos de uso
Sube a WhatsApp un archivo que ya está en el flujo y lo guarda asociado a un número, para que un mensaje posterior lo adjunte por identificador en vez de reenviar el archivo.
Parámetros clave
- Sender Phone Number (or ID): el identificador del número donde queda guardado el archivo.
- Property Name: el nombre de la propiedad binaria que contiene el archivo, un nombre de campo y no una expresión.
- Filename: dentro de Additional Fields, el nombre que recibe el archivo del lado de WhatsApp.
Download media
media.mediaUrlGetLo que ves en n8n
Notas y casos de uso
Trae al flujo un archivo alojado en WhatsApp. Es la vía por la que una foto, un audio o un documento recibido se convierte en algo que los nodos siguientes pueden tratar.
Parámetros clave
- Media ID: el identificador del archivo, único campo obligatorio de la operación.
media.mediaUrlGet, que es el valor visible al leer el JSON de un flujo.Delete media
media.mediaDeleteLo que ves en n8n
Notas y casos de uso
Borra un archivo guardado antes en WhatsApp. Ningún otro punto del nodo recoge lo que dejó una subida, así que esta es la operación que impide que la biblioteca crezca sin fin.
Parámetros clave
- Media ID: el identificador del archivo que se borra, el mismo que devolvió el paso de subida un poco antes en la ejecución.
¿Necesitas ayuda para automatizar WhatsApp Business Cloud con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
