Límites de API y Políticas de Uso
Para garantizar la estabilidad de la plataforma y protegerse contra actividades fraudulentas como el SMS pumping, aplicamos los siguientes límites de tasa. Comprender estos límites le ayuda a crear integraciones resilientes.
✦ No credit card required · Free plan available · Setup in 5 minutes
Límites de la API de WhatsApp — Próximamente
Nuestra API de WhatsApp está actualmente en desarrollo activo. La documentación completa que cubre los límites de tasa por endpoint, los niveles de throughput de mensajes, las asignaciones de ráfaga y las garantías de entrega de webhook se está finalizando y se publicará pronto.
Mientras tanto, esto es lo que podemos compartir:
- Los niveles de throughput son administrados por Meta y escalan automáticamente según la calificación de calidad de su número: Nivel 1 (1,000 contactos/día), Nivel 2 (10,000), Nivel 3 (100,000) y Nivel 4 (ilimitado).
- Los mensajes de plantilla siguen la política comercial de Meta — todas las plantillas deben aprobarse previamente antes de enviar.
- Los mensajes de sesión solo se permiten dentro de las 24 horas del último mensaje entrante del usuario.
Para detalles específicos de límites o para solicitar acceso anticipado, contacte a nuestro equipo.
Límites de API — Preguntas Frecuentes
¿Qué sucede cuando alcanzo el límite de tasa?
Recibe una respuesta HTTP 429 (Too Many Requests). La respuesta incluye un encabezado Retry-After que indica el número de segundos a esperar antes de reintentar. Implemente backoff exponencial en su integración para manejar esto correctamente. Para operaciones de difusión, nuestro motor gestiona automáticamente los límites de throughput de Meta en su nombre.
¿Por qué hay un límite de 3 OTPs por número por 5 minutos?
Este límite existe para proteger contra el fraude de SMS pumping — un esquema donde actores maliciosos usan bots automatizados para inundar números de teléfono con solicitudes de OTP. Sin este límite, una sola clave API podría costarle miles de pesos en cargos fraudulentos. La ventana de 3 OTP / 5 minutos está alineada con las mejores prácticas de la industria.
¿Puedo solicitar límites más altos de SMS API para mi cuenta?
Sí. Si su caso de uso verificado justifica mayor throughput, contacte a nuestro equipo de soporte con los detalles de su caso de uso, volumen esperado e información de cuenta. Los límites personalizados están disponibles en planes Enterprise.
¿Cuándo se publicarán los límites de tasa de la API de WhatsApp?
Nuestra API de WhatsApp está en desarrollo activo. Estamos finalizando las especificaciones técnicas y la documentación completa para todos los endpoints. Los límites detallados se publicarán aquí tan pronto como la API alcance disponibilidad general. Contáctenos si necesita detalles actuales o desea unirse a nuestro programa de acceso anticipado.
¿Qué es una clave de idempotencia y por qué debería usarla?
Una clave de idempotencia es un identificador único que pasa con cada solicitud de API (mediante el header X-Idempotency-Key). Si su solicitud de red falla y vuelve a intentarlo, nuestra API reconocerá la misma clave y devolverá la respuesta original en lugar de enviar un SMS duplicado. Esto evita que los usuarios reciban múltiples OTPs y lo protege de ser cobrado dos veces.
¿Necesita Límites Más Altos o Acceso Anticipado a WhatsApp?
Nuestro equipo puede explicarle las capacidades actuales, acuerdos de límites personalizados y acceso anticipado a la API de WhatsApp.