Límites de frecuencia

Los canales conectados (LinkedIn, WhatsApp, correo y otros) hablan con su proveedor a través de Unipile. Cada proveedor aplica sus propios límites de solicitudes, y superarlos puede hacer que la cuenta se limite o se suspenda. Por eso Customermates aplica a cada canal un presupuesto de solicitudes prudente y se detiene antes de que el proveedor reaccione. Una sincronización en pausa es normal: mantiene la cuenta dentro de los límites del proveedor y se reanuda sola.

¿Cómo funcionan los límites?

Los límites se configuran en el panel de Unipile y los aplica Unipile. Valen por cuenta conectada y en tres niveles a la vez:

• Por endpoint: un tope para cada operación individual (listar chats, leer mensajes) durante un minuto y un día móviles. Son los límites de lectura que aparecen más abajo.
• Por método sensible: un tope más estricto para las operaciones de más riesgo (consultar perfiles, enviar un mensaje o una solicitud de conexión). Son los límites sensibles que aparecen más abajo.
• Por cuenta: un tope global para todas las llamadas de la cuenta.

Cuando una ventana se llena, las llamadas siguientes se rechazan hasta que se renueva.

¿Cuáles son los límites de lectura de cada proveedor?

Las lecturas sincronizan el historial. Se fijan más altas que las escrituras porque leer rara vez provoca un bloqueo del proveedor.

LinkedIn sigue siendo el más prudente porque su detección de actividad automatizada es la más estricta. Algunos valores siguen los topes del propio proveedor: los canales sociales limitan la lectura por minuto a 50, los canales de correo a 100, y el límite diario sube en escalones de 30 (por eso un objetivo de 500 se aplica como 510). Telegram y los proveedores de correo no tienen un límite diario de lectura aparte.

¿Cuáles son los límites para enviar y consultar perfiles?

La consulta de perfiles (que los proveedores consideran sensible al scraping) y cada acción de envío se mantienen prudentes, sin importar el presupuesto de lectura.

Las operaciones que no tienen fila aquí, como enviar un mensaje de LinkedIn o un InMail y las búsquedas en LinkedIn Sales Navigator, siguen sujetas a los topes por endpoint y por cuenta y devuelven el mismo mensaje de límite de frecuencia cuando una ventana se llena.

¿Qué pasa cuando se alcanza un límite?

Las llamadas siguientes de esa cuenta se rechazan hasta que la ventana se renueva, y la acción te indica cuánto esperar. Al enviar un mensaje o iniciar una conversación aparece:

Otras acciones lo expresan de otra manera:

• Resincronizar la conversación, la carga de mensajes anteriores en la parte superior de una conversación y los archivos multimedia de un mensaje: «Este canal ha alcanzado su límite de frecuencia. Puedes reintentar en 2 minutos.» con Saber más.
• Actualizar en la Bandeja de entrada: «Algunos canales han alcanzado su límite de frecuencia. Inténtalo de nuevo en unos minutos.»
• Mover un correo a otra carpeta: «Se detuvo el archivado en {folder} porque el proveedor limita la tasa.» con el tiempo de espera para el resto.

El tiempo de espera sale del valor Retry-After de la respuesta de limitación que devuelve Unipile; si no lo trae, el mensaje dice «más tarde» en lugar de un tiempo de espera. Customermates no repite la acción por ti: vuelve a intentarlo cuando haya pasado la ventana. Mientras tanto no se pierde nada. Por la API REST y por MCP la llamada falla con el mismo mensaje: la API REST responde con el estado HTTP 429 y un encabezado Retry-After de 30 segundos, y MCP devuelve un fallo de tipo rate_limit cuyo problema en _meta.failure tiene customCode: "unipileRateLimit".

¿La importación del historial se reanuda sola?

Sí. Importar el historial completo de mensajes puede requerir aproximadamente una solicitud por conversación. Si se alcanza un límite a mitad de la importación, el importador en segundo plano se pausa y se reanuda automáticamente cuando la ventana se libera; una espera de más de diez minutos aplaza la importación a un barrido posterior. Con Editar en Mensajes de la bandeja de entrada, al desplazarte hasta el principio de una conversación o pulsar Resincronizar la conversación se obtienen del proveedor los mensajes anteriores, y ambas acciones cuentan para los mismos límites. La actividad nueva llega en tiempo real mediante webhooks.