Blog InfluxIA

Cómo configurar WhatsApp Business en n8n con WhatsApp Cloud API: guía paso a paso

Cómo configurar WhatsApp Business en n8n con WhatsApp Cloud API: guía paso a paso

Cómo configurar WhatsApp Business en n8n con WhatsApp Cloud API: guía paso a paso

En esta guía te mostramos cómo configurar WhatsApp Business en n8n usando WhatsApp Cloud API para levantar un mini agente que responda dudas o agende citas en WhatsApp, incluyendo la obtención del token de acceso WhatsApp Business y el Business Account ID WhatsApp, más las credenciales necesarias en n8n para recibir y enviar mensajes.

Nota: no repetimos “qué es n8n” ni “qué es WhatsApp Cloud API”. Si necesitas repaso, mira la integración oficial de n8n con WhatsApp Business Cloud.

Tiempo de lectura

Estimado: 12–15 minutos

Puntos clave

  • Separar credenciales: recepción usa App ID + App Secret; envío usa Access Token + Business Account ID.
  • Empieza con el número de prueba y luego migra a tu línea real para producción.
  • Normaliza los teléfonos a formato E.164 y controla variables como $json.telefono y $json.respuesta.
  • Activa el workflow en n8n para escuchar webhooks reales y valida suscripciones.
  • Renueva el Access Token si caduca y actualiza las credenciales en n8n.
  • Apóyate en la guía de credenciales de n8n para WhatsApp y la integración oficial.

Tabla de contenidos

1) Qué vas a construir y requisitos

Lo que vas a lograr:

  • Recibir mensajes en n8n vía WhatsApp Cloud API.
  • Procesarlos con un mini agente (respuesta automática simple).
  • Responder por WhatsApp al remitente.

Requisitos previos:

  • Cuenta de Meta/Facebook y acceso a business.facebook.com.
  • Meta Business Manager (Portfolio) configurado para tu empresa.
  • App en Meta Developers (tipo Empresa/Business).
  • Acceso a la sección WhatsApp de tu app (WhatsApp Cloud API).
  • n8n instalado y accesible (local, servidor o nube).
  • Número propio opcional (puedes empezar con el número de prueba de Meta).

Recursos útiles:

Sigue leyendo: vamos paso a paso, sin rodeos.

2) Crear y preparar tu entorno en Meta Business

1) Crear/validar tu negocio:

  • Entra en business.facebook.com y completa el perfil de empresa.
  • Crea el Business Manager (Portfolio) si no existe.

2) Crear la app en Meta Developers:

  • Ve a developers.facebook.com y crea una nueva app.
  • Caso de uso: “Otro”.
  • Tipo: Empresa (no se puede cambiar luego; asegúrate).
  • Obtén el App ID y el App Secret en “Información básica” de la app.

3) Activar WhatsApp Cloud API en la app:

  • En el menú de productos, añade “WhatsApp”.
  • Entra a “Configuración de la API” (API Setup).
  • Este panel concentra: número de prueba, token de acceso y Business Account ID. Puedes ver un tutorial en video con el recorrido.

Consejos rápidos:

  • Guarda App ID y App Secret en un gestor seguro.
  • No compartas el App Secret; trátalo como una contraseña.

“Prepara todo en Meta primero; conectar n8n es mucho más fácil cuando ya tienes App ID, App Secret y el producto WhatsApp activado.”

3) Vincular el “on message” en n8n (recepción de mensajes)

En n8n, añadiremos el trigger de WhatsApp para recibir eventos cuando alguien te escriba.

Pasos:

  • Crea un workflow nuevo.
  • Añade el nodo trigger “WhatsApp Business Cloud: On message”.
  • Al configurarlo, crea credenciales nuevas con:
    • App ID.
    • App Secret.

Prueba de recepción:

  • Guarda y deja el workflow en “Active” para escuchar webhooks.
  • Envía un mensaje al número de prueba de Meta.
  • Verás una ejecución con el payload del evento en n8n si todo está bien.

Pistas:

4) Generar el Access Token y obtener el Business Account ID

Para enviar mensajes desde n8n necesitas dos cosas distintas de las usadas en el trigger:

  • token de acceso WhatsApp Business (Access Token).
  • Business Account ID WhatsApp.

Dónde conseguirlos:

  • Ve a tu app en developers.facebook.com.
  • En el producto “WhatsApp” abre “API Setup” o “Configuración de la API”.
  • Allí encontrarás:
    • Access Token (cópialo).
    • Business Account ID (cópialo).
    • Número de prueba y su validación por código.

    Mira este video de configuración.

Valida un número de prueba:

  • Añade un destinatario de prueba.
  • Meta enviará un código por WhatsApp.
  • Introduce el código y quedará verificado para pruebas end-to-end. Recomendado: comienza con el número de prueba de Meta.

Diferencia de credenciales (muy importante):

  • Recepción (“On message”): usa App ID + App Secret.
  • Envío (“Send message”): usa Access Token + Business Account ID.

Notas: El token puede caducar según configuración y permisos. Revísalo y renueva cuando toque; guía en la documentación de credenciales de n8n.

5) Configurar el envío de mensajes en n8n

Ahora conectamos el lado “output”.

Pasos:

  • En el mismo workflow, añade el nodo “WhatsApp Business Cloud: Send message”.
  • Crea nuevas credenciales específicas para envío:
    • Access Token.
    • Business Account ID.
  • Guarda.

Prueba de envío:

  • En el nodo “Send message” elige “Text” como tipo de mensaje.
  • Recipient: usa el número de prueba que validaste (formato E.164: +[código país][número]).
  • Mensaje: “Hola, soy tu bot de n8n. ¡Funciona!”.
  • Ejecuta el nodo o el workflow.

Resultado esperado: Recibes el texto en el teléfono validado.

Si no llega:

  • Revisa que el número esté en E.164 y verificado.
  • Verifica que las credenciales del nodo de envío usan Access Token + Business Account ID.
  • Consulta la guía de la integración y este tutorial en video para pruebas en vivo.

Consejo pro: nombra tus credenciales claramente, por ejemplo: “WA Trigger (AppID/Secret)” y “WA Send (Token/BAID)”.

6) Construir el mini agente en n8n (flujo básico)

Estructura mínima del workflow:

  • Trigger “On message”.
  • Nodo de transformación de datos (Data Transformation).
  • Nodo “agente” (respuesta).
  • Nodo “Send message”.

1) Trigger “On message”
Ya lo tienes agregado. Confirma que recibes campos como from (teléfono), body (texto), timestamp, etc.

2) Transformación: normaliza el teléfono a E.164

  • Añade un nodo “Function” o “Set”.
  • Objetivo: guardar el número entrante en $json.telefono con formato +[código][número].
  • Ejemplo con “Set”: añade un campo telefono y usa una expresión para garantizar el “+”.

Idea simple: si el número no inicia con “+”, prepende “+34” (o tu país). En producción, usa una librería de formateo o un mapa por país.

3) Nodo “agente” o generador de respuesta

  • Empieza simple: un “Switch” o “If” según palabras clave.
  • Si el mensaje incluye “cita”, responde con horarios.
  • Si incluye “precio”, responde tu lista de precios.
  • Si no coincide, responde un saludo y opciones.
  • Crea $json.respuesta con el texto a enviar.

4) Nodo “Send message”: responder al remitente

  • Recipient: usa la expresión {{$json.telefono}}.
  • Mensaje: usa {{$json.respuesta}}.

Atajos de expresiones: no olvides $ en $json y respeta mayúsculas/minúsculas.

Ejemplo mínimo de flujo: On message → Set (telefono, respuesta por defecto) → If (según texto) → Set (respuesta ajustada) → Send message.

Prueba rápida del mini agente: ejecuta el workflow con payload simulado; para WhatsApp real, actívalo en “Active”. Envía “hola” desde tu teléfono verificado y deberías recibir respuesta en segundos.

Más tipos de mensaje y parámetros en la integración oficial de n8n y en este video con ejemplos E2E.

7) Probar con el número de prueba de Meta (end-to-end)

Pasos en Meta:

  • En developers.facebook.com, entra a tu app.
  • En el producto WhatsApp, abre “API Setup”.
  • En “To” añade tu teléfono personal como “destinatario de prueba”.
  • Recibirás un código por WhatsApp. Escríbelo en el panel para verificar.
  • Ahora ese número podrá recibir mensajes desde tu app de prueba. Refiérete a este tutorial de pruebas.

Prueba desde el panel de Meta:

  • En “API Setup” verás un campo para enviar un mensaje de test.
  • Escribe “Hola desde Meta”.
  • Asegúrate de que el remitente sea el “From phone number” de prueba.
  • Debe llegar a tu teléfono verificado; si no, reintenta tras unos segundos. Mira el video de configuración.

Prueba end-to-end con n8n:

  • Envía un WhatsApp desde tu teléfono verificado al número de prueba de Meta.
  • n8n debe disparar el trigger “On message”.
  • Responde con tu nodo “Send message” (usa Business Account ID + Access Token).
  • Verifica que recibes la respuesta en tu teléfono.

Tips rápidos: el formato debe ser E.164; deja el workflow en “Active”; si algo falla, valida credenciales y suscripciones en la integración oficial.

8) Conectar tu propio número de WhatsApp Business

Pasos generales:

  • En tu Business Manager confirma datos de empresa (nombre legal, web, país y categoría). Guía: credenciales WhatsApp en n8n.
  • En la sección de WhatsApp de tu app, elige “Add phone number”.
  • Completa display name, URL corporativa, zona horaria y país.
  • Verifica el número por SMS/llamada ingresando el código recibido.

Expectativas y tiempos: puede tardar horas o días; si rechazan, revisa coherencia de marca y web.

Buenas prácticas: web con dominio y SSL, marca consistente y uso legítimo (soporte, ventas, notificaciones, agendas).

Una vez aprobado: actualiza en n8n el “From” a tu número real; normalmente mantienes el mismo Access Token y Business Account ID si pertenecen a la misma app/cuenta; prueba envío y recepción otra vez. Más en la integración oficial.

Nota sobre tokens: algunos expiran; renueva y actualiza credenciales en n8n según la documentación.

9) Alternativas si no puedes usar directamente Meta

Opciones comunes:

  • Wati (BSP oficial)
    • Ventajas: onboarding guiado, soporte, gestión simple de plantillas y números.
    • Consideraciones: costes mensuales y por mensaje; dependencia del proveedor.
  • Evolution API
    • Ventajas: despliegue rápido para prototipos.
    • Consideraciones: cumplimiento y estabilidad pueden variar; evalúa riesgos.

Consejo: para producción y escala, prioriza proveedores oficiales o la propia WhatsApp Cloud API.

10) Errores frecuentes y cómo resolverlos

  • Enviar con credenciales equivocadas
    • Síntoma: 401/403.
    • Causa: usas App ID/Secret en “Send message”.
    • Solución: usa Access Token + Business Account ID. Referencia: guía de credenciales.
  • Falta de variables en el “agente”
    • Síntoma: sin texto o receptor.
    • Causa: no definiste $json.respuesta o $json.telefono.
    • Solución: crea esas claves antes del envío.
  • Formato de teléfono incorrecto
    • Síntoma: mensaje no se entrega.
    • Causa: no usas E.164.
    • Solución: normaliza a +[código país][número].
  • Expresiones mal escritas
    • Síntoma: error de evaluación.
    • Causa: olvidas $json o el nombre exacto del campo.
    • Solución: usa la vista de expresiones y autocompletado de n8n.
  • Webhook sin suscripción activa
    • Síntoma: no recibes eventos.
    • Causa: trigger desactivado o suscripciones incompletas.
    • Solución: activa el workflow y revisa la configuración. Ver integración oficial.
  • Token caducado
    • Síntoma: 401 intermitente o súbito.
    • Solución: renueva el Access Token y actualiza n8n. Guía: credenciales WhatsApp.

11) Checklist final antes de ir a producción

  • Trigger “On message”
    • Activo y probado con mensajes reales.
    • Campos mapeados: from, body, timestamp.
  • Envío “Send message”
    • Credenciales con Access Token + Business Account ID.
    • Envío confirmado a número de prueba y número real.
  • Datos y formato
    • Números en E.164.
    • Variables definidas: $json.telefono y $json.respuesta.
  • Lógica del agente
    • Respuestas claras para 3–5 intenciones básicas.
    • Fallback amigable.
  • Operación
    • Token válido y recordatorio de renovación.
    • Logs de n8n guardados.
    • Política de privacidad y términos en tu web.
  • Número
    • Número propio verificado o plan con número de testing mientras llega la aprobación.

12) Cierre

Ya tienes un flujo funcional: recibes mensajes, los procesas en un mini agente y respondes por WhatsApp usando n8n y la WhatsApp Cloud API. Sabes obtener y usar el token de acceso WhatsApp Business y el Business Account ID WhatsApp, probar con número de test y preparar la conexión con tu línea real.

¿Te gustaría que hagamos un tutorial aparte con Wati o Evolution API? Déjalo en comentarios. Y si quieres ampliar, revisa la integración oficial de n8n para más tipos de mensaje y parámetros avanzados.

“Con esto podrás configurar WhatsApp Business en n8n para soporte, ventas o agendamiento de forma simple y segura.”

Recursos y referencias

Elementos SEO complementarios

Meta descripción sugerida:
Aprende a configurar WhatsApp Business en n8n con WhatsApp Cloud API: pasos para obtener el token de acceso WhatsApp Business y el Business Account ID WhatsApp, crear el trigger “On message”, enviar mensajes y probar con número de test.

Slug:
configurar-whatsapp-business-n8n-whatsapp-cloud-api

Palabras clave incluidas:

  • configurar WhatsApp Business en n8n
  • WhatsApp Cloud API
  • token de acceso WhatsApp Business
  • Business Account ID WhatsApp

FAQ

¿Qué diferencias hay entre App ID/Secret y el token de acceso WhatsApp Business?

App ID/Secret sirven para autenticar tu app y suscribirte a eventos (webhooks). Se usan en el trigger “On message”. El token de acceso WhatsApp Business (Access Token) autoriza el envío de mensajes desde tu cuenta de WhatsApp Business y se usa junto con el Business Account ID en el nodo “Send message”. Revisa la guía de credenciales de n8n.

¿Cómo encuentro mi Business Account ID WhatsApp?

Entra a developers.facebook.com, abre tu app, ve a WhatsApp > API Setup. Verás el “Business Account ID” junto al Access Token. Aquí tienes un video de referencia.

¿Puedo probar sin verificar mi número?

Sí. Usa el número de prueba que da Meta. Verifica solo tu teléfono como “destinatario de prueba” con el código que llega por WhatsApp. Mira este tutorial.

¿Cuánto tarda Meta en aprobar mi número propio?

Varía: puede ser en horas o tomar días. Asegúrate de que tu web y datos de empresa sean coherentes y visibles para acelerar el proceso.

¿Qué formato de teléfono usa n8n con WhatsApp Cloud API?

E.164: +[código país][número], sin espacios ni guiones. Ejemplo: +34600111222.

¿Mi token de acceso expira?

Puede expirar según cómo lo generaste y los permisos. Revisa el panel de Meta y renueva cuando toque. Luego actualiza las credenciales en n8n. Detalles en la documentación de credenciales.

¿Puedo enviar imágenes o plantillas?

Sí. La integración soporta texto, imagen, documento y plantillas con variables. Empieza con texto y luego amplía desde la integración oficial de n8n.

¿Necesito producción para probar?

No. Con el número de prueba de Meta puedes hacer un circuito completo de envío y recepción antes de mover tu número real. Ver guía en este video.

Cover Image