Travailler avec les Chats¶
Les bots et comptes connectés à Hotline peuvent être dans des chats Telegram de différents types : groupes, groupes de sujets et canaux. Cela permet d'organiser la surveillance des communications, les réponses rapides d'équipe et la publication de contenu au nom du bot ou compte connecté.
Fonctionnalités de Travail avec les Chats¶
Lors de l'activation des paramètres MONITOR_GROUPS ou MONITOR_CHANNELS dans les paramètres de connexion, les fonctions suivantes deviennent disponibles :
- Réception de messages depuis les chats vers le sujet correspondant du groupe backend Hotline
- Envoi de messages vers les chats au nom du bot ou compte connecté via le groupe backend
- Rejoindre des chats via un lien et créer de nouveaux chats avec la commande
/new - Gérer les membres des chats lorsque le bot ou le compte connecté dispose des droits d'administration nécessaires
- Filtrage par mots-clés — activation automatique de la diffusion lorsque des mots spécifiés apparaissent dans les paramètres
GROUPS_KEYWORDSetCHANNELS_KEYWORDS
Surveillance des Grands Chats (nouveau)
Hotline permet désormais une surveillance fiable des grands groupes et canaux avec un volume élevé de messages et des milliers de membres.
Fonctionnalités de la Version Gratuite
Dans la version gratuite de Hotline, lors de l'activation de chaque sujet de chat, un message de bienvenue avec le copyright Hotline du paramètre WELCOME sera envoyé.
De plus, les sujets sont automatiquement fermés après le délai du paramètre AUTOCLOSE en l'absence d'activité.
Pour configurer la fermeture automatique des sujets et désactiver le message de bienvenue, achetez la version payante du système, contactez le service d'assistance.
Limitations avec la Protection du Contenu
Si un chat a activé la protection du contenu (Content Protection), les pièces jointes de ce chat ne seront pas transférées vers le groupe backend, mais le texte du message sera transmis.
Fonctionnalités de Connexion¶
Capacités :
-
Le bot peut voir tous les messages dans les chats où il a été ajouté par un administrateur de chat
-
L'équipe peut répondre au nom du bot dans les chats via le groupe backend
- Filtrage des chats par mots-clés
- Surveillance et duplication des messages depuis les chats privés
Fonctionnalités Importantes :
Ajout du Bot au Chat
Seul un administrateur de chat peut ajouter le bot à un chat. Le bot ne peut pas rejoindre les groupes de manière indépendante.
Si vous devez envoyer des messages depuis le bot dans le chat, assurez-vous que le bot dispose de droits suffisants pour cela.
Désactiver le Privacy Mode dans BotFather
Si vous prévoyez de travailler dans des groupes via le bot, assurez-vous de désactiver le paramètre Privacy Mode pour celui-ci dans @BotFather. Par défaut, ce mode est actif pour les bots et ils ne voient pas tous les messages dans les groupes.
Comment désactiver :
- Ouvrez @BotFather
- Envoyez
/mybots - Sélectionnez votre bot
Bot Settings→Group Privacy→Turn off
Capacités :
- Peuvent rejoindre de manière indépendante les chats publics et privés, y compris les groupes de sujets (rejoindre les chats avec la commande
/newen spécifiant un lien ou un nom de chat) - Création de nouveaux chats au nom du compte connecté
-
API Actions pour la gestion programmatique des chats
-
Votre équipe d'opérateurs peut répondre au nom du compte dans les chats
- Filtrage des chats par mots-clés
- Surveillance et duplication des messages depuis les chats privés
Ajout aux Chats¶
Seul un administrateur de chat peut ajouter le bot au chat :
- Ouvrez le chat nécessaire dans Telegram
- Cliquez sur le nom du chat → Ajouter des Membres
- Trouvez votre bot par
username - Sélectionnez-le et ajoutez-le au chat
- Accordez des droits d'administrateur si nécessaire
Méthode 1 : Méthode Standard dans Telegram
Un compte peut rejoindre de manière indépendante un chat public ou être invité dans un groupe privé de la manière habituelle via l'application Telegram.
Méthode 2 : Commande /new via le Groupe Backend
Utilisez la commande /new dans le sujet General du groupe backend Hotline :
/new CHAT_USERNAME
ou
/new https://t.me/CHAT_USERNAME
ou
/new https://t.me/+INVITE_HASH
Gestion des Chats de Groupe¶
Depuis le sujet du dialogue de groupe correspondant dans le groupe backend, vous pouvez gérer le chat d'origine au nom du bot ou du compte connecté :
| Commande | Action |
|---|---|
/invite USER |
Ajouter un utilisateur au chat |
/kick USER |
Retirer un utilisateur du chat |
/members [QUERY] |
Afficher les membres ou rechercher ceux qui correspondent à la requête |
/leave |
Faire quitter le chat au bot ou au compte connecté |
/title NEW_TITLE |
Modifier le titre du chat représenté par le sujet du groupe backend |
Le paramètre USER peut être un username, un numéro de téléphone au format international ou *USER_ID, par exemple : /invite example_user, /invite +79991234567 ou /invite *123456789.
Le paramètre QUERY est une chaîne de recherche facultative correspondant au nom ou au username d'un membre. La commande /members sans paramètre renvoie jusqu'à 200 membres, tandis que /members QUERY renvoie jusqu'à 200 résultats.
Les commandes fonctionnent pour les chats de groupe ordinaires et les sujets des supergroupes. Le bot ou le compte connecté doit disposer des droits Telegram nécessaires pour l'action sélectionnée.
Seuls les opérateurs répertoriés dans le paramètre EXTENSIONS_ALLOWED peuvent utiliser ces commandes. Si la liste du paramètre est vide, les commandes sont disponibles pour tous les opérateurs du groupe backend.
Activation et Gestion des Sujets¶
Avec les paramètres MONITOR_GROUPS ou MONITOR_CHANNELS actifs, un sujet pour le chat côté groupe backend est créé et activé automatiquement :
- Lors de la mention (@mention) du compte ou bot connecté dans le chat
- Lors de la réponse (reply) à un message du compte ou bot connecté
- Lorsque des mots-clés des paramètres
GROUPS_KEYWORDSouCHANNELS_KEYWORDSapparaissent - Sur tout message entrant avec le paramètre
LEAVE_CLOSEDactif
Gestion de la Diffusion¶
La diffusion continue de tous les messages du chat vers le sujet du groupe backend est effectuée uniquement lorsque le sujet a un statut différent de closed (jaune 🟨 ou violet 🟪, activé par les commandes /wait ou /hold).
Si vous fermez le sujet avec la commande /close, la diffusion des messages s'arrête.
En savoir plus sur les statuts des sujets
Paramètre LEAVE_CLOSED
Avec le paramètre LEAVE_CLOSED actif, les nouveaux sujets sont créés à l'état fermé. Seuls les messages avec des mots-clés seront transmis, et la diffusion est activée uniquement par décision de l'opérateur.
Arrêter la Surveillance des Chats
La suppression d'un sujet dans le groupe backend n'arrête pas la surveillance du chat et n'empêche pas la réactivation du sujet lorsqu'il reçoit des messages correspondant aux règles du paramètre GROUPS_KEYWORDS.
Pour arrêter la surveillance d'un chat sans le quitter, utilisez la commande /ignore dans son sujet (ou /unignore pour reprendre la surveillance).
Particularité des Diffusions depuis d'Autres Groupes de Sujets
Lors de la surveillance d'un groupe de sujets, chaque sujet est perçu par le système comme un chat séparé. Par conséquent, chaque sujet doit être activé séparément (par mention, réponse ou mot-clé).
Filtrage des Chats par Mots-clés¶
Les sujets pour les chats peuvent être créés et activés automatiquement lorsque des messages avec des mots-clés spécifiés y apparaissent.
Les mots-clés et règles de filtrage sont définis dans les paramètres GROUPS_KEYWORDS ou CHANNELS_KEYWORDS.
Comme ensemble unifié de mots d'arrêt, le paramètre RESTRICTED_KEYWORDS_FRONTEND peut être utile.
Travailler avec les Sujets Activés¶
Lorsqu'un sujet est activé par mots-clés :
- Tous les messages du chat sont diffusés vers le sujet, en commençant par le message contenant le mot-clé
- Les messages diffusés affichent des liens de profil des auteurs
- Les opérateurs peuvent répondre dans le chat au nom du bot/compte
- Peuvent écrire en DM à l'auteur du message
- Ou suivre passivement la conversation sans participation
Pour arrêter la diffusion, envoyez la commande /close dans le sujet.
Configuration Avancée du Filtre
Si vous avez besoin de paramètres de filtre plus flexibles (expressions régulières, correspondance exacte, conditions complexes), contactez le service d'assistance Hotline.
Paramètres Utilisés¶
Activation de la surveillance des messages depuis les groupes ou canaux :
MONITOR_GROUPS
Créer et activer des sujets lorsque de nouveaux messages apparaissent dans les chats de groupe dans lesquels le compte ou le bot connecté est membre.
Valeur par défaut : FALSE (les groupes ne sont pas surveillés).
MONITOR_CHANNELS
Créer et activer des sujets lorsque de nouveaux messages apparaissent dans les canaux auxquels le compte connecté est abonné ou dans lesquels le bot est membre.
Valeur par défaut : FALSE (les canaux ne sont pas surveillés).
Désactivation de l'accueil :
WELCOME
Message de bienvenue que l'utilisateur reçoit au premier contact et lorsque sa demande a été fermée (passée au statut /close). Peut être complètement désactivé sur la version payante. La version gratuite nécessite un lien Hotline dans le message de bienvenue.
Valeur par défaut : message de bienvenue standard en anglais.
Désactivation de la fermeture automatique des sujets :
AUTOCLOSE
Période de fermeture automatique du dialogue après la dernière réponse de l'opérateur, spécifiée en heures.
Si le sujet avec l'utilisateur était fermé, il recevra le message de bienvenue du paramètre WELCOME au prochain contact. La version gratuite a une période de fermeture automatique maximum de 48 heures.
Valeur par défaut : 48 heures.
Les mots-clés et règles de filtrage sont définis dans les paramètres :
GROUPS_KEYWORDS
Tableau de mots-clés et phrases pour filtrer les messages des chats de groupe. Active les sujets uniquement lors de la correspondance avec les mots spécifiés.
Valeur par défaut : DÉSACTIVÉ (pas de filtrage).
CHANNELS_KEYWORDS
Tableau de mots-clés et phrases pour filtrer les messages des canaux. Active les sujets uniquement lors de la correspondance avec les phrases spécifiées.
Valeur par défaut : DÉSACTIVÉ (pas de filtrage).
Masquage des informations sur les participants du chat aux opérateurs :
HIDE_INFO
Détermine quelles informations client sont masquées aux opérateurs (noms, titres de groupe, liens utilisateur, sortie de la commande /info).
Avant de l'utiliser, vous devez définir AUTO_INFO sur FALSE.
Valeur par défaut : AUCUNE (toutes les informations sont disponibles).
Contrôle des messages sortants par mots-clés :
RESTRICTED_KEYWORDS_FRONTEND
Liste de mots-clés interdits et de leurs combinaisons pour les messages entrants. Les mots individuels fonctionnent comme des conditions OU, les listes imbriquées comme des groupes ET. Les messages correspondants ne sont pas transférés au groupe backend.
Valeur par défaut : AUCUN (pas de filtrage).
Contrôle des messages entrants par mots-clés :
RESTRICTED_KEYWORDS_BACKEND
Tableau de mots-clés interdits pour les messages sortants. Déclenche une erreur lors de la tentative d'envoi d'un message avec les mots spécifiés.
Valeur par défaut : AUCUN (pas de filtrage).
Scénarios d'Utilisation Pratique¶
-
Support de Chat d'Équipe
Support client 24/7 dans les chats par une équipe d'opérateurs au nom du bot ou compte.
-
Recherche de Prospects
Recherche automatique de clients potentiels dans les chats Telegram par requêtes de mots-clés.
-
Surveillance des Mentions
Suivez les mentions de votre entreprise, de vos produits ou de vos concurrents dans les chats et canaux thématiques.
-
Publication Régulière
Publiez des actualités, des annonces ou du contenu dans les chats au nom d'un compte ou d'un bot via le groupe backend.
-
Sauvegarde des Messages
Enregistrez et dupliquez les messages des chats fermés ou importants dans votre groupe backend privé.