API de WhatsApp Business: guía completa 2026

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: en qué se diferencia de la app gratuita, qué desbloquea, cómo cobra Meta y qué cambia en octubre, cómo se obtiene acceso, 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 ni notificaciones. Todo lo que tu equipo ve —inbox compartido, asignación de chats, reportes, automatización— lo pone el software que conectas encima.

Para operarla necesitas tres cosas: un número dedicado, una cuenta de Meta Business con una WhatsApp Business Account (WABA) y un software que hable con la API. 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 —varios asesores con roles sobre una bandeja compartida y un historial del negocio— y a cambio cambia las reglas: categorías de mensaje, plantillas que Meta aprueba, límites de envío 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 solo agrega costo y trámites.

Qué desbloquea la API

• Automatización con contexto. Un agente de IA lee tu catálogo, tus precios y tus 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 dentro del chat requiere API; las conexiones disponibles están en integraciones.
• Mensajes proactivos aprobados. Confirmaciones de pedido, recordatorios de cita, avisos de envío: son plantillas, la parte de WhatsApp 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 de utilidad y autenticación bajan cuando tu volumen mensual cruza escalones que Meta define por mercado y categoría.

Las tarifas cambian por país y Meta publica su tabla oficial: revísala 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 se pagan con tu tarjeta 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:

1. Cloud API directa. Creas la WABA, pides acceso y programas todo: sin bandeja ni automatización hasta que las construyas. Tiene sentido con equipo de desarrollo propio.
2. Un BSP (proveedor de soluciones). Twilio, 360dialog o Infobip revenden el acceso, casi siempre con un margen por mensaje; encima sigues necesitando software usable por tu equipo.
3. 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 —bajo el proveedor, cambiar de herramienta duele—, puedes exportar conversaciones y contactos, y quién le paga a Meta.

Verificación, nombre para mostrar y límites 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.

Nombre para mostrar: Meta lo revisa y debe corresponder al negocio. La insignia verde (Official Business Account) es otra cosa: no se compra ni se pide; Meta la otorga por notoriedad de marca.

Límites de envío: arrancas en 250 destinatarios nuevos cada 24 horas y subes por escalones —2.000, 10.000, 100.000 y sin límite— manteniendo buena calidad y usando al menos la mitad de tu límite actual en siete días. Verificar la empresa es uno de los caminos para salir del primer escalón. Y presta atención a qué cuenta: solo las conversaciones 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 —unos 10 por minuto, 600 por hora—. Se permiten ráfagas de hasta 45 mensajes en 6 segundos, a cuenta del cupo futuro.
• Llamadas de administración: 200 solicitudes por hora por app y por WABA, que suben a 5.000 con la cuenta activa y números registrados. Sincronizar un catálogo o una base de contactos en bloque choca con este techo antes que con el de mensajes.
• Archivos: imágenes hasta 5 MB; audio y video hasta 16 MB; documentos hasta 100 MB; stickers 100 KB, o 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. La Cloud API la aloja Meta: del lado del envío no hay servidores que mantener. El riesgo está en el otro extremo, los webhooks que reciben cada mensaje entrante. Meta reintenta una notificación fallida de inmediato y luego con menor frecuencia durante 36 horas; lo que no se confirme en ese plazo se descarta. Y agrupa hasta 1.000 eventos por envío sin garantizar agrupamiento ni 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, y 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 de la Cloud API. El corte es corto: hasta tres minutos, con lo que entre en cola. Exporta tus chats antes de tocar nada; 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 en los chats 1:1. 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.

Siete tropiezos comunes en pymes de LATAM

1. 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.
2. 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.
3. 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.
4. Categorizar mal las plantillas. Marketing disfrazado de utilidad se rechaza o se recategoriza, y tu costo cambia.
5. Documentos que no coinciden con el nombre legal. Semanas perdidas en revisión.
6. No preguntar quién le paga a Meta. Aparece en la primera factura, no en la propuesta comercial.
7. 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 a una persona 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. La configuración toma minutos, no semanas.