Límites, esperas y trabajos en segundo plano

Telegram limita la frecuencia con la que una cuenta puede hacer solicitudes. Si haces demasiadas, responde «espera N segundos» (FLOOD_WAIT); si sigues enviando solicitudes durante la espera, esta aumenta. Si escribes a demasiados desconocidos, limita la cuenta por spam. tg regula el ritmo de cada perfil, espera el tiempo que pide Telegram cuando es corto y se detiene cuando es largo. Esta página reúne todas estas reglas.

El ritmo: un cupo por perfilCopy Anchor Link

Cada solicitud que tg hace para un perfil —desde un comando, tg mcp, tg serve o un trabajo en segundo plano— usa el mismo ritmo regulado de ese perfil:

• una ráfaga de 20 solicitudes se ejecuta de inmediato, por lo que los comandos habituales no esperan;
• después de la ráfaga, una solicitud por segundo (60 por minuto), hasta que el cupo se reponga durante la inactividad.

Dos comandos simultáneos comparten el mismo ritmo. Los turnos se guardan en un archivo dentro de la carpeta de estado (pace/<profile>.json), por lo que dos terminales, varios trabajos store fetch --background y serve se ponen en la misma cola en lugar de ejecutarse cada uno a toda velocidad. Ejecutar cinco descargas en paralelo no es más rápido que ejecutarlas una tras otra, ni implica más riesgo. Los distintos perfiles —distintas cuentas de Telegram— tienen su propio ritmo.

Un comando que tenga que esperar más de 5 segundos para su turno lo indica en stderr:

waiting 12 s to keep this profile's pace with Telegram

Cambia el ritmo en el archivo de configuración o, para una sesión del intérprete de comandos, con una variable de entorno:

{ "defaults": { "requestsPerMinute": 30 } }

TG_REQUESTS_PER_MINUTE=30 tg store fetch "Book club"

0 desactiva la regulación del ritmo. Hazlo solo para un perfil cuya cuenta puedas permitirte que Telegram limite.

Cuando Telegram pide esperarCopy Anchor Link

store fetch y messages download --all esperan hasta 5 minutos entre páginas y continúan; una espera más larga detiene la ejecución, y la siguiente continúa desde lo que ya se ha guardado.

Una espera bloquea todo el perfil. Hasta que termine, la siguiente solicitud de cada proceso espera a que finalice; una solicitud que tendría que esperar más de 5 minutos falla de inmediato con el código de salida 8, sin consultar Telegram. tg doctor y tg server status muestran en flood qué está bloqueado. Cuando termina la espera, no hace falta hacer nada; tg flood clear la levanta antes si sabes que Telegram ya no limita la cuenta.

Operaciones de escrituraCopy Anchor Link

• 30 envíos por hora por perfil de forma predeterminada (sendsPerHour), contados entre todos los procesos; consulta security.md.
• El límite por spam (PEER_FLOOD) y una cuenta congelada bloquean todas las operaciones de escritura; la lectura sigue funcionando. Consulta troubleshooting.md.
• tg nunca repite un envío si no se sabe si ha llegado; consulta usage.md.

Lecturas masivasCopy Anchor Link

• store fetch: páginas de hasta 100 mensajes, --pause entre páginas (1 s de forma predeterminada), 1000 mensajes por ejecución salvo que --limit indique otra cantidad. --estimate calcula primero las solicitudes y no envía ninguna.
• messages download --all: una solicitud por página y por archivo; las descargas de archivos también siguen el ritmo regulado.
• chats members list --all, chats list --all y la reparación de lagunas siguen el mismo ritmo regulado.

Trabajos en segundo planoCopy Anchor Link

store fetch --background y store gaps repair --background inician un trabajo que continúa después de terminar el comando: un trabajo por chat a la vez, cada uno en su propio proceso y todos con el mismo ritmo del perfil. tg store jobs list los muestra, y tg store jobs cancel <job> detiene uno después de su página actual. Consulta archive.md.

BotsCopy Anchor Link

Los límites propios de la Bot API de un bot son independientes de los de la cuenta. tg respeta el retry_after que Telegram devuelve; una espera larga termina la ejecución. Consulta bot.md.

Un inicio de sesión, varios procesosCopy Anchor Link

Cada proceso tg abre su propia conexión con la sesión del perfil. Varios pueden funcionar a la vez, pero cada uno genera solicitudes para la misma cuenta; por eso comparten el ritmo.