# Telegram · Chats secretos: configuración y grabación

Canonical page: https://phishdestroy.io/tgwitness/es/docs/reference/secret-chats/

Instale el complemento del protocolo de chats secretos, actívelo por cuenta y grabe los chats que TgWitness crea o acepta.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/es/llms.txt)

Instale el complemento del protocolo de chats secretos, actívelo por cuenta y grabe los chats que TgWitness crea o acepta.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentación](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

La aplicación publicada incluye el backend de «Charla secreta», la integración del colector, las rutas de la API y la interfaz **de Pseudo-secret**. La biblioteca de protocolos es un módulo independiente: abre **Pseudo-secret**, pulsa **Instalar y actívalo**. La aceptación automática de mensajes entrantes permanecerá desactivada hasta que la actives.

## Módulo de protocolo

|  |  |
| --- | --- |
| Módulo | `kiaro-telethon-secret-chat` 0.2.0 |
| Autor | KiaroSama |
| Licencia | GPL-3.0 o posterior; su `LICENSE` y `NOTICE` permanecer dentro del archivo guardado |
| Fuente | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) en el commit `d87bf037b90060383c7b704d8a06ebb98c621c6f` |
| Comprobar | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` sobre la lista de archivos de paquetes y sus propios valores SHA-256 |

**La opción Instalar y activar** está disponible para el administrador principal. TgWitness descarga el archivo fuente de esa confirmación desde GitHub a través de la ruta del espacio de trabajo para las solicitudes externas a Telegram, compara cada archivo del paquete con el valor establecido en la versión de TgWitness, guarda el archivo como `modules/telethon-secret-chat-<commit>.zip` en el directorio de datos y carga el código desde la memoria. No es necesario reiniciar. La comprobación se ejecuta de nuevo cada vez que se inicia el programa; si un archivo difiere, no se carga y la página lo indica. Un archivo del paquete modificado, que falte o que se haya añadido hace que la comprobación falle.

El módulo es una obra independiente con su propia licencia. TgWitness no lo incluye: cada instalación lo descarga del repositorio de su autor. En la página **de detalles** se muestra el módulo cargado, su autor, la licencia, el commit y el SHA-256.

Un administrador que no tenga acceso a GitHub puede instalar la misma confirmación en el entorno de Python ; a continuación, el panel utiliza esa copia:

```
python -m pip install ".[secret-chats]"
```

TgWitness se convierte en un punto final para los chats que crea o acepta. Registra mensajes, archivos adjuntos disponibles, cambios en el temporizador y avisos de eliminación en el registro firmado. El contenido guardado previamente sigue estando disponible tras un aviso de eliminación posterior.

## Disponibilidad del paquete

El 8 de noviembre de 2026 , se comprobó el paquete de instalación publicado en el código fuente [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , la versión `b35f8e18f3d1-1ff85ec98bb2` , versión 0.9.1 preview. El archivo [wheel inmutable](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) y su bloqueo de dependencias superaron la verificación de la firma de lanzamiento mediante SHA-256 y RSA. El backend y la interfaz empaquetados coincidían byte a byte con esa revisión del código fuente. El paquete también contiene el registro de la API y los hooks del recopilador.

Ese paquete no contenía la biblioteca de protocolos y no figura en el lock de dependencias. El `secret-chats` «extra» en [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) fija el mismo commit que el botón del panel.

Esta inspección del paquete determina qué archivos y declaraciones de dependencias se incluyen. El [registro de validación](https://phishdestroy.io/tgwitness/es/docs/reference/verification/) identifica las comprobaciones de tiempo de ejecución independientes. La guía anterior del 6 de noviembre describía una instantánea de desarrollo; ya no describe el paquete mencionado anteriormente.

## Utiliza la interfaz

Abre **Pseudo-secret**, instala el módulo si la página lo ofrece, actívalo para la cuenta y conéctalo. Las solicitudes entrantes quedan en espera hasta que se acepten, a menos que se haya habilitado la aceptación automática. El inicio, la aceptación, el envío y el cierre utilizan los permisos de interacción de la cuenta y la protección de solo lectura.

| Acción | Resultado conservado |
| --- | --- |
| Iniciar un chat por nombre de usuario o ID de usuario | Solicitud saliente; el par la acepta en su dispositivo. |
| Aceptar una solicitud | TgWitness se convierte en el punto final receptor. |
| Enviar o recibir un mensaje | `secret_chat.message`, con su dirección, contenido y temporizador asociado. |
| Recibir un archivo | Bytes descifrados almacenados mediante SHA-256 y un recibo `secret_chat.file`; incluidos en la exportación de pruebas. |
| Recibir un aviso de temporizador o de eliminación | Un registro de acciones independiente junto con los mensajes y archivos conservados. |
| Revisar el chat | Conversaciones, acuses de recibo de archivos, notificaciones y visualización de claves. |

Los chats secretos existentes en otro dispositivo conservan sus claves específicas de ese dispositivo. Una sesión en la nube importada no transfiere esas claves. El material de claves de los chats secretos y los contadores utilizan la bóveda del espacio de trabajo; los mensajes conservados y los archivos descifrados utilizan las protecciones normales de almacenamiento del espacio de trabajo.

## Buscar mensajes guardados

Utiliza **la función Buscar mensajes** dentro de un chat abierto para encontrar una frase exacta, sin tener en cuenta las mayúsculas y minúsculas. **Las teclas Anterior** y **Siguiente**, o «Intro» y «Mayús+Intro» en el campo de búsqueda, permiten desplazarse entre los mensajes que coinciden. El contador cuenta los mensajes; la primera frase coincidente de cada mensaje aparece resaltada. La tecla «Esc» borra la búsqueda.

La función de búsqueda mantiene visibles la conversación circundante, los archivos guardados y los avisos de eliminación. Busca entre los registros ya cargados en el panel. Cuando quedan registros anteriores, el panel lo indica; la opción **Cargar registros más antiguos** amplía el historial y actualiza los resultados de la búsqueda, al tiempo que mantiene el mensaje actual en su sitio.

Cada chat conserva su búsqueda aunque cambies de espacio de trabajo dentro del mismo. Al bloquear el panel o cambiar de espacio de trabajo, esas búsquedas se borran. Los términos de búsqueda permanecen en la memoria de la página y no se almacenan en el almacenamiento del navegador ni se envían como consultas a la API. La búsqueda no envía mensajes de Telegram ni notificaciones de escritura o lectura. La configuración de visibilidad existente sigue regulando la apertura de un chat y otras acciones.

**El informe de compilación** mantiene el ámbito del informe del chat seleccionado; una búsqueda en la vista previa no restringe de forma implícita los registros exportados. Previsualiza la selección del informe antes de descargarlo.

## Controles de persistencia e interacción

La implementación integrada utiliza la búsqueda en el diario duradero para la detección de duplicados, mantiene pendientes las tareas de adjuntar archivos tras una descarga fallida y canaliza el cierre a través del mismo control de interacción que otras acciones remotas. Estas sustituyen a las tres rutas señaladas en la auditoría histórica de la instantánea de desarrollo del 6 de noviembre.

Los mensajes descifrados cuya escritura en el registro falla se guardan en la bóveda para volver a intentarlo. Las comprobaciones del tamaño de los archivos adjuntos y del espacio libre en disco aplazan las descargas, aunque mantienen las tareas en curso. El módulo reutiliza la conexión existente de la cuenta. Las notificaciones de lectura y de escritura se envían únicamente según lo seleccionado en [Lo que ve la otra parte](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees); las notificaciones de capturas de pantalla nunca se envían. Véase [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [las rutas de la API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) y [la política de acceso](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py).

La [auditoría histórica](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) conserva sus conclusiones originales de la instantánea. La disponibilidad y la implementación actuales deben consultarse en la revisión del paquete anterior y en las [capacidades actuales](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md).

## Demostración de la interfaz

El escenario del sitio web utiliza solicitudes, mensajes y archivos ficticios para demostrar el flujo de trabajo del panel. Se trata de un ejemplo de interfaz; las comprobaciones de protocolo y adquisición tienen sus propios resultados fechados en el registro de validación.
