Limites de solicitudes vía API de la plataforma DANAconnect

Las API de DANAconnect cuentan con límites de solicitudes para garantizar la estabilidad, disponibilidad y distribución adecuada de los recursos de la plataforma.
Estos límites establecen la cantidad máxima de solicitudes o transacciones que una integración puede enviar por segundo.
Si una implementación necesita procesar un volumen superior, las solicitudes deberán distribuirse en el tiempo mediante una cola o mediante el mecanismo de control de concurrencia.

Límites por API

Conversation API

Conversation API permite iniciar flujos de comunicación previamente configurados en DANAconnect.
Los límites dependen de la versión utilizada:

• Conversation API V1: admite hasta 30 solicitudes por segundo por empresa y dirección IP.
• Conversation API V2: admite hasta 40 solicitudes por segundo por dirección IP.

La integración debe controlar la frecuencia con la que envía las solicitudes para evitar superar estos límites.

Document Manager API

Document Manager API tiene un límite de procesamiento de entre 2 y 5 solicitudes por segundo.
El límite específico depende del servicio u operación utilizada dentro de la API.
Las operaciones disponibles pueden incluir la carga, consulta, indexación, firma o descarga de documentos.

ValidateMailbox API

ValidateMailbox API tiene un límite de 5 solicitudes por segundo (TPS).
Este servicio fue desarrollado exclusivamente para validaciones transaccionales y no está diseñado para realizar consultas o validaciones masivas de direcciones de correo electrónico.

Recomendaciones para una integración eficiente de la validación de emails vía API

Para obtener el mejor desempeño, se recomienda validar la dirección de email en el momento en que el usuario la registra o actualiza y conservar el resultado para consultas posteriores.
En procesos que requieren una respuesta inmediata, como el envío de códigos OTP, es recomendable utilizar una dirección previamente validada. De esta manera, la validación no agrega tiempo al flujo de autenticación y se ofrece una experiencia más ágil al usuario.
Para bases de contactos o volúmenes elevados de direcciones, recomendamos realizar previamente un proceso de depuración y validación. DANAconnect puede apoyar a su organización en la preparación de estas bases.

Flujo recomendado para OTP

1. El usuario registra o actualiza su dirección de email.
2. La dirección se valida y el resultado queda disponible para usos posteriores.
3. Cuando se solicita un OTP, el sistema utiliza la dirección previamente validada.
4. Si se incorpora una dirección nueva, se completa primero su validación.

File Upload API

File Upload API admite un máximo de 2 solicitudes por segundo.
Esta API permite cargar archivos individualmente para utilizarlos posteriormente como adjuntos dinámicos dentro de una comunicación.

Contact Bulk Upload API

Contact Bulk Load API admite un máximo de 2 solicitudes por segundo.
Esta API permite cargar archivos que contienen múltiples registros de contactos.
El límite corresponde a la cantidad de solicitudes de carga realizadas, no a la cantidad de contactos incluida en cada archivo.

Recomendaciones para las integraciones

Para operar dentro de los límites establecidos, se recomienda:

• Controlar la cantidad de solicitudes enviadas simultáneamente.
• Evitar reintentos inmediatos y continuos cuando una solicitud no pueda ser procesada.
• Implementar una estrategia de reintentos con tiempos de espera progresivos.
• Registrar las solicitudes y respuestas para facilitar el monitoreo y la resolución de errores.
• Utilizar las API de carga masiva cuando sea necesario procesar grandes volúmenes de información.
• Mantener las listas de contactos limpias con buenas prácticas -> ver el artículo

Actualizado el: 04/08/2026