Cómo conectar un agente de IA a WhatsApp Business paso a paso

Para conectar un agente de IA a WhatsApp Business necesitas: (1) una cuenta de negocio en WhatsApp Business Platform, (2) un número verificado con su phone_number_id, (3) webhooks configurados y verificados, (4) plantillas aprobadas para iniciar conversaciones, y (5) una ruta de escalado a humano. Con esos cinco elementos puedes atender clientes de forma automática, 24/7, con control total sobre cada conversación.

Resumen en 30 segundos

• WhatsApp Business Platform (antes Cloud API) es la vía oficial para conectar agentes IA.
• Necesitas una cuenta de Meta Business verificada y acceso a la API.
• Los webhooks reciben mensajes entrantes en tiempo real.
• Las plantillas permiten iniciar conversaciones fuera de la ventana de 24 horas.
• El handoff a humano es obligatorio cuando el agente no puede resolver.

---

Por qué usar WhatsApp Business Platform y no la app estándar

WhatsApp Business App es válida para responder manualmente desde el móvil. Pero si quieres automatizar con IA, necesitas WhatsApp Business Platform (API oficial de Meta): es la única vía que permite recibir mensajes automáticamente, enviar respuestas programadas y escalar a miles de conversaciones sin restricciones de dispositivo.

La integración es más sencilla de lo que parece, pero requiere seguir los pasos en orden.

---

La forma rápida: conectar en menos de 2 minutos con Embedded Signup

Si usas Nexus como plataforma, el proceso completo de conexión se reduce a menos de 2 minutos. Nexus es Meta Tech Provider oficial — lo que significa que Meta nos autoriza a gestionar el registro y la conexión de tu número directamente desde nuestra plataforma, sin que tengas que navegar por el panel de Meta ni gestionar ninguna configuración técnica por tu cuenta.

El proceso con Embedded Signup:

1. Accedes al panel de Nexus y haces clic en "Conectar WhatsApp".
2. Se abre el flujo guiado de Meta directamente en la pantalla — introduces tu número de teléfono y verificas con el código que te llega.
3. Tu número queda conectado y el chatbot está listo para recibir mensajes.

Nexus activa la coexistencia de forma automática durante este proceso: tu equipo puede seguir usando la app de WhatsApp Business en el móvil exactamente como antes, mientras el chatbot gestiona el volumen automático en paralelo.

El resto de esta guía explica cómo funciona el proceso técnico por dentro — útil si quieres entender qué pasa bajo el capó o si estás integrando sin una plataforma de soporte.

---

Prerrequisitos

Antes de empezar, asegúrate de tener:

• Una cuenta en Meta Business Manager verificada.
• Un número de teléfono que no esté vinculado a otra cuenta de WhatsApp (puede ser un número nuevo o migrado).
• Acceso a una plataforma que soporte WhatsApp Cloud API (como Nexus) o un servidor donde desplegar el webhook.
• Una política de privacidad pública accesible desde tu web (requisito de Meta).

---

Paso 1: Crear y configurar la cuenta en WhatsApp Business Platform

Accede a Meta for Developers y crea una aplicación de tipo Business. Dentro de la app, añade el producto WhatsApp.

Necesitarás dos identificadores que usarás en todos los pasos siguientes:

• WABA ID (whatsapp_business_account_id): identifica tu cuenta de negocio de WhatsApp.
• Phone Number ID (phone_number_id): identifica el número específico desde el que envías y recibes mensajes.

Puedes obtenerlos desde el panel de Meta o mediante la API de gestión de números.

Si usas Nexus, el proceso de onboarding guiado (Embedded Signup) obtiene estos identificadores automáticamente y los vincula a tu tenant sin que tengas que gestionarlos manualmente.

---

Paso 2: Configurar el webhook para recibir mensajes

El webhook es la URL de tu servidor donde WhatsApp envía los mensajes entrantes en tiempo real. Meta verificará que la URL funciona antes de activarla.

El proceso de verificación consiste en que Meta llama a tu URL con un parámetro hub.challenge y espera que lo devuelvas tal cual. Una vez verificado, empezarás a recibir eventos de mensajes, estados de entrega y cambios de estado de plantillas.

Configuración mínima del webhook:

URL: https://tudominio.com/api/whatsapp/webhook/{tenant_id}
Método de verificación: GET con hub.challenge
Firma entrante: X-Hub-Signature-256 (HMAC SHA-256 del body con tu app_secret)

Verifica siempre la firma X-Hub-Signature-256 antes de procesar cualquier mensaje. Ignorar este paso es un riesgo de seguridad.

---

Paso 3: Obtener el token de acceso y configurar permisos

Necesitas un token de acceso con permisos whatsapp_business_messaging y whatsapp_business_management para enviar mensajes y gestionar plantillas.

Opciones:

• Token de usuario del sistema (recomendado para producción): no caduca y no depende de un usuario específico.
• Token temporal de usuario: útil para pruebas, pero caduca en horas.

Almacena el token de forma segura (variable de entorno, gestor de secretos). Nunca lo expongas en el código fuente.

---

Paso 4: Crear y aprobar plantillas de mensaje

Las plantillas son mensajes pre-aprobados por Meta que puedes usar para iniciar conversaciones o para contactar a usuarios fuera de la ventana de 24 horas.

Regla de la ventana de 24 horas:

• Si el usuario te escribió primero, puedes responder libremente durante 24 horas.
• Pasadas las 24 horas, solo puedes usar plantillas aprobadas.
• Para iniciar una conversación tú primero, siempre necesitas plantilla.

Una plantilla básica de bienvenida tiene esta estructura:

Nombre: bienvenida_nuevo_contacto
Categoría: UTILITY o MARKETING
Idioma: es_ES
Cuerpo: "Hola {{1}}, soy el asistente de {{2}}. ¿En qué puedo ayudarte hoy?"

Las plantillas tardan entre unas horas y 24 horas en ser aprobadas por Meta.

---

Paso 5: Implementar el handoff a humano

El handoff es el mecanismo por el que el agente cede la conversación a un agente humano cuando no puede resolver la consulta. Es un requisito de las políticas de WhatsApp Business, no una opción.

Define al menos una de estas rutas de escalado:

• Transferencia en chat: el agente informa al usuario de que un humano tomará la conversación y notifica al equipo interno.
• Email o formulario: el agente recoge los datos y los envía a un buzón del equipo.
• Teléfono: el agente facilita un número directo de atención.

Un handoff efectivo incluye:

1. Detección del caso (el agente no puede resolver, urgencia, petición sensible).
2. Mensaje claro al usuario explicando que un humano continuará.
3. Notificación interna al equipo con el contexto de la conversación.

---

Flujo completo de un mensaje

Usuario → WhatsApp → Webhook → Router → Agente IA → Herramientas → Respuesta → WhatsApp → Usuario
                                                   ↘ Handoff a humano (si aplica)

Cada mensaje entrante llega al webhook, se valida la firma, se identifica el tenant y se enruta al agente. El agente decide si responde directamente, consulta herramientas (CRM, calendario, base de conocimiento) o escala a humano.

---

Checklist de go-live

Antes de activar la integración en producción, verifica:

• Webhook verificado por Meta y recibiendo eventos de prueba
• Firma X-Hub-Signature-256 validada en cada request
• Token de acceso de sistema (no token temporal)
• Al menos una plantilla aprobada por Meta
• Ruta de handoff a humano configurada y probada
• Política de privacidad pública con mención a WhatsApp
• Opt-in documentado: los usuarios han dado permiso para recibir mensajes
• Logs de conversación activados para auditoría

---

Preguntas frecuentes

¿Puedo usar un número que ya está en WhatsApp Business App?

Sí, y con coexistencia activada no tienes que dejar de usar la app del móvil. Tu equipo puede seguir respondiendo desde el móvil mientras el chatbot funciona en paralelo. Nexus activa la coexistencia automáticamente durante el proceso de conexión, por lo que no hay que desinstalar ni migrar nada.

¿Qué pasa si respondo fuera de la ventana de 24 horas sin plantilla?

La API devuelve un error y el mensaje no se entrega. El agente debe detectar cuándo ha expirado la ventana y usar una plantilla aprobada para retomar la conversación.

¿Puedo tener varios números en la misma cuenta?

Sí. WhatsApp Business Platform permite múltiples números bajo el mismo WABA. En una plataforma multi-tenant como Nexus, cada tenant puede tener su propio número aislado.

¿Cómo cumplo con el RGPD al usar WhatsApp?

Necesitas base jurídica para el tratamiento (normalmente consentimiento para comunicaciones comerciales), informar al usuario de forma clara antes de iniciar la conversación y no solicitar datos sensibles por chat. La política de privacidad de Nexus incluye un anexo específico para WhatsApp Cloud API con retenciones y transferencias detalladas.

¿Cuánto tarda en estar operativo?

Con Nexus y el proceso de Embedded Signup, la conexión del número tarda menos de 2 minutos. A partir de ahí, configurar las respuestas del chatbot y personalizar el comportamiento depende de la complejidad de tu caso de uso — los más sencillos están listos en menos de una hora. La aprobación de plantillas para mensajes salientes depende de Meta (normalmente menos de 24 horas para mensajes de utilidad estándar).

¿Qué ocurre si el agente no puede resolver una consulta?

El agente activa el handoff a humano: informa al usuario, notifica al equipo y transfiere el contexto. El humano retoma desde donde lo dejó el agente, sin que el usuario tenga que repetir la información.

---

Conclusión

Conectar un agente IA a WhatsApp Business Platform es un proceso estructurado: cuenta verificada, webhooks seguros, plantillas aprobadas y handoff configurado. Una vez activo, tienes atención automática 24/7, trazabilidad completa y escalado a humano cuando se necesita.

Si quieres ver cómo queda aplicado a tu negocio, pídenos una demo y te mostramos el flujo completo en funcionamiento.