Cómo crear un agente de IA para WhatsApp: pasos, piezas y errores comunes

Para crear un agente de IA para WhatsApp necesitas cinco piezas: una app de Meta con un número registrado en la Cloud API, un servidor que reciba los mensajes por webhook, un modelo de IA al que llamar por API, acceso a los datos de tu negocio y una forma de pasar la conversación a una persona. Los pasos son: definir el alcance, dar de alta la cuenta, montar el webhook, conectar el modelo, crear plantillas, probar y lanzar.

Las piezas

Pieza	Qué hace	Quién la pone
Cartera de empresa y app de Meta	Agrupa tu cuenta de WhatsApp, tu número y los permisos	Tú, en Meta Business Suite y en el panel de desarrolladores
Número de teléfono	Es la identidad del agente ante tus clientes	Tú, con un número propio
Cloud API y webhooks	Meta te avisa de cada mensaje entrante y tú respondes con una llamada a la API	Meta
Servidor	Recibe los avisos, decide qué hacer y llama al modelo	Tu desarrollador o tu proveedor
Modelo de IA	Entiende la pregunta y redacta la respuesta	Anthropic, OpenAI u otro, por API
Datos del negocio	Preguntas frecuentes, agenda, CRM, estado de pedidos	Tus sistemas actuales
Paso a persona	Saca la conversación del bot y la pone delante de tu equipo	Tu servidor y tu bandeja de atención

La plataforma depende de los webhooks: todo mensaje que un cliente envía a tu número te llega por esa vía, igual que los avisos de entregado y leído. Sin un servidor que los reciba, no hay agente.

Antes de tocar nada, define el alcance

Escribe en una página:

• Las tres o cuatro tareas que hará el agente. Por ejemplo, responder dudas de horarios y documentación, y agendar visitas.
• De dónde saca cada dato: un documento de preguntas frecuentes, la agenda, el CRM.
• Qué no hará nunca: pagos, datos de salud, negociaciones.
• Cuándo pasa a una persona y quién la atiende, en horario y fuera de él.
• Qué mensajes enviará tu empresa por iniciativa propia: recordatorios, avisos. Esos necesitan plantillas y consentimiento.

Esta página evita un error caro: construir un bot que lo intenta todo y no hace bien nada.

Paso a paso

1. Crea la app con el caso de uso de WhatsApp. En el panel de desarrolladores de Meta, crea una app con el caso de uso "Connect with customers through WhatsApp" y asóciala a una cartera de empresa. Sigue la guía de inicio: Meta crea automáticamente una cuenta y un número de prueba. Las cuentas de prueba tienen límites relajados y no piden método de pago para enviar plantillas.

2. Verifica tu empresa. La verificación de la cartera mejora la capacidad de envío y es una de las vías para pasar del límite inicial de 250 usuarios a 2.000 cada 24 horas fuera de la ventana de atención.

3. Elige el número. Debe ser tuyo, con prefijo de país, y capaz de recibir SMS o llamadas. Si ya está en WhatsApp, hay que borrar esa cuenta antes de registrarlo, salvo que uses la coexistencia a través de un socio de Meta.

4. Decide dónde se guardan los mensajes antes de registrar el número. El almacenamiento local solo se activa con el número sin registrar. Entre las regiones está la UE, en Alemania (código DE). Si lo activas después, toca dar de baja el número y registrarlo otra vez.

5. Genera un token permanente. El token temporal del panel caduca enseguida. Crea un usuario del sistema en la configuración de la empresa y genera su token con los permisos business_management, whatsapp_business_messaging y whatsapp_business_management. Guárdalo como un secreto, nunca en el código.

6. Monta el webhook. Tu servidor necesita una dirección pública con un certificado TLS válido; los autofirmados no sirven. Meta lo verifica con una petición GET y tu servidor debe devolver el valor que recibe:

   si hub.verify_token == TU_TOKEN:
       responder 200 con hub.challenge
   

   Después, cada mensaje llega por POST con una firma en la cabecera X-Hub-Signature-256. Calcula el HMAC-SHA256 del cuerpo con el secreto de tu app y compáralo: si no coincide, descarta el aviso. Responde 200 en cuanto lo guardes y procesa después.

7. Conecta el modelo de IA. Tu servidor envía al modelo las instrucciones, los datos que necesita esa pregunta y el historial reciente. Dale herramientas concretas en lugar de acceso libre: "consultar huecos de la agenda", "crear incidencia". Pide que responda solo con lo que encuentre y que derive cuando no sepa.

8. Programa el paso a persona. Define los disparadores, avisa al equipo, deja el bot en silencio en ese chat y pasa un resumen. La política de WhatsApp exige vías de escalado claras cuando automatizas: traspaso a un agente en el chat, teléfono, email, web, tienda o formulario.

9. Crea las plantillas. Todo lo que envíes fuera de la ventana de 24 horas necesita plantilla aprobada, y la revisión puede tardar hasta 24 horas.

10. Pasa a producción. Añade un número real y un método de pago. Sin método de pago, Meta deja de entregar los mensajes de servicio a partir del 1.001 de cada mes.

La ventana de 24 horas y las plantillas

Es la regla que más condiciona el diseño. Cuando un cliente te escribe o te llama, se abre una ventana de atención de 24 horas, y cada mensaje suyo la reinicia. Dentro de ella, el agente responde con texto libre, imágenes, documentos, listas o botones. Fuera, solo puede enviar plantillas.

Las plantillas tienen tres categorías: marketing, utilidad y autenticación. Una plantilla que mezcla un aviso con una promoción cuenta como marketing, que en España es la categoría más cara. Y para enviar cualquiera necesitas el consentimiento previo del cliente: tiene que quedar claro que acepta recibir mensajes y de qué empresa.

En la práctica, el agente necesita saber en cada momento si la ventana está abierta. Si no lo está, debe usar la plantilla adecuada o callarse. Los precios por categoría están en precios de la API de WhatsApp Business en España.

Cómo probarlo antes de abrirlo a clientes

1. Usa el número de prueba con los teléfonos de tu equipo.
2. Escribe una batería de preguntas reales, sacadas de tus correos y chats, con la respuesta correcta al lado. Repítela cada vez que cambies las instrucciones o el modelo.
3. Incluye preguntas trampa: temas fuera de alcance, peticiones de datos que no debe dar, insultos, mensajes en otro idioma.
4. Prueba el traspaso dentro y fuera de horario.
5. Prueba los fallos: el modelo tarda, tu agenda no responde, Meta reenvía un aviso. Meta reintenta los avisos fallidos durante 7 días, así que tu servidor debe detectar duplicados.
6. Lanza con un grupo pequeño y lee las conversaciones cada semana.

Privacidad y aviso de que es una IA

Tres mínimos. Primero, informa al cliente de quién trata sus datos y para qué, como pide el artículo 13 del RGPD, y firma contratos de encargo con quien los trate por tu cuenta (artículo 28). Segundo, di que es una IA: el artículo 50 del Reglamento de IA, aplicable desde el 2 de agosto de 2026, exige informar de forma clara a más tardar en la primera interacción, salvo que sea evidente. Tercero, elige un proveedor de modelo que no entrene con tus datos y, si necesitas procesar en Europa, revisa sus opciones: OpenAI tiene un endpoint europeo, y la API directa de Anthropic ofrece hoy procesamiento global o en EE. UU..

Tienes más detalle en la guía de chatbots de WhatsApp con IA.

Errores comunes

1. Registrar un número que sigue en la app. Un número en uso en WhatsApp no se puede registrar hasta borrar esa cuenta.
2. Olvidar la ventana de 24 horas. El agente intenta responder con texto libre a quien escribió hace dos días y el envío falla.
3. Meter promoción en una plantilla de utilidad. Meta la clasifica como marketing.
4. Partir cada respuesta en cinco mensajes. Cada uno cuenta como mensaje de servicio, y la API solo permite un mensaje cada 6 segundos al mismo usuario de forma sostenida. Además, el orden de entrega no está garantizado: si importa, espera la confirmación de entrega antes de enviar el siguiente.
5. No validar la firma del webhook ni detectar avisos repetidos.
6. No guardar los avisos. Meta no ofrece una API para recuperar webhooks antiguos: lo que no guardes, se pierde.
7. Pedir datos que la política prohíbe, como números completos de tarjetas de pago o de documentos de identidad (política de WhatsApp).
8. Dejar que el modelo improvise. Sin datos ni límites, inventa. Con herramientas concretas y la orden de derivar, se equivoca mucho menos.
9. No avisar de que es una IA, cuando el Reglamento de IA ya lo exige.
10. Usar el token temporal en producción. Caduca y el agente deja de responder.
11. Lanzar sin método de pago. El agente funciona hasta el mensaje de servicio 1.000 del mes y luego deja de entregar.
12. Pensar en el bot y no en el equipo. Si nadie atiende los traspasos, el cliente se queda peor que antes.

Cuánto tarda y cuánto cuesta

El coste recurrente tiene tres partes: los mensajes de Meta, el uso del modelo de IA y el mantenimiento. Los dos primeros están calculados con tarifas oficiales en la guía de precios y en la de chatbots. Lo que pagarás a Meta cada mes lo sacas con la calculadora de coste de la API de WhatsApp.

Si prefieres que lo construyamos nosotros, empezamos con un análisis gratuito de 2 a 5 días y después damos precio cerrado. Una automatización típica está en marcha en 2 a 4 semanas. Nuestros precios publicados, sin IVA, son de 1.500 a 6.000 € por un flujo de automatización, de 5.000 a 20.000 € por varios flujos y de 4.000 a 12.000 € por un primer producto con IA. Lo hacemos nosotros, sin subcontratar, con los datos en la UE. Tienes los detalles en inteligencia artificial y en automatización de procesos, y ejemplos por sector en administradores de fincas e inmobiliarias.

Fuentes

• Meta, WhatsApp Cloud API Get Started.
• Meta, About the WhatsApp Business Platform.
• Meta, Create a webhook endpoint.
• Meta, Business phone numbers y Register a business phone number.
• Meta, Local storage.
• Meta, Messaging limits.
• Meta, Service messages, Template fundamentals y Template categorization.
• Meta, Get opt-in for WhatsApp.
• Meta, Pricing on the WhatsApp Business Platform.
• Meta, Onboard WhatsApp Business app users.
• WhatsApp, WhatsApp Business Messaging Policy.
• OpenAI, Data controls in the OpenAI platform.
• Anthropic, Data residency.
• Reglamento (UE) 2024/1689 de Inteligencia Artificial, artículos 50 y 113.
• Reglamento (UE) 2016/679, RGPD, artículos 13 y 28.