Base de connaissances

hotline.tg

Un robot pour le grand public Telegram mailings et segmentation d'audience

Capacités de l'équipe /send, /mark et /export pour Telegram CRM Hotline.
Après avoir connecté votre bot ou votre compte utilisateur régulier à Hotline CRM (se connecte en parallèle aux robots ou comptes existants, n'affecte pas leur travail, fait gratuitement en quelques minutes), il devient possible d'utiliser trois commandes puissantes interconnectées de notre bot d'extension du côté de votre groupe backend :

/send – pour les envois massifs de messages individuels ou de modèles avec chaînes de messages aux utilisateurs de Telegram

/mark – pour attribuer des étiquettes (statuts supplémentaires) aux sujets utilisateur et déterminer le comportement des étiquettes

/export – exporter sous forme de fichier une liste des utilisateurs avec lesquels il y a eu une correspondance via le système Hotline et/ou portant l'étiquette spécifiée
Attention: Cette page contient des fragments avec traduction automatique. Si vous avez du mal à comprendre ces informations, essayez de changer la langue en anglais ou en russe et utilisez votre système de traduction de site Web de confiance.
Connexion du robot d'extension
Pour utiliser les commandes décrites dans cet article, vous devez ajouter une extension bot @hotlinetg_extensions_bot avec des droits d'administrateur sur votre groupe backend.

Version de base Hotline (le cœur du système) est responsable de la diffusion fiable du flux de messages avec les utilisateurs et ne contient que fonctionnalité principale.
Limites du système de messagerie
La version gratuite du système permet d'envoyer via le système de messagerie une commande /send jusqu'à 200 messages par mois. La version payante du système permet d'envoyer jusqu'à 1000*N messages par mois, où N est égal au nombre d'opérateurs du système dans un abonnement payant.

Si vous devez étendre les limites standard d'envoi de messages, veuillez contacter Soutien.

Restrictions pour les équipes /mark et /export Réf.
Aide rapide
Pour obtenir une aide rapide en anglais dans votre groupe backend, vous pouvez envoyer une commande à tout moment /send, /mark ou /export sans paramètres dans le contexte approprié (dans General sujet, sujet personnalisé ou dans une réponse à un message).
Limitation d'accès
Fonctions administratives de l'équipe /send, /mark и /export disponible uniquement à partir de General sujet du groupe backend, l'accès à ceux-ci peut être limité via un paramètre spécial @EXTENSIONS_ALLOWED@ dans le bot d'installation @hotlinetg_bot.

Options d'utilisation des commandes /send

Équipe /send vous permet d'envoyer des messages individuels ou même des fils de discussion contenant tous les principaux types de messages Telegram: texte avec n'importe quelle mise en forme, autocollants, messages vocaux, vidéos, images, fichiers.

Les personnes suivantes peuvent être indiquées comme destinataires du courrier :
  • opérateur exécutant la commande /send, pour tester le message (facultatif test)
  • tous les utilisateurs avec lesquels il y a un dialogue (sujet) via le système Hotline (option all)
  • liste des utilisateurs dans le fichier joint (option file)
  • liste des utilisateurs séparés par des virgules dans la commande elle-même (option list)
  • tous les utilisateurs qui reçoivent l'étiquette correspondante par la commande /mark (option mark)

Vous pouvez envoyer à la fois des messages individuels (sans enregistrer le mailing comme modèle) et des chaînes de messages (en enregistrant un seul message ou une séquence de messages comme modèle avec les options nécessaires).

Pour chaque message envoyé dans le paramètre facultatif [now,delay,datetime],delay,datetime] vous pouvez spécifier l'heure d'envoi :
  • now (à envoyer au moment de l'appel de la commande, utilisé par défaut)
  • avec retard dans le format 100s 10min 5h 2j (de 1 à 4 paramètres avec le nombre de secondes, minutes, heures ou jours requis) à partir du moment où la commande a été envoyée ou du moment où le message précédent de la chaîne a été envoyé)
  • date et heure fixes d'expédition par UTC dans le format 2024-12-27 14:25:55
Équipe /send a 3 contextes principaux d’utilisation :

Les paramètres facultatifs pour les commandes sont indiqués entre crochets [carrés].

/send dans General sujet comme reply envoyer un message

Envoyer un message à la liste de destinataires souhaitée
↳ /send test [now,delay,datetime] [instance_id]
Envoi spécifié dans reply message à vous-même pour tester
↳ /send all [now,delay,datetime] [instance_id]
Envoi spécifié dans reply message à tous les utilisateurs avec lesquels il y a déjà eu un dialogue via Hotline
↳ /send file [now,delay,datetime] [instance_id]
Envoi spécifié dans reply message à tous les utilisateurs, user_id qui sont indiqués dans le fichier ci-joint. Liste user_id dans un fichier peuvent être séparés par des virgules, des espaces ou des nouvelles lignes. Les valeurs non numériques du fichier sont ignorées.
↳ /send list [now,delay,datetime] [instance_id] USERS_LIST
Envoi spécifié dans reply message à tous les utilisateurs, user_id qui sont spécifiés dans la liste (dernier paramètre de commande). Valeurs dans la liste user_id séparés par des virgules.
↳ /send mark MARK_NAME [now,delay,datetime] [instance_id]
Envoi spécifié dans reply message à tous les utilisateurs avec une étiquette donnée MARK_NAME commande de cookie /mark.
Paramètre facultatif instance_id peut être spécifié si plusieurs instances sont connectées à un groupe backend et qu'il est nécessaire d'indiquer explicitement pour laquelle d'entre elles la commande de General sujet. Par défaut, toutes les commandes sont exécutées indépendamment pour chaque instance Hotline.
Créer un modèle pour envoyer ou ajouter un message à un modèle existant
↳ /send TEMPLATE_NAME [now,delay,datetime]
Ajoute le spécifié dans reply message à un modèle nouveau ou existant nommé TEMPLATE_NAME. Le nom du modèle doit commencer par une lettre latine et peut contenir des chiffres, un trait d'union ou un trait de soulignement ; les lettres ne sont pas sensibles à la casse. Un modèle peut contenir soit un message, soit une chaîne de messages. Vous pouvez définir l'heure à laquelle le message est envoyé (à partir du moment où la commande est appelée pour le premier message, ou au moment où le message précédent de la chaîne est envoyé).

/send dans General sujet (sans reply)

Envoyer des messages à partir d'un modèle spécifié à la liste de destinataires souhaitée
/send test TEMPLATE_NAME [now,delay,datetime] [instance_id]
Soumettre le modèle TEMPLATE_NAME à moi pour tester
/send all TEMPLATE_NAME [now,delay,datetime] [instance_id]
Soumettre le modèle TEMPLATE_NAME à tous les utilisateurs avec lesquels il y a déjà eu un dialogue via Hotline
/send file TEMPLATE_NAME [now,delay,datetime] [instance_id]
Soumettre le modèle TEMPLATE_NAME à tous les utilisateurs, user_id qui sont indiqués dans le fichier ci-joint. Liste user_id dans un fichier peuvent être séparés par des virgules, des espaces ou des nouvelles lignes. Les valeurs non numériques du fichier sont ignorées.
/send list TEMPLATE_NAME [now,delay,datetime] [instance_id] USERS_LIST
Soumettre le modèle TEMPLATE_NAME à tous les utilisateurs, user_id qui sont spécifiés dans la liste (dernier paramètre de commande). Valeurs dans la liste user_id séparés par des virgules.
/send mark MARK_NAME template TEMPLATE_NAME [now,delay,datetime] [instance_id]
Soumettre le modèle TEMPLATE_NAME tous les utilisateurs avec une étiquette donnée MARK_NAME commande de cookie /mark.
Afficher la liste ou les propriétés des modèles et mailings créés
/send templates
Afficher tous les modèles de newsletter créés.
/send sendings [instance_id]
Afficher les derniers mailings créés (si plusieurs instances sont connectées au groupe backend, vous pouvez préciser laquelle).
/send TEMPLATE_NAME
Afficher les propriétés du modèle de mailing spécifié.
/send sidSENDING_ID
Affichez l'état et les propriétés du mailing spécifié, ainsi que obtenez un rapport sur son exécution au moment actuel.
Modification et suppression de modèles et de mailings
/send TEMPLATE_NAME name NEW_NAME
Définir un nouveau nom pour le modèle
/send TEMPLATE_NAME for MESSAGE_ID [now,delay,datetime]
Définir une nouvelle heure d'envoi dans le modèle pour un message avec l'ID spécifié
/send TEMPLATE_NAME del MESSAGE_ID
Supprimer un message avec un ID spécifié du modèle
/send TEMPLATE_NAME del
Supprimer le modèle spécifié
/send sidSENDING_ID del
Supprimer et annuler un mailing avec l'ID indiqué (disponible uniquement si le mailing n'a pas encore été effectué et est au statut awaits)

/send dans un sujet personnalisé (sans reply)

Envoi du modèle spécifié à l'utilisateur du sujet
/send TEMPLATE_NAME [now,delay,datetime]
De plus, vous pouvez spécifier l'heure d'envoi.
Affichage d'informations sur les modèles et les mailings
/send templates
Afficher les modèles créés dans le groupe backend.
/send sendings
Afficher les envois par commande /send pour le sujet actuel.
/send sidSENDING_ID
Afficher le statut et les propriétés de la soumission spécifiée (sans recevoir de rapport).
IMPORTANT: Après avoir ajouté des extensions, le robot @hotlinetg_extensions_bot toutes les fonctions de commande appelées dans les sujets utilisateur de votre groupe backend /send и /mark devenir disponible pour tous les utilisateurs du groupe backend (employés, managers). Parallèlement, les fonctions administratives des équipes /send, /mark ou /exportappelé General le sujet peut être limité via le paramètre @EXTENSIONS_ALLOWED@ à la connexion correspondante dans le bot d'installation @hotlinetg_bot.

Options d'utilisation des commandes /mark

Équipe /mark vous permet d'attribuer un ensemble arbitraire d'étiquettes aux sujets avec des dialogues du côté du groupe backend (il peut s'agir soit de sujets de dialogues avec des utilisateurs ou des robots, soit de sujets de communication en groupe).

Les étiquettes peuvent être utilisées pour attribuer des propriétés supplémentaires arbitraires aux sujets et/ou à des opérations auxiliaires pratiques.
Capacités des balises :

  • attribuer des sujets supplémentaires aux sujets propriétés pour la segmentation et/ou utilisation ultérieure dans des mailings par l'équipe /send ou lors de l'export avec la commande /export
  • définition des statuts de l'entonnoir de vente, lors de la définition du statut suivant, supprime tous les statuts précédents de l'ensemble donné (le paramètre après)
  • envoi automatique d'un modèle avec une chaîne de messages après avoir attribué l'étiquette correspondante au sujet (le paramètre sends)
  • afficher une chaîne courte ou un emoji dans le titre du sujet, contenant les initiales du gestionnaire responsable de la transaction, le drapeau du pays/de la langue de l'utilisateur ou une autre propriété (paramètre du ticker)
Équipe /mark a 2 contextes principaux d’utilisation :

/mark dans General sujet

/mark
Afficher une liste des étiquettes créées pour ce groupe backend.
/mark new MARK_NAME
Créez une nouvelle étiquette avec le nom donné. Le nom de l'étiquette doit commencer par une lettre latine et peut contenir des lettres latines, des chiffres, un trait d'union ou un trait de soulignement. Les lettres ne sont pas sensibles à la casse.
/mark MARK_NAME
Afficher les propriétés de la balise et une liste de sujets avec cette balise.
/mark MARK_NAME after MARK1, MARK0
Définir le paramètre AFTER pour l'étiquette. La valeur spécifie une liste de noms d'étiquettes qui seront supprimés du sujet lorsque cette étiquette sera attribuée. La liste peut être de n'importe quelle longueur, les valeurs sont séparées par des virgules. Pour effacer un paramètre, envoyez la valeur CLEAR.
/mark MARK_NAME sends TEMPLATE_NAME
Définir le paramètre SENDS pour l'étiquette. La valeur spécifie le nom du modèle de commande /send (avec un seul message ou une chaîne de messages) qui sera activé lorsque ce label sera attribué. Pour effacer un paramètre, envoyez la valeur CLEAR.
/mark MARK_NAME ticker STRING|EMOJI
Définir le paramètre TICKER pour l'étiquette. La valeur peut être une chaîne courte (lettres latines, chiffres, trait d'union, trait de soulignement) ou un emoji, qui sera ajouté au nom du sujet lors de l'attribution de cette étiquette. Pour effacer un paramètre, envoyez la valeur CLEAR.
/mark MARK_NAME name NEW_MARK_NAME
Définissez un nouveau nom pour l'étiquette.

/mark dans le sujet avec dialogue

/mark
Afficher une liste des balises spécifiées pour ce sujet.
/mark MARK_NAME
Ajoutez l'étiquette spécifiée pour ce sujet.
/mark del MARK_NAME
Supprimez le libellé spécifié pour ce sujet.

Utilisation de la commande /export

Équipe /export permet d'obtenir sous forme de fichier une liste des utilisateurs avec lesquels il y a eu une correspondance via le système Hotline et ayant l'étiquette spécifiée.
La commande ne peut être utilisée que dans General sujet de groupe.
/export all
Exporte tous les sujets sous forme de fichier CSV contenant toutes les propriétés principales du sujet (user_id, date du dernier message, statut du dialogue, nom du sujet, type de sujet, lien vers le sujet).
/export MARK_NAME
Exporte tous les sujets avec une étiquette donnée sous forme de fichier CSV au format décrit ci-dessus.
Si vous rencontrez des difficultés pour utiliser les fonctions du robot d'extension, veuillez contacter service d'assistance.