Commandes de base¶
Après avoir exploré les fonctionnalités natives des groupes avec topics et essayé de communiquer au nom des bots ou comptes connectés, il est temps de maîtriser les statuts et les commandes de base de Hotline pour une gestion efficace des dialogues.
/ Commentaires internes¶
Tout message commençant par le symbole / et un espace après celui-ci est considéré comme un commentaire interne et n'est pas envoyé au client.
Exemples de commentaires internes dans les topics
/ J'ai parlé au client au téléphone, il a besoin d'un modèle différent de travail de notre équipe
/ TODO : vérifier avec le service marketing pour la promotion à venir et l'envoyer au client
/ @alex108 aide-moi à comprendre ce cas, voici #avancé
Capacités des commentaires :
- Discuter de la réponse avec l'équipe directement dans le contexte du dialogue
- Utiliser des #hashtags pour la catégorisation
- @mentionner des collègues pour attirer l'attention
- Épingler des commentaires avec des informations complémentaires importantes ou des tâches
Astuce : Utilisez activement les commentaires
Les commentaires internes avec / sont un excellent moyen de documenter les dialogues, de définir des tâches et de coordonner l'équipe directement dans le contexte de la conversation avec le client.
Astuce : Épinglez les commentaires importants
Épinglez les commentaires avec les tâches en cours ou les informations importantes sur le client en haut du topic pour un accès rapide.
Inversion de la logique d'envoi
Vous pouvez activer le paramètre REPLY_ONLY — alors tous les messages deviennent des commentaires, et seules les réponses explicites aux messages du client (reply) seront envoyées au client.
Statuts des topics¶
Chaque topic de dialogue a l'un des trois statuts, affiché par un carré coloré dans le nom du topic.
-
🟪 Nécessite attention/réponse¶
Statut :
user_answeredQuand défini :
- Lors de la réception d'un nouveau message de l'utilisateur
- Lors de la création d'un nouveau topic
- Lorsque l'utilisateur contacte à nouveau après fermeture
Commande :
/holdUtilisez
/holdpour garder explicitement le topic en état actif si une attention supplémentaire est requise (par exemple, des informations supplémentaires ou l'achèvement d'une tâche est attendu). -
🟨 En attente de réponse¶
Statut :
support_answeredQuand défini :
- Automatiquement lors de la première réponse de l'opérateur dans un topic violet (🟪 → 🟨)
- Retourne automatiquement du jaune au violet lors de la réception d'un nouveau message de l'utilisateur (avec un délai de 2 minutes pour ne pas interférer avec le dialogue actif)
Commande :
/waitUtilisez
/waitpour déplacer explicitement le topic en mode d'attente si la réponse a été donnée à l'utilisateur et qu'aucune action supplémentaire n'est requise. -
⬛️ Dialogue fermé¶
Statut :
closedQuand défini :
- Lors de l'exécution de la commande
/close - Automatiquement par délai d'expiration du paramètre
AUTOCLOSE(par défaut 48 heures après la dernière réponse de l'opérateur, peut être désactivé)
Commande :
/closeFermez le topic lorsque le problème du client est complètement résolu. Lors de la fermeture :
- L'utilisateur recevra un nouveau message de bienvenue du paramètre
WELCOMEau prochain contact - Les membres du groupe sans droits de gestion des topics ne peuvent plus écrire dans le topic fermé
- Le topic est automatiquement activé lors d'un nouveau message de l'utilisateur (⬛️ → 🟪)
- Lors de l'exécution de la commande
Surveillez les statuts
L'utilisation appropriée des statuts aide l'équipe à comprendre quels dialogues nécessitent une attention et lesquels attendent la réponse du client.
Mise en cache du nom du topic
Dans les applications Telegram, il existe parfois une fonctionnalité de mise en cache — l'icône de statut peut ne pas se mettre à jour immédiatement après l'envoi d'une commande. Si la synchronisation est nécessaire maintenant, renvoyez la commande /hold ou /wait, ou attendez l'actualisation du statut.
Référence rapide /help¶
Obtenez à tout moment une référence rapide des commandes disponibles et des statuts en envoyant la commande /help dans n'importe quel topic du groupe de travail.
Informations sur le topic /info¶
Obtenez des informations de base sur le topic actuel avec la commande /info.
- Nom de l'utilisateur et lien vers le profil (si disponible)
- ID de l'utilisateur
- Nom d'utilisateur et lien vers le chat (si disponible)
- Numéro de téléphone (si disponible)
- Langue (si définie)
- Connexion frontend
- Titre du chat et lien public (si disponible)
- ID du chat
- Connexion frontend
Informations automatiques
Vous pouvez activer le paramètre AUTO_INFO — alors les informations seront affichées automatiquement lors de la création de chaque nouveau topic.
Masquer les informations
Via le paramètre HIDE_INFO, vous pouvez masquer les informations client aux opérateurs réguliers et désactiver la commande /info dans le groupe.
Blocage /ban et /unban¶
Bloquez les utilisateurs sans tact avec la commande /ban et débloquez-les si nécessaire avec la commande /unban.
Le principe des commandes diffère selon le type de connexion.
Le blocage ajoute le user_id du dialogue privé correspondant au paramètre IGNORE_CHATS
Utilise la fonction de blocage native de Telegram
Ignorer /ignore et /unignore¶
Ignorez des dialogues individuels avec la commande /ignore pour qu'ils n'encombrent pas les messages entrants, et ramenez-les avec /unignore.
La commande /ignore diffère de /ban :
/banpour les bots ajoute non seulement leuser_idàIGNORE_CHATS, mais bloque aussi l'utilisateur côté Telegram — il ne pourra plus écrire au bot./ignorecesse simplement de réagir aux messages du dialogue sans bloquer l'expéditeur. L'utilisateur peut toujours écrire, mais ses messages ne créeront ni n'activeront de topic dans le groupe de travail.
- Ajoute le dialogue actuel à la liste runtime
ignore_chat_ids. - Enregistre la liste dans le paramètre
@IGNORE_CHATS@. - Ferme le chat via TDLib
closeChat. - Fonctionne pour tout type de dialogue : chats privés, groupes, supergroupes, canaux et topics.
- Pour les dialogues de topic, le
chat_idde la supergroupe est ajouté à la liste, pas le topic individuel.
- Retire le dialogue actuel de
ignore_chat_ids. - Met à jour le paramètre
@IGNORE_CHATS@. - Après l'exécution, les nouveaux messages du dialogue réapparaîtront dans le groupe de travail.
Quand utiliser /ignore
Utilisez /ignore pour les chats qui ne nécessitent pas de réponse de l'opérateur : diffusions de canaux, groupes de spam, chats de service ou dialogues temporairement non pertinents.
Référence rapide des commandes
Les commandes /ignore et /unignore sont listées dans la sortie /help.
Masquer un dialogue /hide¶
Supprimez un topic de dialogue backend du groupe backend tout en conservant les messages sur le frontend avec la commande /hide.
La suppression normale d'un topic dans le groupe backend supprime tous les messages sur le frontend dans le dialogue correspondant. La commande /hide permet de supprimer le topic sur le backend sans toucher aux messages sur le bot ou le compte connecté.
La commande est utile pour nettoyer le groupe backend des topics superflus ou obsolètes lorsqu'il n'est pas nécessaire de bloquer les messages de l'utilisateur ou du chat de groupe correspondant. Si en plus de supprimer le topic vous devez cesser de recevoir des messages du dialogue correspondant, vous pouvez exécuter la commande /ignore dans le topic avant d'appeler /hide.
Ce qui se passe lors de l'exécution :
- Le topic avec le dialogue est supprimé uniquement du groupe backend.
- Tous les messages dans le chat frontend correspondant sont conservés.
- Si un message arrive à nouveau dans le dialogue (et que le dialogue n'a pas été bloqué par
/ignoreou/ban), le topic est recréé et activé, et un message de bienvenue est envoyé à l'utilisateur ou au chat (s'il est activé sur la connexion). - Un rapport sur le masquage du topic est envoyé au topic
General.
L'opération est irréversible
Soyez prudent avec la commande /hide : il est impossible de restaurer les messages d'un topic supprimé car Hotline ne stocke pas le texte des messages sur ses serveurs.
Droits d'accès
La commande n'est disponible que pour les opérateurs listés dans le paramètre EXTENSIONS_ALLOWED.
Création de topics /new¶
Créez de nouveaux dialogues avec des utilisateurs ou rejoignez des chats avec la commande /new.
Les capacités de la commande diffèrent selon le type de connexion.
- Les bots dans Telegram ne peuvent pas écrire aux utilisateurs en premier, le dialogue avec un bot doit être initié par l'utilisateur. En savoir plus sur les capacités du compte utilisateur utilisé comme frontend.
- La commande ne peut être utilisée que pour recréer un topic supprimé si l'
USER_IDou leUSERNAMEde l'utilisateur est connu.
Format de commande (le symbole @ dans USERNAME n'est pas nécessaire) :
/new USERNAME | *USER_ID | #PHONE
- Peuvent écrire en premier aux autres utilisateurs
- Peuvent démarrer des bots, leur envoyer des commandes et recevoir des réponses dans le topic
- Peuvent rejoindre des chats via un lien public ou un lien d'invitation
Créer un dialogue avec un utilisateur ou un bot (le symbole @ dans USERNAME n'est pas nécessaire) :
/new USERNAME | *USER_ID | #PHONE
/new BOT_USERNAME | *BOT_USER_ID
Après avoir créé un topic avec un bot, vous pouvez lui envoyer des commandes via le topic, en les commençant par des doubles barres obliques //, par exemple :
//start
//help
Rejoindre un groupe ou un canal :
/new PUBLIC_CHAT_LINK
/new PUBLIC_CHANNEL_LINK
/new https://t.me/PUBLIC_CHAT_LINK
/new https://t.me/PUBLIC_CHANNEL_LINK
/new https://t.me/+PRIVATE_INVITE_HASH
Création de chats (fonctionnalité expérimentale)
Si vous spécifiez un USERNAME inexistant, un lien public pour un chat ou un bot, alors un chat avec le nom spécifié sera créé depuis le compte.
Connexions multiples
S'il y a plusieurs connexions dans un groupe backend, vous pouvez spécifier l'instance spécifique depuis laquelle le topic doit être créé (par défaut, la commande est exécutée pour chaque connexion du groupe).
Exemple de commande pour créer un dialogue par USERNAME avec une connexion spécifique (les accolades ne sont pas nécessaires) :
/new USERNAME i{INSTANCE_ID}
Création massive de topics pour les dialogues¶
Créez jusqu'à 1000 topics dans le groupe backend avec une seule commande à partir d'une liste ou d'un fichier — pratique pour migrer une base clients existante, des chats de groupe ou des listes de contacts d'événements.
Droits d'accès
La création massive de dialogues n'est disponible que pour les opérateurs listés dans EXTENSIONS_ALLOWED. La commande individuelle /new <query> reste disponible pour tous les opérateurs.
Commandes dans le sujet General :
/newou/new help— afficher l'aide sur les modes disponibles./new file— créer des dialogues à partir d'un fichier joint (une valeur par ligne, sans lignes vides)./new list VALEUR1,VALEUR2,...— créer des dialogues à partir d'une liste séparée par des virgules dans le message.
Valeurs prises en charge dans le fichier ou la liste :
*USER_ID— ID utilisateur Telegram*-CHAT_ID— ID de groupe ou de canal (avec signe moins)#PHONE— numéro de téléphoneUSERNAME— nom d'utilisateur (sans@)t.me/...ou lien d'invitation
Comment ça marche :
- Délai de 5 secondes entre les créations de dialogues.
- Tous les dialogues créés obtiennent le statut
closed. - À la fin de la commande, un rapport CSV est envoyé au sujet
Generalavec le résultat pour chaque destinataire. - Un seul bulk
/newpeut être exécuté à la fois dans un groupe backend. - Maximum 1000 dialogues par commande.
Migration rapide de base
Si vous avez déjà une liste de clients dans Excel ou CSV, copiez simplement la colonne avec les identifiants dans un fichier, ajoutez le préfixe pour les valeurs numériques (* pour user_id ou chat_id; # pour les numéros de téléphone) — et obtenez des topics prêts pour les dialogues.
Les topics sont activés par tout message sortant ; pour les messages entrants, un message de bienvenue peut également être envoyé selon les paramètres.
Modules supplémentaires¶
En plus des commandes de base du côté du groupe backend, Hotline dispose d'un certain nombre de modules qui peuvent être très utiles pour les opérateurs du support.
Réponses rapides avec la commande /say
Création et envoi rapides de messages préparés dans les sujets. Prend en charge le texte, les médias, les albums et le transfert de messages.
Diffusions utilisateurs avec la commande /send
Diffusions massives à tous ou à des clients sélectionnés avec possibilité de planification.
Tags et tunnels de vente avec la commande /mark
Attribuez des tags visibles aux sujets pour la segmentation, l'organisation des tunnels de vente et les automatisations.
Export de base clients avec la commande /export
Exportez les données clients vers un fichier CSV pour sauvegarde ou analyse.
Analytics d'équipe
Statistiques détaillées des performances des opérateurs, analyse des demandes clients et rapports pour diverses périodes.
Commandes personnalisées¶
Dans Hotline, il est possible d'ajouter des commandes personnalisées pour étendre les fonctionnalités :
- Intégration avec des systèmes externes (CRM, ERP, gestionnaires de tâches)
- Automatisation de processus métier spécifiques
- Création de commandes propres pour vos besoins
- Connexion de services externes via des webhooks