IA en WhatsApp con la API oficial de Meta: cómo lo monté

Este otoño he puesto IA en WhatsApp, con un asistente que contesta en dos negocios que conozco por dentro. Uno es la escuela de baile Martorell Salsera, donde funciona dentro de la app de la escuela y sigue en pruebas con un número de pruebas. El otro es IMFALU, la empresa de obras, donde desde el 19 de noviembre de 2026 atiende el WhatsApp que aparece en su web de fachadas y obras.
La base es Vocero CRM, de código abierto con licencia MIT: bandeja de conversaciones, embudo de ventas, un agente con base de conocimiento y un «laboratorio» donde clientes simulados prueban al agente antes de que hable con nadie. Lo instalo en un servidor propio, una instancia por negocio, con los añadidos que cada caso pedía.

API oficial o WhatsApp por QR: el riesgo de bloqueo
La vía rápida para conectar un programa a WhatsApp es una librería que se hace pasar por WhatsApp Web: escaneas un QR y listo. El README de whatsapp-web.js, una de las más usadas, lo dice claro: no garantiza que no te bloqueen, porque WhatsApp no permite bots ni clientes no oficiales. Un proyecto que analizamos para IMFALU traía ese modo QR con el mismo aviso, y lo descartamos.
La otra es la API oficial (WhatsApp Business Platform, en su versión Cloud API, alojada por Meta). Para conectar números de clientes tuve que hacerme proveedor de tecnología de Meta: verificar el negocio (el 10 de octubre de 2026, tardó minutos), pasar la revisión de la app (enviada el 11 de octubre y aprobada el 24) y, además, registrarme como proveedor. La verificación sola no basta: hasta que hice ese último paso, Meta seguía respondiendo que no podía dar de alta clientes.
| Conexión por QR | API oficial | |
|---|---|---|
| Riesgo de bloqueo del número | El que avisan sus propias librerías | Ninguno si cumples las políticas |
| Escribir a quien no te ha escrito | Sin control | Solo con plantillas aprobadas |
| Coste | Ninguno directo | Por mensaje, según tipo y país |
| Puesta en marcha | Minutos | Verificaciones y revisión de Meta |
Con la «coexistencia», el número sigue funcionando en la app WhatsApp Business del móvil a la vez que en la API. En IMFALU lo implementamos así y el número se conectó en minutos.
Y una norma que conviene conocer: desde el 15 de enero de 2026 los términos de Meta prohíben usar la API para ofrecer chatbots de IA de propósito general. Un asistente que atiende a los clientes de tu negocio está permitido; por eso en la escuela el agente solo habla de la escuela y, si alguien insiste con otros temas, se despide y lo deja a una persona.
La ventana de 24 horas y las plantillas
La regla que más condiciona el diseño: solo hay texto libre durante las 24 horas siguientes al último mensaje del cliente. Vocero lo calcula en src/server/inbox/window.ts y bloquea el envío cuando la ventana está cerrada. Fuera de esa ventana solo valen plantillas aprobadas por Meta, de tres categorías: marketing, utilidad y autenticación.
En la escuela creé tres: aviso de algo pendiente al responsable, aviso de clase anulada y recordatorio de clase de prueba. Meta las aprobó unas 24 horas después. La importante es la primera: cada vez que el agente deja algo apuntado, el responsable recibe un WhatsApp con el nombre, el teléfono y el motivo.
Sobre el coste, a noviembre de 2026: Meta cobra por mensaje entregado desde el 1 de julio de 2025, con tarifas por categoría y país. Desde el 1 de octubre de 2026 también cobra los mensajes de servicio, los que contestas dentro de la ventana, a partir del mensaje 1.001 de cada mes y número. Hace falta tener un método de pago en la cuenta.
Webhooks: por dónde entra cada mensaje
Cada mensaje llega a tu servidor como un POST de Meta. Antes, Meta verifica la URL con un GET que lleva un token acordado y un desafío que hay que devolver. Los POST van firmados con el secreto de la app (cabecera x-hub-signature-256); en el código de Vocero la firma solo se comprueba si configuras ese secreto, así que configúralo. El servidor responde 200 enseguida y procesa el mensaje después.
Tres requisitos fallan sin avisar: el webhook configurado en la app, la suscripción manual a cada campo (messages, message_template_status_update y smb_message_echoes vienen sin suscribir) y la app publicada. Si falta uno, no entra nada y nadie te dice por qué.
El campo smb_message_echoes es clave con la coexistencia: cuando alguien del equipo contesta desde el móvil, ese mensaje llega como «eco». Vocero lo guarda como respuesta manual y pausa la IA en esa conversación, así el agente no se pisa con una persona.
La velocidad también cuenta. Vocero espera unos segundos para juntar mensajes seguidos y el modelo de la escuela razonaba antes de contestar: la primera respuesta tardó 14 segundos. Lo bajé acortando la espera y quitando el razonamiento.
IA en WhatsApp: qué contesta y cuándo pasa a una persona
Mi regla: el modelo conversa, el código decide. En la escuela, cada 15 minutos un proceso automático lee de la propia base de datos de la escuela el horario, los precios del mes, los eventos, los días cerrados y las plazas, y lo escribe en la base de conocimiento del agente. Aun así, en las pruebas comprobamos un fallo: un sábado sin evento dijo que había sesiones «sábados y domingos». Añadí un bloque con la fecha de hoy y lo que hay los próximos 10 días.
El agente también puede reservar plaza llamando a la API de la escuela; el texto de confirmación lo escribe el servidor con la respuesta real, no el modelo. Lo probamos en simulación y con un alta real de una persona inventada, borrada después; falta una reserva de un interesado de verdad.
Para el traspaso hay dos niveles:
- Apunta y sigue. Pagos, bajas, acuerdos especiales o datos que no tiene: deja una nota «PENDIENTE», mueve el contacto a una etapa visible en el panel, avisa al responsable y continúa atendiendo.
- Se despide y calla. Si piden hablar con una persona, si hay enfado, si se acumulan tres pendientes o si insisten con temas ajenos. Siempre explica que una persona contestará por ese mismo chat; antes se quedaba mudo y parecía colgado.
Hay también un tope de respuestas por conversación y día. En IMFALU las reglas son otras: nada de precios ni plazos, una urgencia recibe el teléfono en el primer mensaje y los candidatos van a la página de empleo. En el laboratorio, con seis clientes simulados basados en casos típicos de IMFALU, sacó 92 sobre 100.
RGPD y transparencia
- Papeles. La empresa es responsable del tratamiento; Meta, el servidor y el proveedor del modelo son encargados. Si el modelo está fuera del Espacio Económico Europeo hay transferencia internacional, y tiene que estar cubierta y explicada en la política de privacidad.
- Lo que pide Meta. La revisión de la app exige política de privacidad y página de eliminación de datos.
- Minimizar. La base de conocimiento no lleva datos de clientes. El filtro que hace que el agente de la escuela no conteste a los alumnos recibe la lista como huellas cifradas con sal, no como teléfonos en claro.
- Historial importado. Al conectar por coexistencia se importan meses de chats, también con trabajadores y proveedores. En IMFALU el agente estuvo primero activado solo para un número de prueba.
- Avisar de que es una IA. El Reglamento europeo de IA (artículo 50), aplicable desde el 2 de agosto de 2026, exige que la persona sepa que habla con un sistema de IA salvo que sea evidente.
Cuándo conviene y cuándo no
Conviene si recibes muchas preguntas repetidas, si los datos buenos ya viven en tu sistema y se leen por API, y si alguien revisa los pendientes cada día.
No conviene si tienes pocas conversaciones, si casi cada respuesta depende de un presupuesto o de un criterio personal, o si nadie va a mantenerlo: los tokens caducan, las plantillas se revisan y Meta cambia condiciones y precios. Si lo que buscas es una bandeja compartida para que respondan personas, Chatwoot encaja mejor (su IA está en la parte de pago). Si solo necesitas avisos por SMS desde un Android, textbee es más sencillo.
Es el tipo de proyecto que hago dentro de inteligencia artificial para empresas. Si quieres que lo miremos para tu empresa, escríbeme desde la web.
Fuentes
- Vocero CRM, licencia MIT
- Precios de la WhatsApp Business Platform (consultada el 20-nov-2026)
- Cloud API de WhatsApp
- Webhooks de la Cloud API
- Plantillas de mensaje
- Prohibición de chatbots de propósito general desde el 15-ene-2026 (TechCrunch, 18-oct-2025)
- Aviso de bloqueo en el README de whatsapp-web.js
- Reglamento (UE) 2024/1689 de IA, artículo 50
Preguntas frecuentes
¿Se puede poner IA en WhatsApp sin riesgo de que bloqueen el número?
Con la API oficial de Meta (Cloud API), sí, siempre que cumplas sus políticas. Las librerías que se conectan escaneando un QR avisan en su propio README de que no garantizan que no te bloqueen.
¿Qué es la ventana de 24 horas de WhatsApp?
Es el plazo en el que puedes escribir texto libre: las 24 horas siguientes al último mensaje del cliente. Fuera de esa ventana solo valen plantillas aprobadas por Meta, de marketing, utilidad o autenticación.
¿Hay que avisar de que contesta una IA?
Sí. El artículo 50 del Reglamento europeo de IA, aplicable desde el 2 de agosto de 2026, exige que la persona sepa que habla con un sistema de IA salvo que sea evidente.
Sobre cómo escribo estos artículos: preparo los contenidos con ayuda de herramientas de inteligencia artificial y después los reviso, corrijo y publico yo. La responsabilidad editorial de lo que leas aquí es mía.
¿Tienes un proyecto en mente?
Cuéntame qué necesitas y lo sacamos adelante. Respuesta rápida y sin compromiso.
Hablemos →