TgWitness / Documentación

Lo que se ha probado →

Referencia / Configuración

Telegram · Formatos de cuentas y sesiones

Inicie sesión mediante teléfono, código QR o clave de autenticación, importe sesiones de Telethon, Pyrogram o Telegram Desktop, y gestione varias cuentas.

TgWitness / Documentación · Primeros pasos

Primeros pasos

TgWitness inicia sesión como una cuenta de usuario de Telegram (no como un bot) a través de MTProto, utilizando Telethon. Cada cuenta se encuentra en su propio espacio de trabajo (denominado «workspace» en la API y en las herramientas de línea de comandos) con su propia sesión, fuentes, registro y clave de firma.

Los archivos de sesión, las cadenas de sesión y las claves de autenticación son autorizaciones de cuenta: quienquiera que las posea puede actuar en nombre de dicha cuenta. No contienen el historial de mensajes.

[!ADVERTENCIA] Utiliza cuentas específicas. Telegram restringe y puede bloquear permanentemente las cuentas por volúmenes de solicitudes que considere excesivos, independientemente del cliente o la finalidad, y documenta dichos límites solo de forma parcial. Conecta cuentas preparadas para la observación en lugar de cuentas personales o de otro tipo que tengan valor, y crea un ID de API / hash de API en una cuenta específica.

De un vistazo#

Lo que tiene Pestaña «Añadir cuenta» También necesitará
El número de teléfono y el acceso a sus códigos de inicio de sesión Teléfono Contraseña de 2FA, si está activada
Telegram abierto en otro dispositivo Código QR Contraseña de 2FA, si está activada
Un archivo .session (Telethon o Pyrogram) Archivos Archivo JSON complementario opcional para la configuración de la aplicación
.session + .json con el mismo nombre Archivos (seleccione ambos) Por lo general, nada más
Una carpeta «tdata» en Telegram Desktop Archivos (en formato ZIP) El código de acceso local de la versión de escritorio, en caso de que se haya configurado uno
Una sesión de cadenas de Telethon (texto, .txt, .tgwitness-session) Archivos No se requiere un par de API independiente
Una clave de autenticación y un DC en una sola línea: <512 hex>:<1–5> Archivos (texto pegado o un archivo de texto) No se requiere un par de API independiente
Un .json con una sesión o una clave de autenticación Archivos No se requiere un par de API independiente
Una clave de autenticación (512 caracteres hexadecimales) y su número DC Clave de autenticación ID de usuario opcional

TgWitness reconoce los archivos por su contenido, no por su nombre. Al cambiar el nombre de un archivo, este nunca se convierte.

Antes de empezar: ID de la API y hash de la API#

Puedes iniciar sesión sin crear una aplicación de la API de Telegram. Cuando no se introduce ningún par, ni se importa ni está ya guardado en el espacio de trabajo, TgWitness selecciona un par de su conjunto integrado de 50 pares públicos de la API (tgwitness/api_pool.py), dando prioridad a Telegram Desktop para un inicio de sesión nuevo y conservando primero un par guardado; el resto de candidatos se barajan. Si Telegram rechaza un par (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), se prueba el siguiente, hasta un máximo de ocho por inicio de sesión; los pares rechazados se omiten hasta que se reinicia la aplicación. El par con el que se ha iniciado sesión se guarda con la cuenta y se reutiliza para ella.

Los pares integrados son públicos: se publican en el código abierto de los clientes y bibliotecas de Telegram. Un ID de API y un hash de API identifican la aplicación ante Telegram y no otorgan acceso a los datos de la cuenta. El inicio de sesión utiliza la propia autorización de la cuenta: un código de inicio de sesión y una contraseña de autenticación de dos factores (2FA), o una sesión que la cuenta ya haya autorizado. Cada observation.started registro indica el par utilizado, por lo que un par integrado queda documentado para el tribunal de la misma forma que el propio. En su lugar, puede introducir su propio par desde my.telegram.org. Según la experiencia del proyecto, un nuevo par personal provoca que la mayoría de las cuentas se desconecten, por lo que utilícelo solo cuando un caso requiera su propia aplicación: créelo con una cuenta dedicada e introdúzcalo antes de que comience la recopilación (pasos a continuación).

Los campos de conexión que faltan utilizan un par determinista de dispositivo/sistema operativo de los catálogos opentele2 2.0.0 incluidos: Ordenador de sobremesa 2040, Android 6, Android X 21724, iOS 10840, macOS 2834 y Web 2496. El ID de compilación del código fuente de Android 4 también utiliza el catálogo de Android, tal y como se identifica en BuildVars de Telegram para Android . Web utiliza A por defecto; un sufijo de versión de aplicación K importado o un paquete de idioma macos selecciona K, y la versión 0.7.0 selecciona Webogram. Los ID de aplicación desconocidos mantienen los valores predeterminados del servidor de Telethon. Los campos importados siempre tienen prioridad, incluyendo una versión anterior de la aplicación y un paquete de idioma vacío. El catálogo nunca cambia el ID/hash de la API. Su instantánea de versión se revisa explícitamente, no se recupera durante el inicio de sesión. Un perfil guardado permanece estable tras las actualizaciones.

account.getAuthorizations informa de los metadatos de autorización guardados por Telegram; no es un reflejo de cada nuevo initConnection. Compáralo con el perfil realmente enviado. Conectar una autorización existente no valida su hash de API asociado: initConnection envía el ID de la API, mientras que el hash se utiliza en las solicitudes de inicio de sesión.

Tras una nueva autorización por teléfono o código QR, TgWitness solicita la configuración, el centro de datos más cercano, el estado de conexión, los idiomas (cuando el paquete de idiomas no está vacío), las actualizaciones de la aplicación y las actualizaciones de los términos de servicio, con un intervalo de 0.3 a 1.5 segundos entre solicitudes. La actualización del estado marca brevemente la cuenta como en línea. Esta secuencia se ejecuta una vez al completar el inicio de sesión, no durante importaciones, reconexiones o reinicios. La autorización se guarda en primer lugar; una solicitud fallida detiene la secuencia sin reintentar ni descartar el inicio de sesión. Los resultados se registran como account.initialized, con nombres de error en lugar de cuerpos de respuesta. Las propias políticas de Telegram determinan las restricciones de la cuenta.

Para tdesktop , si falta tz_offset , se utiliza la diferencia horaria local del servidor con respecto al UTC, redondeada a 900 segundos mediante el algoritmo opentele2 (MIT; licencia en tgwitness/client_profiles.LICENSE ). Se actualiza en cada conexión para que se reflejen los cambios por el horario de verano. Un tz_offset importado tiene prioridad en todas las plataformas y se conserva exactamente, incluido el cero. Se conservan las demás entradas initConnection.params . El formulario de inicio de sesión HTTP acepta la zona horaria numérica devuelta por la importación de archivos; se rechazan los valores booleanos, las fracciones y las diferencias horarias fuera del rango admitido.

Las rutas directas, SOCKS5 y HTTP CONNECT utilizan el ConnectionTcpObfuscated de Telethon (MTProto abreviado y ofuscado). HTTPS CONNECT mantiene el TLS hasta el proxy y utiliza el mismo transporte ofuscado dentro del túnel. MTProxy mantiene su transporte intermedio aleatorio obligatorio y la gestión de secretos. Los cambios de ruta aplican las mismas opciones. La ofuscación modifica la estructura de los paquetes; no oculta la cuenta ni los metadatos de su cliente a Telegram, ni implica inmunidad frente a las restricciones.

Tras conectar un cliente autorizado, TgWitness comprueba la configuración, el centro de datos más cercano, la autorización actual, la línea de base de la capa revisada, los idiomas, las actualizaciones de la aplicación y las actualizaciones de las condiciones de servicio. Estos diagnósticos se ejecutan una vez por cada instancia de cliente, antes de la recopilación, y se muestran en los detalles de la conexión junto con su hora. El registro account.connection_checked recoge el resultado sin hash de sesión, direcciones IP, tokens ni hash de API. Nunca aceptan condiciones ni instalan actualizaciones. Un error en la solicitud o un «FloodWait» detiene las solicitudes posteriores; un resultado que falte permanece desconocido. Las comprobaciones locales pueden seguir informando de sus resultados, mientras que las comprobaciones de red se omiten. Si se activan los chats seleccionados de forma estricta, la autorización actual no se solicita y esa comprobación se muestra como omitida.

Tras iniciar sesión y en cada nueva conexión, TgWitness lee la configuración de contenido sensible de la cuenta. Cuando está desactivada y Telegram permite el cambio, TgWitness la activa para que se guarde el contenido que Telegram marca como sensible (18+), y registra account.content_settings. Esta configuración pertenece a la cuenta y se aplica en todas las aplicaciones de Telegram. La opción «Chats seleccionados estrictos» no la modifica; actívala antes de iniciar sesión.

Las solicitudes simultáneas para restablecer la conexión de un espacio de trabajo comparten su cliente y esperan a que finalice el establecimiento de dicha conexión. Si un intento falla o se cancela, se libera la siguiente solicitud para que vuelva a intentarlo. Si las credenciales guardadas, el cliente o el estado de autorización cambian durante el establecimiento de la conexión, el intento anterior se detiene en lugar de indicar que la conexión está lista.

Los diagnósticos de FloodWait conservan el método TL fallido, cualquier envoltorio Takeout/rango, la espera solicitada por el servidor y el plazo efectivo en telegram.backoff. Los detalles de la conexión muestran el método y el plazo mientras las solicitudes están en pausa. El diagnóstico incluye contadores de llamadas de cliente por método desde que se creó dicho cliente; cuentan por separado la resolución de pares anidados, pero no cuentan los paquetes ni los intentos de reintento internos de Telethon. Los contadores actuales también están disponibles como collector.rpc_activity en la API de estado. No se incluyen argumentos de solicitud, nombres de usuario, hashes de acceso ni texto de excepción. El último diagnóstico y el plazo completo se conservan tras el reinicio. Las esperas anteriores sin un registro de método no pueden atribuirse retrospectivamente. Consulte : límites de exportación para la revisión del código fuente y la distinción entre descubrimiento y adquisición del historial.

official_app=True o False es el indicador de autorización actual de Telegram. Ninguno de estos valores determina si la cuenta está restringida, es de confianza o se encuentra bajo observación. Las instantáneas account.devices existentes en modo de pruebas siguen constituyendo el historial de todos los dispositivos que han iniciado sesión; los diagnósticos de conexión solo conservan la descripción del dispositivo actual.

Antes de la conexión, las comprobaciones de aviso comparan la plataforma de la API, el paquete de idioma, los formatos de dispositivo/sistema operativo y versión de la aplicación, la configuración regional del sistema móvil y la capa de esquema real de Telethon con la referencia del catálogo revisado. Las advertencias aparecen en el registro del servidor y en los metadatos del estado de la cuenta; nunca sustituyen los valores importados ni modifican la capa de esquema. Una capa diferente es una señal para revisar la compatibilidad; el propio estado de conexión de la cuenta indica si funciona. Telegram decide las restricciones por su parte, independientemente del perfil de cliente que se utilice. El estado de cuenta desconectada utiliza el perfil guardado en lugar de generar otra descripción del dispositivo.

Para utilizar tu propia aplicación en su lugar:

  1. Abra my.telegram.org e inicie sesión con cualquier número de teléfono del que disponga. El código le llegará a la aplicación de Telegram, no por SMS.
  2. Seleccione herramientas de desarrollo de API.
  3. Cree una aplicación: cualquier título y nombre abreviado (de 5 a 32 letras), plataforma: ordenador de sobremesa. La URL y la descripción pueden dejarse en blanco.
  4. Copie el «api_id» de la aplicación (un número) y el «api_hash» de la aplicación (32 caracteres hexadecimales).

En el panel, «API ID + Hash» aparece debajo del formulario de inicio de sesión. Puede pegar un único par api_id:api_hash en el campo «API ID» y ambos campos se rellenarán automáticamente. Un mismo par puede utilizarse para todas sus cuentas. Tras iniciar sesión con éxito, se guarda, cifrado, únicamente en ese espacio de trabajo y nunca se reenvía al navegador.

Intervienen tres tipos de credenciales diferentes:

Secreto Abrir Dónde se encuentra
Token de panel El panel web de TgWitness panel-token.txt en el directorio de datos, o TGWITNESS_TOKEN
ID de la API + hash No aporta nada por sí solo; identifica la aplicación Emparejamiento integrado, configuración importada o su propia aplicación en my.telegram.org
Autorización de la cuenta La cuenta de Telegram Se crea mediante inicio de sesión por teléfono o código QR, o bien se importa como una sesión.

Si es necesario acceder a Telegram a través de un proxy, configúralo primero en Más herramientas → Cuenta → Ajustes → Ajustes de conexión → Cambiar ruta de conexión.

Número de teléfono#

  1. Abre Más herramientas → Cuenta, pestaña Teléfono, e introduce el número en formato internacional, por ejemplo, +44 7700 900123. Los espacios y los guiones se eliminan automáticamente.
  2. Pulse «Continuar». Los campos «API ID» y «Hash» pueden dejarse en blanco.
  3. Introduce el código que envía Telegram, normalmente a la aplicación de Telegram; Telegram decide si envía un SMS.
  4. Si la cuenta dispone de verificación en dos pasos, introduzca esa contraseña. No se trata del token del panel ni del código de acceso del dispositivo.
  5. Compruebe el ID de la cuenta que aparece tras iniciar sesión y, a continuación, seleccione las fuentes.

Los códigos de inicio de sesión y la contraseña de autenticación de dos factores (2FA) nunca se guardan en el disco.

Código QR#

Utilice esta opción cuando la cuenta ya haya iniciado sesión en un teléfono u otro ordenador.

  1. Pestaña «Código QR» → Mostrar código QR. Los campos «ID de API» y «Hash» pueden dejarse en blanco.
  2. En el dispositivo en el que ha iniciado sesión: Ajustes → Dispositivos → Vincular dispositivo de escritorio, escanee el código y confirme.
  3. Introduzca la contraseña de 2FA en TgWitness si Telegram se la solicita.

La imagen del código QR se genera localmente. Los códigos caducan; pulse «Generar otro código QR» para volver a intentarlo. Al bloquear el panel, cambiar de espacio de trabajo o iniciar otro inicio de sesión se cancela un código pendiente.

Clave de autenticación + ID de DC#

Una clave de autorización (Auth Key) es la autorización sin procesar de 256 bytes que subyace a cada sesión de Telegram, escrita como 512 caracteres hexadecimales, junto con el número del centro de datos DC 1–5.

  1. Pestaña «Clave de autenticación». Pegue la clave completa; una clave abreviada que contenga «…» no funcionará.
  2. Seleccione el DC ID proporcionado junto con la clave.
  3. Si lo desea, introduzca el ID de usuario. En ese caso, TgWitness rechazará la conexión si Telegram detecta una cuenta diferente.
  4. Cuenta de Press Connect.

Una clave de autenticación (512 caracteres) no es un hash de API (32 caracteres). La misma clave también puede importarse como JSON; consulte «JSON de la cuenta».

Archivos de cuentas#

Abre Añadir cuenta → Archivos y selecciona hasta cuatro archivos pertenecientes a una misma cuenta, con un tamaño total de 8 MiB; pulsa Comprobar archivos y, a continuación, Conectar cuenta. Al seleccionar archivos o pegar el texto de la sesión no se envía nada; al pulsar Comprobar archivos, estos se envían a tu servidor de TgWitness, que los lee sin necesidad de iniciar sesión y muestra la sesión que ha encontrado.

Los formularios Archivos, Clave de autenticación y de importación masiva muestran la advertencia de sesión paralela antes de conectarse. Por defecto, las autorizaciones importadas se reutilizan. Mantén el cliente original cerrado mientras su clave se esté utilizando aquí. Archivos y Clave de autenticación también ofrecen Crear una autorización independiente, descrita más adelante. La importación masiva sigue utilizando el modo directo. El inicio de sesión por teléfono y mediante QR interactivo crea autorizaciones independientes. El encabezado de la advertencia permanece visible en el formulario de importación; su explicación completa se abre automáticamente cuando se proporcionan archivos o una cadena de clave/sesión. Se puede ocultar tras leerla, de modo que el selector de archivos y los controles de conexión sigan siendo utilizables en un teléfono.

Una implementación certificada (Phala Cloud, Intel TDX) no realiza la recopilación con una clave importada. En ese caso, Archivos y la clave de autenticación solo se conectan si se selecciona la opción Crear una autorización independiente; la importación masiva no es posible. El inicio de sesión por teléfono y mediante código QR funciona con normalidad.

  • Los archivos se convierten en memoria en su servidor de TgWitness. Las subidas no se almacenan, los archivos ZIP no se extraen al disco y no se establece contacto con ningún servicio externo.
  • A continuación, la sesión resultante se comprueba con Telegram. Si un archivo indica un ID de usuario, debe coincidir con la cuenta que Telegram indica.
  • Se rechazan los archivos que describen diferentes cuentas o diferentes credenciales de API en lugar de seleccionar una sola.
  • El texto de contraseña o sesión contiene el campo de contraseña local de TData, un cuadro para pegar una StringSession y leer archivos sin iniciar sesión (rellena el formulario sin conectarse a Telegram). Al pegar una StringSession se borran los archivos seleccionados, y al elegir archivos se borra el texto pegado, de modo que la comprobación y la conexión utilizan la última selección. Tras cambiar el código de acceso, vuelve a pulsar Comprobar archivos.

Crear una autorización independiente#

Selecciona Crear una autorización independiente antes de conectar archivos importados o una clave de autorización. TgWitness conecta brevemente al donante importado, lo utiliza para aprobar el token de inicio de sesión QR del nuevo cliente y desconecta al donante inmediatamente después de la aprobación. El nuevo cliente tiene su propia clave de autorización y un perfil de escritorio seleccionado por separado. Las credenciales de la API y el perfil del dispositivo proporcionados por el donante se utilizan únicamente para la conexión del donante. No se cierra sesión ni se revoca ninguna autorización existente.

Mantenga el cliente original del donante completamente cerrado durante este paso. La conexión inicial sigue utilizando su clave copiada, por lo que este modo no puede eliminar ese riesgo inicial de uso paralelo. Una vez conectada la nueva autorización, el propietario puede volver a abrir el cliente original y utilizar ambos al mismo tiempo. El inicio de sesión interactivo mediante código QR permite que el cliente original apruebe el inicio de sesión sin copiar ni conectar su clave aquí.

No cierres la sesión ni finalices la sesión del donante. Cuando finaliza la sesión que aprobó un inicio de sesión mediante código QR, Telegram también finaliza la sesión que aprobó; en una prueba en directo, la nueva autorización se interrumpió en menos de un segundo tras el cierre de sesión del donante. La importación registra la sesión del donante (session_origin.approved_by: dispositivo, ID de API y hora de creación). La lista de sesiones la marca; Finalizar sesión la rechaza, mientras que Finalizar todas las demás sesiones y Hacer que esta sea la única sesión mantienen el donante conectado.

Si Telegram solicita la autenticación de dos factores (2FA), este modo utiliza twoFA el JSON seleccionado, si está disponible, o solicita la contraseña. Si se rechaza una contraseña importada, se vuelve al formulario de contraseña. Las contraseñas no se guardan. La clave candidata se guarda cifrada en independent_login.enc, incluidos los cambios durante la migración del centro de datos. Tras una interrupción, selecciona el mismo donante y esta opción para reanudar la clave candidata guardada. El donante se comprueba help.getAppConfig antes de la aprobación; una cuenta bloqueada se detiene ahí. Si Telegram rechaza el donante antes de aprobar el inicio de sesión, la clave candidata no aprobada se descarta y la importación puede comenzar de nuevo. Otro donante sustituye a una clave candidata guardada solo cuando Telegram indica que dicha clave candidata no ha iniciado sesión; se mantiene una clave candidata que haya iniciado sesión o que esté a la espera de su contraseña de 2FA. El espacio de trabajo permanece reservado para esa cuenta; si la finalización falla, no se elimina el nuevo espacio de trabajo. Conserva su directorio de datos y su clave de almacén. Las credenciales finales y el account.authorized el registro del diario incluyen el método de importación, los formatos de entrada y el ID de la API del donante, sin la clave ni la contraseña del donante.

El 5 de noviembre de 2026, una cuenta dedicada superó las comprobaciones en tiempo real con los donantes de Telethon, Pyrogram y TData: finalización de la autenticación de 2 factores (2FA), nuevas claves de autorización distintas, acceso simultáneo por parte del donante y del nuevo cliente, y lectura de un canal público. El caso de Telethon también reanudó un candidato guardado tras una interrupción en el paso de la contraseña. Cada nueva autorización completó las seis solicitudes de inicialización posteriores al inicio de sesión, y su registro firmado se verificó. La sesión original siguió siendo utilizable en los cuatro formatos proporcionados.

La base de datos de errores RPC de Telegram asocia FRESH_CHANGE_ADMINS_FORBIDDEN al cambio de administradores, FRESH_CHANGE_PHONE_FORBIDDEN al cambio de número de teléfono y FRESH_RESET_AUTHORISATION_FORBIDDEN a la revocación de otras sesiones, el cambio de su duración o el registro de una clave de acceso. SESSION_TOO_FRESH_* y PASSWORD_TOO_FRESH_* se refieren a transferencias de titularidad y retiradas de ingresos o regalos. No se trata de operaciones de recopilación; un nuevo inicio de sesión no implica una prohibición general de lectura de 24 horas. La exportación puede devolver TAKEOUT_INIT_DELAY_* por separado. TgWitness conserva las pausas solicitadas por el servidor y no reintenta la aceptación de tokens automáticamente ni revoca sesiones para eludir restricciones.

Más herramientas → Cuenta → Seguridad de la cuenta → Sesiones de esta cuenta → Finalizar todas las demás sesiones: llama a `auth.resetAuthorizations` a petición del operador y registra `account.all_other_sessions_terminated` con el recuento de sesiones antes y después. Telegram lo acepta desde una sesión en la que se haya iniciado sesión durante 24 horas. Cuando este espacio de trabajo inicia sesión mediante un código QR desde una sesión importada, la sesión que lo ha aprobado permanece conectada: TgWitness cierra las demás una a una con `account.resetAuthorization` y registra `kept_approving_session`. Convierte esta en la única sesión, luego se detiene por ese motivo y no cambia la contraseña.

Haga que esta sea la única sesión que realice lo mismo para una clave creada al iniciar sesión desde este espacio de trabajo y, a continuación, active una contraseña de dos pasos si la cuenta no dispone de ninguna. El panel muestra esa contraseña una sola vez; TgWitness la conserva en la caja fuerte del espacio de trabajo únicamente hasta ese momento. El registro recoge session.exclusive_from. Si Telegram muestra posteriormente otra sesión, el diario lo registra session.exclusive_ended y el panel muestra una alerta. El verificador muestra ambos.

Haz que esta sea la única sesión en la que Telegram permita que se realice la misma acción con un temporizador. La opción aparece en Sesiones de esta cuenta para una clave creada en este espacio de trabajo y se registra como session.exclusive_automatic. Durante la observación, el colector comprueba cada cinco minutos si han transcurrido 24 horas desde el registro account.authorized de esa clave — Telegram responde FRESH_RESET_AUTHORISATION_FORBIDDEN antes de eso— y, a continuación, ejecuta la misma operación una vez. El éxito se registra como session.exclusive_from, al igual que el botón manual. Un rechazo se registra una vez como session.exclusive_postponed con el motivo indicado por Telegram, y el recopilador vuelve a intentarlo con un retraso creciente de hasta seis horas. El modo de solo lectura no tiene ningún efecto aquí: finalizar sesiones es una acción relacionada con la seguridad de la cuenta, no una acción del chat.

Una contraseña de dos pasos generada por la ejecución automática se guarda en la bóveda del espacio de trabajo, cifrada con la clave del espacio de trabajo, antes de que Telegram la establezca. El panel la recupera una vez de POST /api/account/sessions/only/password, que la elimina, y la muestra en el mismo cuadro de diálogo que el flujo manual al abrir Sesiones de esta cuenta. La página de conexión indica que hay una contraseña pendiente. Esta nunca se registra en el registro y permanece tras un reinicio hasta que se haya mostrado.

Las nuevas sesiones también se notifican durante la observación: cuando la lista de sesiones de Telegram incorpora una entrada, el registro account.sessions la nombra bajo added y el panel genera una alerta con el dispositivo, la aplicación y el país de esa instantánea.

Sonda de testigo#

Más herramientas → Cuenta → Seguridad de la cuenta → La sonda de testigo comprueba si otro cliente recibe las actualizaciones de esta cuenta. Añade un segundo espacio de trabajo en el que hayas iniciado sesión con una cuenta de Telegram diferente y su propia clave de sesión, crea un grupo privado con ambas cuentas, luego elige ese grupo como chat de sonda y el segundo espacio de trabajo como espacio de trabajo de testigo, y activa la sonda. Ambas cuentas deben tener desactivada la opción Solo lectura, y el espacio de trabajo de testigo debe estar en modo de observación.

Durante la observación, este espacio de trabajo envía probe:<n>:<token> al grupo cada 60–120 segundos y registra probe.sent. El testigo responde con ack:<n>:<token> y registra probe.seen y probe.ack_sent. Un ack que llega a esta sesión como actualización en tiempo real en un plazo de 20 segundos se registra como probe.acked. De lo contrario, el espacio de trabajo lee el historial reciente del grupo. Un ack que se encuentre allí pero que no se haya entregado en tiempo real se registra como coverage.gap con el motivo probe_ack_missed_live: el panel genera una alerta y marca la recepción del evento como fallida hasta que llegue un ack posterior en tiempo real (connection.restored, motivo probe_ack_live). No se registra ningún ack como probe.unanswered; una interrupción de la conexión durante la espera o un historial ilegible se registran como probe.inconclusive. Las restricciones de solo lectura, de Telegram y las pausas de FloodWait se registran una vez como probe.skipped.

Telethon .session#

En qué consiste La base de datos SQLite que crean las herramientas basadas en Telethon, por ejemplo, my_account.session
Reconocida por Tablas sessions (junto con dc_id, server_address, port, auth_key) y version = 7 u 8
Requisitos Exactamente una fila de sesión autorizada; una base de datos cerrada y completa.

Cierre primero el programa que creó el archivo. Si my_account.session-journal o my_account.session-wal aparecen junto a él, la base de datos no está finalizada: abra y cierre el cliente original correctamente. La eliminación de esos archivos «sidecar» puede dejar una copia dañada.

Pyrogram .session#

En qué consiste Las herramientas basadas en Pyrogram crean una base de datos SQLite
Reconocida por Tabla sessions con dc_id, auth_key, test_mode, user_id, is_bot; version = 2 o 3
Requisitos Una sesión de usuario autorizada en la red de producción. Se rechazan las sesiones de bots y de centros de datos de prueba.

El identificador de usuario almacenado se compara con el de Telegram durante el inicio de sesión.

Par «sesión + JSON»#

Las cuentas suelen distribuirse en dos archivos con el mismo nombre, por ejemplo, « 447700900123.session» y «447700900123.json». Seleccione ambos a la vez.

  • A partir del JSON, TgWitness utiliza app_id/api_id y app_hash/api_hash, por lo que normalmente no es necesario introducir credenciales de la API.
  • El perfil de conexión utiliza device_model (alias device), system_version (alias sdk), app_version, lang_code, system_lang_code (alias system_lang_pack), lang_pack y tz_offset opcional (segundos respecto a UTC, de -43200 a 50400). Los campos proporcionados tienen prioridad sobre los valores predeterminados generados y el idioma del panel o del navegador . Se rechazan los alias conflictivos. El perfil resuelto se guarda en las credenciales cifradas del espacio de trabajo y se reutiliza tras el reinicio, incluida la versión de la aplicación.
  • phone, la configuración del proxy y los tokens de dispositivo se ignoran. twoFA es de solo lectura cuando se selecciona Crear una autorización independiente; la importación directa lo ignora.
  • Un JSON sin un campo de autorización compatible es solo metadatos. Añade su archivo de sesión o continúa con el inicio de sesión mediante teléfono o código QR. Un JSON que contenga una sesión compatible o una clave de autenticación puede autorizar por sí solo; consulta Account JSON.

Telegram Desktop (TData)#

TData es la carpeta «tdata» de la aplicación Telegram Desktop (la aplicación multiplataforma de desktop.telegram.org).

Sistema Ubicación predeterminada: tdata
Windows %APPDATA%\Telegram Desktop\tdata (Telegram portátil: junto a Telegram.exe)
Linux ~/.local/share/TelegramDesktop/tdata
macOS ~/Library/Application Support/Telegram Desktop/tdata

Para importarlo:

Advertencia de sesión paralela. La importación directa de TData reutiliza la clave de autorización de Telegram Desktop. No utilices esa clave en Desktop y TgWitness simultáneamente. Telegram puede invalidar la autorización con AUTH_KEY_DUPLICATED, dejando ambas copias inutilizables hasta que se realice un nuevo inicio de sesión.

Cierra completamente Desktop, incluido su proceso en la bandeja del sistema, y mantén esa copia cerrada mientras TgWitness utiliza la sesión importada. Cierra la aplicación, no cierres la sesión ni revocas la sesión: la revocación también invalida la copia importada. Si necesitas que ambos clientes estén en ejecución, selecciona Crear una autorización independiente y mantén Desktop cerrado hasta que el nuevo inicio de sesión se realice con éxito, o inicia sesión en TgWitness mediante teléfono o código QR. Se recomienda utilizar una cuenta dedicada, pero esto no garantiza que las claves clonadas sean seguras para su uso en paralelo.

Esto también se aplica a los .session , al texto de StringSession y a la clave de autenticación en formato HEX. Otros clientes con sus propias autorizaciones creadas de forma independiente pueden permanecer conectados. Consulte la documentación de Telegram sobre AUTH_KEY_DUPLICATED.

  1. Cierre completamente Telegram Desktop.
  2. Cree un archivo ZIP que contenga únicamente estos dos elementos de tdata:

    • key_datas
    • el archivo de 16 caracteres que termina en «s» situado junto a él, normalmente «D877F783D5D3EF8Cs»

    Al comprimir toda la carpeta con su caché multimedia, se suelen superar los límites (512 entradas, 32 MiB descomprimidos). 3. Seleccione el archivo ZIP en «Archivos». Si Telegram Desktop tiene un código de acceso local, introdúzcalo primero en el campo «Código de acceso» o «Texto de sesión». No se trata de la contraseña de la autenticación de dos factores (2FA).

Compatible con: una cuenta por archivo, almacenamiento moderno key_datas/key_data0/key_data1, código de acceso local. No compatible con: carpetas con varias cuentas conectadas, diseños antiguos de la versión de escritorio, archivos ZIP protegidos con contraseña y la aplicación nativa independiente de macOS «Telegram para macOS».

Telethon StringSession#

Una sola línea de texto, que suele comenzar por «1» y tiene una longitud aproximada de 350 caracteres. Cárguela como un archivo «.txt» o «.tgwitness-session» (de un máximo de 4 KiB), o pégela en el campo «Código de acceso» o «Texto de sesión». Solo se aceptan cadenas de Telethon; las cadenas de Pyrogram y TDLib utilizan formatos diferentes.

Clave de autenticación y DC en una sola línea#

Las listas de cuentas suelen incluir la autorización sin procesar como <512 hexadecimal characters>:<DC id>, por ejemplo, a1b2…ef:5. Pega esa línea en Código de acceso o en el texto de la sesión, cárgala como archivo de texto o introdúcela en el campo session de un JSON de cuenta. TgWitness asigna los DC 1–5 a las mismas direcciones de producción que la importación JSON de auth_key + dc_id y indica el formato como Clave de autenticación HEX y DC. Se rechaza cualquier otro número de DC o longitud de clave.

Fichero JSON de la cuenta#

Un objeto JSON, de un máximo de 64 KiB, en un archivo con extensión «.json».

Campo (alias) Significado
api_id (app_id) ID de la aplicación, un número positivo
api_hash (app_hash) Hash de la aplicación, 32 caracteres hexadecimales
string_session (session_string, session_str; session heredado) Texto de StringSession de Telethon, o <512 hexadecimal characters>:<DC id>, no es un nombre de archivo
auth_key (auth_key_hex) + dc_id Clave de autenticación completa de 512 caracteres y DC 1–5
user_id (id) Opcional; se comprueba con Telegram antes de guardar la autorización.
device_model (device) Descripción del dispositivo de conexión
system_version (sdk) Versión del sistema operativo de conexión
app_version Versión de la aplicación enviada a Telegram
lang_code, system_lang_code (system_lang_pack), lang_pack Idioma del cliente, idioma del sistema y paquete de idioma del cliente; se permite un valor lang_pack vacío.
tz_offset Desfase opcional respecto al UTC en segundos, enviado en initConnection.params; número entero o cadena de números enteros decimales

Si están presentes tanto un alias como el nombre principal, deben coincidir. Los campos de sesión explícitos de Telethon tienen prioridad sobre un blob genérico de session en otro formato. Si ambos contienen sesiones de Telethon reconocibles, deben describir la misma autorización. Sin un campo explícito, session debe ser una StringSession válida de Telethon o una clave de autenticación y un DC en formato <512 hexadecimal characters>:<DC id>. Ejemplos:

{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }
{
  "api_id": 1234567,
  "api_hash": "0123456789abcdef0123456789abcdef",
  "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
  "dc_id": 2,
  "user_id": 123456789
}

En el primer ejemplo solo se rellenan las credenciales de la API; inicie sesión mediante teléfono o código QR, o añada un archivo de sesión. No se aceptan listas masivas (una matriz JSON de cuentas).

Identifique lo que tiene#

Como puede ver Se trata de Uso
*.session; al abrirlo en un editor de texto, aparece SQLite format 3 en la parte superior Telethon o Pyrogram SQLite Archivos (detectados automáticamente)
Una carpeta «tdata» que contiene «key_datas» Telegram Desktop TData Comprima los dos archivos en un ZIP y, a continuación, «Archivos»
Una línea de texto que comienza por 1, ~350 caracteres Telethon StringSession Archivos
Una línea de texto 512 characters 0-9a-f, seguida de : y un dígito del 1 al 5 Clave de autenticación y DC Archivos, código de acceso de la caja o texto de sesión
*.json con app_id/app_hash Metadatos complementarios Archivos, junto con su sesión
*.json con auth_key o string_session Fichero JSON de la cuenta Archivos
512 caracteres 0-9a-f Clave de autenticación Clave de autenticación
32 caracteres 0-9a-f Hash de la API ID de la API + Hash
td.binlog o un db.sqlite procedente de una aplicación de TDLib Almacenamiento TDLib No compatible
123456789:AA… Token del bot No compatible

Formatos no compatibles#

Formato Alternativa
Almacenamiento de TDLib (td.binlog) y exportaciones de TDLib Inicie sesión mediante el teléfono o un código QR
Cadenas de sesión de Pyrogram Utilice el archivo Pyrogram .session, o el código QR/teléfono
TData con varias cuentas registradas Cierre la sesión en las demás cuentas de Telegram Desktop o utilice el archivo de sesión propio de cada cuenta
Tokens de bot No compatible: TgWitness actúa como una cuenta de usuario
Listas en formato CSV/JSON de numerosas cuentas Importe archivos de sesión compatibles mediante Cuentas → Importar cuentas, o inicie sesión por teléfono/QR en espacios de trabajo separados
Sesiones de prueba en DC o con bots Utilice una cuenta de usuario de producción

Cuentas múltiples#

Pulsa el signo + junto al selector de cuentas, o abre Más herramientas → Cuenta → Ajustes → Ajustes de conexión → Espacios de trabajo, introduce una etiqueta e inicia sesión.

  • Cualquier número de espacios de trabajo, incluido el principal. Cada uno cuenta con su propia sesión, ruta de proxy, fuentes, política de captura, registro, clave de firma, puntos de control y exportaciones.
  • Cambiar el espacio de trabajo que se muestra no detiene los demás.
  • Un registro permanece vinculado a la cuenta que lo creó. Para iniciar sesión con una cuenta diferente se requiere otro espacio de trabajo, y una misma cuenta no puede asignarse a dos espacios de trabajo.
  • El token del panel principal controla todos los espacios de trabajo. El acceso concedido puede limitar el acceso de otras personas a cuentas y chats seleccionados, con permisos y límites de sesión independientes.
  • La función «Cuentas» cambia el nombre de un espacio de trabajo y elimina uno añadido, junto con su sesión, su registro, sus fuentes y su clave de firma. El espacio de trabajo principal no se puede eliminar desde el panel.

Importación masiva y grupos de cuentas#

Utiliza Cuentas → Importar cuentas para añadir varias cuentas, emparejar archivos por nombre base y ver el resultado de cada inicio de sesión. Cada cuenta dispone de su propio espacio de trabajo.

Un grupo agrupa cuentas relacionadas sin fusionar sus sesiones, claves ni pruebas. Al hacer clic en «Grupo abierto» en «Cuentas» se accede a su página en /groups/<id>:

  • Cuentas: ruta de conexión, observación y último mensaje de cada miembro, con las opciones «Iniciar todo» y «Pausar todo».
  • Requiere atención: cuentas en las que se ha cerrado sesión, que no están disponibles o que presentan un problema de conexión, recepción, fuente o multimedia; cada nombre lleva a su ficha.
  • En los chats de varias cuentas se pueden ver: las fuentes compartidas, las cuentas que las observan y las interrupciones en el periodo de observación del espacio de trabajo disponible (hasta siete días). La exportación con N cuentas divide la exportación de un canal o supergrupo entre ellas y firma un único archivo.
  • Exportar grupo: una imagen ZIP con la exportación firmada de cada cuenta en accounts/ y manifest.json enumerando sus SHA-256 y huellas digitales de las claves, firmadas por el espacio de trabajo principal en manifest.signature.json. Verifica cada archivo de cuenta por separado con python -m tgwitness.verify y la huella digital de confianza de esa cuenta.

Los miembros comparten la configuración del grupo; cada cuenta puede mantener sus propios valores. Consulta la configuración compartida, la guía de importación y grupos y el panel de control del grupo MTProxy.

Cerrar sesión#

Más herramientas → Cuenta → Cerrar sesión en Telegram (con la observación en pausa) solicita a Telegram que finalice la sesión, por lo que también desaparece de Ajustes → Dispositivos de la cuenta y elimina la sesión del almacén del espacio de trabajo. El diario, las fuentes, los ajustes y la clave de firma permanecen, y el diario registra el cierre de sesión. El espacio de trabajo sigue perteneciendo a su cuenta: solo esa cuenta puede volver a conectarse a él. Si Telegram no responde, la sesión se elimina igualmente aquí y el panel lo indica; finalízala en Telegram en Ajustes → Dispositivos.

Cuando Telegram finaliza la sesión#

Si Telegram bloquea, congela o cierra la sesión de la cuenta, o finaliza la sesión desde otro dispositivo, el registro detalla la causa, el error de Telegram, la ruta y el centro de datos. El estado de la cuenta muestra «Descargar el informe de pérdida de la cuenta»: un archivo JSON firmado con los registros de las 24 horas previas a la pérdida, es decir, conexiones, rutas, sesiones, avisos de la cuenta y interrupciones de cobertura, cada uno con su hash de registro y su firma. Compruébalo con python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP; la exportación de pruebas contiene la cadena de hash completa. Una cuenta bloqueada también se detecta cuando se conecta y durante la observación, y sus acciones de envío y participación quedan desactivadas.

Mantener a salvo los archivos de las cuentas#

  • Trate cada .session, TData ZIP, StringSession, clave de autenticación y JSON de cuenta como si fuera una contraseña. TgWitness guarda la autorización importada en su almacén cifrado; puede eliminar los archivos originales posteriormente.
  • No ejecute la misma autorización en dos programas a la vez. Telegram podría revocarla (AUTH_KEY_DUPLICATED), y ambas copias dejarían de funcionar.
  • Una sesión caducada o revocada no puede reactivarse mediante conversión. Vuelva a iniciar sesión.

Solución de problemas#

Mensaje o síntoma Qué hacer
No se puede leer esta sesión. Cierre su cliente original… El archivo SQLite está abierto o sin terminar (sidecar -journal/-wal). Cierre correctamente el programa original y vuelva a copiar el archivo.
Esquemas SQLite de Telethon compatibles: 7 y 8 / Pyrogram … 2 y 3 El archivo se ha creado con una versión muy antigua o desconocida de la biblioteca. Inicie sesión mediante teléfono o código QR en su lugar.
Solo se admiten sesiones de usuario autorizadas en entorno de producción. El archivo Pyrogram pertenece a un bot o a la red de pruebas.
El archivo TData supera las 512 entradas o los 32 MiB Solo los archivos ZIP «key_datas» y «D877F783D5D3EF8Cs», no toda la carpeta.
No se puede descifrar TData. Compruebe el código de acceso local del ordenador de sobremesa. Introduzca el código de acceso local de Telegram Desktop en el campo «Código de acceso» o «Texto de sesión».
Importe una cuenta de TData cada vez Telegram Desktop contaba con varias cuentas; véase «Formatos no compatibles».
Los archivos seleccionados describen diferentes cuentas o credenciales de API. Seleccione archivos de una sola cuenta.
El archivo JSON no contiene credenciales ni autorizaciones compatibles con la API. Compruebe los nombres de los campos en el archivo JSON de la cuenta.
Únicamente metadatos de la API El archivo JSON no contiene ninguna sesión. Añada el archivo «.session» o utilice el teléfono o el código QR.
La clave de autenticación HEX debe contener los 512 caracteres hexadecimales completos La clave está truncada o contiene «…».
El ID de la cuenta no coincide con el de la cuenta importada El ID de usuario del archivo difiere del que indica Telegram; el archivo corresponde a otra cuenta.
La cuenta ya pertenece a otro espacio de trabajo Abra ese espacio de trabajo en lugar de añadir la cuenta dos veces.
Está conectado, pero falta un grupo privado en la lista de chats en Más herramientas → Fuentes. Comprueba la pertenencia al grupo. El selector revisa los primeros 1,000 diálogos; aumenta el límite en Más herramientas → Parámetros.
Error en la conexión mediante proxy Comprueba la ruta y el modo IP. El modo automático MTProxy prueba otra entrada que funcione. La opción «Ocultar la dirección» espera; el modo «Directo», como último recurso, puede conectarse directamente tras el retraso configurado. Consulta los modos de enrutamiento.

Véase también: conexión y seguridad para proxies y cifrado, y cómo funciona la recopilación de los datos capturados tras iniciar sesión.