Base de connaissances

hotline.tg

Intégrations externes avec Hotline Telegram CRM

Cet article parle d'un moyen d'étendre les fonctionnalités Hotline Telegram CRM en utilisant votre propre robot assistant (appelé robot assistant) travaillant du côté de votre groupe thématique en utilisant Hotline Topics API.
À l'aide d'un assistant bot, vous pouvez augmenter considérablement la commodité et la productivité de travailler avec le système :

  • implémentez vos propres commandes du côté du groupe de sujets
  • obtenir des informations sur les utilisateurs à partir de systèmes externes
  • créer des transactions ou appeler des commandes arbitraires dans des systèmes externes
  • connectez un bot IA au groupe pour interagir avec les utilisateurs
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.
Toujours en Hotline Il existe d'autres approches pour étendre les fonctionnalités, qui sont décrites dans des articles séparés :

Comment fonctionne le robot assistant
  • Vous en créez un nouveau Telegram robot via @botfather, programmer son comportement
  • Le bot est ajouté au groupe backend, à partir duquel il peut traiter les commandes qui lui sont destinées uniquement, répondre aux événements spécifiés dans le groupe ou compléter les commandes standard existantes
  • La partie logicielle du bot interagit avec Topics API (rapporte l'adresse du sujet et reçoit les informations disponibles sur l'utilisateur avec lequel le dialogue est mené)
  • Lors de la connexion à Hotline compte utilisateur, le bot peut également voir les messages de l'utilisateur (le mode de diffusion correspondant via le compte est activé sur demande dans Soutien)
  • Réaction Hotline pour les commandes personnalisées est désactivé via le paramètre @CUSTOM_COMMANDS@ dans le bot d'installation
Vous pouvez implémenter vous-même le robot assistant ou demander un développement payant auprès de notre service d'assistance. Notre équipe a déjà accumulé un certain nombre de solutions standards qui peuvent être rapidement adaptées à différentes tâches.
Nous utilisons souvent la plateforme comme constructeur pour le bot assistant N8N. La version gratuite de cette plateforme est assez fonctionnelle et n'est pas limitée par le nombre d'appels, le système peut être installé sur votre propre serveur, vous permet de représenter visuellement l'algorithme de fonctionnement du bot et dispose de nombreuses connexions API prêtes à l'emploi avec des systèmes externes. .
Paramètres spéciaux pour le bot assistant dans @botfather
Pour qu'un assistant de bot ajouté à un groupe de sujets puisse voir tous les messages des opérateurs système, il doit spécifier des paramètres spéciaux dans @botfather:

  • Désactivez le mode de confidentialité dans la section Confidentialité du groupe (par défaut il est actif)
  • Autoriser l'ajout d'un bot aux groupes avec le paramètre Autoriser les groupes
Cas 1: Obtention d'informations supplémentaires sur l'utilisateur à partir de systèmes externes
Le robot assistant peut surveiller les messages indiqués par les opérateurs du côté du groupe backend et compléter le résultat de la commande /info des informations supplémentaires sur l'utilisateur, ou répondre à toute autre commande personnalisée.
Si vous entrez la commande requise dans un sujet de dialogue avec l'utilisateur, le robot assistant peut contacter Topics API systèmes Hotline, fournissez l'adresse du sujet et recevez des informations sur l'utilisateur au format JSON (user_id, language_code, first_name, last_name, username, phone).
Ensuite, le robot assistant peut demander des informations supplémentaires sur l'utilisateur au système externe par son intermédiaire. user_id et affichez-le dans un sujet destiné à l'opérateur système.
Par exemple, via l'extension de commande /info Dans notre support, nous avons mis en place un affichage rapide d’une liste des instances actives de l’utilisateur et s’il dispose d’un abonnement payant.
Un principe similaire peut également être utilisé pour obtenir toute autre information disponible sur l'utilisateur, par exemple :

  • liste des transactions des utilisateurs par son user_id
  • solde courant, tarifs des utilisateurs connectés
  • liste des groupes partagés avec l'utilisateur
Cas 2: Création d'une transaction ou d'un contact avec un utilisateur dans un système externe

Le robot assistant peut surveiller les messages indiqués par les opérateurs du côté du groupe backend et compléter le résultat de la commande /info des informations supplémentaires sur l'utilisateur, ou répondre à toute autre commande personnalisée.

De tels problèmes peuvent être résolus par un système externe, tandis que Hotline peut agir comme une interface native très pratique pour communiquer avec Telegram utilisateurs (pour être une sorte de front office).
Exemple d'intégration avec Notion

Au service d'assistance Hotline Nous utilisons Notion comme système de stockage et de structuration de notre base de données clients (notion.so).
Lors de l'envoi d'une commande /notion côté sujet de groupe, les données client sont écrites dans la base de données Notion et un lien vers la carte client créée est renvoyé. En cliquant sur le lien, vous pouvez accéder rapidement à la fiche client, remplir les tags du client et lui donner la priorité.
Notion peut facilement présenter votre clientèle sous la forme d'un tableau, d'un tableau avec des cartes, des filtres et des tris. Si nécessaire, vous pouvez filtrer les utilisateurs souhaités côté Notion, obtenir une liste de leurs identifiants et, par exemple, puis utilisez-le dans votre newsletter.
En appelant la commande /notion dans le sujet de l'utilisateur à nouveau, le bot assistant, en plus du lien vers la carte, renvoie une liste de balises spécifiées pour l'utilisateur.
Une intégration similaire via API est possible avec de nombreux autres systèmes : Google Sheets, AMO, Bitrix, SalesForce, etc.
Cas 3: Connexion rapide d'un tarif dans un système externe pour l'utilisateur
Si les utilisateurs avec lesquels vous communiquez via Hotline sont également des utilisateurs de n'importe quel système, alors l'opérateur Hotline peut utiliser le robot assistant pour activer les méthodes nécessaires.
1 exemple: Après avoir accepté et reçu le paiement de l'utilisateur via Hotline, vous pouvez envoyer une commande comme /activate t1 m6, qui activera le Tarif 1 conditionnel pendant 6 mois pour cet utilisateur et lui enverra une notification à ce sujet. La commande est implémentée de la même manière /deactivate.
2 exemple: Équipe / admin Le mode administrateur est lancé dans le bot externe pour gérer les paramètres de l'utilisateur correspondant qui a contacté le service support.
Cas 4: Créer un lien avec un utilisateur dans un système externe
S'il est nécessaire d'établir une connexion entre l'utilisateur Telegram selon lui user_id avec l'identifiant de compte correspondant dans le système externe, il est alors possible d'implémenter une commande comme /link N005
Une commande similaire peut lier un utilisateur (ou plusieurs utilisateurs) au numéro de compte N005. Après avoir établi une connexion avec l'utilisateur, la commande /info (Cas 1) peut être complété par l'affichage des informations sur son compte depuis un système externe.
Ceci est souvent utile lors de la mise en œuvre d'un service d'assistance d'entreprise, lorsque plusieurs utilisateurs peuvent écrire au service d'assistance à partir d'un seul client.
Cas 5: Enregistrement de la correspondance d'un groupe thématique dans un système externe
Pour que le robot assistant puisse voir les messages des utilisateurs et pouvoir les traiter, les messages envoyés au groupe de sujets doivent provenir du compte utilisateur et non du robot. En raison des restrictions de Telegram, les robots ne peuvent pas voir les messages des autres robots des groupes.
Activez un mode spécial de diffusion de messages vers un groupe thématique via un compte utilisateur (userbot) est possible grâce à notre Soutien.
Lorsque la diffusion des messages des utilisateurs vers un groupe de sujets via un compte est activée, ces messages deviennent disponibles pour le robot assistant pour traitement.
Cela permet de sauvegarder des messages dans un système externe, par exemple pour sauvegarder la correspondance avec les clients ou utiliser des fragments de correspondance pour entraîner l'intelligence artificielle.
Remarque concernant l'enregistrement des messages : Vous pouvez également faire des copies de sauvegarde des messages d'un groupe à tout moment manuellement grâce à la fonction Exporter l'historique des discussions dans les propriétés du sujet de groupe.
Cas 6: Ajouter un consultant en IA à votre Telegram compte ou bot
Lorsque la diffusion de messages des utilisateurs vers un groupe de sujets via un compte est activée (userbot) le robot assistant peut voir les messages des utilisateurs.
Vous pouvez ensuite transmettre des messages utilisateur avec le contexte IA souhaité via l'API et recevoir une réponse, que vous pouvez ensuite afficher dans le groupe de sujets sous forme de commentaire ou envoyer directement à l'utilisateur.
Vous pouvez par exemple inviter l’utilisateur à poser sa question en attendant que l’opérateur réponde à l’intelligence artificielle afin qu’il puisse tenter de résoudre lui-même son problème.
Il est de bon ton de poser des questions à l’intelligence artificielle en commençant votre question par l’adresse de l’IA, par exemple : ai, quelles commandes y a-t-il dans le système ?
Vous pouvez également apprendre à l'IA à comprendre que si on lui pose une question commençant par un commentaire, il s'agit alors d'une question de l'opérateur du système et la réponse doit également être donnée sous la forme d'un commentaire.
Alternativement, vous pouvez envoyer tous les messages de l'utilisateur pour analyse IA (cela coûte plus cher en termes de jetons IA) et émettre ou non une réponse selon la logique requise. Par exemple, répondez à l’utilisateur uniquement lorsque l’IA estime que la question correspond exactement à ce qui se trouve dans sa base de connaissances.
Pour un contrôle flexible du fonctionnement de l'IA, vous pouvez saisir des restrictions spéciales et des commandes auxiliaires qui activent/désactivent l'IA dans un sujet donné ou changent le mode de communication avec l'utilisateur.
En savoir plus sur les cas d'utilisation de l'IA en relation avec Telegram CRM Hotline (bientôt)
Découvrez également d'autres moyens d'étendre les fonctionnalités Hotline: