API de WhatsApp: Tipos, Acceso, Precios y Límites
// Vincular una cuenta de WhatsApp existente
const cuenta = await cuenta.cliente.conectarWhatsapp();
// account.qrCodeString -> mostrar al usuario
// o pasar un pairing_phone_number en su lugar
const chats = await cliente.chats.list({
tipo_de_cuenta: 'WHATSAPP'
});
¿Qué es la API de WhatsApp?
| Nombre | Qué es | Quién lo opera | Requisitos de acceso |
|---|---|---|---|
| Plataforma de WhatsApp Business (API en la nube) | La propia API oficial de Meta para aprovisionar nuevos números de teléfono comerciales y enviar mensajes de plantilla a escala | Meta | Aplicación de desarrollador de Meta, WABA, número de teléfono comercial, verificación para niveles superiores |
| Acceso como Proveedor de Soluciones Comerciales (BSP) | Un tercero (Twilio, 360dialog y similares) que revende la misma Cloud API, integrada en su propio panel y sistema de facturación | Infraestructura de Meta, gestionada por BSP | Mismos requisitos subyacentes de Meta, aprovisionados a través del BSP |
| API de sesión unificada (Unipile) | Conecta una cuenta de WhatsApp, de empresa o personal, tal como lo hace WhatsApp Web, mediante código QR o código de emparejamiento | Unipile, en nombre del usuario autenticado | Sin verificación de Meta Business, sin número nuevo, sin aprobación de plantillas |
¿Cuáles son los diferentes tipos de API de WhatsApp?
| Tipo | Aprovisionamiento | Mejor para | Funciona con una cuenta existente |
|---|---|---|---|
| API en la nube | Nuevo número de teléfono comercial + Verificación de Meta Business para mayor volumen | Empresas que envían marketing o notificaciones a gran escala | No, requiere un número nuevo |
| API local | Descontinuado. Meta lo retiró y promovió la migración a la API en la nube | Solo integraciones heredadas | No |
| Aplicación WhatsApp Business | Aplicación gratuita orientada al consumidor, configuración manual en un dispositivo | Pequeñas empresas que gestionan los chats manualmente | Sí, pero de forma manual, un dispositivo, no mediante programación |
| API de sesión unificada (Unipile) | Vincula la cuenta tal como lo hace WhatsApp Web, sin un número nuevo | Plataformas SaaS que integran la propia cuenta de WhatsApp de cada usuario en el producto | Sí, este es el caso de uso principal |
Ecosistema API de WhatsApp
Meta ofrece dos API oficiales que permiten a las empresas integrar WhatsApp en su software. Ambas están diseñadas para permitir el envío de mensajes de alto volumen, con funciones como mensajes predefinidos (plantillas), intercambio de medios y herramientas de atención al cliente.
API de WhatsApp Business
La Business API fue la primera solución lanzada por Meta para ayudar a las empresas a interactuar con sus clientes en WhatsApp. Suele ser autoalojada o gestionada por un proveedor autorizado, lo que da a las empresas más control sobre la infraestructura. Admite mensajes salientes con plantillas, respuestas de clientes y formatos multimedia enriquecidos, lo que la hace adecuada para empresas que necesitan integrar WhatsApp directamente en su CRM, centro de contacto o sistema de soporte.
API de WhatsApp en la nube
Lanzada más tarde, la API en la nube está totalmente alojada por Meta. Elimina la necesidad de que las empresas gestionen servidores o manejen una infraestructura pesada. La API en la nube ofrece funciones básicas similares, como el envío y la recepción de mensajes, la gestión de plantillas y la compatibilidad con medios, pero es más fácil de implementar para los desarrolladores. Se posiciona como una forma más rápida de acceder a WhatsApp mediante programación, especialmente para las empresas que desean escalabilidad sin la sobrecarga del alojamiento local.
La complejidad de la integración de WhatsApp
Si bien las API de Negocio y Nube de Meta proporcionan potentes capacidades, su integración está lejos de ser sencilla. Los desarrolladores deben gestionar la verificación comercial, las aprobaciones de plantillas y las cuotas de mensajes antes incluso de empezar a operar. Alojar o conectarse a la API de Nube también requiere gestionar webhooks, cifrado y el cumplimiento de estrictas reglas de opt-in (solicitud de consentimiento). Estos obstáculos a menudo retrasan los proyectos y limitan el acceso a los proveedores SaaS más pequeños que desean añadir WhatsApp rápidamente a sus plataformas.