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
- Filtrage par mots-clés — activation automatique de la diffusion lorsque des mots spécifiés apparaissent dans les paramètres
GROUPS_KEYWORDSetCHANNELS_KEYWORDS
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
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.
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).
Valeur par défaut : AUCUNE (toutes les informations sont disponibles).
Contrôle des messages sortants par mots-clés :
RESTRICTED_KEYWORDS_FRONTEND
Tableau de mots-clés interdits pour les messages entrants. Les messages avec les mots spécifiés 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 marque ou produit dans les chats Telegram thématiques.
-
Gestion de Communauté
Gérez plusieurs chats communautaires depuis une interface opérationnelle unique.
-
Modération de Contenu
Modération automatisée des chats de groupe avec filtres de mots-clés et contrôle des opérateurs.
-
Gestion de Canal
Publication d'équipe sur les canaux avec approbation et planification du contenu.