Clase 05 · Módulo 10
Configurar WhatsApp Cloud API
Configurar WhatsApp Cloud API
Qué logras en esta clase
Envías un mensaje de WhatsApp desde n8n y recibes la respuesta en un flujo, por la vía oficial.
- Creas la app en Meta y la conectas a una cuenta de mensajería.
- Reemplazas el token temporal por uno permanente.
- Conectas el envío y la recepción con n8n.
02
Más piezas que en Telegram
En Telegram bastaba un token. Aquí hay una app, una cuenta, un número, un token y un webhook, y cada uno se configura en un lugar distinto.
03
El mapa de piezas
| Pieza | Qué es |
|---|---|
| App de Meta | El registro de tu integración ante Meta |
| Portafolio comercial | La cuenta de empresa dueña de todo |
| Cuenta de mensajería | La cuenta de WhatsApp Business conectada a la app |
| Número | Desde donde salen los mensajes |
| Token de acceso | La clave que usa n8n |
El webhook es la sexta pieza: la dirección donde Meta te avisa lo que llega.
04
Qué necesitas antes de partir
- Una cuenta de Facebook, o una cuenta administrada de Meta.
- Registrarte como desarrollador en Meta.
- Un teléfono con WhatsApp para recibir los mensajes de prueba.
- n8n con dirección pública HTTPS para recibir (módulo 5, clase 6).
Las pantallas de Meta cambian seguido. Sigue esta clase con la guía oficial «Get started» abierta al lado.
05
El recorrido completo
Son tres tramos. No pases al siguiente hasta que el anterior funcione.
06
Crear la app
- Entra al panel de apps de Meta, en developers.facebook.com/apps, y pulsa Create App.
- Escribe el nombre de la app y tu correo.
- Elige el caso de uso Connect with customers through WhatsApp.
- Selecciona un portafolio comercial existente o crea uno.
- Revisa los requisitos de publicación que aparezcan y confirma con Create app.
Al terminar quedas en la sección de inicio rápido de WhatsApp.
07
Conectar la cuenta de mensajería
- Pulsa Start using the API: se abre la página API Setup.
- Conecta la app a una cuenta de mensajería: elige una existente o crea una con Create a WhatsApp Business account.
- Guarda el identificador de la cuenta de mensajería que muestra el panel.
08
Enviar el mensaje de prueba
- Pulsa Generate access token para obtener un token temporal.
- En From, elige el número de origen de prueba.
- En To, agrega tu propio número como destino.
- Pulsa Send message y revisa tu teléfono.
- Responde ese mensaje desde tu teléfono.
Si llegó, la app y la cuenta están bien conectadas.
09
Tres datos que te llevas del panel
| Dato | Para qué |
|---|---|
| Identificador de la cuenta de mensajería | Lo pide la credencial de n8n |
| Identificador del número de origen | Indica desde qué número envías |
| Token temporal | Solo para esta primera prueba |
10
El token temporal no sirve para trabajar
El token del panel vence rápido. Un flujo que lo use deja de enviar sin aviso a las pocas horas.
11
Crear el usuario del sistema
Un usuario del sistema es una cuenta técnica del negocio, sin persona detrás, pensada para integraciones.
- Entra a la configuración del negocio, en business.facebook.com/latest/settings, y abre System users.
- Pulsa Add y crea el usuario.
- Selecciónalo y pulsa Assign Assets.
- Elige tu app y activa Manage app en control total.
- Elige tu cuenta de WhatsApp y activa Manage WhatsApp Business accounts.
- Confirma con Assign assets.
12
Generar el token permanente
- Con el usuario del sistema seleccionado, pulsa Generate token.
- Agrega estos permisos:
business_management
whatsapp_business_messaging
whatsapp_business_management- Copia el token y guárdalo en un lugar seguro.
13
Las credenciales en n8n
n8n documenta la conexión en la página «WhatsApp Business Cloud credentials». Los nombres de cada campo cambian entre versiones, así que ábrela y comprueba:
- Qué pide la credencial del nodo de envío: espera el token y el identificador de la cuenta.
- Si el disparador usa una credencial distinta de la de envío.
- De qué parte del panel de Meta sale cada valor.
14
Enviar desde n8n
- Agrega el nodo WhatsApp Business Cloud.
- Elige la credencial y la operación de enviar mensaje.
- Selecciona el número de origen.
- Escribe el número de destino con código de país, sin espacios.
- Ejecuta el nodo y revisa el teléfono.
Fuera de la ventana de 24 horas el texto libre no se entrega: por eso respondiste antes el mensaje de prueba.
15
Cómo te avisa Meta lo que llega
Meta llama a tu dirección con dos tipos de aviso: mensajes que te envían y cambios de estado de los tuyos, como entregado y leído. Ambos llegan dentro del campo messages.
16
Recibir con el disparador
- Agrega el nodo WhatsApp Trigger en un flujo nuevo.
- Crea su credencial siguiendo la documentación del nodo.
- Elige recibir los avisos de mensajes.
- Ejecuta en prueba y escribe al número desde tu teléfono.
El disparador registra tu dirección ante Meta. Si prefieres hacerlo a mano con un nodo Webhook, la guía de Meta explica el paso de verificación que exige.
17
La dirección tiene que ser estable
Meta guarda la dirección de tu webhook. Con un túnel rápido, cambia en cada arranque y el bot queda sordo.
18
Qué dirección usar en cada etapa
| Etapa | Dirección |
|---|---|
| Primera prueba | Túnel rápido, sabiendo que caduca |
| Bot que atiende clientes | Túnel con nombre, servidor o n8n Cloud |
Recuerda fijar N8N_WEBHOOK_URL (módulo 5, clase 6) para que n8n registre la dirección pública y no localhost. El despliegue estable se ve en el módulo 14.
19
Separar mensajes de estados
Cada mensaje que envías genera avisos de estado que también disparan el flujo.
20
Del número de prueba al número real
La guía de inicio no cubre el paso a producción. Antes de usar el número de tu negocio, busca en la documentación de Meta:
- Cuántos destinatarios admite el número de prueba.
- Requisitos para registrar un número real y si puede seguir en la app del teléfono.
- Si tu negocio necesita verificación.
- Cómo se revisa el nombre visible.
- Qué límite diario de mensajes tendrás al partir.
21
Si algo no funciona
| Síntoma | Revisa |
|---|---|
| El envío falla a las horas | Sigues usando el token temporal |
| Error de permisos | Activos y permisos del usuario del sistema |
| Envía pero no recibe | Dirección del webhook y flujo publicado |
| El texto libre no llega | La ventana de 24 horas está cerrada |
22
Lo que te llevas
- La configuración tiene tres tramos: app, token permanente y webhook.
- El token de trabajo sale de un usuario del sistema, no del panel de pruebas.
- Envío y recepción son nodos distintos en n8n.
- El webhook necesita una dirección pública que no cambie.
- Mensajes y estados llegan juntos: hay que filtrarlos.
23
Hazlo ahora
En 15 minutos:
- Crea la app y envía el mensaje de prueba desde el panel de Meta.
- Anota los identificadores de la cuenta y del número.
- Crea el usuario del sistema y genera el token permanente.
- Guárdalo en una credencial de n8n y envíate un mensaje desde un nodo.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Get started with the WhatsApp Cloud API (Meta)developers.facebook.com ↗
- Pricing on the WhatsApp Business Platform (Meta)developers.facebook.com ↗
- WhatsApp Business Cloud credentials (documentación de n8n)docs.n8n.io ↗
- WhatsApp Business Cloud (documentación de n8n)docs.n8n.io ↗
- WhatsApp Trigger (documentación de n8n)docs.n8n.io ↗
- Webhook (documentación de n8n)docs.n8n.io ↗
- n8n Docs — Variables de entorno de endpoints (N8N_WEBHOOK_URL)docs.n8n.io ↗