# Telegram · Fonctionnement de la collecte

Canonical page: https://phishdestroy.io/tgwitness/fr/docs/reference/collection/

Champ d’observation, mises à jour en temps réel, vérifications croisées, pièces jointes, actions effectuées et signification d’une lacune, message par message.

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

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

Translation coverage: this edition includes material from the English original.

Champ d’observation, mises à jour en temps réel, vérifications croisées, pièces jointes, actions effectuées et signification d’une lacune, message par message.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Collecte](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)

![Collecte](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69)

TgWitness enregistre ce qu’observe un compte Telegram connecté. La surveillance en temps réel conserve les messages, les modifications capturées, les notifications de suppression et les pièces jointes avec leurs horaires d’observation et leur contexte source. L’historique des lectures, des revérifications et des enregistrements du journal d’administration disponibles ajoute à cet enregistrement des observations identifiées séparément.

**Sur cette page**

- [De la connexion au journal](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#from-login-to-a-journal)
- [Portée de l'observation : discussions sélectionnées, un dossier ou l'intégralité du compte](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)
- [Portée et sélection des événements](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#scope-and-event-selection)
- [Actions propres](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#own-actions)
- [Mode enquête : rejoindre des équipes et communiquer avec des bots](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots)
- [Niveaux de revérification](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#recheck-tiers)
- [Historique des messages et attribution](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#message-history-and-attribution)
- [Instantanés historiques](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#history-snapshots)
- [Gestion des pièces jointes](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#attachment-handling)
- [Mettre en pause, verrouiller, se déconnecter et redémarrer](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#pause-lock-disconnect-and-restart)
- [Isolation et vérification des comptes](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#account-isolation-and-verification)

## De la connexion au journal

Pour les photos et fichiers à autodestruction, voir [Médias à autodestruction](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md). Ce document explique le fonctionnement du priority worker, les résultats enregistrés et indisponibles, ainsi que les limites du blocage des accusés de réception dans le collecteur d'API.

Organigramme · Autoriser un compte utilisateur → Sélectionnez les groupes et canaux accessibles; Sélectionnez les groupes et canaux accessibles → Enregistrer les paramètres relatifs aux événements et aux pièces jointes; Enregistrer les paramètres relatifs aux événements et aux pièces jointes → Commencer l'observation; Commencer l'observation → Recevez les mises à jour du client actif; Recevez les mises à jour du client actif → Appliquer la politique relative aux sources et aux événements; Appliquer la politique relative aux sources et aux événements → Ajouter une observation signée; Ajouter une observation signée → Consultez ou exportez le journal; Ajouter une observation signée → Traiter toute pièce jointe en attente; Traiter toute pièce jointe en attente → Ajoutez le résultat du téléchargement · Autoriser un compteutilisateur · Sélectionnez lesgroupes et canauxaccessibles · Enregistrer lesparamètres relatifsaux événements et auxpièces jointes · Commencerl'observation · Recevez les mises àjour du client actif · Appliquer la politiquerelative aux sourceset aux événements · Ajouter uneobservation signée · Consultez ou exportezle journal · Traiter toute piècejointe en attente · Ajoutez le résultat dutéléchargement

**Schéma sous forme de texte**

1. Autoriser un compte utilisateur → Sélectionnez les groupes et canaux accessibles
2. Sélectionnez les groupes et canaux accessibles → Enregistrer les paramètres relatifs aux événements et aux pièces jointes
3. Enregistrer les paramètres relatifs aux événements et aux pièces jointes → Commencer l'observation
4. Commencer l'observation → Recevez les mises à jour du client actif
5. Recevez les mises à jour du client actif → Appliquer la politique relative aux sources et aux événements
6. Appliquer la politique relative aux sources et aux événements → Ajouter une observation signée
7. Ajouter une observation signée → Consultez ou exportez le journal
8. Ajouter une observation signée → Traiter toute pièce jointe en attente
9. Traiter toute pièce jointe en attente → Ajoutez le résultat du téléchargement

L’autorisation, l’accès à une source, un collecteur en cours d’exécution et la livraison complète sont des questions distinctes. Une connexion réussie ne donne pas accès à tous les groupes. La livraison est suivie séparément : les enregistrements de couverture, la récupération des lacunes de mise à jour et les vérifications montrent ce qui est bien parvenu.

## Périmètre d’observation : discussions sélectionnées, un dossier ou l’intégralité du compte

**Plus d’outils → Sources → Le champ d’application** détermine les discussions qu’un espace de travail enregistre.

La nouvelle configuration commence par l'étape **Choisir les discussions**. Les choix enregistrés précédemment sont conservés. Si vous sélectionnez **Toutes les discussions** dans l'assistant de configuration, une confirmation vous sera demandée lorsque la liste chargée contiendra plus de 50 discussions ; l'estimation de la taille reste une opération distincte, basée sur un échantillon.

| Mode | Enregistre | Nouvelles conversations |
| --- | --- | --- |
| Discussions sélectionnées (par défaut) | Uniquement les discussions que vous ajoutez manuellement | Jamais ajouté automatiquement |
| Dossier Telegram | Conversations contenues dans l’un des dossiers du compte : conversations incluses par nom, auxquelles s’ajoutent les catégories du dossier (contacts, non-contacts, groupes, chaînes, bots), moins les conversations exclues et, si le dossier le précise, les conversations archivées | Les conversations correspondantes sont ajoutées dès qu’elles deviennent actives ; celles que vous ajoutez au dossier dans Telegram sont récupérées dans l’heure qui suit. |
| Compte complet | Toutes les conversations auxquelles le compte a accès | Chaque nouvelle conversation, groupe, conversation privée ou bot est ajouté dès la réception de sa première mise à jour. |

- **Les types de sources** (canaux, groupes, discussions privées, bots) limitent les modes « dossier » et « compte entier ». Les discussions sélectionnées peuvent être de n’importe quel type, y compris les discussions privées et les bots ; les types de sources n’empêchent jamais l’ajout d’une discussion que vous avez ajoutée manuellement. La désactivation d’un type, une exclusion ou le passage au mode « discussions sélectionnées » interrompt les sources ajoutées automatiquement dès que la modification est enregistrée, avant même que la liste des sources ne soit recalculée, et ce même lorsque Telegram n’est pas accessible : leurs nouveaux messages, l’historique des échanges, l’historique des nouvelles discussions, les paramètres des contacts et les observations de profil.
- **Chats you add by hand** stay recorded in folder and whole-account modes even when they are outside the folder; only *Exclude*, *Remove* or a pause stops them. Chats the scope added (*auto*) follow the folder: one that leaves it is paused at the next recompute.
- **Les discussions exclues** ne sont jamais enregistrées, quel que soit le mode. En mode « Dossier » et « Compte entier », les actions *Exclure* et *Supprimer* sur une source l'ajoutent à cette liste, afin que le filtre ne l'ajoute pas à nouveau. Si vous sélectionnez à nouveau la conversation manuellement (dans « Sources », depuis « Conversations » ou sous « Paramètres » → **Quelles conversations ?**), elle est retirée de la liste. La liste peut contenir jusqu’à 5 000 conversations ; au-delà, *la fonction Supprimer* est refusée et la conversation peut être mise en pause à la place.
- **Actions propres à l’outil** (activées par défaut) : les messages envoyés par ce compte, ses modifications et les appuis sur les touches du clavier de réponse. Lorsque cette fonction est désactivée, les messages sortants et les modifications sont ignorés.
- Le passage à un dossier ou à l'ensemble du compte nécessite une confirmation : ces modes enregistrent les discussions privées et les messages de tiers et ne doivent être utilisés que sur un compte dédié. La confirmation et chaque modification de périmètre sont consignées dans des enregistrements `scope.changed`. Sur un compte configuré comme compte principal, le formulaire de périmètre et la fonction « Investigation » refusent un dossier ou l’intégralité du compte, tout comme la fonction « Start » ; seule une copie ponctuelle sans enregistrement peut les utiliser.
- Les discussions ajoutées par le scope apparaissent comme des sources marquées *auto*, enregistrées sous le nom `scope.applied` (au démarrage et toutes les heures) ou `source.discovered` (une nouvelle discussion pendant l'observation). Le retour aux discussions sélectionnées met en pause simultanément toutes les sources ajoutées automatiquement, sans relire la liste des discussions du compte. Une conversation exclue cesse d’être enregistrée dès que la portée est enregistrée, et sa source est mise en pause même lorsque Telegram ne renvoie pas la liste des conversations. Pendant l’ observation, l’enregistrement de la portée la réapplique, même si les valeurs n’ont pas changé.

Portée de ces modes :

- **Les discussions secrètes** utilisent l'[intégration pseudo-secrète](https://phishdestroy.io/tgwitness/fr/docs/reference/secret-chats/) intégrée, avec un module de protocole installé depuis le panneau de configuration et un commutateur d'activation par compte. L'historique dans le cloud et la fonctionnalité « Takeout » utilisent un chemin d'acquisition distinct.
- **Périodes hors ligne.** Après un redémarrage, TgWitness reprend la position de mise à jour enregistrée, demande à Telegram les mises à jour manquées et revérifie les discussions. Telegram conserve un historique limité ; ainsi, après une longue interruption, les rapports et `verify.py` indiquent l’intervalle restant comme une lacune (voir [couverture](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)).
- Seuls les 1,000 premiers dialogues sont répertoriés au démarrage (la limite se trouve sous **Plus d’outils → Paramètres**) ; les discussions plus anciennes sont ajoutées dès qu’elles redeviennent actives. L’historique antérieur d’une discussion ajoutée n’est pas récupéré — effectuez un instantané de l’historique ou une exportation complète de la discussion lorsque vous en avez besoin.
- Les conditions relatives aux dossiers qui changent constamment (silencieux, lu) ne sont pas prises en compte : ces discussions restent sous surveillance.
- **Les boutons du bot intégrés (callback)** sur lesquels on appuie dans une autre application sont invisibles pour une deuxième session ; la réponse ou la modification du bot est enregistrée. Les frappes sur le clavier de réponse sont transmises sous forme de messages sortants et sont identifiées par le code `button_press`.
- Plus il y a de discussions, plus il y a de demandes. Telegram restreint les comptes dont le volume est jugé excessif, ce qui constitue une raison supplémentaire d’utiliser des comptes dédiés.

### Discussions sélectionnées avec rigueur

**Réglage strict : seules les discussions sélectionnées** apparaissent dans la section **Discussions sélectionnées** ; cette option est désactivée par défaut. Elle est destinée à une autorisation qui ne s'applique qu'aux discussions sélectionnées. Lorsqu'elle est activée :

- Les notifications de service de Telegram (777000) ne sont pas lues : ni au début ni à la fin de l'observation, ni toutes les minutes pendant l'observation. Aucun enregistrement `session.security_baseline` ou `account.security_event` n'est créé.
- 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.
- Les notifications de suppression ne sont comparées à une vérification de session que si une telle vérification a été effectuée au cours des 10 dernières minutes (lorsqu’il s’agit de la seule session, ou après l’ouverture **des sessions de ce compte**). Sinon, à moins que la dernière vérification des droits ne montre que ce compte n’a pas pu supprimer le message (ce qui n’est jamais le cas dans les discussions privées et les groupes ordinaires), les notifications indiquent : *On ne sait pas qui l’a supprimé : ce compte lui-même, depuis une autre session ou un autre appareil, aurait également pu le supprimer.*
- Avec une clé de session importée, aucune information du journal n'indique l'heure à laquelle cette session s'est connectée tant que la liste des sessions n'a pas été lue (par exemple dans **la rubrique Sessions de ce compte**). Jusqu'à ce moment-là, les exportations de chat et les exportations **automatiques** de compte utilisent la session standard au lieu de « Takeout », avec le motif `session_age_unknown`.
- Turning a chat on does not read its earlier messages. Without the switch, each chat turned on (in Sources, in Chats, by joining from the panel or in the setup wizard) gets one `baseline` snapshot of its latest messages, up to **More tools → Parameters → Largest history snapshot** (500 by default), when observation next runs. A waiting snapshot that comes due while the switch is on is dropped. A chat joined from the panel does not get its latest messages read as a new chat either (the **When a new chat or bot appears** count, 100 by default), and opening a chosen chat with no saved messages in Chats does not load its last 100 messages by itself. **Load history** and snapshots you start yourself still read history.
- Le paramètre de contenu sensible du compte n'est ni lu ni modifié. Sans ce commutateur, la connexion et chaque nouvelle connexion l'activent lorsqu'il est désactivé et que Telegram autorise la modification (`account.content_settings`) ; ce paramètre appartient au compte et s'applique dans toutes les applications Telegram. Le contenu que Telegram marque comme sensible peut rester masqué.
- Les mises à jour relatives aux appels téléphoniques ne sont pas enregistrées sous la clé `account.phone_call`.
- La commande « Stopping observation » n'enregistre que l'empreinte de la clé de session ; elle ne lit ni la liste des sessions ni le fichier 777000.

Cela ne limite pas les données envoyées par Telegram : les mises à jour de chaque discussion parviennent toujours à cette session, et seules les discussions sélectionnées sont enregistrées. La liste des discussions du compte (jusqu’aux **discussions lues figurant dans la liste du compte**) et ses dossiers sont toujours lus au démarrage, puis à nouveau lorsque la portée est enregistrée pendant l’observation, afin de retrouver les discussions sélectionnées. Les notifications de suppression sans discussion associée (``deletion.unscoped``) sont toujours enregistrées : elles ne contiennent que des identifiants de message et peuvent appartenir à une discussion privée sélectionnée ou à un groupe ordinaire. La vérification des comptes gelés (`help.getAppConfig`), les autres vérifications de connexion et les fonctionnalités que vous activez vous-même (fermeture automatique des autres sessions, la sonde témoin, les discussions pseudo-secrètes, **les sessions de ce compte** et la liste des appareils connectés de Telegram sous **« Plus « Témoins »**, qui lit la liste des sessions à chaque passage d’horodatage et dont la configuration contribue aux objectifs **« Suivre les discussions »** et **« Preuves pour une affaire** ») continuent de fonctionner.

Activez-le avant de vous connecter ; sinon, la connexion elle-même vérifie l'autorisation en cours et active le contenu sensible. Chaque modification correspond à un enregistrement signé `scope.changed`, et `observation.started` contient la valeur de `scope.strict`. Le fait de basculer vers un dossier ou vers l'ensemble du compte désactive cette fonctionnalité.

## Portée et sélection des événements

Chaque espace de travail dispose de ses propres sources. TgWitness ne rejoint pas de groupes, n’accepte pas d’invitations et ne répertorie pas automatiquement tous les membres. Les sources doivent déjà être accessibles au compte. Au démarrage, le collecteur vérifie les sources sélectionnées par rapport aux dialogues visibles du compte ; les 1,000 premiers dialogues sont inspectés, sauf si **la section Plus d’outils → Paramètres → Chats de la liste du compte** indique le contraire. Une source absente est marquée comme **accès non confirmé** ; on ne suppose pas qu’elle vous ait supprimé.

| Contexte | Collecte | Conséquences en cas de désactivation |
| --- | --- | --- |
| Nouveaux messages | Messages ordinaires remis | Les modifications ou suppressions ultérieures peuvent ne pas disposer de texte capturé antérieurement avec lequel effectuer une comparaison. |
| Modifications | Versions modifiées des messages fournies | Les modifications intermédiaires ne sont pas reconstituées par la suite. |
| Suppressions | Notifications de suppression ciblées et notifications non ciblées au niveau du compte | Les notifications de suppression ne sont pas ajoutées au journal. |
| Réactions | Instantanés des réactions fournis | Les mises à jour relatives aux réactions ne sont pas ajoutées séparément. |
| Adhésion | Envoi de messages relatifs au service d’adhésion et de mises à jour destinées aux participants | Ces observations relatives à l’adhésion ne sont pas incluses. |

Les paramètres s’appliquent à toutes les sources sélectionnées dans l’espace de travail. Enregistrez le formulaire pour appliquer les modifications ; celles-ci sont consignées avec des valeurs « avant » et « après » signées. La désactivation d’une catégorie ne supprime pas les enregistrements antérieurs. Sa réactivation ne permet pas de récupérer les mises à jour manquées.

Les enregistrements opérationnels et autres événements liés aux services de groupe restent distincts de ces paramètres. Les messages de service relatifs à l’adhésion peuvent générer des enregistrements de messages lorsque l’adhésion est activée, même si la capture standard des nouveaux messages est désactivée. Les objets Telegram capturés conservent leurs métadonnées intégrées ; un paramètre ne constitue pas une règle de caviardage.

**Les suppressions dans les discussions privées et les groupes ordinaires** apparaissent sous forme d’identifiants de message sans discussion associée. Ces discussions partagent une séquence d’identifiants de message valable pour l’ensemble du compte ; ainsi, lorsqu’un message portant cet identifiant a été enregistré précédemment, sa discussion est connue : la suppression est enregistrée dans cette discussion avec le `chat_resolution` qui explique comment. Les identifiants jamais enregistrés restent une **suppression sans contexte**, associée à une discussion explicite non résolue. Il s’agit de notifications de suppression Telegram, conservées même lorsque leur discussion ne peut pas encore être mise en corrélation. Le schéma de la notification contient des identifiants ; le journal ajoute l’heure de réception et tout contexte de message enregistré, y compris le `deleted_message_was_outgoing`. Les entrées disponibles du journal d’administration fournissent une source distincte concernant l’action, l’acteur et l’heure de l’événement.

## Actions propres

Les messages envoyés par le compte surveillé sont identifiés par la mention « `outgoing` ». La modification d’un message sortant précise que, dans les discussions privées et les groupes, seul son auteur peut le modifier, tandis que les publications sur les chaînes peuvent être modifiées par d’autres administrateurs. Lorsqu’un message sortant reprend le texte d’un bouton issu du dernier clavier de réponse enregistré dans cette conversation, il porte la mention « `button_press` » accompagnée d’un lien vers l’enregistrement correspondant du clavier.

L'exclusion de vos propres actions s'applique également aux vérifications en arrière-plan et à l'historique automatique des nouvelles conversations. Les messages sortants ignorés font avancer la position de vérification afin qu'ils ne puissent pas bloquer les messages entrants ultérieurs. Les actions explicites effectuées dans le panneau et les instantanés d'historique demandés manuellement restent enregistrés.

## Mode d’enquête : rejoindre des groupes et communiquer avec des bots

**Plus d’outils → Sources → Portée → Le mode Investigation** prépare la portée pour un compte dédié qui rejoint les discussions d’équipe, lance des bots et leur envoie des messages : l’ensemble du compte, chaque type de source, ses propres actions, ainsi que, pour chaque discussion ou bot qui apparaît, son profil et ses derniers 200 messages visibles. Vérifiez le formulaire et cliquez sur **Enregistrer la portée** ; le passage à l’ensemble du compte nécessite la confirmation habituelle.

- **Boutons.** Les boutons situés sous un message sont conservés avec celui-ci et s’affichent dans **les discussions** : liens, applications web, liens de connexion, textes à copier, données de rappel, requêtes intégrées, demandes de numéro de téléphone ou de localisation. Les liens s’affichent sous forme de texte et ne sont jamais ouverts par le panneau. Lorsqu’un bot modifie uniquement les boutons (un nouveau lien de paiement), il s’agit d’une nouvelle version du message, tant lors des mises à jour en temps réel que lors des vérifications ultérieures.
- **Nouvelles conversations et nouveaux bots.** En mode « dossier » et en mode « compte entier », **lorsqu’une nouvelle conversation ou un nouveau bot apparaît**, l’enregistrement s’effectue immédiatement après son apparition :

  - son profil sous forme d’enregistrement `source.profile` : description du bot et commandes, texte de présentation d’un utilisateur, d’un groupe ou d’une chaîne, membres, discussion associée et lien d’invitation lorsque Telegram en fournit un ;
  - ses derniers messages visibles (jusqu’à 1 000) sous la forme d’un instantané de l’historique marqué `new_chat` : les messages antérieurs d’une discussion de groupe à laquelle vous venez de rejoindre, ou ce qu’un bot a dit avant que l’observation ne détecte la discussion. Les messages déjà enregistrés en temps réel ne sont pas répétés.

  Les discussions nouvellement sélectionnées utilisent ces paramètres lorsque la portée est appliquée, y compris les discussions déjà présentes dans la liste des dialogues du compte. Le chargement initial du profil et de l’historique s’effectue simultanément pour un maximum de trois discussions ; les opérations sur une même discussion restent dans l’ordre. Chaque étape de l’historique ou du profil utilise le délai d’expiration configuré, de sorte que les requêtes bloquées libèrent leur processus de travail. L’historique est enregistré avant la lecture facultative du profil ; un échec de la lecture du profil n’empêche pas la capture de cet historique. Les étapes ayant échoué sont réessayées après 5 secondes, ce délai doublant jusqu’à un maximum de 5 minutes sans occuper de processeur pendant cette période. Les identifiants en attente, les délais de réessai et les étapes terminées sont enregistrés localement. Un redémarrage ne reprend que les étapes inachevées ; un réessai de profil ne répète pas une lecture d’historique déjà effectuée. Les sources désactivées avant leur tour sont ignorées. La vue d’ensemble affiche les chargements de discussions actifs, en attente et en cours de réessai séparément des téléchargements de pièces jointes. Un FloodWait met ce travail en pause et le reprend par la suite ; les échecs sont enregistrés et l’ enregistrement en direct du chat se poursuit. Cela inclut les temps d’attente liés à la résolution de l’ identité du nouveau chat : la tâche en attente relative au profil/historique est conservée pour une nouvelle tentative, et un temps d’attente plus long existant au niveau du compte n’est pas raccourci. Les travailleurs partagent ce temps d’attente ; la concurrence ne contourne pas les limites de requêtes de Telegram. - **Fiches techniques disponibles sur demande.** **Discussions → Profil → Enregistrer le profil maintenant** enregistre le profil actuel de n'importe quelle source ; le plus récent s'affiche au-dessus des messages. - **Instantanés de l'état des discussions (aperçu).** Signaler les modifications survenant en dehors du flux de messages sans qu'un message ne soit émis : le fait de « désépingler » chaque message ne laisse aucune trace au niveau du message ; un administrateur perd ses droits ; un cadeau est masqué, converti, mis à niveau ou remboursé. Pendant la surveillance, chaque source activée est lue périodiquement et enregistrée sous forme de fichier signé `chat.state` enregistrement : titre, noms d'utilisateur, description, nombre de membres et d'administrateurs, chat associé, mode lent, identifiants des messages épinglés (jusqu'à 100), administrateurs avec leurs droits et titres, et cadeaux affichés sur les canaux et les profils d'utilisateurs (jusqu'à 100). Chaque enregistrement répertorie les différences par rapport à l'instantané précédent : champs modifiés avec les valeurs avant et après, messages épinglés ajoutés ou supprimés, administrateurs et cadeaux ajoutés, modifiés ou ne figurant plus dans la liste. - Une partie que Telegram refuse (par exemple la liste des administrateurs d'une chaîne pour un membre qui n'est pas administrateur) est mentionnée dans `errors`; sa valeur antérieure est conservée et répertoriée dans `carried_forward`, jamais signalé comme ayant été supprimé. - Un enregistrement dont les seules modifications concernent les nombres d'occurrences, et une vérification n'ayant révélé aucun changement, se réfèrent au dernier état complet avec `state_seq` et cumulatif `state_overrides`. Un état complet est enregistré au moins tous les sept jours et chaque fois qu'un élément autre que le nombre de personnes change. - `parts_complete` indique les listes bornées. Les ajouts nécessitent une liste antérieure complète, les suppressions nécessitent une liste actuelle complète, et les valeurs vides explicites indiquent un effacement. - **Plus d'outils → Paramètres → État du chat** définit l'intervalle (12 heures par défaut ; la valeur 0 désactive les instantanés ), la pause entre les sources, les parties à lire, et si les vérifications n'ayant révélé aucun changement doivent être enregistrées. `FLOOD_WAIT` et `FLOOD_PREMIUM_WAIT` interrompre les demandes de capture d'écran restantes, conserver tout délai applicable à l'ensemble du compte qui serait encore en cours, et permettre au chat interrompu de faire l'objet d'une nouvelle tentative après ce délai d'attente. - **Non visible.** Les boutons intégrés (de rappel) sur lesquels on clique dans une autre application Telegram, la fenêtre contextuelle ou le lien par lequel un bot répond à une telle action, ainsi que les liens d'invitation utilisés dans une autre application ne sont pas transmis à TgWitness. Ce que le bot envoie ou modifie par la suite est enregistré.

### Intervention lors de la table ronde

**La rubrique « Chats »** comprend désormais un mini-client utilisant le compte Telegram de l'espace de travail sélectionné :

- Rédigez un message en texte brut ou sélectionnez **« Répondre »** sous un message enregistré. Le message sortant ainsi généré est enregistré même lorsque la configuration exclut les mises à jour sortantes.
- Appuyez sur**le bouton « Appuyer »** situé sous un bouton de rappel ou de texte actif. Le serveur récupère à nouveau le message et refuse l’action si le clavier diffère de la version enregistrée. Les accusés de réception des rappels conservent le texte de la fenêtre contextuelle de Telegram, le drapeau d’alerte et l’URL ; la réponse s’affiche également sous la conversation. Les URL restent du texte sélectionnable et ne s’ouvrent pas automatiquement.
- Appuyez sur **+** → **Ouvrir le lien Telegram**, saisissez `@username`, un lien public `https://t.me/name`, `https://t.me/+invite` / `joinchat/invite`, ou un lien de bot avec `?start=parameter`, puis appuyez sur **Enregistrer l'aperçu**. Le lien d'origine et l'aperçu Telegram sont signés avant l'adhésion. **Rejoindre / ouvrir et observer** : le système rejoint alors le groupe/la chaîne ou ouvre l'utilisateur/le bot, ajoute la conversation en tant que source activée, et envoie `/start` à un bot, en incluant son paramètre de démarrage. Une demande de rejoignement en attente de l'approbation de l'administrateur est enregistrée comme « en attente », et non comme une adhésion.

Activez **Démarrer l’observation** pour capturer les réponses entrantes en temps réel. Les actions du panneau fonctionnent lorsque l’observation est en pause ; le panneau enregistre alors ses réponses directes, et l’ observation en temps réel capture le reste de la conversation. Les sources nouvellement ajoutées utilisent le profil/historique de collecte configuré lorsque l’observation est en cours. Lorsqu’une source est en pause, activez-la dans **Plus d’outils → Sources** avant d’envoyer un message ou d’appuyer sur ses boutons.

`interaction.preview`, `interaction.requested` et `interaction.result` sont des événements courants du journal signés inclus dans les exportations de preuves. Les requêtes identifient le compte, le message/bouton ou l'aperçu concerné, et indiquent si l'observation était en cours. Les accusés de réception distinguent les cas de réussite, de rejet, d'approbation en attente et de résultat inconnu. Une requête interrompue peut avoir atteint Telegram : veuillez vérifier la conversation avant de lancer une nouvelle action. La réutilisation d’un identifiant de requête permet de récupérer son accusé de réception enregistré sans répéter l’action, y compris après un redémarrage. Le panneau conserve l’ identifiant après une réponse ambiguë pour la même action au cours de la session de page en cours. Il conserve également cet identifiant lorsque l’actualisation de la vue échoue après une action réussie : l’accusé de réception reste visible, et un nouveau clic permet de le récupérer. Les RPC de rappel et de participation ne disposent que d’une seule tentative ; les lectures réessayables conservent leur politique de réessai configurée. Le changement de discussion efface immédiatement le brouillon et la cible de réponse, et désactive l’envoi jusqu’à ce que la nouvelle conversation soit chargée.

Ce mini-client prend en charge les boutons de texte et de rappel. Les boutons de mini-applications affichent **Ouvrir la mini-application**, ce qui lance l'application dans un navigateur isolé ([Mini-applications](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Les demandes de connexion, de numéro de téléphone et de localisation, les paiements, les requêtes intégrées et les pièces jointes nécessitent toujours un client Telegram ; les métadonnées enregistrées associées à ces boutons restent visibles. Les nouveaux contrôles utilisent du texte en anglais.

## Niveaux de vérification

Les vérifications de suivi interrogent à nouveau Telegram pour les messages manqués, les modifications et les messages qu’il ne renvoie plus. Les sources marquées d’une étoile sont des sources **prioritaires**, revérifiées toutes les 15 minutes par défaut ; toutes les autres sources toutes les 6 heures. Les discussions sélectionnées sont initialement considérées comme des sources prioritaires, tandis que celles ajoutées via un dossier ou l’ensemble du compte sont traitées comme des sources standard. Au maximum 30 sources sont revérifiées par passage et les autres attendent la minute suivante ; après une reconnexion, les sources prioritaires sont traitées en premier. Les deux intervalles sont définis sous **Plus d’outils → Sources → Enregistrement → Revérification** (0 désactive un niveau) et sont enregistrés sous le nom `recheck.changed`.

Les messages manqués sont récupérés à partir du point où le passage précédent s’est arrêté, jusqu’à un maximum de **Plus d’outils → Paramètres → Messages manqués récupérés par discussion et par passage** (1,000 par défaut). Après un long arrêt, la nouvelle vérification comble donc l’intégralité du vide, même lorsque des messages en temps réel plus récents que ce vide ont été enregistrés en premier. Une discussion qui est encore en cours de rattrapage est vérifiée à nouveau la minute suivante au lieu d’ attendre son intervalle de niveau ; `recheck.completed` affiche `continues_after` jusqu’à ce que l’opération soit terminée.

Les comparaisons portent sur le texte des messages, les entités, les claviers (y compris les suppressions) et le contenu/l’identité des pièces jointes. La modification des hachages d’accès aux fichiers ou des références de fichiers ne constitue pas à elle seule une modification, pas plus que ce que Telegram ajoute de lui-même : le chargement d’un aperçu de lien, les vues d’une story, les contenus multimédias payants débloqués par ce compte, la réception d’une facture. Chaque version enregistrée dans « Chats » renvoie vers son enregistrement complet dans le journal, y compris les métadonnées des médias.

## Historique des messages et attribution

Supposons que le collecteur observe « Réunion à 10 h », puis constate « Réunion à 11 h », et reçoive ensuite une notification de suppression. Il ajoute alors trois observations distinctes. Le texte d’origine est conservé, la modification constitue une version distincte, et la notification indique qu’ une suppression a été constatée.

Si la collecte a commencé après la disparition de la première version, ce texte n’est pas disponible. Si plusieurs modifications ont eu lieu alors que le processus était hors ligne, seules les versions observées par la suite peuvent être enregistrées. Une notification de suppression ne permet pas de récupérer un contenu qui n’a jamais été capturé.

L'enregistrement combine plusieurs sources :

| Source | Informations conservées |
| --- | --- |
| Message en direct ou mise à jour de modification | ID du message, métadonnées de l’expéditeur, version capturée, heure de réception et date de création/modification du message Telegram fournie. |
| Notification de suppression en temps réel | ID des messages signalés, heure de réception, notification brute et liens vers le contenu précédemment enregistré. |
| Journal d’administration disponible | Action, acteur, date de la source et contenu du message fourni, consultés par un compte disposant des droits requis. |
| Interaction avec le panneau | L’action demandée et son résultat enregistré sous le compte sélectionné. |
| Vérifier à nouveau | Réponse actuelle de Telegram comparée au message précédemment enregistré. |

`observed_at` correspond à l'instant auquel l'enregistrement a été écrit dans l'horloge du collecteur et augmente avec `seq`. Les enregistrements créés lors du traitement d’une mise à jour en temps réel comportent également `received_at`, l’heure à laquelle la mise à jour a atteint le collecteur, ainsi que `processing_delay_ms`, le délai entre la réception et l’écriture ; les mises à jour mises en attente lors du démarrage d’une observation sont traitées dans l’ordre d’arrivée avant celles qui sont postérieures. `source_at` conserve une date source lorsque cet événement en fournit une. Les observations de décalage d’horloge des télégrammes, les enregistrements de discontinuité d’horloge et [les vérifications de temps externes](https://phishdestroy.io/tgwitness/fr/docs/reference/timestamp/) fournissent le contexte temporel associé. Les champs d’une notification de message ordinaire décrivent cette notification ; les enregistrements du journal d’administration et d’interaction conservent leurs propres attributs.

## Instantanés de l'historique

Un instantané récupère les derniers messages visibles d'une source activée, dans la limite de 500 par requête. Les résultats sont classés comme des observations d'historique. Les instantanés manuels s'exécutent parallèlement aux observations. Les observations répétées sont conservées sous forme d'enregistrements distincts. L'activation d'une source entraîne également la création d'un instantané de référence (`baseline`) de celle-ci, sauf si [l'option Chats sélectionnés](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#strict-chosen-chats) est activée.

Les instantanés s'arrêtent si la source est désactivée pendant la lecture. Les réponses doivent appartenir à la conversation demandée et contenir des identifiants de message positifs strictement décroissants, situés en deçà de la limite demandée. Une réponse non valide interrompt l'instantané avant que ce message ne soit enregistré ; les messages déjà conservés restent dans le journal signé avec l'enregistrement de l'interruption.

Les instantanés respectent la politique relative aux pièces jointes, mais restent distincts des changements liés aux événements en temps réel. Ils ne reconstituent pas les messages supprimés ni les versions intermédiaires manquantes. Vous pouvez en demander un lorsque l’enregistrement est en pause ; les pièces jointes mises en file d’attente attendent que l’observation commence et que le processus de téléchargement s’exécute.

L’exécution **Historique** est une tâche exclusive distincte : elle lit les sources sélectionnées et télécharge leurs pièces jointes en attente séquentiellement, sans lancer la surveillance. La pause libère le compte ; la reprise poursuit l’exécution enregistrée. Pour filtrer par dates, langue et réponses sur plusieurs comptes libres, voir [Export distribué de conversations](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md).

## Gestion des pièces jointes

Le téléchargement des pièces jointes est activé par défaut et est suspendu lorsque l'espace disque disponible est inférieur à 1 GiB. Le collecteur valide simultanément la surveillance des messages et la tâche de téléchargement. La tâche conserve le descripteur multimédia d’origine et la politique de taille, de sorte qu’une pièce jointe modifiée ultérieurement ne soit pas remplacée sans préavis.

Les téléchargements s’exécutent après la capture des messages. Un téléchargement terminé crée un enregistrement `media.saved` avec son SHA-256 et son nombre d’octets. Les opérations ignorées, ayant échoué, ayant fait l’objet d’une nouvelle tentative ou ayant été interrompues ont des résultats distincts ; un fichier est considéré comme préservé lorsque son enregistrement `media.saved` existe. Le fichier final doit également correspondre au nombre d’octets indiqué dans le descripteur de pièce jointe observé à l’origine. Une réponse trop courte ou inattendue n’est pas enregistrée comme média préservé.

Le fichier et son entrée de dossier sont validés sur le disque avant l'écriture de `media.saved`. Lorsque le processus de collecte précédent s'est terminé sans arrêt ordonné, le prochain démarrage lit tous les fichiers enregistrés comme sauvegardés au cours de cette exécution. Un fichier manquant ou dont les octets diffèrent de la valeur SHA-256 enregistrée se voit attribuer un enregistrement `media.missing_after_restart` ; son téléchargement est remis en file d’attente, et les octets divergents sont déplacés vers le répertoire `media-damaged/`. Les fichiers déplacés vers un stockage hors site ne sont pas lus.

Au sein d’un même espace de travail, les tâches mises en file d’attente simultanément pour la même représentation de pièce jointe attendent que le transfert en cours soit terminé, puis vérifient à nouveau les octets enregistrés avant de les réutiliser. Chaque tâche conserve son propre résultat signé et une référence à l’enregistrement du fichier précédemment enregistré. L’annulation d’une tâche en attente n’annule pas le transfert en cours ; si ce transfert échoue ou est annulé, la tâche suivante peut réessayer. Différentes pièces jointes peuvent être téléchargées simultanément.

Les tâches présentant le même compte, la même représentation, la même taille estimée et la même action de capture restent en file d'attente tant qu'une tâche correspondante est en cours d'exécution. Elles n'occupent pas de créneaux de téléchargement, ce qui permet aux autres fichiers de démarrer même lorsque la file d'attente contient de nombreuses copies d'un fichier lent. La réussite d'une tentative réactive la file d'attente. Les voies prioritaires, les délais de réessai enregistrés et la propriété de l'historique s'appliquent toujours ; chaque observation reçoit son propre résultat.

Les exportations via le chat partagent également un transfert actif pour les représentations répétées de fichiers au sein du même répertoire d'exportation. Chaque message conserve la référence de sa pièce jointe, et toute réutilisation nécessite une nouvelle vérification de la taille et du hachage SHA-256. Différents fichiers peuvent être vérifiés en parallèle sans bloquer le transfert. Les chemins temporaires de téléchargement et de copie sont uniques à chaque opération ; en cas d'annulation, le système attend que tout lecteur de fichier local actif ait terminé avant de procéder au nettoyage. L'index des fichiers d'exportation sérialise uniquement l'accès aux métadonnées, et non le hachage des fichiers ni les téléchargements.

Les lectures de hachage côté serveur pour différentes pièces jointes s'exécutent également en parallèle, partageant les trois emplacements de requête de fichier du client avec les téléchargements d'octets. Les lectures répétées d'une même représentation réutilisent uniquement un résultat complet mis en cache. Les lectures de fichiers libèrent la file d'attente des requêtes ordinaires ; les délais FloodWait enregistrés sont vérifiés à nouveau lorsqu'une requête obtient un emplacement.

Des limites sont définies **par type** : photos, vidéos, GIF et animations, messages vidéo circulaires, messages vocaux, musique et fichiers audio, autocollants et fichiers. Chaque type peut être désactivé et dispose de sa propre limite de taille comprise entre 1 et 2 000 MiB ; les nouveaux espaces de travail commencent avec 20 MiB pour les photos, 100 MiB pour les vidéos, 50 MiB pour les fichiers, les fichiers audio et les vidéos circulaires, 20 MiB pour les messages vocaux et les GIF, et 5 MiB pour les autocollants. Dans les nouveaux espaces de travail, les GIF et les autocollants sont désactivés par défaut jusqu’à ce qu’ils soient activés. Les espaces de travail dont les politiques ont été enregistrées avant la mise en place des limites par type conservent tous les types activés et maintiennent leur limite unique pour chaque type. *La taille maximale des fichiers* s’applique à tous les types simultanément. La désactivation d’un type génère un enregistrement « `media.skipped` » ; les fichiers de taille inconnue ou trop volumineux ne sont pas téléchargés. Les fichiers volumineux bénéficient d’un temps de téléchargement supplémentaire en fonction de leur taille et d’une vitesse de base de 256 KiB/s. Les tâches survivent au redémarrage, mais les références expirées, la perte d’accès ou la suppression de fichiers peuvent tout de même empêcher leur récupération. Les tâches en attente conservent la limite qui leur est associée ; ainsi, une augmentation de la limite ne s’applique qu’aux nouveaux fichiers. La désactivation d’un type ou la réduction de sa limite exclut également les fichiers en attente concernés, chacun étant associé à un enregistrement « `media.skipped` » ; la désactivation des téléchargements met la file d’attente en pause jusqu’à ce qu’ils soient réactivés.

## Mettre en pause, verrouiller, se déconnecter et redémarrer

| Action ou état | Effet |
| --- | --- |
| Changer d'espace de travail | Modifie l’affichage du panneau ; les autres collecteurs conservent leur état. |
| Verrouillez le panneau ou fermez l'onglet | Le serveur et le système d’observation continuent de fonctionner. |
| Observation en pause | Interrompt ce collecteur et conserve les pièces jointes en attente de traitement. |
| Désactiver une source | Interrompt toute capture ciblée future ; les tâches multimédias mises en file d’attente pour celle-ci sont mises en attente tant qu’elle est désactivée. |
| Supprimer une source | Il ignore cette source et supprime les profils des utilisateurs concernés ; les enregistrements déjà sauvegardés restent dans le journal à ajout seul. Les pièces jointes encore en attente sont enregistrées comme ayant échoué (`source_removed`). En modes « dossier » et « compte entier », elles sont également exclues. |
| Modifier l'itinéraire de connexion | Nécessite une pause, ferme les anciens clients et annule les connexions inachevées. |
| Arrêtez le processus Python | Interrompt tous les espaces de travail ; aucune observation n’est effectuée lorsque l’outil est hors ligne. |
| Redémarrage après une période d’observation active | Tente de reprendre la portée enregistrée à l'aide de la session sauvegardée. Une pause manuelle annule cette intention. |

Le collecteur enregistre les déconnexions détectées, les nouvelles tentatives, les erreurs, les démarrages/arrêts et les signaux de vie. Les interruptions brèves peuvent échapper aux vérifications périodiques de connectivité. Après un redémarrage, les mises à jour manquées sont demandées à partir de la position de mise à jour enregistrée et les discussions observées sont revérifiées périodiquement ; voir [le format des preuves](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#durable-collection-and-process-receipts-02). Un instantané ajoute l’état actuel en tant que contexte, et l’écart reste enregistré.

## Isolement et vérification des comptes

Chaque espace de travail dispose de son propre journal, de ses propres autorisations, de sa clé de signature, de sa politique et de sa file d’attente. Seul son client actif peut y ajouter des observations en temps réel. Les clients rejetés, en attente, remplacés ou effectuant un test de connexion ne peuvent pas enregistrer de mises à jour en temps réel dans ce journal. Différents comptes peuvent observer le même groupe, mais leurs journaux restent distincts.

Chaque événement comprend le hachage précédent et une signature Ed25519. Les exportations couvrent l’ intégralité du journal de l’espace de travail grâce à un numéro de séquence fixe. Les filtres du panneau ne filtrent pas l’exportation ; la collecte peut se poursuivre au-delà de ses limites pendant sa préparation.

**La vérification du journal** contrôle la chaîne d’événements et les signatures à travers la limite affichée. Son résultat est effacé lorsque l’espace de travail change, et le panneau identifie les nouveaux enregistrements ajoutés après la vérification. L’exportation au format ZIP permet également de vérifier les médias collectés.

Conserver les empreintes et les points de contrôle de manière indépendante. Consulter la section « [Portée de la vérification](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#verification-scope) » pour les contrôles d'acquisition dans chaque mode, et la section « [Opérations quotidiennes](https://phishdestroy.io/tgwitness/fr/docs/reference/operations/) » pour la collecte de routine.
