Límites de tasa, restricciones y errores de API

Limitación de tasa

Cada clave API está limitada a un número de solicitudes por minuto, según su plan: Starter 60, Business 180, Pro 500, Enterprise 1.200 solicitudes/minuto. Más allá, la API devuelve un error 429 Too Many Requests con un encabezado Retry-After (60 segundos) y los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Las cuentas de alto volumen podrán solicitar un aumento en este límite. Para los envíos masivos, el endpoint bulk acepta hasta 10.000 mensajes por solicitud.

Códigos de respuesta HTTP comunes

• 200 OK — solicitud procesada exitosamente
• 400 Bad Request: parámetro faltante o con formato incorrecto (por ejemplo, número no válido)
• 401 Unauthorized: falta la clave API o no es válida
• 402 Payment Required: saldo insuficiente
• 429 Too Many Requests: se superó el límite de tasa
• 500 Internal Server Error: error en la plataforma, comuníquese con el soporte indicando la hora de la solicitud y el error.code devuelto

Mejores prácticas

• Implementar lógica de reintento con retroceso exponencial en los errores 429 y 500
• Registre sistemáticamente el message_id devuelto para facilitar cualquier diagnóstico futuro
• Utilice el modo sandbox para probar su integración sin consumir créditos reales ni enviar mensajes reales