Export de base de données client avec la commande `/export`¶

La commande /export exporte les dialogues Hotline sous forme de rapport tabulaire contenant les utilisateurs et les chats de groupe. Vous pouvez exporter tous les dialogues actifs, sélectionner les dialogues selon une ou plusieurs étiquettes, exclure certaines étiquettes ou obtenir les topics supprimés. Vous pouvez aussi ajouter des données Telegram actuelles : langue, username, nom et téléphone.

Dans cette page, une étiquette désigne une marque Hotline (mark) créée et attribuée avec la commande /mark. La syntaxe et le champ CSV conservent donc le terme technique mark.

Comment ça fonctionne¶

La commande fonctionne uniquement dans le topic General du groupe backend. Au démarrage, un message apparaît dans General et l'opérateur reçoit une notification dans son chat privé avec le bot de configuration.

Le CSV terminé est envoyé à l'opérateur dans ce chat privé. Seul un résumé avec le mode, le nombre de lignes et les erreurs est publié dans General. Si le bot de configuration ne peut pas envoyer de message privé à l'opérateur, l'export ne démarre pas.

Fonctionnalités principales¶

Export de tous les dialogues actifs
Sélection selon une ou plusieurs étiquettes
Exclusion des dialogues portant certaines étiquettes
Export des informations sur les topics supprimés
Ajout des données Telegram actuelles : username, nom, langue et téléphone
Sélection d'une connexion lorsque plusieurs utilisent le même groupe backend
Arrêt d'un export en cours

Format d'export¶

Pour les dialogues actifs, le CSV contient les champs suivants :

Champ	Description
`chat_id`	Identifiant du chat ou de l'utilisateur Telegram ; les topics utilisent `chat_id(thread_id)`
`last_date`	Date du dernier message dans le topic
`status`	Statut actuel du dialogue (`user_answered`, `support_answered`, `closed`)
`title`	Nom du topic
`frontend_type`	Type de topic (`private`, `group`, `channel`, etc.)
`topic_link`	Lien vers le topic dans le groupe backend
`marks`	Marques Hotline attribuées avec `/mark`, appelées étiquettes dans cette page
`ignore_chat`	Indique si le chat figure dans `IGNORE_CHATS`

Pour les dialogues supprimés, les champs disponibles sont chat_id, last_date, status, title et frontend_type.

L'option with ajoute les champs choisis username, name, lang et phone. La colonne error est également ajoutée si Hotline n'a pas pu obtenir les données Telegram actuelles d'un chat.

Format CSV

Le fichier CSV peut être ouvert dans Excel, Google Sheets ou importé dans d'autres systèmes CRM pour un traitement ultérieur.

/export envoie le rapport CSV à l'opérateur. Avec un accès API, le même rapport terminé peut être récupéré en TSV via /api/v2/export/{export_id}/report?format=tsv.

Appel de la commande¶

Aide¶

/export
/export help

Les deux commandes affichent l'aide en anglais.

Tous les Dialogues Actifs¶

/export all

Exporte tous les dialogues actifs de la connexion actuelle.

Dialogues avec des Étiquettes¶

/export mark deal
/export mark vip,deal

Si plusieurs étiquettes sont indiquées, le rapport inclut les dialogues qui en possèdent au moins une. /export mark vip,deal sélectionne les dialogues étiquetés vip ou deal.

Si une étiquette n'existe pas, l'export ne démarre pas. Séparez les noms par des virgules.

Exclure des Étiquettes¶

/export all exclude spam,test
/export mark vip,deal exclude blocked

exclude retire les dialogues qui possèdent au moins une des étiquettes indiquées. Cette option fonctionne avec all et mark.

Dialogues Supprimés¶

/export deleted

Exporte les informations de l'archive des topics supprimés. Les étiquettes et exclude ne sont pas utilisés dans ce mode.

Les données proviennent de la base Hotline. Pour vérifier les topics et archiver ceux qui n'existent plus, exécutez /sync all deleted dans General. Avec de nombreux dialogues, testez d'abord dry sur un nombre limité, par exemple /sync 10 dry.

Données Supplémentaires¶

/export all with username,name
/export mark vip,deal with lang,phone
/export deleted with data

Après with, indiquez username, name, lang et phone, séparés par des virgules. data est un raccourci pour les quatre champs.

Les données actuelles sont récupérées via Telegram, ce qui augmente la durée de génération. En cas de restrictions Telegram pour les comptes ou bots connectés, certaines lignes peuvent contenir une valeur dans error au lieu des données demandées.

Sélectionner une Connexion¶

/export all instance INSTANCE_ID
/export mark vip,deal instance INSTANCE_ID with data

instance INSTANCE_ID limite l'export à la connexion indiquée. Cette option est utile lorsque plusieurs bots ou comptes utilisent le même groupe backend.

Arrêter l'Export¶

/export stop

Arrête l'export actif de la connexion. Aucun rapport partiel n'est créé. Un seul export peut être exécuté à la fois par connexion.

Notes importantes¶

Droits d'accès

L'accès est contrôlé par EXTENSIONS_ALLOWED. Si la liste est vide ou absente, tous les opérateurs du groupe backend peuvent utiliser la commande. Une liste non vide la réserve aux opérateurs indiqués.

Confidentialité

Le CSV peut contenir des identifiants de chat, des attributs internes de segmentation, des noms et des téléphones. Respectez les règles de confidentialité. Il est recommandé de télécharger immédiatement les fichiers puis de les supprimer du chat.

Export régulier

Effectuez des exports réguliers de la base de données pour créer des sauvegardes.

Limite de Taille

Un rapport peut contenir jusqu'à 100 000 lignes. Si le résultat dépasse cette limite, l'export se termine par une erreur.

Export de base de données client avec la commande /export¶