Telegram: Administración
Telegram: Miembros, permisos administrativos, ajustes y revisión del spam.
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.
Comprobar grupo y permisos
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.
Preparar un plan de moderación
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.
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
tgguarda 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ó.
tgabre 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
| 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. Los detalles de cada comando se encuentran en grupos y canales en la guía de uso; cada opción está en la referencia de comando.
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; un agente en una aplicación sin terminal necesita el servidor MCP. 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
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:
tg personal review 'chat:Hiking' --unanswered 4h --jsonEjemplo 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 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
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:
tg personal chats events "Hiking" 'time>=7d' --jsonEjemplo 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
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:
tg personal chats links reset "Hiking" --jsonRestringir la incorporación de miembros:
tg personal chats update "Hiking" --only-admins-add on --jsonEjemplo 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
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:
tg personal chats moderate "Hiking" --dry-run --jsonEjemplo 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
Pide un resumen de decisiones, compromisos y preguntas pendientes.
Tu petición:
Usa tg CLI. Resume la semana en Hiking.
Comando:
tg personal review 'chat:Hiking date>7d' --jsonEjemplo 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
No necesitas un agente para obtener las preguntas pendientes: basta con ejecutar el comando.
0 9,21 * * * tg personal review 'chat:Hiking' --unanswered --json >> ~/hiking-open.jsonl 2>> ~/tg-cron.logcron no tiene terminal y, a menudo, no tiene XDG_RUNTIME_DIR, sin el cual tg no puede acceder al llavero: consulte ejecución programada.
Funciones disponibles
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 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).
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:
tg personal tags add --chat <group> watch-tasks
tg personal tags remove --chat <group> watch-tasksEn 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:
tg personal tasks scan <chat>
tg personal tasks scan <chat> --last 300 --yesconfig 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:
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:
tg personal tasks list state:opentg 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:
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category othertasks 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:
{
"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:
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other --into <task>tg personal tasks close <task> --as dismissed --reason no-reply-neededUn 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>:
tg personal tasks list close:suggestedtg 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:
tg personal tasks update <task> --title "Send Anna the contract" --due 2d --remind-time 1dtg 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:
tg personal tasks agendatasks agenda y tasks duplicates list admiten campos de consulta:
tag:ycategory:dejan las tareas con esa etiqueta o categoría:tag:urgent,category:money.claimed:dice de quién es una tarea:none,mine,othersoany. Sin él, la agenda muestra las tareas que nadie tomó y las tuyas;claimed:anylas muestra todas.decision:elige los pares de duplicados:review, el valor por defecto, espera al agente revisor, yunsurete espera a ti:decision:unsure.
tg personal tasks agenda category:money tag:urgent claimed:anytg personal tasks duplicates list decision:unsuretg 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:
tg personal stats tasks showUna 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
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:
tg personal chats rules show "Hiking"Eliminar un mensaje que tiene un enlace:
tg personal chats rules set "Hiking" links deleteBloquear a estas personas por id...
tg personal chats rules set "Hiking" blocked 12345,67890…y eliminarlos cuando escriban o se unan:
tg personal chats rules set "Hiking" blockedPeople removeEliminar sin preguntarte primero:
tg personal chats rules set "Hiking" consent.delete allowVea lo que haría el cheque, sin hacerlo:
tg personal chats moderate "Hiking" --dry-runCompruebe qué hay de nuevo desde la última ejecución y actúe:
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
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.
Limitaciones
- El historial de Telegram es el récord.
chats eventsyreviewven 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 --unansweredcuenta 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_WAITdice cuánto tiempo esperar (ver cuando Telegram pide esperar).
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.
Tu petición:
Usa tg CLI. Muéstrame la actividad de Hiking esta semana y las lagunas del historial.
Comando:
tg personal stats chats show "Hiking" --since-time 7d --offline --jsonEjemplo 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
tg personal stats chats official <chat> --jsonTelegram 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
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
«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:
tg personal chats members fetch "Hiking Club" --track --jsontg personal stats chats show "Hiking Club" --since-time 7d --by day --timezone Europe/Madrid --jsontg personal chats members history "Hiking Club" "time>=7d" --offline --jsontg personal chats tracking show "Hiking Club" --offline --jsontg personal chats members check "Hiking Club" --jsonPide 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.