# Telegram: Administración (/es/docs/tg/groups)

Consulta miembros, ajustes y actividad antes de elegir una tarea administrativa. Comprueba permisos, preguntas pendientes y cuentas sospechosas. Primero un informe; cambiar ajustes o eliminar miembros son decisiones aparte.

[Cuenta personal](/llms.mdx/docs/es/tg/usage/content.md) · [Bots](/llms.mdx/docs/es/tg/bot/content.md) · [Administración](/llms.mdx/docs/es/tg/groups/content.md)

## Comprobar grupo y permisos

```text prompt
Usa tg CLI. En Club, muestra descripción, miembros, administradores y mis permisos. ¿Qué ajustes puedo cambiar? No cambies nada.
```

Recibirás información y acciones disponibles. Ser miembro no concede automáticamente permisos administrativos.

[Informes del grupo y participantes](/llms.mdx/docs/es/tg/rankings/content.md)

## Preparar un plan de moderación

```text prompt
Usa tg CLI. Revisa Club: preguntas pendientes, nuevos miembros y señales de spam. Sugiere personas a ayudar y mensajes a comprobar. No borres, bloquees ni cambies ajustes.
```

Recibirás mensajes y motivos concretos. Elige después si responder, revisar una cuenta o cambiar reglas de acceso. Los comandos están abajo.

[Antibot y otros informes](/llms.mdx/docs/es/tg/rankings/content.md#task-antibot)

## Comandos e instrucciones

Utilice esta página cuando sea administrador de un grupo de Telegram y desee ayuda para mantenerlo en orden. Aprenderá cómo encontrar preguntas que nadie respondió, ver quién se unió y quién los agregó, resumir una semana, eliminar el spam según sus propias reglas y mantener un historial de la lista de miembros. La lectura marca nada leído, por lo que verificar un grupo no les dice a sus miembros que usted miró.

Aquí todo funciona desde tu cuenta personal, en grupos donde eres administrador. Algunas palabras en esta página:

- **Un administrador** es un miembro con derechos para administrar el grupo. Algunos comandos cuentan sólo sus respuestas y las respuestas de los administradores.
- **El almacén local** es la copia de mensajes que `tg` guarda en esta computadora. Los informes y las tareas lo utilizan, por lo que solo ven lo que se descargó.
- **Una tarea** es algo que espera de ti, como una pregunta que nadie respondió. `tg` abre y cierra tareas en el archivo local.
- **Las reglas** dicen qué busca `tg personal chats moderate`, como enlaces o inundaciones, y qué puede hacer.
- **Una instantánea de miembros** es la lista de miembros guardada en un día. Las instantáneas a lo largo del tiempo muestran quién se unió y quién se fue.

## Qué puedes hacer [#qué-puedes-hacer]

| Tarea | Comando |
| --- | --- |
| Encuentra preguntas que esperan una respuesta | `tg personal review --unanswered` |
| Vea quién se unió, se fue, fue agregado o eliminado | `tg personal chats events` |
| Resumen de una semana: decisiones, promesas, preguntas abiertas | `tg personal review 'date>7d'` |
| Mantenga una lista de lo que le espera | `tg personal tasks list` |
| Elimina el spam según tus propias reglas | `tg personal chats rules set`, `tg personal chats moderate` |
| Reemplazar un enlace de invitación filtrado | `tg personal chats links reset` |
| Dejar entrar a la gente o rechazarla | `tg personal chats requests list\|confirm\|reject` |
| Ver la actividad de la semana y las estadísticas propias de Telegram | `tg personal stats chats show`, `tg personal stats chats official` |
| Guarde la lista de miembros todos los días | `tg personal chats members fetch --track` |
| Encuentra miembros que parezcan bots o spammers | `tg personal chats members check` |

La lista completa de comandos de grupo está [abajo](#what-there-is). Los detalles de cada comando se encuentran en [grupos y canales en la guía de uso](/llms.mdx/docs/es/tg/usage/content.md#groups-and-channels); cada opción está en la [referencia de comando](/llms.mdx/docs/es/tg/commands/content.md).

## Con un agente [#con-un-agente]

Su agente de IA (por ejemplo, Claude Code, Codex, Cursor o Gemini CLI) puede ejecutar estas comprobaciones por usted. Un agente con una terminal necesita la [skill tg](/llms.mdx/docs/es/tg/recipes/content.md#once-first); un agente en una aplicación sin terminal necesita el [servidor MCP](/llms.mdx/docs/es/tg/mcp/content.md). A continuación: lo que usted dice, lo que ejecuta el agente y lo que obtiene a cambio.

Los nombres, mensajes y resultados a continuación son ficticios. Los comandos están separados de la respuesta: el agente lee los datos y los presenta.

### Revisión de la mañana: quién espera una respuesta [#revisión-de-la-mañana-quién-espera-una-respuesta]

Empieza por las preguntas que esperan una respuesta tuya o de los administradores.

**Tu petición:**

> Usa tg CLI. ¿Qué preguntas de Hiking llevan más de cuatro horas esperando respuesta?

**Comando:**

```sh
tg personal review 'chat:Hiking' --unanswered 4h --json
```

**Ejemplo de respuesta del agente:**

> **3 preguntas esperan una respuesta.**
>
> | Persona | Pregunta | Espera |
> | --- | --- | --- |
> | Lena | ¿A qué hora salimos el sábado? | 6 horas |
> | Sam | ¿Compartimos las tiendas? | 12 horas |
> | Ira | ¿Quién llevará la olla? | 15 horas |
>
> Abre una pregunta para revisar el contexto de la conversación.

Estas son las reglas de `review`: un signo de interrogación fuera de un enlace, o una respuesta a ti o a un administrador, puede abrir una pregunta. Tu respuesta o la de un administrador, incluso el siguiente mensaje, puede cerrarla. El [informe estadístico](/llms.mdx/docs/es/tg/rankings/content.md) cuenta respuestas directas vinculadas y puede dar otro resultado. Si Telegram no proporciona la lista de administradores, solo cuentan tus respuestas y el resultado lo indica.

### Nuevos miembros de la semana [#nuevos-miembros-de-la-semana]

Revisa los eventos de entrada. Una cuenta nueva merece revisión; su edad no demuestra que sea spam.

**Tu petición:**

> Usa tg CLI. ¿Quién se unió a Hiking esta semana? Muéstrame a quién conviene revisar.

**Comando:**

```sh
tg personal chats events "Hiking" 'time>=7d' --json
```

**Ejemplo de respuesta del agente:**

> | Nuevo miembro | Cómo entró |
> | --- | --- |
> | Kate | Añadido por Lena |
> | Oleg | Entró por su cuenta |
>
> Revisa la información disponible del perfil de Oleg antes de sacar conclusiones. La edad de la cuenta no basta para expulsarlo.

Los eventos solo cubren el historial disponible. Puedes consultar la lista actual de miembros por separado.

### Un enlace de invitación filtrado [#un-enlace-de-invitación-filtrado]

Reemplaza el enlace de invitación cuando hayas pedido ese cambio.

**Tu petición:**

> Usa tg CLI. Se filtró el enlace de Hiking. Reemplázalo y permite que solo los administradores añadan miembros.

**Reemplazar el enlace:**

```sh
tg personal chats links reset "Hiking" --json
```

**Restringir la incorporación de miembros:**

```sh
tg personal chats update "Hiking" --only-admins-add on --json
```

**Ejemplo de respuesta del agente:**

> | Ajuste | Resultado |
> | --- | --- |
> | Enlace anterior | Reemplazado |
> | Quién puede añadir miembros | Solo administradores |
>
> El enlace privado nuevo aparece en el resultado solicitado; compártelo solo con las personas indicadas.

Estos comandos cambian el grupo. La petición del ejemplo autoriza ambos cambios; una petición para consultar el enlace no lo haría.

### Limpieza de spam con tu aprobación [#limpieza-de-spam-con-tu-aprobación]

Primero vea lo que sugieren las reglas, sin ninguna acción.

**Tu petición:**

> Usa tg CLI. Verifique Hiking en busca de spam. No borres nada todavía; mostrar las sugerencias.

**Comando:**

```sh
tg personal chats moderate "Hiking" --dry-run --json
```

**Ejemplo de respuesta del agente:**

> **Acción sugerida:** eliminar un mensaje con un enlace de invitación.
>
> | Encontrado | Sugerencia | Estado |
> | --- | --- | --- |
> | Enlace de invitación | Eliminar el mensaje | Solo vista previa |
>
> No se eliminó nada. Confirma el mensaje concreto antes de aplicar la acción.

Las acciones reales necesitan tu solicitud y los permisos del perfil. Una vista previa no da permiso para eliminar.

### Resumen semanal [#resumen-semanal]

Pide un resumen de decisiones, compromisos y preguntas pendientes.

**Tu petición:**

> Usa tg CLI. Resume la semana en Hiking.

**Comando:**

```sh
tg personal review 'chat:Hiking date>7d' --json
```

**Ejemplo de respuesta del agente:**

> **Decidido:** salir a las 7:00 desde la estación.
>
> **Compromisos:**
>
> - Lena — comida.
> - Sam — tiendas.
>
> **Pendiente:** quién llevará la olla.
>
> Puedo mostrar los mensajes originales para comprobar el resumen.

### Revisiones programadas [#revisiones-programadas]

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

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

cron no tiene terminal y, a menudo, no tiene `XDG_RUNTIME_DIR`, sin el cual `tg` no puede acceder al llavero: consulte [ejecución programada](/llms.mdx/docs/es/tg/recipes/content.md#running-on-a-schedule).

## Funciones disponibles [#funciones-disponibles]

| Comando | Qué hace |
|---|---|
| `tg personal review 'chat:"<chat>"' --unanswered [duration]` | preguntas que usted y los administradores no han respondido durante tanto tiempo: `4h`, `1d`; 24 horas por defecto |
| `tg personal chats events <chat>` | quién se incorporó, se fue, fue añadido o eliminado, y por quién; 7 días por defecto |
| `tg personal chats members list <chat>` | todos los miembros del grupo, con su rol y cuándo fueron vistos por última vez |
| `tg personal topics list <chat>`, `tg personal search topics <chat> <text>` | los temas de un grupo de foro; la búsqueda los encuentra por título |
| `tg personal topics show <chat> <id>` | un tema: título, cerrado o fijado, recuento de no leídos, última actividad |
| `tg personal topics enable <chat>` | habilitar un foro; un grupo básico requiere `--upgrade --yes` y devuelve una nueva identificación de chat |
| `tg personal topics create <chat> <title>` | crear un tema; después de un resultado desconocido marque `topics list` en lugar de repetir |
| `tg personal topics edit <chat> <id> --emoji <emoji>` | dar a un tema un icono de `topics icons list`; `--emoji none` lo quita; `topics create` también acepta `--emoji` |
| `tg personal messages send <chat> <text> --topic <id>`, `tg personal polls create <chat> <question> <answers> --topic <id>` | enviar un mensaje o encuesta sobre un tema del foro |
| `tg personal messages forward <chat> <message> --to <forum> --topic <id>` | reenviar un mensaje a un tema del foro `--to` |
| `tg personal chats inspect <link>` | adónde conduce una invitación o un enlace público; no se une a nada |
| `tg personal chats create <title> [person...]` | un nuevo grupo (un supergrupo) o un canal con `--channel` |
| `tg personal chats join <link>`, `tg personal chats leave <chat>` | unirse por un enlace, salir |
| `tg personal chats update <chat>` | el título, la descripción y si los miembros pueden fijar (`--all-can-pin`) o agregar personas (`--only-admins-add`) |
| `tg personal chats members add\|remove <chat> <person...>` | agregar personas (se les dice; se nombra a quienes no se pudieron agregar) o eliminarlas (sus mensajes permanecen) |
| `tg personal chats admins add <chat> <person> --can <rights>` | convertir a un miembro en administrador con estos derechos: miembros, administradores, información, fijar, vincular, publicar, editar, eliminar |
| `tg personal chats admins remove <chat> <person>` | retirar los permisos de administrador; sigue siendo miembro |
| `tg personal chats links update <chat> <link> --approval --expire-time <time>`, `tg personal chats links update <chat> <link> --no-approval --max-uses <n>` | cambiar solo la aprobación, el vencimiento o el límite de uso proporcionados de su enlace de invitación adicional; suministrar al menos un cambio |
| `tg personal chats links show\|reset <chat>` | el enlace de invitación; `reset` hace uno nuevo y el viejo deja de funcionar |
| `tg personal chats requests list\|confirm\|reject <chat>` | solicitudes para unirse a un grupo que necesita la aprobación de un administrador: quién preguntó, déjelo entrar, rechace; `--all` responde a todas las solicitudes |
| `tg personal chats rules show\|set\|unset <chat>` | las reglas del grupo |
| `tg personal chats moderate <chat>` | comprobar el grupo según sus reglas; hace lo que permiten las reglas |
| `tg personal messages delete --for-everyone`, `pin`, `unpin` | eliminar para todos, pin |

Solo el propietario del grupo puede activar los temas. Un supergrupo existente no necesita
actualización. Al actualizar un grupo básico, este recibe un nuevo id de chat; el archivo local guarda
los mensajes anteriores con el id original y no fusiona los dos historiales.

En un tema de foro, el texto, los pies de foto y de archivo y los envíos programados se quedan en el
tema, y una respuesta explícita debe pertenecer a ese tema. Un tema cerrado o inexistente se rechaza
antes de enviar nada. Si no se sabe cómo terminó un envío, repítelo con el mismo `--operation-id`, chat y
tema; para un envío programado, consulta `tg personal messages scheduled <chat>` en lugar de repetirlo.

Un agente conectado a través del [servidor MCP](/llms.mdx/docs/es/tg/mcp/content.md) puede ejecutar los mismos comandos, siempre que los permisos del perfil lo permitan.

`create`, `join`, `leave`, `update`, `link reset`, `members` y `admins` cambian algo que ven los miembros del grupo: un nuevo grupo les dice a las personas agregadas, y se muestra una entrada o salida en el chat. Cada uno pasa por los permisos del perfil y el control de envío, y cada persona agregada cuenta para el límite por hora (consulte [el control de envío](/llms.mdx/docs/es/tg/security/content.md#the-send-guard)).

## Lo que te espera [#lo-que-te-espera]

`review` y `serve` mantienen una lista de tareas en el archivo local: lo que tienes que hacer y lo que alguien te debe. Una tarea apunta a su mensaje y nunca lo copia. Dónde abre una tarea una regla:

- **Un chat individual:** una pregunta que no respondiste y un mensaje que te menciona.
- **Un grupo:** solo una pregunta que responde a tu mensaje y una mención tuya. Las preguntas de otras personas no son tus tareas.
- **Un canal o Mensajes guardados:** nada.

Tu respuesta cierra la tarea. Para registrar cada pregunta de un grupo, sea para quien sea, ponle una etiqueta al grupo:

```sh
tg personal tags add --chat <group> watch-tasks
tg personal tags remove --chat <group> watch-tasks
```

En un grupo con esta etiqueta, cada pregunta que no respondiste abre una tarea: un mensaje con signo de interrogación o una respuesta a uno tuyo. Solo cuentan los mensajes nuevos; para los anteriores usa `tasks scan`. Una petición o una promesa sin signo de interrogación no es una tarea de una regla: tu agente la agrega con `tasks add`. Tu respuesta cierra la pregunta, y también una respuesta a ella de cualquier miembro que no sea quien preguntó. Un mensaje posterior que no responde a la pregunta no cierra nada; esa tarea la cierras tú o tu agente. Pon la etiqueta solo en grupos donde las respuestas te tocan a ti.

La primera sincronización de una cuenta no abre tareas de tu historial; las siguientes abren tareas a partir de mensajes nuevos. Para convertir el historial de un chat en tareas, mira lo que se abriría y luego ábrelo:

```sh
tg personal tasks scan <chat>
tg personal tasks scan <chat> --last 300 --yes
```

`config set task_first_pass_per_chat <n>` permite que la primera sincronización abra hasta n tareas por chat.

Cuando alguien te promete algo, guárdalo como tarea suya y consulta lo que otros te deben:

```sh
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other --assignee sender
tg personal tasks list "assignee:any state:open"
```

`--assignee sender` es quien envió el mensaje; `--assignee person:<id>` nombra a otra persona, y `tasks update <task> --assignee none` quita el responsable. Una tarea sin responsable está bien: mejor eso que una tarea perdida.

Vea lo que le espera, primero el mayor, luego solo preguntas y menciones en un grupo:

```sh
tg personal tasks list state:open
```

```sh
tg personal tasks list chat:<chat id> "(kind:question OR kind:mention)"
```

Agregue lo que las reglas no pueden ver, como una promesa que hizo, o cierre una tarea que no necesita respuesta:

```sh
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other
```

`tasks categories` muestra las categorías que puede tener una tarea. Para cambiar la lista, edita la sección `task_categories` de `~/.config/WireCat/config.json`. Es un archivo de ajustes común a las herramientas de WireCat, no el de un perfil. Solo guarda tus cambios a la lista por defecto: un nombre con su significado y sus palabras clave añade o sustituye una categoría, y `null` quita una de la lista por defecto:

```json
{
  "task_categories": {
    "garden": "plants | seedling, es:planta",
    "religion": null
  }
}
```

`config set task_categories.garden "plants | seedling"` y `config unset task_categories.garden` escriben en el mismo archivo y conservan sus otras secciones; `config unset task_categories` vuelve a la lista por defecto. Un almacén movido con `MESSAGING_STORE` lee el `config.json` que está a su lado.

Si la tarea puede ser el mismo trabajo que una abierta, `tasks add` rechaza la creación con código 2 y muestra los candidatos. Repite con `--into <task>` para vincular el mensaje con esa tarea, o con `--new` para crear otra. Si solo coincide con una tarea cerrada en los últimos 14 días, `tasks add` la abre como seguimiento, enlazada `follow-up-of` a la cerrada. `tasks duplicates list` muestra los pares encontrados por las reglas y `tasks merge <task> --into <other>` los une:

```sh
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other --into <task>
```

```sh
tg personal tasks close <task> --as dismissed --reason no-reply-needed
```

Un agente de IA que cierra una tarea indica su certeza con `--certainty`, de 0 a 1. Por debajo del umbral del almacén (`task_agent_close_min`, 0.8 por defecto) la tarea sigue abierta con una sugerencia de cierre; `config set task_agent_close off` convierte cada cierre de un agente en una sugerencia. `tasks list close:suggested` las encuentra. Confirma una con `tasks close <task>` o recházala con `tasks reject <task>`:

```sh
tg personal tasks list close:suggested
```

```sh
tg personal tasks reject <task>
```

Ponle a una tarea un título, una fecha límite y una fecha para volver a mirarla, y vincúlale los
mensajes y chats a los que pertenece. La fecha de revisión es para ti o para tu agente; tg nunca le
recuerda nada a nadie:

```sh
tg personal tasks update <task> --title "Send Anna the contract" --due 2d --remind-time 1d
```

```sh
tg personal tasks link <task> msg:telegram/<you>/<chat>/<message> --chat "Hiking"
```

Mira lo que necesita atención hoy: tareas vencidas o que vencen pronto, chats donde alguien espera tu
respuesta y chats donde tú esperas la suya. Lee el archivo local, no el texto de los mensajes:

```sh
tg personal tasks agenda
```

`tasks agenda` y `tasks duplicates list` admiten campos de consulta:

- `tag:` y `category:` dejan las tareas con esa etiqueta o categoría: `tag:urgent`, `category:money`.
- `claimed:` dice de quién es una tarea: `none`, `mine`, `others` o `any`. Sin él, la agenda muestra las
  tareas que nadie tomó y las tuyas; `claimed:any` las muestra todas.
- `decision:` elige los pares de duplicados: `review`, el valor por defecto, espera al agente revisor, y
  `unsure` te espera a ti: `decision:unsure`.

```sh
tg personal tasks agenda category:money tag:urgent claimed:any
```

```sh
tg personal tasks duplicates list decision:unsure
```

`tg skill show follow-ups` muestra una rutina diaria para un agente de IA que redacta borradores de
respuesta a partir de esta lista y no envía nada.

Vea las tareas abiertas por chat, la más antigua y el tiempo medio para cerrar:

```sh
tg personal stats tasks show
```

Una tarea cerrada permanece cerrada y una tarea descartada nunca regresa. Solo sus propias respuestas cierran una tarea (las de un administrador no) y no se ve una mención de `@username`. Un agente conectado a través de MCP recibe los mismos comandos.

## Normas [#normas]

Las reglas de un grupo dicen qué busca `tg personal chats moderate` y qué puede hacer al respecto. Viven en un archivo de este perfil, nunca en Telegram, y nada vigila al grupo en segundo plano: una regla actúa sólo cuando ejecutas `chats moderate`.

Muestra las reglas. Hasta el primer cambio, son los valores predeterminados, marcados como no guardados:

```sh
tg personal chats rules show "Hiking"
```

Eliminar un mensaje que tiene un enlace:

```sh
tg personal chats rules set "Hiking" links delete
```

Bloquear a estas personas por id...

```sh
tg personal chats rules set "Hiking" blocked 12345,67890
```

…y eliminarlos cuando escriban o se unan:

```sh
tg personal chats rules set "Hiking" blockedPeople remove
```

Eliminar sin preguntarte primero:

```sh
tg personal chats rules set "Hiking" consent.delete allow
```

Vea lo que haría el cheque, sin hacerlo:

```sh
tg personal chats moderate "Hiking" --dry-run
```

Compruebe qué hay de nuevo desde la última ejecución y actúe:

```sh
tg personal chats moderate "Hiking"
```

| Regla | Predeterminado | Lo que busca |
|---|---|---|
| `links`, `invites`, `forwards` | `report` | un mensaje con un enlace, un enlace de invitación a otro grupo, un mensaje reenviado |
| `blocked`, `blockedNames` | — | personas por id, o por parte de su nombre, separados por comas |
| `blockedPeople` | `report` | qué hacer con un mensaje o unirse a una persona bloqueada |
| `flood.messages`, `flood.minutes`, `flood.action` | 5, 1, `report` | más que tantos mensajes de una persona en tantos minutos |
| `trusted` | — | personas sobre las que nunca se actúa; tampoco se actúa sobre administradores ni sobre ti |
| `consent.delete`, `consent.remove` | `ask` | hasta donde permites cada acción |

La acción de cada regla es `report`, `delete` o `remove`. Si ocurre un `delete` o un `remove` es el nivel del grupo, `consent.delete` y `consent.remove`: `deny` nunca, `readonly` solo informa, `ask` le pregunta sobre cada uno (el valor predeterminado; `--allow-dangerous` dice sí a todos), `allow` lo hace. Cada acción sigue pasando por el control de envío y su límite horario, y una ejecución se detiene después de `--max-actions` (10). La siguiente ejecución comienza donde se detuvo ésta; `--since-time` mira un momento propio y deja ese punto donde está.

Un agente conectado a través de MCP actúa únicamente cuando un nivel es `allow`; lo que pide aparece en la lista, no se hace. `newAccount` no se ofrece: Telegram no dice la antigüedad de una cuenta.

## Con un bot [#con-un-bot]

Si su bot es administrador del grupo, puede ejecutar la misma verificación: `tg <bot> bot chats moderate`. Una persona que el bot elimina no puede volver a través del enlace a menos que agregue `--no-block`. El bot solo juzga los mensajes que vio o importó en esta computadora, y no juzga las uniones. Consulte [moderar un grupo con un bot](/llms.mdx/docs/es/tg/bot/content.md#moderating-a-group-by-its-rules).

## Limitaciones [#limitaciones]

- **El historial de Telegram es el récord.** `chats events` y `review` ven lo que aún contiene el historial del chat; un mensaje de servicio que un administrador eliminó también desapareció para ellos.
- **Los administradores se conocen solo donde dice Telegram.** Sin ellos, `review --unanswered` cuenta solo tus respuestas y lo dice.
- **Nada vigila un grupo por sí solo.** Se ejecuta una verificación cuando usted, un agente a petición suya o su horario la ejecutan.
- **Se aplican límites de tarifas de Telegram.** Leer a cada miembro de un grupo grande representa muchas solicitudes; una respuesta `FLOOD_WAIT` dice cuánto tiempo esperar (ver [cuando Telegram pide esperar](/llms.mdx/docs/es/tg/troubleshooting/content.md#telegram-asks-to-wait-n-s-before-the-next-request)).

## Estadísticas para administradores de grupos [#estadísticas-para-administradores-de-grupos]

Consulta los mensajes, las personas que escribieron y las respuestas de la semana. Para saber quién responde, quién necesita ayuda y si los nuevos miembros se quedan, abre [Estadísticas](/llms.mdx/docs/es/tg/rankings/content.md).

**Tu petición:**

> Usa tg CLI. Muéstrame la actividad de Hiking esta semana y las lagunas del historial.

**Comando:**

```sh
tg personal stats chats show "Hiking" --since-time 7d --offline --json
```

**Ejemplo de respuesta del agente:**

> | Métrica | En el historial disponible |
> | --- | ---: |
> | Mensajes | 120 |
> | Personas que escribieron | 18 |
> | Respuestas | 30 |
>
> El historial está incompleto: estos son recuentos observados. Esta consulta local no descargó eventos de entrada o salida.

Sin `--offline`, el CLI también descarga eventos de entrada y salida. Las observaciones diarias de miembros guardadas siguen disponibles localmente. El primer informe no puede reconstruir listas de miembros anteriores.

### Estadísticas de Telegram [#estadísticas-de-telegram]

```sh
tg personal stats chats official <chat> --json
```

Telegram calcula estadísticas para los administradores de supergrupos y canales suficientemente grandes, las mismas de la pantalla Estadísticas de sus aplicaciones. `tg personal stats chats official` las consulta e imprime un objeto JSON. Telegram elige el periodo, indicado como `period`. Cada total incluye el valor del periodo anterior.

- Un supergrupo (`kind: "group"`) tiene miembros, mensajes, lectores y autores, los principales autores, administradores e invitadores, y 8 gráficos: crecimiento, miembros, nuevos miembros por origen, idiomas, mensajes, acciones, horas y días de la semana.
- Un canal (`kind: "channel"`) tiene seguidores, vistas, compartidos y reacciones por publicación y por historia, cuántos seguidores tienen notificaciones activadas, publicaciones recientes con sus recuentos y 12 gráficos.

Cada gráfico es una lista de series sobre sus valores `x`: `date` (un día, `YYYY-MM-DD`), `time` (ISO 8601) o `number`. Si Telegram no puede proporcionar un gráfico, aparece como `{ "error": ... }` y los demás siguen disponibles. El comando solo lee: no envía, marca como leído ni cambia nada. Se rechaza `--jsonl`.

Telegram responde solo para un chat donde te muestra estadísticas. En un grupo básico, un chat que no administras o uno demasiado pequeño, el comando falla con un error de permisos o validación. Una ejecución requiere unas 10 a 17 solicitudes: la ficha del chat, las estadísticas y cada gráfico que Telegram envía después. Indica el chat por `@username` o ID: un título se busca primero en tu lista de chats, lo que añade una solicitud por cada 100 chats. Telegram guarda las estadísticas en un servidor propio, así que la primera ejecución añade una clave de acceso para ese servidor al archivo de sesión; nunca se imprime.

### Instantáneas de miembros y cambios [#instantáneas-de-miembros-y-cambios]

`tg personal chats members fetch` lee los miembros al almacén local y registra perfiles, cambios, el recuento del día y si la lectura fue completa. `--max-pages` limita las páginas. Tras una lectura parcial no se registra a nadie como salido: eso exige leer toda la lista disponible y conocer un recuento del grupo no superior al número leído. Un presupuesto mayor no evita los límites de Telegram para las listas de miembros.

`--track` añade el grupo a la lista de seguimiento. `chats tracking list` muestra todos los grupos seguidos; `show` muestra el estado de uno y los recuentos diarios de los últimos 30 días. `add` inicia el seguimiento sin descargar de inmediato; `remove` detiene las descargas diarias y conserva el historial registrado. Mientras funciona `tg personal serve`, descarga los grupos uno a uno, inicia la primera ronda un minuto después de conectarse y omite los ya descargados en el día UTC actual. El seguimiento no inicia `serve`; si estuvo detenido varios días, la siguiente ejecución registra una instantánea nueva en lugar de rellenar los días perdidos.

`tg personal chats members history` muestra las entradas, salidas y cambios de perfil registrados, de más antiguo a más nuevo; una consulta como `time>=7d` limita el periodo. Nunca consulta Telegram. Una entrada usa la hora de Telegram si se conoce; si no, la primera vez que se vio a la persona. Una salida se fecha en la primera instantánea completa sin ella, no en el momento exacto de su marcha. La primera descarga registra la lista inicial: esas personas no necesariamente entraron ese día. `chats members list --offline` lee la última lista guardada completa; las lecturas parciales no la sustituyen. Sin una instantánea completa, esta lista puede estar vacía aunque ya se hayan registrado algunos perfiles y eventos. Los perfiles y el historial permanecen en el almacén local junto a los mensajes.

`tg personal chats members check` enumera miembros con señales de bot y sus motivos; `--max-pages` limita las páginas y una consulta como `score>=3` fija el umbral (`score>=2` si no se indica). No elimina a nadie y excluye a los administradores y al propietario. `meta.truncated` indica que no se leyeron todos los miembros. No funciona con `--offline`; las puntuaciones necesitan revisión humana. Telegram proporciona datos de bot, scam, fake, deleted, foto, entrada e invitador cuando están disponibles. «Nunca escribió» significa que no se encontraron mensajes en el historial local, no demuestra que esa persona nunca escribiera en el grupo.

`--deep <n>` comprueba también a los primeros n miembros en detalle, a uno por segundo: su perfil, su foto de perfil más antigua, hasta 1000 mensajes guardados de cada uno y dos listas públicas de spam, Combot CAS y lols.bot. Se envía el ID de cada miembro a esas listas. La comprobación completa aparece en `check` de cada miembro revisado.

### Un informe semanal de tu grupo [#un-informe-semanal-de-tu-grupo]

«Hiking Club» es un grupo ficticio de ejemplo. Descarga primero sus mensajes con `messages sync` si aún no están guardados; después registra la lista actual de miembros y prepara el informe:

```sh
tg personal chats members fetch "Hiking Club" --track --json
```

```sh
tg personal stats chats show "Hiking Club" --since-time 7d --by day --timezone Europe/Madrid --json
```

```sh
tg personal chats members history "Hiking Club" "time>=7d" --offline --json
```

```sh
tg personal chats tracking show "Hiking Club" --offline --json
```

```sh
tg personal chats members check "Hiking Club" --json
```

Pide al agente que incluya mensajes, remitentes activos, preguntas sin respuesta, cambios de miembros y días con instantáneas. Mantén visibles en el informe las entradas de `missing`, `meta.truncated` y los huecos entre instantáneas. Deja `tg personal serve` funcionando o repite las descargas de miembros para los informes siguientes; el primer informe no puede mostrar salidas anteriores a la primera lista registrada.
