Administrar grupos

tg ayuda a administrar un grupo: muestra las preguntas sin respuesta, quién se ha unido y quién lo ha añadido, y lo ocurrido durante la semana. Lee sin marcar los mensajes como leídos, por lo que los miembros no ven que has revisado el grupo.

Todo lo descrito aquí funciona desde tu cuenta personal. Consulta los comandos completos en uso de grupos y canales y todas las opciones en la referencia de comandos.

Con un agenteCopy Anchor Link

Un agente con terminal (Claude Code, Codex) necesita la skill; uno sin terminal (Claude Desktop, Cursor) necesita el servidor MCP. Los ejemplos siguientes muestran qué pedir, qué comando ejecuta el agente y qué devuelve.

Revisión de la mañana: quién espera una respuestaCopy Anchor Link

You:    What is still unanswered in "Hiking"?
Agent:  (tg review --chat "Hiking" --unanswered 4h --json)
        Unanswered for more than 4 hours — 3 questions:
        · Lena, 08:12 — "What time do we leave on Saturday?"
        · Artem, yesterday 22:40 — a reply to your post about the route: "Are the tents shared?"
        · Ira, yesterday 19:05 — "Who brings the pot?"
        You or the admins answered the rest.

Se considera pregunta un mensaje con ? o una respuesta a ti o a un administrador; un ? dentro de un enlace no cuenta. Se considera contestada si tú o un administrador respondéis al mensaje o sois los siguientes en hablar después de quien preguntó. Si Telegram no indica quiénes son los administradores, solo cuentan tus respuestas y el comando lo avisa.

Nuevos miembros de la semanaCopy Anchor Link

You:    Who joined "Hiking" this week?
Agent:  (tg chats events "Hiking" --type join,add --json)
        Five people:
        · Kate — added by Lena, Tuesday
        · Oleg — joined by the link, Wednesday
        · …

chats events lee los mensajes de servicio del grupo, por lo que muestra lo que Telegram conserva en el historial: quién se unió, salió, fue añadido o eliminado, y quién realizó la acción. tg chats members list muestra todos los miembros, su función y cuándo se conectaron por última vez.

Un enlace de invitación filtradoCopy Anchor Link

You:    The invite link to "Hiking" ended up in a public chat. Replace it, and stop members adding people.
Agent:  (tg chats link reset "Hiking" --json)
        (tg chats update "Hiking" --only-admins-add on --json)
        Done: the old link no longer works, the new one is https://t.me/+…, and only admins can add
        people now.

link reset devuelve el estado actualizado del grupo, incluido el nuevo enlace; chats update también devuelve su estado. Así el agente puede explicar el cambio sin volver a consultar el grupo.

Resumen semanalCopy Anchor Link

You:    Sum up the week in "Hiking".
Agent:  (tg review --chat "Hiking" --since-time 2026-09-20T00:00 --json)
        Decided: we leave on 4 October, at 7:00 from the station.
        Taken on: Lena — food, Artem — tents.
        Open: who brings the pot — asked three times, no answer.

Revisiones programadasCopy Anchor Link

No necesitas un agente para obtener las preguntas pendientes: basta con ejecutar el comando.

0 9,21 * * * tg review --chat "Hiking" --unanswered --json >> ~/hiking-open.jsonl 2>> ~/tg-cron.log

cron no tiene terminal y a menudo no define XDG_RUNTIME_DIR, sin la cual tg no puede acceder al almacén de claves: consulta tareas programadas.

Funciones disponiblesCopy Anchor Link

Un agente sin terminal dispone de las operaciones de lectura mediante herramientas MCP: tg_review con unanswered, tg_chats_events, tg_chats_members, tg_chats_inspect (MCP).

create, join, leave, update, link reset, members y admins producen cambios visibles para el grupo: al crear un grupo se avisa a los añadidos, y al entrar o salir aparece un mensaje en el chat. Cada operación pasa por los permisos del perfil y la protección de envíos; cada persona añadida cuenta para el límite por hora (seguridad).

ReglasCopy Anchor Link

Las reglas del grupo definen qué busca tg chats moderate y qué puede hacer. Se guardan en un archivo del perfil, nunca en Telegram. No hay vigilancia automática en segundo plano: las reglas solo se aplican al ejecutar chats moderate.

tg chats rules show "Hiking"                       # the defaults, marked not saved, until the first change
tg chats rules set "Hiking" links delete           # a message with a link is deleted
tg chats rules set "Hiking" blocked 12345,67890    # these people…
tg chats rules set "Hiking" blockedPeople remove   # …are removed when they write or join
tg chats rules set "Hiking" consent.delete allow   # delete without asking
tg chats moderate "Hiking" --dry-run               # what it would do, doing nothing
tg chats moderate "Hiking"                         # judge what is new since the last run, and act

La acción de cada regla es report, delete o remove. Para ejecutar delete o remove, se consulta el nivel del grupo en consent.delete y consent.remove: deny nunca actúa, readonly solo informa, ask pregunta por cada acción (predeterminado; --allow-dangerous aprueba todas) y allow la ejecuta. Cada acción sigue pasando por la protección de envíos y su límite por hora. La ejecución se detiene después de --max-actions (10). La siguiente continúa donde se detuvo; --since-time consulta un momento que elijas y no cambia ese punto guardado.

Por MCP, tg_chats_moderate solo actúa si el nivel es allow; las acciones que requieren aprobación se enumeran sin ejecutarlas. newAccount no está disponible: Telegram no indica la antigüedad de una cuenta.

LimitacionesCopy Anchor Link

• El historial de Telegram es la fuente. chats events y review ven lo que todavía contiene el historial; si un administrador elimina un mensaje de servicio, también desaparece para estos comandos.
• Solo se conocen los administradores si Telegram los indica. En caso contrario, review --unanswered solo cuenta tus respuestas y lo avisa.
• Nada vigila el grupo por su cuenta. La revisión se ejecuta cuando la inicias tú, un agente por petición tuya o una tarea programada.
• Se aplican los límites de Telegram. Leer todos los miembros de un grupo grande requiere muchas peticiones. Una respuesta FLOOD_WAIT indica cuánto debes esperar (solución de problemas).