TgWitness / Documentación

Lo que se ha probado →

Algunas partes de esta página siguen estando en inglés: el original en inglés se modificó tras su traducción.

Referencia / Recopilar

Telegram · Cómo funciona la recopilación

Ámbito de observación, actualizaciones en tiempo real, verificaciones cruzadas, archivos adjuntos, acciones propias y qué significa una laguna, registro por registro.

TgWitness / Documentación · Colección

Recopilación

TgWitness registra lo que observa una cuenta de Telegram conectada. La supervisión en tiempo real conserva los mensajes, las ediciones capturadas, las notificaciones de eliminación y los archivos adjuntos con sus horas de observación y el contexto de origen. Las lecturas del historial, las revisiones y los registros disponibles del registro de administración añaden observaciones identificadas por separado a dicho registro.

En esta página

Desde el inicio de sesión hasta el registro#

Para fotos y archivos autodestructibles, véase «Medios autodestructibles». En él se explican el priority worker, los resultados guardados y no disponibles, y los límites del bloqueo de los acuses de lectura en el recopilador de la API.

Diagrama de flujoAutorizar una cuenta de usuario → Seleccione grupos y canales accesibles; Seleccione grupos y canales accesibles → Guardar la configuración de eventos y archivos adjuntos; Guardar la configuración de eventos y archivos adjuntos → Iniciar la observación; Iniciar la observación → Reciba actualizaciones del cliente activo; Reciba actualizaciones del cliente activo → Aplicar la política de fuentes y eventos; Aplicar la política de fuentes y eventos → Añada una observación firmada; Añada una observación firmada → Revisar o exportar el registro; Añada una observación firmada → Procesar cualquier archivo adjunto en cola; Procesar cualquier archivo adjunto en cola → Añada el resultado de la descargaAutorizar una cuentade usuarioSeleccione grupos ycanales accesiblesGuardar laconfiguración deeventos y archivosadjuntosIniciar la observaciónReciba actualizacionesdel cliente activoAplicar la política defuentes y eventosAñada una observaciónfirmadaRevisar o exportar elregistroProcesar cualquierarchivo adjunto encolaAñada el resultado dela descarga
Diagrama en formato de texto
  1. Autorizar una cuenta de usuario → Seleccione grupos y canales accesibles
  2. Seleccione grupos y canales accesibles → Guardar la configuración de eventos y archivos adjuntos
  3. Guardar la configuración de eventos y archivos adjuntos → Iniciar la observación
  4. Iniciar la observación → Reciba actualizaciones del cliente activo
  5. Reciba actualizaciones del cliente activo → Aplicar la política de fuentes y eventos
  6. Aplicar la política de fuentes y eventos → Añada una observación firmada
  7. Añada una observación firmada → Revisar o exportar el registro
  8. Añada una observación firmada → Procesar cualquier archivo adjunto en cola
  9. Procesar cualquier archivo adjunto en cola → Añada el resultado de la descarga

La autorización, el acceso a una fuente, un recopilador en funcionamiento y la entrega completa son cuestiones distintas. Un inicio de sesión correcto no concede acceso a todos los grupos. La entrega se realiza un seguimiento por separado: los registros de cobertura, la recuperación de lagunas de actualización y las revisiones muestran lo que ha llegado.

Ámbito de observación: chats seleccionados, una carpeta o toda la cuenta#

Más herramientas → Fuentes → El ámbito determina qué chats registra un espacio de trabajo.

La nueva configuración comienza con Elegir chats. Se conservan las opciones guardadas anteriormente. Si se selecciona Todos los chats en el asistente de configuración, se solicita una confirmación cuando la lista cargada contiene más de 50 chats; la estimación del tamaño sigue siendo una operación independiente basada en una muestra.

Modo Registros Nuevos chats
Chats seleccionados (por defecto) Solo los chats que añada manualmente Nunca se añade automáticamente
Carpeta de Telegram Chats en una de las carpetas de la cuenta: chats incluidos por nombre, más las categorías de la carpeta (contactos, no contactos, grupos, canales, bots), menos los chats excluidos y, si así lo indica la carpeta, los chats archivados Los chats correspondientes se añaden tan pronto como se activan; los chats que añada a la carpeta en Telegram se recogen en el plazo de una hora.
Cuenta completa Todas las conversaciones que recibe la cuenta Cada nuevo chat, grupo, chat privado o bot se añade en el momento en que se produce su primera actualización.
  • Los tipos de fuente (canales, grupos, chats privados, bots) limitan los modos de carpeta y de cuenta completa. Los chats seleccionados pueden ser de cualquier tipo, incluidos los chats privados y los bots; los tipos de fuente nunca bloquean un chat que hayas añadido manualmente. Si se desactiva un tipo, se establece una exclusión o se cambia a «chats seleccionados», las fuentes añadidas automáticamente se detienen en cuanto se guarda el cambio, antes de que se recalcule la lista de fuentes y también cuando no se pueda acceder a Telegram: sus nuevos mensajes, el historial de mensajes, el historial de nuevos chats, la configuración de los contactos y las observaciones del perfil.
  • Los chats que añadas manualmente permanecen registrados en los modos «carpeta» y «toda la cuenta» incluso cuando se encuentren fuera de la carpeta; solo las opciones Excluir, Eliminar o una pausa los detienen. Los chats que se añaden (automáticamente) siguen la carpeta: aquellos que salgan de ella se pondrán en pausa en el siguiente recálculo.
  • Los chats excluidos nunca se graban, en ningún modo. En los modos «Carpeta» y «Toda la cuenta», las opciones Excluir y Eliminar en una fuente lo añaden a esta lista, por lo que el filtro no lo vuelve a incluir. Si vuelves a seleccionar el chat manualmente (en «Fuentes», desde «Chats» o en «Configuración» → ¿Qué chats?), se elimina de la lista. La lista tiene capacidad para un máximo de 5.000 chats; si se supera ese límite, no se permite la opción Eliminar y, en su lugar, se puede pausar el chat.
  • Acciones propias (activadas por defecto): los mensajes que envía esta cuenta, sus modificaciones y las pulsaciones del botón del teclado de respuesta. Si se desactiva, se omiten los mensajes salientes y las modificaciones.
  • Al cambiar a una carpeta o a toda la cuenta, se solicita confirmación: estos modos graban chats privados y mensajes de terceros, y solo deben utilizarse en una cuenta específica. La confirmación y cada cambio de ámbito se registran en registros scope.changed. En una cuenta configurada como principal, el formulario de ámbito y la función «Investigación» rechazan una carpeta o toda la cuenta, al igual que lo hace «Inicio»; solo se puede realizar una copia única sin grabación.
  • Los chats añadidos por el ámbito aparecen como fuentes marcadas como auto, registradas como scope.applied (al inicio y cada hora) o source.discovered (un nuevo chat durante la observación). Al volver a los chats seleccionados, se pausan todas las fuentes añadidas automáticamente a la vez, sin volver a leer la lista de chats de la cuenta. Un chat excluido deja de registrarse tan pronto como se guarda el ámbito, y su fuente se pausa incluso cuando Telegram no devuelve la lista de chats. Durante la observación, al guardar el ámbito este se vuelve a aplicar, incluso si los valores no han cambiado.

Ámbito de aplicación de estos modos:

  • Los Secret Chats utilizan la integración Pseudo-secret incluida, con un módulo de protocolo instalado desde el panel y un interruptor de activación por cuenta. El historial en la nube y «Takeout» utilizan una ruta de adquisición independiente.
  • Períodos sin conexión. Tras un reinicio, TgWitness reanuda la posición de actualización guardada, solicita a Telegram las actualizaciones perdidas y vuelve a comprobar los chats. Telegram mantiene un historial limitado, por lo que tras una interrupción prolongada, los informes y verify.py indican el intervalo restante como una laguna (véase cobertura).
  • Al inicio solo se muestran los primeros 1,000 diálogos (el límite se encuentra en Más herramientas → Parámetros); los chats más antiguos se añaden cuando vuelven a estar activos. No se recupera el historial anterior de un chat añadido; realiza una instantánea del historial o una exportación completa del chat cuando lo necesites.
  • No se aplican las condiciones de las carpetas que cambian constantemente (silenciadas, leídas): dichos chats siguen siendo objeto de observación.
  • Los botones del bot integrados (de devolución de llamada) pulsados en otra aplicación son invisibles para una segunda sesión; se registra la respuesta o la edición del bot. Las pulsaciones del teclado de respuesta llegan como mensajes salientes y se etiquetan como button_press.
  • Un mayor número de chats implica un mayor número de solicitudes. Telegram restringe las cuentas cuyo volumen considera excesivo, lo que constituye una razón más para utilizar cuentas específicas.

Chats seleccionados de forma rigurosa#

Estricto: solo los chats seleccionados aparecen en Chats seleccionados y está desactivado por defecto. Está pensado para un permiso que abarca únicamente los chats seleccionados. Cuando está activado:

  • No se leen las notificaciones del servicio de Telegram (777000): ni cuando comienza o finaliza la observación, ni cada minuto durante la observación. No se registran datos en session.security_baseline ni en account.security_event.
  • The account's session list is not read: not when observation starts or stops (the panel's question about other sessions for Evidence for a case and the evidence protection modes is skipped too), not every two minutes while observing, not when a connection opens, and not by the connection check, whose Current authorization entry is shown as skipped. The two-step verification status used by the takeover check is not read either. So account.sessions, session.concurrent_at_start and session.takeover_risk are not written, and a session ended from another device is not reported as session_revoked_externally.
  • While this is the only session of the account (Make this the only session or its automatic version), the session list is still read every two minutes while observing and when a connection opens, so that session.exclusive_ended is recorded when another session appears. 777000 stays unread in that period, although the session.exclusive_from record says Telegram's sign-in notices keep being recorded.
  • Los avisos de eliminación se comparan con una comprobación de sesión solo si se ha ejecutado una en los últimos 10 minutos (siempre que sea la única sesión, o tras abrir las sesiones de esta cuenta). De lo contrario, a menos que la última comprobación de derechos indique que esta cuenta no pudo eliminar el mensaje (lo cual nunca ocurre en chats privados ni en grupos normales), se muestra el siguiente mensaje: Se desconoce quién lo ha eliminado: también podría haberlo eliminado la propia cuenta, desde otra sesión o desde otro dispositivo.
  • Con una clave de sesión importada, en el registro no aparece la hora a la que se inició sesión hasta que se lee la lista de sesiones (por ejemplo, en Sesiones de esta cuenta). Hasta entonces, las exportaciones de chat y las exportaciones automáticas de cuentas utilizan la sesión habitual en lugar de Takeout, con el motivo session_age_unknown.
  • Al activar un chat no se leen los mensajes anteriores. Sin este ajuste, cada chat que se active (en «Fuentes», en «Chats», ya sea al unirse desde el panel o en el asistente de configuración) obtiene una instantánea de baseline de sus mensajes más recientes, hasta el número establecido en Más herramientas → Parámetros → Instantánea de historial más grande (500 por defecto), cuando se ejecute la siguiente observación. Cualquier instantánea pendiente que venza mientras el interruptor esté activado se descarta. Un chat al que se acceda desde el panel tampoco tiene sus mensajes más recientes leídos como si fuera un chat nuevo (el recuento Cuando aparece un nuevo chat o bot, 100 por defecto), y al abrir un chat seleccionado sin mensajes guardados en «Chats» no se cargan por sí solos sus últimos 100 mensajes. El historial y las instantáneas que cargues tú mismo siguen mostrando el historial.
  • La configuración de contenido sensible de la cuenta no se lee ni se modifica. Sin el interruptor, al iniciar sesión y en cada nueva conexión, esta opción se activa cuando está desactivada y Telegram permite el cambio (account.content_settings); la configuración pertenece a la cuenta y se aplica en todas las aplicaciones de Telegram. El contenido que Telegram marca como sensible puede permanecer oculto.
  • Las actualizaciones relacionadas con llamadas telefónicas no se registran como account.phone_call.
  • Al detener la observación, solo se escribe la huella digital de la clave de sesión; no se lee la lista de sesiones ni el 777000.

No limita lo que envía Telegram: las actualizaciones de todos los chats siguen llegando a esta sesión, y solo se graban los chats seleccionados. La lista de chats de la cuenta (hasta los «Chats leídos» de la lista de la cuenta) y sus carpetas se siguen leyendo al inicio, y de nuevo cuando se guarda el ámbito durante la observación, para localizar los chats seleccionados. Los avisos de eliminación sin chat (`deletion.unscoped`) siguen registrándose: solo contienen ID de mensajes y pueden pertenecer a un chat privado seleccionado o a un grupo normal. La comprobación de cuentas congeladas (help.getAppConfig), las demás comprobaciones de conexión y las funciones que actives tú mismo (finalización automática de otras sesiones, la sonda de testigo, chats pseudo-secretos, «Sesiones de esta cuenta» y la lista de Telegram de dispositivos conectados en «Más testigos, que lee la lista de sesiones cada vez que pasa una marca de tiempo y cuya configuración cumple los objetivos de «Seguir chats» y «Pruebas para un caso») siguen funcionando.

Actívalo antes de iniciar sesión; de lo contrario, el propio proceso de inicio de sesión comprueba la autorización actual y activa el contenido sensible. Cada cambio se registra en un registro firmado de scope.changed, y observation.started contiene el valor como scope.strict. Al cambiar a una carpeta o a toda la cuenta, se desactiva.

Ámbito de aplicación y selección de eventos#

Cada espacio de trabajo tiene sus propias fuentes. TgWitnessno se une a grupos, no acepta invitaciones ni enumera a todos los miembros automáticamente. Las fuentes deben estar ya accesibles para la cuenta. Al iniciarse, el recopilador comprueba las fuentes seleccionadas con los diálogos visibles de la cuenta; se inspeccionan los primeros 1,000 diálogos, a menos que Más herramientas → Parámetros → Chats leídos de la lista de la cuenta indique lo contrario. Una fuente ausente se marca como acceso no confirmado; no se da por hecho que te haya eliminado.

Configuración Recopila Efecto cuando está desactivado
Nuevos mensajes Mensajes entregados normales Es posible que las modificaciones o eliminaciones posteriores no tengan texto capturado anteriormente con el que compararlas.
Modificaciones Versiones editadas de los mensajes entregadas Los cambios intermedios no se reconstruyen posteriormente.
Eliminaciones Notificaciones de eliminación con alcance específico y notificaciones a nivel de cuenta sin alcance específico Las notificaciones de eliminación no se añaden al registro.
Reacciones Instantáneas de las reacciones recabadas No se añaden actualizaciones de reacciones por separado.
Afiliación Se han enviado mensajes de servicio a los miembros y actualizaciones a los participantes No se incluyen las observaciones de los miembros.

La configuración se aplica a todas las fuentes seleccionadas en el espacio de trabajo. Guarde el formulario para aplicar los cambios; estos se registran con valores firmados «antes» y «después». Desactivar una categoría no elimina los registros anteriores. Volver a activarla no recupera las actualizaciones perdidas.

Los registros operativos y otros eventos del servicio de grupo permanecen independientes de estos ajustes. Los mensajes de servicio relacionados con la afiliación pueden generar registros de mensajes cuando la afiliación está habilitada, incluso si la captura habitual de nuevos mensajes está desactivada. Los objetos de Telegram capturados conservan los metadatos incrustados; un ajuste no es una regla de censura.

Las eliminaciones en chats privados y grupos normales llegan como ID de mensajes sin un chat asociado. Estos chats comparten una secuencia de ID de mensajes para toda la cuenta, por lo que cuando un mensaje con ese ID se guardó anteriormente, se conoce su chat: la eliminación se registra en ese chat con el chat_resolution, que explica cómo. Los ID que nunca se guardaron permanecen como una eliminación sin ámbito con un chat explícito sin resolver. Se trata de notificaciones de eliminación de Telegram, que se conservan incluso cuando su chat aún no se puede correlacionar. El esquema de la notificación contiene identificadores; el diario añade la hora de recepción y cualquier contexto del mensaje guardado, incluido deleted_message_was_outgoing. Las entradas disponibles del registro de administración proporcionan una fuente independiente de la acción, el autor y la hora de origen.

Acciones propias#

Los mensajes enviados por la cuenta observada se etiquetan como outgoing. Una modificación de un mensaje saliente indica que, en los chats privados y los grupos, solo su autor puede modificarlo, mientras que las publicaciones en canales pueden ser modificadas por otros administradores. Cuando un mensaje saliente repite el texto de un botón del teclado de respuesta guardado más reciente en ese chat, lleva la etiqueta «button_press» con un enlace al registro de dicho teclado.

La exclusión de las acciones propias también se aplica a las revisiones de antecedentes y al historial automático de nuevos chats. Los mensajes salientes omitidos adelantan la posición de revisión, de modo que no puedan bloquear los mensajes entrantes posteriores. Las acciones explícitas en el panel y las instantáneas del historial solicitadas manualmente siguen quedando registradas.

Modo de investigación: unirse a grupos y comunicarse con bots#

Más herramientas → Fuentes → Ámbito → El modo de investigación prepara el ámbito para una cuenta dedicada que se une a chats de equipo, inicia bots y escribe en ellos: toda la cuenta, cada tipo de fuente, las acciones propias y, para cada chat o bot que aparezca, su perfil y sus últimos 200 mensajes visibles. Revisa el formulario y pulsa Guardar ámbito; el cambio a toda la cuenta requiere la confirmación habitual.

  • Botones. Los botones que aparecen debajo de un mensaje se conservan junto a él y se muestran en «Chats»: enlaces, aplicaciones web, enlaces de inicio de sesión, textos para copiar, datos de devolución de llamada, consultas en línea, solicitudes de un número de teléfono o una ubicación. Los enlaces se muestran como texto y el panel nunca los abre. Cuando un bot solo modifica los botones (por ejemplo, un nuevo enlace de pago), se considera una nueva versión del mensaje, tanto en las actualizaciones en tiempo real como en las revisiones posteriores.
  • Nuevos chats y bots. En los modos «por carpeta» y «cuenta completa», cuando aparece un nuevo chat o bot, se guarda inmediatamente después de su aparición:

    • su perfil como registro source.profile: descripción del bot y comandos, el texto de «Acerca de» de un usuario, grupo o canal, miembros, chat vinculado y enlace de invitación cuando Telegram lo proporcione;
    • sus últimos mensajes visibles (hasta 1.000) como una instantánea del historial marcada con new_chat: los mensajes anteriores de un chat de grupo al que acaba de unirse, o lo que dijo un bot antes de que la observación detectara el chat. Los mensajes ya guardados en tiempo real no se repiten.

    Los chats recién seleccionados utilizan esta configuración cuando se aplica el ámbito, incluidos los chats que ya figuran en la lista de diálogos de la cuenta. La carga inicial del perfil y del historial se ejecuta en hasta tres chats simultáneamente; las tareas correspondientes a un mismo chat se mantienen en orden. Cada etapa del historial o del perfil utiliza el tiempo de espera de operación configurado, por lo que las solicitudes bloqueadas liberan su proceso de trabajo. El historial se guarda antes de la lectura opcional del perfil; un error en el perfil no impide dicha captura del historial. Las etapas fallidas se reintentan tras 5 segundos, duplicando el tiempo hasta un máximo de 5 minutos sin ocupar a ningún trabajador durante el retraso. Los ID pendientes, los plazos de reintento y las etapas completadas se guardan localmente. Al reiniciar, solo se reanudan las etapas no finalizadas; un reintento del perfil no repite una lectura del historial ya completada. Las fuentes desactivadas antes de su turno se omiten. La vista general muestra las cargas de chat activas, pendientes y en proceso de reintento por separado de las descargas de archivos adjuntos. Un FloodWait pausa este trabajo y se reanuda posteriormente; los fallos se registran y la grabación en directo del chat continúa. Esto incluye las esperas mientras se resuelve la identidad del nuevo chat: la tarea pendiente del perfil o del historial se conserva para volver a intentarla, y una espera más prolongada ya existente a nivel de cuenta no se acorta. Los trabajadores comparten esta espera; la concurrencia no elude los límites de solicitudes de Telegram. - Perfiles bajo petición. Chats → Perfil → Guardar perfil ahora guarda el perfil actual de cualquier fuente; el más reciente se muestra encima de los mensajes. - Instantáneas del estado del chat (vista previa). El estado fuera del flujo de mensajes cambia sin que haya un mensaje: al desanclar todos los mensajes no queda ningún rastro a nivel de mensaje, un administrador pierde sus derechos, un regalo se oculta, se convierte, se actualiza o se reembolsa. Durante la observación, cada fuente habilitada se lee periódicamente y se guarda como un registro firmado chat.state : título, nombres de usuario, descripción, recuento de miembros y administradores, chat vinculado, modo lento, ID de mensajes fijados (hasta 100), administradores con sus derechos y títulos, y regalos mostrados en los canales y perfiles de usuario (hasta 100). Cada registro enumera las diferencias con respecto a la instantánea anterior: campos modificados con el estado anterior y posterior, mensajes fijados añadidos o eliminados, administradores y regalos añadidos, modificados o que ya no aparecen en la lista. - La parte que Telegram rechaza (por ejemplo, la lista de administradores de un canal para un miembro que no es administrador) se indica en errors; su valor anterior se conserva y aparece en carried_forward, sin que se indique nunca que se ha eliminado. - Un registro cuyos únicos cambios sean recuentos, y una comprobación que no haya detectado ningún cambio, hace referencia al último estado completo con state_seq y acumulativo state_overrides. Se guarda un estado completo al menos cada siete días y siempre que cambie algo que no sea un recuento. - parts_complete marca las listas con límite. Las adiciones requieren una lista anterior completa, las eliminaciones requieren una lista actual completa, y los valores vacíos explícitos registran el borrado. - Más herramientas → Parámetros → Estado del chat permite configurar el intervalo (12 horas por defecto; 0 desactiva las instantáneas ), la pausa entre fuentes, qué partes se leen y si se registran las comprobaciones que no han detectado ningún cambio. FLOOD_WAIT y FLOOD_PREMIUM_WAIT detiene las restantes solicitudes de instantáneas, conserva cualquier plazo más largo a nivel de cuenta y deja el chat interrumpido apto para otro intento tras esa espera. - No visible. Los botones en línea (de devolución de llamada) pulsados en otra aplicación de Telegram, la ventana emergente o el enlace con el que un bot responde a dicha pulsación, y los enlaces de invitación utilizados en otra aplicación no llegan a TgWitness. Lo que el bot envía o edita posteriormente sí se registra.

Actuación desde el panel#

La sección «Chats» incluye ahora un minicliente que utiliza la cuenta de Telegram del espacio de trabajo seleccionado:

  • Escriba un mensaje de texto sin formato o seleccione «Responder» debajo de un mensaje guardado. El mensaje saliente resultante se registra incluso cuando el ámbito de aplicación excluye las actualizaciones salientes.
  • Pulse el botón «Pulsar» situado debajo de un botón de respuesta o de texto actual. El servidor vuelve a recuperar el mensaje y rechaza la acción si el texto difiere de la versión guardada. Los acuses de recibo conservan el texto emergente de Telegram, el indicador de alerta y la URL; la respuesta también se muestra debajo de la conversación. Las URL siguen siendo texto seleccionable y no se abren automáticamente.
  • Pulsa + → Abrir enlace de Telegram, introduce @username, un enlace público https://t.me/name, https://t.me/+invite / joinchat/invite o un enlace de bot con ?start=parameter, y pulsa Guardar vista previa. El enlace original y la vista previa de Telegram se firman antes de unirse. Al unirte o abrir el enlace, se observa que, al unirte al grupo o canal, o al abrir el usuario o el bot, se añade el chat como fuente habilitada y se envía /start al bot, incluyendo su parámetro de inicio. Una solicitud de unión que esté pendiente de la aprobación del administrador se registra como «pendiente», no como «miembro».

Activa Iniciar observación para capturar las respuestas entrantes en tiempo real. Las acciones del panel funcionan mientras la observación está en pausa; a continuación, el panel guarda sus respuestas directas y la observación en tiempo real captura el resto de la conversación. Las fuentes recién añadidas utilizan la configuración de perfil/historial cuando la observación está en marcha. Cuando una fuente esté en pausa, actívala en Más herramientas → Fuentes antes de enviar o pulsar sus botones.

interaction.preview, interaction.requested y interaction.result son eventos habituales del registro firmados que se incluyen en las exportaciones de pruebas. Las solicitudes identifican la cuenta, el mensaje o el botón o el registro de vista previa, así como si la observación estaba en ejecución. Los acuses de recibo distinguen entre éxito, rechazo, aprobación pendiente y un resultado desconocido. Es posible que una solicitud interrumpida haya llegado a Telegram: compruebe el chat antes de iniciar una nueva acción. La reutilización de un ID de solicitud recupera su confirmación guardada sin repetir la acción, incluso tras un reinicio. El panel conserva el ID tras una respuesta ambigua para la misma acción durante la sesión de la página actual. También conserva ese ID cuando falla la actualización de la vista tras una acción realizada con éxito: la confirmación permanece visible, y al hacer clic de nuevo se recupera. Las RPC de devolución de llamada y de incorporación tienen un único intento de aplicación; las lecturas reintentables mantienen su política de reintentos configurada. Al cambiar de chat, se borran inmediatamente el borrador y el destinatario de la respuesta, y se desactiva el envío hasta que se cargue la nueva conversación.

Este minicliente gestiona los botones de texto y de devolución de llamada. Los botones de miniaplicaciones muestran la opción Abrir miniaplicación, que ejecuta la aplicación en un navegador aislado (miniaplicaciones). Las solicitudes de inicio de sesión, de número de teléfono y de ubicación, los pagos, las consultas en línea y los archivos adjuntos siguen requiriendo un cliente de Telegram; los metadatos guardados de los botones siguen siendo visibles. Los nuevos controles utilizan texto en inglés.

Niveles de verificación#

Las revisiones vuelven a solicitar a Telegram los mensajes perdidos, las ediciones y los mensajes que ya no devuelve. Las fuentes marcadas con un asterisco son fuentes prioritarias, que se revisan cada 15 minutos por defecto; el resto de fuentes, cada 6 horas. Los chats seleccionados comienzan como fuentes prioritarias, mientras que los chats añadidos mediante una carpeta o la cuenta completa se consideran fuentes normales. Se vuelven a comprobar un máximo de 30 fuentes por pasada y el resto espera al minuto siguiente; tras una reconexión, las fuentes prioritarias tienen prioridad. Ambos intervalos se configuran en Más herramientas → Fuentes → Grabación → Revisión (0 desactiva un nivel) y se registran como recheck.changed.

Los mensajes perdidos se recuperan a partir del punto donde se detuvo la pasada anterior, hasta un máximo de Más herramientas → Parámetros → Mensajes perdidos recuperados por chat y pasada (1,000 por defecto). Tras una parada prolongada, la revisión vuelve a cubrir todo el intervalo, incluso cuando se guardaron primero mensajes en tiempo real más recientes que dicho intervalo . Un chat que aún se está poniendo al día se vuelve a revisar al minuto siguiente, en lugar de esperar a su intervalo de nivel; recheck.completed muestra continues_after hasta que finaliza.

Las comparaciones incluyen el texto de los mensajes, las entidades, los teclados (incluida su eliminación) y el contenido o la identidad de los archivos adjuntos. El mero hecho de modificar los hash de acceso a los archivos o las referencias a los mismos no constituye una modificación, ni tampoco lo que Telegram rellena por sí mismo: la carga de una vista previa de un enlace, las visualizaciones de historias, los contenidos multimedia de pago desbloqueados por esta cuenta o la recepción de una factura. Cada versión guardada en «Chats» enlaza con su registro completo en el diario, incluidos los metadatos multimedia.

Historial de mensajes y atribución#

Supongamos que el recopilador observa «Reunión a las 10:00», posteriormente ve «Reunión a las 11:00» y, a continuación, recibe un aviso de eliminación. Se añaden tres observaciones distintas: el texto original se conserva, la modificación constituye una versión separada y el aviso registra que se ha observado una eliminación.

Si la recopilación comenzó después de que desapareciera la primera versión, dicho texto no estará disponible. Si se produjeron varias modificaciones mientras el proceso estaba fuera de línea, solo se podrán guardar las versiones observadas posteriormente. Un aviso de eliminación no permite recuperar contenido que nunca se haya capturado.

El registro combina varias fuentes:

Fuente Información conservada
Mensaje en directo o actualización de edición ID del mensaje, metadatos del remitente, versión capturada, hora de recepción y fecha de envío o edición del mensaje de Telegram.
Notificación de eliminación en tiempo real Se incluyen los ID de los mensajes notificados, la hora de recepción, la notificación sin procesar y los enlaces a contenido guardado previamente.
Registro de administración disponible Acción, actor, fecha de origen y contenido del mensaje proporcionado, leídos por una cuenta con los derechos necesarios.
Interacción con el panel La acción solicitada y su resultado registrado en la cuenta seleccionada.
Vuelva a comprobarlo Respuesta actual de Telegram comparada con el mensaje guardado anteriormente.

observed_at es la hora en la que se escribió el registro en el reloj del colector y aumenta con seq. Los registros escritos durante el procesamiento de una actualización en tiempo real también incluyen received_at, el momento en que la actualización llegó al colector, y processing_delay_ms, el tiempo transcurrido desde la recepción hasta el registro; las actualizaciones retenidas mientras comienza la observación se procesan por orden de llegada antes que las posteriores. source_at Conserva una fecha de origen cuando dicho evento la proporciona. Las observaciones de desfase del reloj de los telegramas, los registros de discontinuidad del reloj y las comprobaciones de tiempo externas proporcionan el contexto temporal asociado. Los campos de una notificación de mensaje ordinaria describen dicha notificación; los registros del registro de administración y de interacción conservan su propia atribución.

Instantáneas del historial#

Una instantánea solicita los últimos mensajes visibles de una fuente habilitada, hasta 500 por solicitud. Los resultados se etiquetan como «observaciones del historial». Las instantáneas manuales se ejecutan junto con las observaciones. Las observaciones repetidas se guardan como registros independientes. Al activar una fuente, también se toma una instantánea debaseline, a menos que esté activada la opción chats seleccionados estrictamente.

Las capturas se detienen si la fuente se desactiva durante la lectura. Las respuestas deben pertenecer al chat solicitado y contener ID de mensajes positivos estrictamente decrecientes por debajo del límite solicitado. Una respuesta no válida interrumpe la captura antes de que se guarde ese mensaje; los mensajes ya conservados permanecen en el diario firmado junto con el registro de la interrupción.

Las capturas de pantalla se ajustan a la política de archivos adjuntos, pero permanecen separadas de los cambios en tiempo real. No reconstruyen los mensajes eliminados ni las versiones intermedias perdidas. Puede solicitar una mientras la herramienta está en pausa; cualquier archivo adjunto que se haya puesto en cola esperará hasta que comience la observación y se ejecute el proceso de descarga.

La ejecución de Historial es una tarea exclusiva e independiente: lee las fuentes seleccionadas y descarga sus adjuntos en cola secuencialmente, sin iniciar la supervisión. Pausar libera la cuenta; reanudar continúa la ejecución guardada. Para filtrar por fechas, idioma y respuestas entre varias cuentas libres, consulta Exportación distribuida de chats.

Gestión de archivos adjuntos#

La descarga de archivos adjuntos está activada por defecto y se detiene cuando queda menos de 1 GiB de espacio libre en disco. El recopilador realiza simultáneamente la observación de los mensajes y la tarea de descarga. La tarea conserva el descriptor multimedia original y la política de tamaño, por lo que un archivo adjunto editado posteriormente no se sustituye de forma silenciosa.

Las descargas se ejecutan tras la captura de mensajes. Una descarga completada crea un registro media.saved con su SHA-256 y el recuento de bytes. Las operaciones omitidas, fallidas, reintentadas e interrumpidas tienen resultados distintos; un archivo se considera conservado cuando existe su registro media.saved . El archivo completado también debe coincidir con el recuento de bytes del descriptor del archivo adjunto observado original. Una respuesta corta o inesperadamente larga no se registra como contenido multimedia conservado.

El archivo y su entrada en la carpeta se guardan en el disco antes de que se escriba media.saved. Cuando el proceso del colector anterior finalizó sin una parada ordenada, el siguiente inicio lee todos los archivos registrados como guardados durante esa ejecución. Un archivo que falte o cuyos bytes difieran del SHA-256 registrado recibe un registro media.missing_after_restart, su descarga se vuelve a poner en cola y los bytes que difieren se trasladan a media-damaged/. Los archivos trasladados a un almacenamiento externo no se leen.

Dentro de un mismo espacio de trabajo, los trabajos en cola simultáneos para la misma representación de un archivo adjunto esperan a que finalice la transferencia activa y, a continuación, vuelven a comprobar los bytes guardados antes de reutilizarlos. Cada trabajo conserva su propio resultado con signo y una referencia al registro del archivo guardado anteriormente. La cancelación de un trabajo en espera no cancela la transferencia activa; si dicha transferencia falla o se cancela, el siguiente trabajo puede volver a intentarlo. Se pueden descargar simultáneamente diferentes archivos adjuntos.

Los trabajos con la misma cuenta, representación, tamaño previsto y acción de captura permanecen en cola mientras se está ejecutando un trabajo coincidente. No ocupan espacios de descarga, por lo que se pueden iniciar otros archivos incluso cuando la cola comienza con muchas copias de un archivo lento. Al completarse un intento, se reactiva la cola. Las vías prioritarias, los retrasos de reintento guardados y la propiedad del historial siguen siendo aplicables; cada observación recibe su propio resultado.

Las exportaciones de chat también comparten una transferencia activa para representaciones repetidas de archivos dentro del mismo directorio de exportación. Cada mensaje conserva su referencia de archivo adjunto, y su reutilización requiere una nueva comprobación del tamaño y del SHA-256. Se pueden comprobar diferentes archivos en paralelo sin mantener un bloqueo de transferencia común. Las rutas temporales de descarga y copia son únicas para cada operación; la cancelación espera a que finalice cualquier lectura local activa del archivo antes de proceder a la limpieza. El índice de archivos de exportación serializa únicamente el acceso a los metadatos, no el cálculo del hash de los archivos ni las descargas.

Las lecturas de hash del servidor para diferentes archivos adjuntos también se ejecutan de forma simultánea, compartiendo las tres ranuras de solicitud de archivos del cliente con las descargas de bytes. Las lecturas repetidas de la misma representación solo reutilizan un resultado completo almacenado en caché. Las lecturas de archivos dejan libre la cola de solicitudes habitual; los plazos guardados de FloodWait se comprueban de nuevo cuando una solicitud obtiene una ranura.

Los límites se establecen por tipo: fotos, vídeos, GIF y animaciones, mensajes de vídeo circulares, mensajes de voz, música y audio, pegatinas y archivos. Cada tipo puede desactivarse y tiene su propio límite de tamaño, que va de 1 a 2.000 MiB; los nuevos espacios de trabajo comienzan con 20 MiB para fotos, 100 MiB para vídeos, 50 MiB para archivos, audio y vídeos circulares, 20 MiB para mensajes de voz y GIF, y 5 MiB para los stickers. Los nuevos espacios de trabajo mantienen los GIF y los stickers desactivados hasta que se activen. Los espacios de trabajo con políticas guardadas antes de la implantación de los límites por tipo mantienen todos los tipos activados y conservan su único límite para cada tipo. El tamaño máximo de archivo se establece para todos los tipos a la vez. Un tipo desactivado genera un registro media.skipped; los archivos de tamaño desconocido o que superan el límite no se descargan. Los archivos de gran tamaño disponen de tiempo de descarga adicional en función de su tamaño y de una velocidad base de 256 KiB/s. Los trabajos se mantienen tras un reinicio, pero las referencias caducadas, la pérdida de acceso o los archivos eliminados pueden seguir impidiendo la recuperación. Los trabajos en espera conservan el límite guardado con ellos, por lo que un aumento del límite solo se aplica a los archivos nuevos. Desactivar un tipo o reducir su límite también omite los archivos en espera que excluye, cada uno con un registro «media.skipped»; desactivar las descargas pone en pausa la cola hasta que se vuelvan a activar.

Pausar, bloquear, desconectar y reiniciar#

Acción o condición Efecto
Cambiar de espacio de trabajo Cambia la vista del panel; los demás recopiladores mantienen su estado.
Bloquee el panel o cierre la pestaña Mantiene el servidor y la observación en funcionamiento.
Observación de pausa Detiene ese recopilador y conserva el trabajo de los archivos adjuntos en cola.
Desactivar una fuente Desactiva la captura programada futura; las tareas multimedia en cola relacionadas con ella quedan en espera mientras esté desactivada.
Eliminar una fuente Se omite como fuente y se eliminan los perfiles de sus usuarios; los registros ya guardados permanecen en el registro de solo adición. Los archivos adjuntos que aún están pendientes se registran como fallidos (source_removed). En los modos de carpeta y de cuenta completa, también se excluyen.
Modificar la ruta de conexión Requiere una pausa, cierra los clientes antiguos y cancela los inicios de sesión no completados.
Detenga el proceso de Python Detiene todos los espacios de trabajo; no se realizan observaciones mientras está desconectado.
Reinicio tras la observación activa Intenta reanudar el ámbito guardado utilizando la sesión guardada. Una pausa manual anula dicha intención.

El recopilador registra las desconexiones detectadas, los reintentos, los errores, los inicios y paradas, y los latidos. Las comprobaciones periódicas de conectividad pueden pasar por alto interrupciones breves. Tras un reinicio, se solicitan las actualizaciones perdidas a partir de la posición de actualización guardada y los chats observados se vuelven a comprobar periódicamente; véase el formato de evidencia. Una instantánea añade el estado actual como contexto, y la brecha queda registrada.

Aislamiento y verificación de cuentas#

Cada espacio de trabajo cuenta con su propio registro, autorización, clave de firma, política y cola. Solo su cliente activo puede aportar observaciones en tiempo real. Los clientes rechazados, pendientes, sustituidos y los que realizan pruebas de conexión no pueden escribir actualizaciones en tiempo real en su registro. Diferentes cuentas pueden observar el mismo grupo, pero sus registros permanecen separados.

Cada evento incluye el hash anterior y una firma Ed25519. Las exportaciones abarcan todo el registro del espacio de trabajo mediante un número de secuencia fijo. Los filtros del panel no filtran la exportación; la recopilación puede continuar más allá de sus límites mientras se está preparando.

El registro de verificación comprueba la cadena de eventos y las firmas a través del límite mostrado. Su resultado se borra cuando cambia el espacio de trabajo, y el panel identifica los nuevos registros añadidos tras la comprobación. La exportación en formato ZIP también verifica los archivos multimedia recopilados.

Conservar las huellas digitales y los puntos de control de forma independiente. Consultar el Ámbito de verificación para las comprobaciones de adquisición en cada modo, y Operaciones diarias para la recopilación rutinaria.