API de WhatsApp Business: guía completa 2026
Requisitos que pide Meta, diferencias reales con la app, precios por mensaje y qué revisar antes de migrar tu número.
Equipo xcale9 min de lectura

La API de WhatsApp Business no es una app que se descarga: es la puerta que Meta abre para que un software —una plataforma de automatización, un CRM, tus propios sistemas— envíe y reciba mensajes en tu número de negocio. Esa distinción explica casi todo lo demás: varios asesores en un mismo número, el cobro por mensaje y la verificación que Meta exige.
Esta guía cubre lo que hay que decidir antes de moverse: diferencias con la app gratuita, precios de Meta y qué cambia en octubre, cómo se obtiene acceso, qué requisitos pide, qué límites tiene y los tropiezos más comunes en Colombia y México.
Qué es la API de WhatsApp Business y qué no es
El nombre oficial del producto es WhatsApp Business Platform y la API es su interfaz: un canal técnico, sin bandeja ni pantalla. Todo lo que tu equipo ve —inbox compartido, asignación, reportes, automatización— lo pone el software que conectas encima.
El estándar hoy es la Cloud API, alojada por Meta: no hay servidores que mantener.
Y tres cosas que no es: un atajo para mensajes masivos, una versión más barata de la app o un chatbot. La API transporta mensajes; quien responde es tu equipo o la IA que configures encima.
App de WhatsApp Business vs. API: las diferencias reales
La app gratuita es un buen producto y muchos negocios deberían quedarse en ella. Sus techos:
- Dispositivos: un teléfono principal más 4 vinculados; con Meta Verified, hasta 10.
- Difusión: listas de hasta 256 contactos, y solo llegan a quien tenga tu número guardado.
- Sin roles ni asignación: todos ven todo y nadie es dueño de una conversación.
- Sin integraciones: el catálogo se mantiene a mano; el chat no lee inventario, agenda ni pagos.
- El historial vive en el dispositivo: si se pierde el teléfono o se va el asesor, se va la conversación.
La API resuelve los cinco y a cambio cambia las reglas: categorías de mensaje, plantillas que Meta aprueba, límites atados a la calidad y un costo por mensaje.
El umbral honesto: si una persona cubre tu volumen y no necesitas conectar el chat con tus sistemas, la app gana. Migrar sin un problema concreto agrega costo y trámites.
Qué desbloquea la API
- Automatización con contexto. Un agente de IA lee tu catálogo, precios y políticas y responde sobre eso: es lo que construimos en xcale.
- Integraciones. Consultar stock en Shopify, agendar en tu calendario o generar un link de pago requiere API; las conexiones están en integraciones.
- Mensajes proactivos aprobados. Confirmaciones de pedido, recordatorios de cita, avisos de envío: son plantillas, lo que la app no hace a escala.
Cuánto cuesta la API de WhatsApp Business
El cambio que muchas guías siguen contando mal: desde el 1 de julio de 2025 Meta cobra por mensaje, no por conversación. Y hay una segunda fecha: desde el 1 de octubre de 2026 cobra también los mensajes que no son plantilla.
Por categoría:
- Marketing (promociones, campañas): siempre se cobra.
- Utilidad (confirmaciones, recordatorios, estados de pedido): se cobra fuera de una ventana de atención abierta y, desde el 1 de octubre de 2026, también dentro.
- Autenticación (códigos de verificación): se cobra siempre, incluso dentro de una ventana de atención abierta.
- Servicio (tus respuestas dentro de la ventana de 24 horas que abre el cliente): gratis hasta el 30 de septiembre de 2026; desde el 1 de octubre se cobran por mensaje, a la tarifa de utilidad y autenticación del país del destinatario, sin escalones por volumen.
Dos detalles que cambian un presupuesto: los anuncios click-to-WhatsApp abren una ventana gratuita de 72 horas —la única que octubre no toca— y las tarifas bajan cuando tu volumen mensual cruza los escalones que Meta define por mercado.
Las tarifas cambian por país y Meta publica tarifarios descargables por moneda, peso colombiano y mexicano incluidos: revisa el tuyo antes de presupuestar.
Hasta el 30 de septiembre de 2026, un WhatsApp entrante casi no le cuesta nada a Meta. Desde el 1 de octubre responder también se cobra: la pregunta deja de ser quién habla primero y pasa a ser cuántos mensajes gastas en resolver.
El segundo costo es la plataforma con la que operas el número. La nuestra empieza en $49 al mes con 7 días de prueba gratis. Pregunta obligada antes de firmar: ¿los cargos de Meta los pagas tú en el WABA o los factura el proveedor? Eso define quién asume los impuestos locales.
Cómo obtener acceso: Cloud API, BSP o plataforma
Tres caminos, y la elección depende de quién construya el software:
- Cloud API directa. Creas la WABA y programas todo: sin bandeja ni automatización hasta que las construyas. Tiene sentido con equipo propio.
- Un BSP (proveedor de soluciones). Twilio, 360dialog o Infobip revenden el acceso, casi siempre con margen por mensaje; encima sigues necesitando software usable.
- Una plataforma completa. Crea la WABA por ti y trae bandeja compartida, automatización e integraciones desde el primer día. Es la ruta de la mayoría de las pymes y lo que hacemos en xcale.
Tres preguntas antes de firmar: ¿la WABA y el número quedan a nombre de tu empresa, puedes exportar conversaciones y contactos, y quién le paga a Meta?
Qué requisitos pide la API de WhatsApp Business
Meta no publica una lista única: los pide por etapas y cada una bloquea la siguiente.
- Una cuenta de Meta Business a nombre de la empresa, no un perfil personal.
- Una app en Meta for Developers con el caso de uso de WhatsApp —o un proveedor que la cree por ti: las rutas 2 y 3 se saltan este paso.
- Un número propio con indicativo de país y área (los códigos cortos no sirven), capaz de recibir SMS o llamada y que no esté activo hoy en WhatsApp. Meta recomienda móvil: los VoIP fallan más en la verificación.
- Un nombre para mostrar que corresponda al negocio; queda en revisión hasta que Meta lo aprueba o lo rechaza. La insignia verde (Official Business Account) es otra cosa: no se compra ni se pide, Meta la otorga por notoriedad de marca.
- La verificación de empresa, si quieres pasar del primer escalón de envío.
Verificación de empresa: se hace en Meta Business Manager con documentos legales cuyo nombre registrado coincida con el de la cuenta —en Colombia, RUT o certificado de Cámara de Comercio; en México, constancia de situación fiscal—. Ahí se atasca la mayoría de las solicitudes: nombre comercial en la cuenta, nombre legal en el documento. Corrígelo antes de aplicar, no después del rechazo.
Cuántos números puedes registrar: sin verificar, dos. Al verificar la empresa —o al alcanzar el escalón de 2.000— Meta sube el tope a 20.
Límites de envío: arrancas en 250 destinatarios nuevos cada 24 horas. Para llegar a 2.000 Meta documenta tres caminos: verificar tu empresa, que la verifique tu proveedor, o entregar 2.000 plantillas a números distintos en 30 días con buena calificación de calidad. De ahí sube solo —10.000, 100.000 y sin límite— si mantienes la calidad y usas al menos la mitad de tu límite en siete días. Solo cuenta lo que inicias tú: responderle a quien te escribe no consume cupo.
Qué límites tiene la API de WhatsApp Business
Los límites de la API de WhatsApp Business son de tres tipos —velocidad, tamaño y entrega— y ninguno aparece en una demo: aparecen con el volumen. Los que Meta documenta:
- Velocidad de envío: 80 mensajes por segundo por número de negocio, ampliable a pedido. Un número en coexistencia queda fijo en 20.
- Frecuencia por contacto: un mensaje cada 6 segundos al mismo usuario, con ráfagas de hasta 45 en 6 segundos a cuenta del cupo futuro.
- Llamadas de administración: 200 por hora por app y por WABA, 5.000 con la cuenta activa. Sincronizar un catálogo en bloque choca con este techo antes que con el de mensajes.
- Archivos: imágenes 5 MB; audio y video 16 MB; documentos 100 MB; stickers 100 KB (500 KB animados). Pasarse devuelve el error 131052.
- Lo que no existe: grupos, estados, listas de difusión, catálogo y pedidos no forman parte de la Cloud API.
Alta disponibilidad: el extremo frágil eres tú, no Meta. El riesgo no está en el envío, que aloja Meta, sino en el otro extremo: los webhooks que reciben cada mensaje entrante. Meta reintenta una notificación fallida durante 36 horas; lo que no se confirme en ese plazo se descarta. Y agrupa hasta 1.000 eventos por envío sin garantizar el orden, así que el receptor tiene que deduplicar. La pregunta para tu proveedor: ¿qué pasa con los mensajes que entran mientras su sistema está caído?
Cómo migrar de la app a la API sin perder el historial
Meta documenta dos caminos para llevar un número que ya usas; la diferencia es tu historial.
El camino clásico: borrar y registrar. Sacas el número de la app —Configuración → Cuenta → Eliminar mi cuenta— y lo registras en la Cloud API. Meta lo advierte sin rodeos: el historial se pierde y ese número no vuelve a la app salvo que lo des de baja. El corte es corto: hasta tres minutos, con lo que entre en cola. Exporta tus chats antes: el respaldo es un archivo, no algo que la API lea.
Coexistencia: el número vive en los dos lados. Meta también permite que un proveedor conecte un número de la app a la Cloud API sin sacarlo. Con coexistencia:
- Se sincronizan todos los contactos con número de WhatsApp.
- Se sincronizan los últimos 180 días de historial si el negocio autoriza compartirlo; los multimedia, solo los últimos 14 días.
- Los mensajes se replican en ambos sentidos: lo que tu equipo responde desde el teléfono aparece en la plataforma, y al revés.
Lo que cuesta: los chats de grupo no se sincronizan, y activarla desactiva las listas de difusión, los mensajes temporales, los de una sola vista y la ubicación en tiempo real. Tienes 24 horas desde el alta para sincronizar el historial; si se pasa, se repite todo. Requiere la app 2.24.17 o superior.
La pregunta al proveedor no es si migran tu número sino si soportan coexistencia: de ahí depende si llegas con seis meses de contexto o con la bandeja vacía.
Cinco tropiezos comunes en pymes de LATAM
- Migrar el número sin preguntar por coexistencia. Se decide una vez y no tiene vuelta atrás: pregúntalo antes de firmar, no el día de la migración.
- Creer que puedes escribirle a quien quieras cuando quieras. Fuera de la ventana de 24 horas solo salen plantillas aprobadas: el mayor choque cultural viniendo de la app.
- Subir la base de contactos y disparar. Sin consentimiento llegan los bloqueos, que bajan tu calificación de calidad y te recortan el límite de envío.
- Categorizar mal las plantillas. Marketing disfrazado de utilidad se rechaza o se recategoriza, y tu costo cambia.
- Automatizar antes de tener las respuestas. La API no conoce tus precios ni tus políticas; si no están escritas, tu agente no tiene qué decir. El proceso de venta va primero, y lo desarrollamos en cómo vender por WhatsApp.
Cuándo dar el salto
Tres señales, basta con una:
- Más de una persona necesita atender el mismo número.
- Estás perdiendo chats fuera de horario o en picos de volumen.
- Necesitas que el chat lea inventario, agenda o pagos reales.
Si ninguna aplica, quédate en la app y vuelve cuando alguna lo haga.
Si alguna aplica, la decisión de fondo no es la API: es qué conectas encima. Nosotros construimos agentes de IA con memoria persistente que recuerdan al cliente entre conversaciones, responden sobre tu catálogo y escalan ante una excepción o una negociación. En Dra. Duarte Medicina Estética, una clínica que opera así, 15% de las conversaciones por chat terminan en una cita agendada.
Preguntas frecuentes
¿Qué es la API de WhatsApp Business?
Es la interfaz oficial de Meta (WhatsApp Business Platform) que permite que un software envíe y reciba mensajes en el número de WhatsApp de tu negocio. No es una app: no tiene bandeja de entrada ni pantalla propia. El inbox compartido, la asignación de chats, la automatización y los reportes los aporta la plataforma que conectas encima de ella.
¿Cuánto cuesta la API de WhatsApp Business?
Desde el 1 de julio de 2025 Meta cobra por mensaje entregado, no por conversación, y el 1 de octubre de 2026 cambia qué mensajes entran en la cuenta. Hasta el 30 de septiembre: marketing y autenticación siempre se cobran, utilidad es gratis dentro de una ventana de atención abierta y tus respuestas libres dentro de la ventana de 24 horas no se cobran. Desde el 1 de octubre también se cobran esas respuestas y las plantillas de utilidad enviadas dentro de la ventana, a la tarifa de utilidad y autenticación del país del destinatario. A eso se suma el costo de tu plataforma.
¿Puedo usar el mismo número en la app de WhatsApp Business y en la API?
Sí, si tu proveedor soporta coexistencia: Meta permite conectar un número de la app de WhatsApp Business a la Cloud API sin sacarlo de la app, y los mensajes se replican en ambos sentidos. Si el proveedor solo hace el alta clásica, no: al registrar el número en la API sale de la app y solo vuelve si lo das de baja. La coexistencia tiene su costo — se desactivan las listas de difusión, los mensajes temporales y los de una sola vista, y los chats de grupo no se sincronizan.
¿Necesito empresa registrada para acceder a la API de WhatsApp Business?
Para escalar, sí, aunque no es el único camino. Sin verificación quedas en el primer escalón de envío —250 destinatarios nuevos cada 24 horas— y con un máximo de dos números registrados. Meta documenta tres formas de llegar a 2.000: verificar tu empresa en Meta Business Manager, que la verifique tu proveedor, o entregar 2.000 plantillas a números distintos en 30 días con buena calificación de calidad. La verificación exige documentos legales cuyo nombre coincida exactamente con el de la cuenta: RUT o certificado de Cámara de Comercio en Colombia, constancia de situación fiscal en México.
¿Cuánto tarda en quedar activa la API?
La conexión técnica del número es cuestión de horas cuando la documentación está lista. Lo que marca el tiempo real es la verificación de empresa, que depende de Meta y de que tus documentos coincidan con el nombre de la cuenta; los rechazos por ese detalle son la causa más común de demoras de semanas. La aprobación de plantillas suele ser mucho más rápida.
¿Pierdo mis conversaciones al migrar a la API de WhatsApp Business?
Depende del camino. Si borras el número de la app y lo registras en la Cloud API, Meta confirma que el historial se pierde: exporta tus chats antes. Si tu proveedor soporta coexistencia, se sincronizan los últimos 180 días de mensajes —los archivos multimedia solo de los últimos 14— siempre que autorices compartirlos y completes la sincronización dentro de las 24 horas siguientes al alta. Los chats de grupo no se sincronizan por ninguna de las dos vías.


