Conectar un número de WhatsApp Business API (la API oficial de Meta, también llamada Cloud API) a FlujosChat toma unos 20 minutos. La parte difícil no es ninguno de los pasos en sí: es que uno de ellos falla en silencio. Todo parece bien configurado, el servidor responde, la API acepta mensajes… y aun así no llega nada. Esta guía va en el orden correcto y marca exactamente dónde está esa trampa.

Antes de empezar

Necesitás tener a mano tres cosas:

Una cuenta en Meta Business Manager con tu negocio verificado.
Un número de teléfono que NO tenga WhatsApp activo (ni la app normal ni WhatsApp Business). Si ya lo usás en tu celular, primero tenés que borrar esa cuenta o usar otro número.
Tu cuenta de FlujosChat con el plan activo.

¿Prefieres que lo hagamos por ti?

Si no querés pasar por Meta, escribinos y configuramos la integración con vos en una videollamada. Contactar al equipo →

Los 6 pasos

Crea la app en Meta y añade el producto WhatsApp

Entrá a developers.facebook.com → Mis Apps → Crear app → tipo Negocios. Una vez creada, en el panel de productos añadí WhatsApp.

Meta te va a crear automáticamente una WABA (WhatsApp Business Account) de prueba y un número de test. Podés usar ese número para probar, pero para producción registrá tu número real en API Setup → Agregar número de teléfono.

Copia los tres identificadores

En WhatsApp → API Setup vas a ver dos IDs; el tercero está en la configuración de la app. Anotá los tres:

Phone Number ID — el ID del número (no es el número en sí; es una cadena larga de dígitos).
WhatsApp Business Account ID — el ID de la WABA.
App Secret — en Configuración → Básica → Clave secreta de la app. FlujosChat lo usa para verificar que los mensajes vienen realmente de Meta.

Genera un token PERMANENTE (no el temporal)

Este paso es el que más gente saltea. En la pantalla de API Setup, Meta te ofrece un token temporal que vence en 24 horas. Si usás ese, tu bot va a funcionar hoy y va a dejar de funcionar mañana.

Para generar el token permanente:

Andá a Business Manager → Configuración del negocio → Usuarios → Usuarios del sistema.
Creá un usuario del sistema con rol Administrador y asignale tu app.
Clic en Generar nuevo token → elegí tu app → marcá los permisos whatsapp_business_messaging y whatsapp_business_management.
Copiá el token y guardalo: Meta lo muestra una sola vez.

Pega los datos en FlujosChat

En tu dashboard, andá a Configuración → WhatsApp y completá: el token permanente, el App Secret, tu número, el Phone Number ID y el WABA ID. Guardá.

Al guardar, FlujosChat te genera dos valores que vas a necesitar en el paso siguiente: Webhook URL y Webhook Verify Token. Ambos tienen un botón para copiarlos.

Configura el webhook y suscribe el campo «messages»

Volvé a Meta → WhatsApp → Configuration → Webhook → Editar. Pegá la Webhook URL y el Verify Token que copiaste de FlujosChat, y verificá.

No te vayas todavía: falta suscribir «messages»

Registrar la URL no alcanza. En la misma pantalla, en la lista de campos del webhook, tenés que darle Suscribirse al campo messages. Si no lo hacés, Meta verifica tu URL correctamente pero nunca te envía los mensajes entrantes.

Suscribe la WABA a tu app — el interruptor maestro

Este es el paso que casi nadie hace y el que rompe todo. Aunque la URL del webhook esté registrada en la app, Meta todavía no sabe que los eventos de tu WABA deben ir a esa app. Hay que decírselo explícitamente, una sola vez, con esta llamada:

bash

curl -X POST \
  "https://graph.facebook.com/v22.0/<TU_WABA_ID>/subscribed_apps" \
  -H "Authorization: Bearer <TU_TOKEN_PERMANENTE>"

Si responde { "success": true }, ya está. Podés correrlo desde tu terminal, desde Postman, o desde el Graph API Explorer de Meta.

Por qué este error es el más traicionero

No produce ningún mensaje de error. El webhook existe, tu servidor corre, la API acepta mensajes salientes — pero Meta simplemente no notifica nada, porque no sabe que debe hacerlo. Si tenés «todo bien configurado» y aun así no llega nada, empezá por acá.

Probá que funciona

Desde otro celular, mandale un WhatsApp a tu número de negocio. En unos segundos deberías ver la conversación aparecer en Conversaciones, y si tenés un flujo con la palabra clave que escribiste, debería responder solo.

La ventana de 24 horas

Una regla de Meta que sorprende a todos: solo podés enviarle texto libre a alguien que te escribió en las últimas 24 horas. Fuera de esa ventana, Meta rechaza el mensaje.

Para contactar a alguien fuera de la ventana (una promo, un recordatorio, un carrito abandonado) tenés que usar una plantilla aprobada previamente por Meta. En FlujosChat las gestionás desde Plantillas. Cuando el cliente responde a la plantilla, la ventana se abre de nuevo y ya podés conversar libremente.

«Configuré todo y no me llegan los mensajes»

Es el síntoma más común, y casi siempre es una de estas cuatro causas — en este orden de probabilidad:

La WABA no está suscrita a la app (paso 6). El sospechoso número uno. Corré el POST /subscribed_apps y probá de nuevo.
El campo «messages» no está suscrito en el webhook (paso 5).
El token venció. Si usaste el token temporal de 24 h, se murió. Generá el permanente (paso 3) y actualizalo en FlujosChat.
La app está en modo Desarrollo. En developers.facebook.com, arriba a la derecha, pasala a Live. En modo desarrollo, Meta solo entrega eventos de números que tengan un rol asignado en la app.

Si cambiás el token, revisá el App Secret

La verificación de firma de los webhooks usa el App Secret. Si regeneraste el token o moviste la integración a otra app de Meta, asegurate de que el App Secret guardado en FlujosChat sea el de la app que efectivamente está enviando los webhooks — si no coinciden, los mensajes llegan pero se rechazan por firma inválida.

Checklist final

Antes de dar por cerrada la integración, verificá los ocho puntos:

El número de negocio no tenía WhatsApp activo antes de registrarlo en Meta
La app de Meta está en modo Live (no Desarrollo)
Token permanente de usuario del sistema (no el temporal de 24 h)
Permisos whatsapp_business_messaging y whatsapp_business_management concedidos
Webhook URL verificada en Meta con el Verify Token de FlujosChat
Campo «messages» suscrito en el webhook
POST /subscribed_apps ejecutado con el WABA ID y el token permanente
El App Secret guardado en FlujosChat es el de la app que envía los webhooks

Con eso, tu número queda conectado y podés armar tus flujos y agentes de IA. Acá te contamos cómo crear tu primer flujo →

Cómo conectar WhatsApp Business API con FlujosChat (paso a paso)