2.1 WhatsApp Business API: arquitectura, conceptos y cómo funciona realmente
WhatsApp Business API: arquitectura y conceptos
WhatsApp tiene más de 2,000 millones de usuarios activos. Es el canal de comunicación más usado en México y América Latina. Pero hay una diferencia abismal entre el WhatsApp que tienes en tu celular y el WhatsApp que conectarás a tu agente de IA en este diplomado. Entender esa diferencia desde el inicio te ahorrará semanas de frustración.
Este subtema no es técnico todavía — es conceptual. Antes de escribir una sola línea de código o configurar un solo webhook, necesitas entender qué es la API, cómo está estructurada, y por qué funciona de una forma muy distinta a lo que probablemente imaginas.
La API de WhatsApp no tiene pantalla.
Es un canal de comunicación que controla tu código, no tus dedos.
Cuando usas WhatsApp en tu celular, tú escribes, tú envías, tú respondes. La API elimina al humano de la ecuación: tu sistema recibe mensajes, los procesa con lógica o IA, y responde automáticamente — todo sin que nadie toque una pantalla. Esa es la diferencia fundamental que cambia todo lo que viene en este módulo.
El error más común: Empresas que dicen “ya tenemos WhatsApp” refiriéndose a la app del celular, cuando lo que necesitan es la API. Es como decir “ya tenemos internet” porque tienes datos en el celular, cuando tu negocio necesita un servidor dedicado.
WhatsApp Personal
Para uso individual
Para personas- App en tu celular personal
- 1 usuario por número
- Sin catálogo ni automatización
- Sin API — no se puede integrar
- Gratis
WhatsApp Business App
Para pequeños negocios
Para negocios pequeños- App en el celular del negocio
- Catálogo de productos
- Respuestas rápidas y etiquetas
- Horario de atención automático
- Límite de 1 sesión simultánea
- Sin integración con CRM o IA
- Gratis
WhatsApp Business API
Para empresas y sistemas automatizados
Lo que usarás en este nivel- Sin interfaz gráfica — puro código
- Múltiples agentes simultáneos
- Integración con CRM, n8n, IA
- Envío masivo con plantillas aprobadas
- Webhooks en tiempo real
- Métricas de entrega y lectura
- Pago por conversación
La WhatsApp Business API no es un servicio simple que contratas y usas. Tiene una arquitectura de tres capas que debes entender para saber con quién hablas, quién controla qué, y dónde encaja n8n en el sistema:
Meta (Facebook) — El dueño de las reglas
La capa superior que nadie puede saltarse
Meta es dueña de WhatsApp y define absolutamente todo: las reglas de uso, los formatos de mensajes, las categorías de conversación, los precios, qué plantillas se aprueban o rechazan, y qué número puede o no puede usar la API. Nadie puede conectarse a WhatsApp sin pasar por Meta.
BSP / Meta Cloud API — El punto de acceso
La capa de intermediación entre Meta y tu sistema
Hay dos formas de acceder a la API: directamente via Meta Cloud API (técnicamente más complejo, sin costo de intermediario) o a través de un BSP — Business Solution Provider. Los BSP son empresas certificadas por Meta (Twilio, 360Dialog, Infobip, WATI) que simplifican el acceso a cambio de una tarifa adicional por mensaje o suscripción mensual.
Tu sistema — n8n, CRM y Agente de IA
La capa que tú construyes en este diplomado
Aquí es donde vive todo lo que construirás: el workflow de n8n que recibe el webhook de Meta, el agente de IA que procesa el mensaje y decide la respuesta, el CRM donde se registra el lead, y la lógica que determina si el bot responde o un humano toma el control.
🔄 Flujo de un mensaje entrante
👤 Usuario
envía mensaje
📡 Servidores
de Meta
🔗 BSP / Cloud
API
🔔 Webhook n8n
(POST JSON)
🤖 Agente IA
procesa y responde
Meta Cloud API
Conexión directa con Meta. Sin intermediarios.
Recomendado en este diplomado- Sin costo de intermediario — pagas solo a Meta
- Control total sobre la configuración
- Acceso a funciones nuevas antes que los BSP
- Cuenta Meta Business Manager propia
- Requiere más configuración inicial
- Soporte técnico de Meta (lento)
- Tú gestionas la verificación del negocio
BSP (Twilio, 360Dialog…)
Intermediario certificado que simplifica el acceso.
Para proyectos que necesitan soporte rápido- Configuración más sencilla y guiada
- Soporte técnico dedicado del BSP
- Útil si Meta rechaza tu verificación
- Cobran tarifa adicional por mensaje o suscripción mensual
- Dependencia de un tercero adicional
- Acceso a funciones nuevas más lento
- Los datos pasan por los servidores del BSP
Regla crítica: El número que registras en la API deja de existir para la app del celular. Una vez conectado a la API, solo puede usarse vía API. No puedes abrirlo en WhatsApp ni en WhatsApp Business App — quedaría desconectado de la API.
✅ Números válidos
Número fijo de empresa, número virtual (Twilio, Google Voice), número nuevo de SIM dedicado, número portado de otra operadora. Cualquier número que pueda recibir un SMS o llamada de verificación.
🔢 Un número = una cuenta
Cada número está vinculado a una sola cuenta de WhatsApp Business API. Si necesitas dos números (uno para ventas, uno para soporte), necesitas dos cuentas y dos configuraciones separadas en Meta Business.
⛔ Número con WhatsApp activo
Si el número ya tiene WhatsApp personal o Business App activo, debes eliminarlo de la app primero. Meta te pedirá que confirmes que el número no está en uso antes de registrarlo en la API.
💡 Recomendación práctica
Para este diplomado: usa una SIM nueva o un número virtual de bajo costo (~$1-5 USD/mes). Así evitas comprometer un número de negocio ya establecido mientras aprendes y pruebas la configuración.
Este es el concepto que más confunde a los nuevos usuarios de la API. Hay dos mundos completamente distintos para enviar mensajes, con reglas radicalmente diferentes:
Mensajes de Sesión
El cliente escribe primero — tú respondes libremente
Ventana de 24 horasCuando un cliente te envía el primer mensaje, se abre una ventana de 24 horas. Durante esa ventana puedes responder con cualquier contenido: texto libre, imágenes, videos, audios, documentos, botones interactivos o listas. Sin restricciones de formato y sin costo adicional por tipo de contenido.
Este es el escenario principal de tu agente de IA: responde a las preguntas del cliente dentro de la ventana de sesión activa.
Cliente
Hola! ¿tienen disponible el Diplomado IA Nivel 2?
Tu agente (dentro de las 24h)
¡Hola! Sí, el Nivel 2 está disponible. Es el programa de IA Agéntica con n8n, 6 módulos, 42 horas en vivo. ¿Quieres que te mande el temario completo? 📚
Mensajes de Plantilla
Tú escribes primero — requiere aprobación de Meta
Fuera de la ventana de 24hSi han pasado más de 24 horas desde el último mensaje del cliente, o si quieres iniciar tú la conversación, debes usar una plantilla pre-aprobada por Meta. Las plantillas tienen un formato fijo con variables que puedes personalizar.
Meta aprueba o rechaza cada plantilla según sus políticas. El proceso toma entre 24 y 72 horas. Las categorías permitidas son: Utility (transaccional), Authentication (verificación) y Marketing (promocional).
Plantilla aprobada: recordatorio_clase
Hola {{1}}, te recordamos que tu próxima sesión en vivo del Diplomado IA es mañana {{2}} a las {{3}}. 📅 Accede desde: {{4}}
Las variables {{1}}, {{2}}, {{3}}, {{4}} se reemplazan con datos reales al enviar.
Una conversación es una ventana de 24 horas desde el primer mensaje — no importa cuántos mensajes se intercambien dentro de esa ventana, cuenta como una sola conversación. El precio varía por categoría y por país. Las conversaciones de servicio (cuando el cliente escribe primero) son las más baratas y a veces gratuitas.
Utility
Mensajes transaccionales post-compra: confirmaciones de pedido, actualizaciones de estado, recordatorios de cita.
Costo bajoAuthentication
Códigos de verificación, OTPs, confirmación de identidad. Casos muy específicos con formato estricto.
Costo bajoMarketing
Promociones, ofertas, anuncios de nuevos productos, campañas de reactivación. La categoría más cara.
Costo altoService
Respuestas a mensajes iniciados por el cliente. La ventana de sesión activa. En México, a veces gratuitas.
Gratuitas / mínimo💡 Para el Nivel 2: La mayoría de tus conversaciones de agente IA serán de tipo Service (el cliente escribe primero) — las más baratas o gratuitas. Los costos significativos aparecen cuando lanzas campañas masivas de marketing, que es un escenario avanzado del Módulo 6.
Los límites de envío no son fijos — escalan automáticamente según tu historial de calidad. Empiezas conservador y Meta aumenta tu capacidad conforme demuestra que tus mensajes no son spam:
Conversaciones únicas por día
El límite inicial de toda cuenta nueva. Suficiente para un agente de IA en fase de pruebas o un negocio mediano. Se sube automáticamente cuando mantienes buena calidad durante 7 días.
Conversaciones únicas por día
Meta eleva el límite automáticamente cuando alcanzas el 80% del límite anterior y mantienes una tasa de bloqueos por debajo del 2%. Para negocios con volumen medio-alto.
Conversaciones únicas por día
El nivel de empresas con operaciones masivas. Requiere historial limpio sostenido y verificación de negocio completada. Para llegar aquí se necesitan meses de operación limpia.
⚠️ La calidad de cuenta se mide por reportes de spam. Si los usuarios bloquean o reportan tus mensajes frecuentemente, Meta degrada tu límite — o suspende el número. Nunca envíes mensajes masivos no solicitados. El agente de IA que construirás responde — no bombardea.
⚡ Cada mensaje del usuario dispara un POST a tu n8n
Cuando configuras tu app en Meta, le indicas una URL de webhook — que es exactamente el Webhook Trigger de tu workflow en n8n. Cada vez que alguien te manda un mensaje, Meta hace un POST inmediato a esa URL con un JSON que contiene toda la información del mensaje.
n8n recibe ese JSON, el workflow se dispara, el agente de IA procesa el mensaje y responde — todo en cuestión de segundos. Este es el ciclo completo del agente que construirás en el Módulo 4.
Payload JSON que Meta envía a tu webhook cuando llega un mensaje de texto
{
"object": "whatsapp_business_account",
"entry": [{
"id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
"changes": [{
"value": {
"messaging_product": "whatsapp",
"contacts": [{
"profile": { "name": "María García" }, ← Nombre del usuario
"wa_id": "523319126408" ← Número del usuario
}],
"messages": [{
"from": "523319126408", ← Número remitente
"id": "wamid.HBgN...", ← ID único del mensaje
"timestamp": "1715421600", ← Unix timestamp
"type": "text", ← Tipo: text, image, audio...
"text": {
"body": "Hola, quiero información del diplomado" ← ¡El mensaje!
}
}]
},
"field": "messages"
}]
}]
}
💡 Reconoces esta estructura — es la misma que viste en el subtema 1.5. En el Módulo 4 construirás el workflow completo que extrae el mensaje, lo procesa con IA y responde al usuario via HTTP Request a la API de Meta.
🎯 Lo que debes recordar del subtema 2.1
3 productos distintos
Personal, Business App y Business API. Son productos completamente diferentes. La API no tiene interfaz — solo código.
3 capas de arquitectura
Meta (las reglas) → BSP/Cloud API (el acceso) → Tu sistema (n8n + IA). En este diplomado usas Meta Cloud API directa.
Número dedicado
El número registrado en la API no puede usarse en la app del celular. Usa un número nuevo o virtual para empezar.
La regla de las 24h
Mensaje de sesión (respuesta libre dentro de 24h) vs. plantilla (mensaje iniciado por ti, pre-aprobado por Meta).
Por conversación, no por mensaje
Meta cobra por ventana de 24h. Las conversaciones Service (cliente escribe primero) son gratuitas o casi gratuitas en México.
Webhook = el puente
Cada mensaje dispara un POST a tu n8n. El JSON que llega es el que aprendiste en el 1.5. En el Módulo 4 lo procesarás con IA.
Comentarios