Administración de grupos y canales
Miembros, invitaciones, permisos y moderación de grupos y canales. Las acciones requieren los permisos pertinentes.
Esta referencia reúne comandos administrativos. Consulta opciones de miembros, invitaciones, permisos y moderación antes de cambiar algo.
Miembros, invitaciones, permisos y moderación de grupos y canales. Las acciones requieren los permisos pertinentes.
Opciones comunes a todos los comandos
| Opción | Qué hace |
|---|---|
-V, --version | muestra el número de versión. |
-v, --verbose | añade detalles: -v muestra identificadores, -vv todos los datos conocidos. Valor predeterminado: 0. |
--json | salida para programas: un único valor JSON por stdout, nada más. |
--jsonl | salida para programas: un objeto JSON por línea, para flujos y jq. |
--quiet | oculta los mensajes de diagnóstico, pero sigue mostrando fallos. |
--trace | registros de la conexión por stderr; nunca el contenido de mensajes. |
--timeout <duration> | detiene todo el comando después de este intervalo: 30s, 2m, 500ms. |
--offline | responde desde lo guardado sin conectarse; falla si no hay datos. |
--no-input | no pedir entrada ni abrir un inicio de sesión interactivo; la entrada mediante una tubería sigue disponible. |
--max-input-bytes <bytes> | máximo de bytes de entrada almacenados en búfer (predeterminado: 16777216). |
--max-output-bytes <bytes> | máximo de bytes de salida para máquinas (predeterminado: 4194304; 0 desactiva el límite). |
--fields <paths> | campos de elementos o del objeto separados por comas: id,text; conservar la paginación y los identificadores de operaciones. |
--dry-run | previsualizar los argumentos analizados y los permisos antes de ejecutar la acción. |
--yes | omite la confirmación que el nivel ask exige antes de escribir. |
--record | guarda esta ejecución: identificadores y tiempos, nunca contenido. |
--no-record | no guarda la ejecución, independientemente de la configuración. |
Comandos
tg chats members
miembros de un grupo
tg chats members list
todos los miembros por páginas, con función y última conexión
tg chats members list <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--limit <n> | cuántos mostrar. |
--page <n> | número de página, desde 1. |
--all | todas las filas, sin paginar. |
tg chats members audit
miembros que parecen bots, con los motivos para cada uno, a partir de la lista de miembros y el almacenamiento local; --deep comprueba individualmente a las personas seleccionadas; no elimina a nadie
tg chats members audit <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--budget <pages> | como máximo este número de páginas de 200 miembros, con una pausa entre ellas (predeterminado: 10). |
--min-score <n> | solo miembros con al menos esta puntuación; 1 muestra a todos los que tienen algún motivo (predeterminado: 2). |
--deep <n> | comprobar también los primeros n perfiles, las fotos más antiguas, hasta 1,000 mensajes almacenados de cada uno y las listas públicas de bloqueos, a las que se envían sus identificadores — una persona por segundo. |
tg chats members history
quién entró, quién salió y qué perfiles cambiaron, primero los más antiguos — lo que chats members fetch registró en el almacenamiento local; nunca consulta el servicio de mensajería
tg chats members history <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--since-time <time> | ISO 8601 o hace 2h / 1d; todos los registros si no se indica. |
tg chats members fetch
leer la lista completa de miembros de un grupo en el historial de miembros del almacenamiento local: quién entró, quién salió, recuentos diarios y cambios de perfil; una persona se registra como ausente solo cuando se ha leído a todos los miembros
tg chats members fetch <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--track | descargarla también a diario mientras se ejecuta serve; chats tracking enumera y modifica esos chats. |
--budget <pages> | como máximo este número de páginas de 200 miembros, con una pausa entre ellas (predeterminado: 10). |
tg chats members add
añade personas y les notifica
Changes something in Telegram.
tg chats members add <chat> <person>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
person | obligatorio | identificador o parte del nombre. |
tg chats members remove
elimina personas; conserva sus mensajes
Changes something in Telegram.
tg chats members remove <chat> <person>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
person | obligatorio | identificador o parte del nombre. |
tg chats create
crea grupo o canal; notifica a las personas añadidas
Changes something in Telegram.
tg chats create <title> [person] [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
title | obligatorio | nombre del grupo. |
person | opcional | personas que añadir, por identificador o parte del nombre. |
| Opción | Qué hace |
|---|---|
--channel | canal privado en lugar de grupo; las personas entran mediante enlace. |
tg chats update
cambia nombre, descripción o activa y desactiva ajustes del grupo o canal
Changes something in Telegram.
tg chats update <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--title <title> | nombre nuevo. |
--description <text> | descripción nueva. |
--all-can-pin <on|off> | permite fijar mensajes a todos los miembros. |
--only-admins-add <on|off> | solo administradores pueden añadir miembros. |
--join-approval <on|off> | la gente pide unirse, y un administrador los deja entrar. |
tg chats link
enlace de invitación del grupo
tg chats link show
enlace de invitación, si tienes permiso para verlo
tg chats link show <chat>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
tg chats link create
crear otro enlace de invitación; nadie recibe un aviso hasta que lo compartas
Changes something in Telegram.
tg chats link create <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--approval | quien quiera entrar con el enlace debe solicitarlo primero y un administrador permite su entrada; el enlace deja de tener límite de usos. |
--expire-time <time> | deja de funcionar entonces: 2026-09-25T09:00 (hora local) o dentro de 30m, 2h, 7d. |
--max-uses <n> | como máximo este número de personas puede entrar con el enlace, de 1 a 99999. |
tg chats link list
tus enlaces de invitación, primero los más recientes, con el número de personas que entraron y que esperan
tg chats link list <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--revoked | los enlaces que revocaste, en su lugar. |
--limit <n> | cuántos. |
tg chats link revoke
revocar un enlace; para el enlace propio del grupo, la respuesta contiene el nuevo
Changes something in Telegram.
tg chats link revoke <chat> <link>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
link | obligatorio | el enlace tal como lo muestra chats link list. |
tg chats link update
cambiar uno de tus enlaces de invitación, también el principal del grupo
Changes something in Telegram.
tg chats link update <chat> <link> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
link | obligatorio | el enlace tal como lo muestra chats link list. |
| Opción | Qué hace |
|---|---|
--approval | quien quiera entrar con el enlace debe solicitarlo primero y un administrador permite su entrada; el enlace deja de tener límite de usos. |
--no-approval | cualquiera con el enlace entra de inmediato. |
--expire-time <time> | deja de funcionar entonces: 2026-09-25T09:00 (hora local) o dentro de 30m, 2h, 7d; never quita la caducidad. |
--max-uses <n> | como máximo este número de personas puede entrar con el enlace, de 1 a 99999. |
tg chats link reset
sustituye el enlace de invitación; el anterior deja de funcionar
Changes something in Telegram.
tg chats link reset <chat>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
tg chats requests
solicitudes para entrar en un grupo que requiere aprobación de un administrador
tg chats requests list
quién solicitó entrar, primero los más recientes; solo los administradores pueden verlos y la lectura no avisa a nadie
tg chats requests list <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--limit <n> | cuántos. |
--search <text> | solo personas cuyo nombre o @username contiene este texto. |
--link <link> | solo personas que lo solicitaron mediante este enlace de invitación; no se combina con --search. |
tg chats requests accept
permitirles entrar; el grupo ve que se unen
Changes something in Telegram.
tg chats requests accept <chat> [person] [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
person | opcional | quien solicitó entrar: un identificador de chats requests list. |
| Opción | Qué hace |
|---|---|
--all | todas las solicitudes pendientes, contabilizadas primero frente al límite por hora. |
--link <link> | con --all: solo las solicitudes hechas mediante este enlace de invitación. |
tg chats requests decline
rechazar la solicitud
Changes something in Telegram.
tg chats requests decline <chat> [person] [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
person | opcional | quien solicitó entrar: un identificador de chats requests list. |
| Opción | Qué hace |
|---|---|
--all | rechazar todas las solicitudes pendientes; los rechazos no cuentan para el límite horario de envíos. |
--link <link> | con --all: solo las solicitudes hechas mediante este enlace de invitación. |
tg chats admins
otorga o retira permisos de administrador a un miembro
tg chats admins add
convierte a un miembro en administrador con estos permisos
Changes something in Telegram.
tg chats admins add <chat> <person> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
person | obligatorio | identificador o parte del nombre. |
| Opción | Qué hace |
|---|---|
--can <rights> | permisos separados por comas: members, admins, info, pin, link, post, edit, delete. |
tg chats admins remove
retira permisos de administrador; sigue siendo miembro
Changes something in Telegram.
tg chats admins remove <chat> <person>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
person | obligatorio | identificador o parte del nombre. |
tg chats moderate
revisa mensajes y miembros nuevos según las reglas y ejecuta lo permitido
Changes something in Telegram.
tg chats moderate <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | chat por título completo o parcial, identificador, @username o me para Mensajes guardados. |
| Opción | Qué hace |
|---|---|
--since-time <time> | revisa desde esta fecha ISO 8601 o intervalo anterior como 2h / 1d; no cambia el punto guardado. |
--dry-run | revisa y prepara un plan, sin actuar. |
--allow-dangerous | aprueba todas las acciones con nivel ask en las reglas del grupo. |
--max-actions <n> | máximo de acciones por ejecución; 10 por defecto. |
Códigos de salida
Elige la rama según el código, no según el texto: el texto puede cambiar, el código no.
| Código | Cuándo |
|---|---|
0 | éxito |
2 | validation_error |
3 | configuration_error |
4 | authentication_error |
5 | permission_error |
6 | not_found |
7 | confirmation_required |
8 | rate_limited |
9 | timeout |
10 | network_error |
11 | provider_error |
12 | provider_unavailable |
13 | invalid_response |
14 | outcome_unknown |
130 | cancelled |
1 | cualquier otro caso |
0 y solo 0 significa que la operación se completó. 14 (outcome_unknown) significa que un mensaje puede
haberse enviado: repítelo solo con el mismo --send-id, que Telegram usa para descartar una segunda copia.