Chatbot pour un compte Telegram Business

Vous pouvez désormais créer des assistants professionnels personnels — des bots spéciaux qui s'intègrent directement dans les chats Telegram individuels. Ces bots traitent automatiquement les demandes entrantes et répondent au nom du propriétaire du compte, réduisant considérablement le temps consacré aux tâches routinières et améliorant l'efficacité de la communication.

Cas d'utilisation :
Ces assistants peuvent être configurés à diverses fins, telles que :

Fournir des consultations sur des produits ou services.
Répondre aux questions fréquemment posées.
Effectuer une large gamme d'autres tâches automatisées.

Fonctionnalité clé : contrôle transparent

Un utilisateur peut repasser instantanément à la communication manuelle à tout moment sans interrompre ni désactiver le fonctionnement du bot, garantissant un contrôle total sur le chat.

Attention !

Le compte Telegram Business dispose d'une fenêtre de 24 heures.

Une fois qu'un utilisateur envoie son premier message, le bot dispose d'une fenêtre de 24 heures pour répondre et poursuivre la conversation. Cette fenêtre est réinitialisée chaque fois que l'utilisateur répond.

Si l'utilisateur répond : La fenêtre de 24 heures redémarre, permettant un dialogue continu.

Si l'utilisateur NE répond PAS dans les 24 heures : La fenêtre se ferme. Le bot sera bloqué et ne pourra plus envoyer de messages jusqu'à ce que l'utilisateur envoie un nouveau message pour rétablir le contact.

Connexion du bot

Étape 1. Configuration dans la section Messagers.

Si vous connectez un bot Telegram pour la première fois.

Tout d'abord, allez dans l'onglet Canaux de la section Mavibot pour connecter le chatbot Telegram (s'il n'y en a pas encore).

Ensuite, nous connectons le bot Telegram selon les instructions.

Si Telegram est connecté.

Si vous avez déjà un bot Telegram connecté, trouvez ce bot dans les canaux :

Ensuite, cliquez sur le bouton des paramètres, après quoi vous verrez une fenêtre modale avec les champs de token, etc. :

Dans la fenêtre modale qui s'ouvre, cliquez sur TERMINÉ pour mettre à jour les paramètres de votre bot Telegram (vous n'avez pas besoin de modifier d'autres paramètres) :

À ce stade, le travail avec les canaux est terminé. Allez dans les paramètres du messager.

Étape 2. Paramètres du messager.

Pour connecter le chatbot Telegram à votre compte professionnel, allez dans les paramètres de votre profil, où vous devez trouver l'onglet "Telegram Business" :

Ensuite, vous verrez l'onglet "Chatbots", dans lequel vous devez entrer :

Ensuite, dans le nouvel onglet ouvert, saisissez le lien vers le bot Telegram requis ou son nom d'utilisateur (la saisie du lien est préférable).

Dans le même onglet, définissez l'autorisation (case à cocher "Répondre aux messages") pour que le chatbot réponde aux messages.

À ce stade, la configuration du chatbot dans le compte professionnel est terminée. Passez à l'étape suivante.

Étape 3. Paramètres BotFather.

Après avoir lié le chatbot au compte professionnel, vous devez mettre à jour les paramètres du chatbot dans BotFather, où vous avez initialement créé le bot Telegram.

Pour ce faire, ouvrez le chat avec BotFather et activez-le pour qu'il fonctionne avec le compte professionnel :

Allez dans les paramètres du bot :

Ensuite, cliquez sur le bouton "Business Mode" pour activer le mode professionnel pour le chatbot :

Prêt ! Tous les paramètres nécessaires du chatbot avec un compte professionnel ont été effectués.

Maintenant, dans les paramètres du canal, vous trouverez le bot Telegram et verrez l'ID professionnel ainsi que le nom du propriétaire du compte professionnel :

Comment désactiver

Pour désactiver le chatbot en mode professionnel, allez dans les canaux et trouvez le chatbot dans lequel vous souhaitez désactiver ce paramètre. Cliquez sur le bouton des paramètres :

Cliquez sur le bouton "Désactiver le compte professionnel".

Si vous désactivez votre compte professionnel, le chatbot continuera à fonctionner en mode standard.

Fonctions disponibles

(API) Fonction dans le calculateur :

tg_callback(platform_id , callback_message,group_id, tg_business)

Paramètres :

! platform_id - ID client Telegram

! callback_message - message de rappel

group_id - ID du bot Telegram

tg_business - pour travailler avec des clients professionnels, prend la valeur "1".

tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)

Paramètres :

! platform_id - identifiant du chat dans Telegram *

! question - question

! options - tableau d'options de réponse

is_anonymous - 1 - sondage anonyme, '' - non anonyme

allows_multiple_answers - 1 - réponses multiples autorisées, '' - réponse unique uniquement

reply_markup - clavier, ou '' - pas de clavier

disable_notification — indicateur d'envoi avec notification sonore (par défaut 0) ; 1 - envoyer silencieusement, 0 - envoyer avec notification

protect_content - 1 - protéger contre la copie et les captures d'écran, '' - aucune protection

token - jeton du bot ; s'il n'est pas fourni, le jeton actuel est utilisé

reply_to_message_id - ID du message cité

message_thread_id — identifiant du fil (disponible dans les supergroupes avec fonctionnalité de forum)

business_connection_id -valeur utilisée lors de la connexion d'un bot (ID professionnel, affiché dans les canaux) ; doit être transmise si le jeton du bot est fourni et que le message doit être envoyé via le compte utilisateur lié au bot

tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )

! platform_id - identifiant du chat dans Telegram *

! question - question

! options - tableau d'options de réponse

! explanation - texte affiché lorsque l'utilisateur sélectionne une réponse incorrecte ou appuie sur l'icône de l'ampoule dans un sondage de type quiz ; 0 à 200 caractères, avec pas plus de deux sauts de ligne après l'analyse des entités.

! correct_option_id - numéro de la bonne réponse, à partir de 1.

is_anonymous -1 - sondage anonyme, '' - non anonyme

reply_markup - clavier, ou '' - pas de clavier

parse_mode - markdown ou html pour explanation, ou '' pour aucun formatage.

protect_content - 1 protéger contre la copie et les captures d'écran, '' - aucune protection.

disable_notification — indicateur d'envoi avec notification sonore (par défaut 0) ; 1 - envoyer silencieusement, 0 - envoyer avec notification

token - jeton du bot ; s'il n'est pas fourni, le jeton actuel est utilisé.

reply_to_message_id - ID du message cité

message_thread_id — identifiant du fil (disponible dans les supergroupes avec fonctionnalité de forum)

open_period - temps autorisé pour terminer le quiz/test ; valeur numérique de 5 à 600, représentant des secondes.

business_connection_id - valeur utilisée lors de la connexion d'un bot (ID professionnel, affiché dans les canaux) ; doit être transmise si le jeton du bot est fourni et que le message doit être envoyé via le compte utilisateur lié au bot

tg_send_message_1(token, platform_id, text, client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities, business_connection_id)

Paramètres :

! token — jeton du bot Telegram obtenu auprès de BotFather

! platform_id — identifiant du client Telegram auquel le message doit être envoyé *

! text - texte du message

client_message_id - ID du message cité

reply_markup — paramètres des boutons **

parse_mode — mode de formatage du texte pour le gras ou l'italique dans la description du message ***. valeurs possibles : html, markdown, markdownV2

disable_web_page_preview - indique s'il faut afficher un aperçu du lien ; définir sur 1 pour désactiver, sinon 0 ou laisser vide ("")

protect_content — indicateur de protection du contenu contre la copie ; pour activer, transmettez toute valeur autre que 0, False ou des guillemets vides ('')

disable_notification — indicateur d'envoi avec notification sonore (par défaut 0) ; 1 - envoyer silencieusement, 0 - envoyer avec notification

message_thread_id — identifiant du fil (disponible dans les supergroupes avec fonctionnalité de forum) entities — permet de copier du texte préformaté avec tout le style ; spécifiez les plages de caractères pour chaque style de formatage. Vous pouvez trouver un exemple dans le champ tg_request. Le paramètre doit contenir un dictionnaire.

business_connection_id - valeur utilisée lors de la connexion d'un bot (ID professionnel, affiché dans les canaux) ; doit être transmise si le jeton du bot est fourni et que le message doit être envoyé via le compte utilisateur lié au bot

Exemple de passage de paramètre :

entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Dans l'exemple, seul le dictionnaire est affiché, tandis que le texte du message lui-même est défini dans une variable séparée.