Resumen
La API de WhatsApp Business permite a las empresas medianas y grandes comunicarse con los clientes a gran escala. Las empresas pueden integrar la API en sus sistemas para gestionar interacciones con los clientes automatizadas y gestionadas por humanos.
La API de WhatsApp Business está disponible en dos opciones de alojamiento:
Cloud API (alojado por Meta)
API en Instalaciones Locales (autoalojado por empresas o Proveedores de Soluciones Empresariales (BSP))
La elección de la opción adecuada depende de las necesidades de tu negocio. Esta guía desglosa las diferencias entre Cloud API y API en Instalaciones Locales, ayudándote a determinar cuál es la mejor para tu caso de uso.
Importante: Un número de teléfono solo puede asociarse con una de estas APIs a la vez. No puedes usar el mismo número en ambas plataformas simultáneamente.
Instrucciones
Descripción general de Cloud API
Cloud API está alojado por Meta y permite a las empresas enviar mensajes a través de la Graph API. Utiliza webhooks para recibir eventos como mensajes entrantes y actualizaciones de estado de entrega.
Características principales:
No requiere mantenimiento de servidores - Meta gestiona el alojamiento y la infraestructura.
Actualizaciones automáticas - Las empresas siempre tienen acceso a las últimas características y parches de seguridad.
Mayor rendimiento de mensajes - Soporta hasta 500 mensajes por segundo (envío y recepción combinados).
Autenticación simplificada - Usa User Access Tokens.
Menores costos de infraestructura - Las empresas solo pagan por los mensajes enviados.
Para obtener más información, consulte la Documentación del Desarrollador de Graph API.
Descripción general de API en Instalaciones Locales
La API en Instalaciones Locales requiere que las empresas o BSPs alberguen y mantengan el software de la API de WhatsApp en sus propios servidores.
Características principales:
Mayor control - Las empresas gestionan su propia infraestructura.
Seguridad personalizada - Las empresas controlan su propia Entidad Certificadora (CA) y certificados webhook.
Soporta Check Contacts API y Media Provider API, que están obsoletas en Cloud API.
Menor latencia para implementaciones locales, dependiendo de la infraestructura de la empresa.
Alta disponibilidad requerida - Las empresas deben implementar soluciones de recuperación ante desastres.
Comparación: Cloud API vs. API en Instalaciones Locales
Característica | Cloud API (Alojado por Meta) | API en Instalaciones Locales (Autoalojado) |
Alojamiento | Alojado por Meta | Las empresas/BSP alojan en sus propios servidores |
Mantenimiento | Meta maneja actualizaciones y parches | Las empresas/BSP deben gestionar actualizaciones y escalabilidad |
Costo | Las empresas pagan por mensaje enviado | Costos adicionales de infraestructura para configuración y mantenimiento de servidores + tarifas por mensaje |
Protocolo API | Graph API | REST API |
Rendimiento de mensajes | Hasta 500 mensajes por segundo (envío y recepción combinados) | Hasta 70 mensajes por segundo (concesión única), 250 mensajes por segundo (multi-conexión) |
Gestión de certificados | Gestionado por Meta | Las empresas gestionan sus propios certificados |
Recuperación ante desastres | Meta garantiza la disponibilidad (meta de 99.9%) | Las empresas deben implementar soluciones de respaldo |
Único vs. Multi-inquilino | Multi-inquilino (soporta múltiples números de teléfono) | Único inquilino (un número de teléfono por implementación) |
Monitoreo | Meta monitorea la salud de la instancia | Las empresas deben configurar el monitoreo ellas mismas |
Tasas de error mínimas | ~0.1% | No publicado; varia según la infraestructura |
Ubicación del servidor | América del Norte | Determinado por la infraestructura de la empresa |
SLA (Disponibilidad) | Meta de 99.9% de disponibilidad | Varia según la configuración de la empresa |
Soporte | Soporte 24/7 para problemas críticos | Soporte 24/7 de mejor esfuerzo para problemas críticos |
Consideraciones clave para elegir entre Cloud API y API en Instalaciones Locales
Cuándo elegir Cloud API
No quieres gestionar servidores ni infraestructura.
Necesitas escalabilidad con esfuerzo mínimo.
Quieres actualizaciones automáticas sin tiempo de inactividad.
Tu negocio necesita alto rendimiento para el mensajería (hasta 500 mensajes por segundo).
Cuándo elegir API en Instalaciones Locales
Requieres control total sobre infraestructura y seguridad.
Tu negocio no puede usar servicios alojados por Meta debido a restricciones regulatorias.
Confías en Check Contacts API y Media Provider API (obsoletas en Cloud API).
Tienes infraestructura existente y recursos para la gestión de servidores.
OBSOLESCENCIAS EN CLOUD API
Algunas funciones disponibles en On-Premises API están obsoletas en Cloud API:
Característica | API en Instalaciones Locales | Cloud API |
Check Contacts API | Necesaria para verificar números de teléfono antes de enviar mensajes | Ya no es necesaria – solo usa el número de teléfono |
Media Provider API | Soportada | Obsoleta – usa los pasos de carga de medios de Cloud API |
Conclusión
La elección entre Cloud API y API en Instalaciones Locales depende de las necesidades de tu negocio:
Cloud API es la mejor opción para empresas que buscan facilidad de uso, menor mantenimiento y escalabilidad.
API en Instalaciones Locales es ideal para empresas que requieren control total, seguridad personalizada y alojamiento en instalaciones.
Si aún no estás seguro, considera tus capacidades de infraestructura, requisitos de seguridad y necesidades de escalabilidad antes de tomar una decisión.
Preguntas Frecuentes (FAQs)
Preguntas Generales
1. ¿Qué es la API de WhatsApp Business?
→ La API de WhatsApp Business permite a las empresas comunicarse con los clientes a gran escala, habilitando mensajes automatizados y gestionados por humanos.
2. ¿Cuáles son los dos tipos de opciones de alojamiento de WhatsApp Business API?
→ Hay dos opciones de alojamiento:
Cloud API – Alojado por Meta, no requiere mantenimiento de servidores.
API en Instalaciones Locales – Autoalojada por empresas o Proveedores de Soluciones Empresariales (BSP), requiere gestión de servidores.
3. ¿Puedo usar Cloud API y API en Instalaciones Locales al mismo tiempo?
→ No, un número de teléfono solo puede registrarse en una plataforma a la vez.
Cloud API
4. ¿Qué es Cloud API?
→ Cloud API es una API de WhatsApp Business alojada por Meta que permite a las empresas enviar mensajes a través de la Graph API sin gestionar su propia infraestructura.
5. ¿Cuáles son los beneficios de usar Cloud API?
No es necesario configurar ni mantener servidores.
Actualizaciones automáticas con nuevas características y parches de seguridad.
Mayor rendimiento de mensajes (hasta 500 mensajes por segundo).
Menores costos de infraestructura (solo pagas por los mensajes enviados).
6. ¿Dónde están ubicados los servidores de Cloud API?
→ Los servidores de Cloud API están alojados en América del Norte.
7. ¿Qué método de autenticación usa Cloud API?
→ Cloud API usa User Access Tokens para la autenticación.
8. ¿Cloud API soporta Check Contacts API o Media Provider API?
→ No, estas APIs están obsoletas en Cloud API.
API en Instalaciones Locales
9. ¿Qué es API en Instalaciones Locales?
→ La API en Instalaciones Locales es una versión autoalojada de la API de WhatsApp Business que las empresas o BSPs deben gestionar en sus propios servidores.
10. ¿Cuáles son las ventajas de usar API en Instalaciones Locales?
Control total sobre la infraestructura y seguridad.
Capacidad para gestionar certificados y requisitos de cumplimiento.
Puede ser desplegada en modelos de alta disponibilidad para recuperación ante desastres.
Soporta Check Contacts API y Media Provider API (que están obsoletas en Cloud API).
11. ¿Cuáles son los requisitos de infraestructura para API en Instalaciones Locales?
→ Las empresas deben configurar y mantener sus propios servidores, gestionar autoridades de certificación y monitorear la salud del sistema.
12. ¿Cómo compara el rendimiento de mensajes con Cloud API?
La API en Instalaciones Locales soporta hasta 70 mensajes por segundo (concesión única) y 250 mensajes por segundo (multi-conexión).
Cloud API soporta hasta 500 mensajes por segundo (envío y recepción combinados).
13. ¿Dónde se puede alojar API en Instalaciones Locales?
→ Puede alojarse en cualquier centro de datos o proveedor de nube elegido por la empresa.
Elegir entre Cloud API y API en Instalaciones Locales
14. ¿Cómo decido entre Cloud API y API en Instalaciones Locales?
Elige Cloud API si prefieres un mantenimiento mínimo, actualizaciones automáticas y mayor rendimiento de mensajes.
Elige API en Instalaciones Locales si requieres control total sobre la seguridad, la infraestructura y los despleg questioluciones.
15. ¿Tiene Cloud API mejor tiempo de actividad que API en Instalaciones Locales?
→ Cloud API tiene una meta de 99.9% de tiempo de actividad, mientras que el tiempo de actividad de API en Instalaciones Locales depende de la infraestructura de la empresa.
16. ¿Reduce Cloud API los costos en comparación con API en Instalaciones Locales?
→ Sí. Cloud API elimina los costos de configuración y mantenimiento de servidores, por lo que las empresas solo pagan por los mensajes enviados.
17. ¿Puedo migrar de API en Instalaciones Locales a Cloud API?
→ Sí, pero necesitarás deregistrar tu número de teléfono de API en Instalaciones Locales antes de registrarlo en Cloud API.
Soporte y mantenimiento
18. ¿Quién gestiona las actualizaciones para Cloud API?
→ Meta maneja automáticamente actualizaciones de software y parches de seguridad para Cloud API.
19. ¿Quién es responsable del mantenimiento de API en Instalaciones Locales?
→ Las empresas o BSPs deben realizar actualizaciones, parches de seguridad y monitoreo de servidores ellas mismas.
20. ¿Qué opciones de soporte están disponibles para ambas APIs?
Cloud API: Soporte 24/7 para problemas críticos.
API en Instalaciones Locales: Soporte 24/7 de mejor esfuerzo para problemas críticos.