Référence / Configuration
Telegram · Première configuration et paramètres
L'assistant de configuration, les objectifs, les niveaux d'interface, les chemins de connexion et les paramètres partagés par un groupe de comptes.
TgWitness / Documentation · Pour commencer
Un nouvel espace de travail s’ouvre /first-run. Le premier écran vous demande ce que vous souhaitez faire : « Juste télécharger », « Suivre les discussions » ou « Preuves pour une affaire ». Ce choix définit l’objectif et le niveau de l’interface : « Simple » pour « Juste télécharger », « Standard » pour les deux autres. Le niveau détermine le nombre de champs affichés dans chaque formulaire ; chaque page reste accessible depuis le menu. D’autres options sur le même écran permettent de définir explicitement le niveau, le thème et le fuseau horaire ; la liste des langues se trouve dans l’en-tête de l’assistant. Les écrans suivants concernent la connexion, Telegram et les discussions. Les chemins de connexion restent masqués pendant la vérification automatique et s’affichent en cas d’échec. Une barre de progression en cinq étapes permet de revenir aux étapes déjà terminées. Chaque réponse est enregistrée sur le serveur dès qu’elle est modifiée ; ainsi, un rafraîchissement de la page reprend la même étape. Le dernier écran répertorie les réponses et vous permet de revenir à n’importe laquelle d’entre elles.
La langue, le fuseau horaire IANA, le thème et le niveau sont enregistrés par opérateur et par espace de travail. Les valeurs par défaut sont la langue du navigateur, le fuseau horaire de l’appareil, le thème du système et l’ interface simple. Le changement de langue ne modifie pas la session du panneau. Les heures indiquées dans le journal signé ne changent jamais.
/settings modifie les mêmes enregistrements que l’assistant. La recherche couvre les champs principaux, les paramètres et les formulaires étendus ; un champ masqué peut être ouvert sans changer de niveau. Les niveaux ne changent que l’affichage : le serveur vérifie lui-même les autorisations. Une section dont tous les réglages dépassent le niveau choisi les affiche tout de même. Les réglages de collecte et la première connexion relèvent de l’administrateur de l’espace de travail.
La page des paramètres est une liste. La carte du compte, en haut, ouvre Compte Telegram. En dessous, chaque ligne nomme une section et la valeur utilisée : Quelles discussions ? et Connexion sous Compte ; Objectif, Enregistrement et fichiers, Protection de l'enregistrement et Notifications et copie externe sous Enregistrement ; Langue, heure et apparence sous Panneau ; et les pages expertes sous Autres outils. À côté de la liste, une carte indique si les valeurs recommandées sont actives, avec les principales valeurs et Annuler la dernière modification, et Modifications récentes liste les dernières modifications.
Une section s'ouvre dans une fenêtre au-dessus de la liste et dispose de sa propre adresse, telle que
/settings/connection. La flèche de retour, le bouton de fermeture, la touche Échap, un clic en dehors de la
fenêtre et le bouton « Retour » du navigateur permettent de revenir à la liste. La sélection Quels chats ? est conservée avec
Enregistrer la sélection de chats ; la fermeture sans enregistrement des modifications donne lieu à une demande de confirmation. L'enregistrement conserve les
types de sources, les discussions exclues, les actions personnelles et les paramètres de nouvelle discussion de Plus d'outils → Sources →
Portée ; une discussion choisie ici est retirée de la liste des discussions exclues et enregistrée comme une
source sélectionnée manuellement. Chaque modification affiche
Annuler pendant 20 secondes, et chaque entrée dans Modifications récentes peut être annulée ultérieurement. Une
annulation ne rétablit que les paramètres modifiés par cette entrée, y compris les limites de fichiers personnalisées.
Lorsqu’une modification ultérieure a touché les mêmes paramètres, l’annulation est refusée et rien
ne change. Une annulation correspond à un nouvel enregistrement settings.changed dans le journal.
| Niveau | Champs | Barre latérale |
|---|---|---|
| Simple | L'essentiel, rien que l'essentiel | Accueil, Discussions, Journal, Exportations, Comptes et Paramètres |
| Norme | Paramètres communs avec explications | Ajoute Tableau des cas, Sources, Accès et Documentation sous Autres outils |
| Expert | Tous les champs, limites et détails techniques | Ajoute également Carte du système, Topologie du réseau, Extras, Demander à l’archive, Paramètres, Compte, Journal système et Intégrations sous Plus d’outils |
Les noms des sections restent les mêmes à tous les niveaux. Ouvrez Apparence au bas de la barre latérale pour modifier le niveau. Le guide du panneau décrit chaque section.
Objectifs#
| Objectif | Collecte | Fichiers | Services externes | Adresse du serveur |
|---|---|---|---|---|
| Simplement télécharger | L’exportation ponctuelle démarre à partir de l’écran de configuration final ; la collecte continue reste désactivée. | Photos jusqu’à 20 Mo | Horodatages | Automatique |
| Suivre les discussions | En continu | Photos et vidéos d'une durée maximale de 60 secondes / 20 Mo | Horodatages et notifications de problèmes | Automatique |
| Éléments de preuve à l'appui d'une affaire | En continu | Tous les fichiers jusqu’à 1 Go | Horodatages, drand, notifications | Non, le masquer |
La copie hors site, le bot « witness » et la vérification du code sont recommandés à des fins de preuve. Les adresses de stockage et de notification nécessitent d’abord une destination. Une fonctionnalité qui communique avec un service externe demande l’autorisation d’envoyer des requêtes en dehors de Telegram ; la désactiver entraîne la désactivation des horodatages, des notifications et de la copie hors site.
La modification de l’objectif affiche d’abord la différence, et les modifications manuelles peuvent être conservées. Un champ qui diffère de l’objectif est marqué « Modifié par vous » et peut être restauré. La révision des paramètres empêche qu’une différence révisée ne vienne remplacer une modification effectuée dans un autre onglet.
Connexion#
Tant qu'aucun itinéraire n'a été sélectionné ici, un nouvel espace de travail utilise MTProxy automatique · listes publiques avec l'option Masquer l'adresse (sécurité de la connexion). Le choix Automatique ci-dessous correspond à une étape de configuration distincte.
Automatic tente d’abord WARP, puis les serveurs MTProxy publics, puis une connexion directe, cette dernière n’étant utilisée que lorsque l’adresse du serveur peut être affichée. Automatic et WARP peuvent installer des composants vérifiés par hachage et enregistrer le serveur auprès de Cloudflare ; sans ce consentement, Automatic ignore WARP. WARP utilise le gestionnaire wgcf/wireproxy existant et un port SOCKS5 local ; la table de routage du système n’est pas modifiée.
L’importation en masse demande l’itinéraire avant que toute session n’atteigne Telegram : WARP (par défaut), MTProxy public ou direct. La vérification de session utilise le même type d’itinéraire, et chaque compte importé dispose de son propre tunnel WARP avant sa première connexion.
Votre propre proxy accepte tg://proxy, socks5://, http:// et https://. Le certificat d’un
proxy HTTPS est vérifié avant que les identifiants ne lui soient envoyés.
Une vérification de connexion est valable pendant cinq minutes et est liée à l’itinéraire, à la politique et aux réponses de l’assistant ; toute modification de l’un de ces éléments nécessite une nouvelle vérification. L’option « Continuer sans vérification » est disponible et ne remplace pas la connexion à Telegram. L’itinéraire choisi est revérifié en arrière-plan, et la fonction « Automatique » relance sa chaîne après une perte de connexion. Lorsqu’aucun proxy public ne répond, le compteur passe au rouge et déclenche des actions WARP et de revérification.
Groupes de comptes#
Les comptes d'un groupe partagent leurs paramètres. Ouvrez Comptes → Groupes et paramètres partagés → Paramètres partagés, ou Paramètres du groupe sur la page Paramètres d'un compte.
Le groupe partage l’objectif, les fichiers enregistrés, les horodatages, le drand, les notifications de problèmes, la copie hors site, les demandes en dehors de Telegram, le mode IP, les éléments à enregistrer, le calendrier de vérification, les règles de notification, les paramètres de rapport, les paramètres et l’itinéraire de connexion. Les destinataires des notifications, les identifiants du proxy et les informations de connexion restent propres à chaque compte, tout comme le démarrage et la mise en pause de la collecte.
- Chaque membre suit le groupe. Dans les paramètres, on peut attribuer une valeur 🔗 à partir du groupe ou ✏️ une valeur personnalisée ; l’option « Revenir à la valeur du groupe » rétablit la valeur par défaut.
- Une modification répertorie les comptes concernés (s'applique à 2 comptes sur 3) et demande confirmation pour chaque compte avant de remplacer une valeur. Les comptes non cochés conservent leur valeur d'origine.
- Un paramètre que le groupe ne partage pas reste sur « Non partagé » : chaque compte conserve sa propre valeur jusqu’à ce que vous cliquiez sur « Partager cette valeur ».
- La copie des paramètres d'un compte applique les valeurs du compte sélectionné à l'ensemble du groupe.
- Lorsqu’un compte est déplacé vers un groupe, on lui demande : « Voulez-vous adopter les paramètres du groupe ? ». Sinon, il conserve ses propres paramètres, signalés par ✏️. Les comptes ajoutés ultérieurement adoptent d’emblée les paramètres du groupe.
- Un compte d’observation conserve son mode IP jusqu’à ce qu’il soit mis en pause.
Chaque modification est consignée dans le journal signé de l'espace de travail principal et de chaque membre concerné. La suppression d'un groupe conserve ses comptes et leurs valeurs actuelles.
La page du groupe /groups/<id> affiche les membres, les éléments nécessitant une attention particulière et les discussions
visibles par plusieurs comptes. Voir « Groupes de comptes ».
Espaces de travail existants#
Un espace de travail comportant une session ou une configuration déjà effectuée n'affiche pas l'assistant. Ses valeurs ne sont pas remplacées par un objectif lors du chargement de la page. Masquer un champ ne désactive pas la fonctionnalité ni ne supprime sa valeur. Ouvrir la première configuration dans « Paramètres » affiche à nouveau les mêmes écrans ; les valider ne lance aucune nouvelle exportation ni observation et l'indique clairement, et une sélection de chat modifiée n'est conservée qu'en cliquant sur Enregistrer la sélection de chat.
L'estimation de la taille et de la durée porte sur un maximum de trois discussions sélectionnées et jusqu’à 20 messages par discussion. Il s’agit d’une estimation : elle ne tient pas compte des limites imposées par Telegram, de la vitesse d’un serveur donné ni des fichiers présents dans chaque discussion.