Chatbot pour un compte Telegram Business

Vous pouvez désormais créer des assistants commerciaux 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, par exemple :

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

Fonction clé : contrôle fluide

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

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 empêché d’envoyer d’autres messages jusqu’à ce que l’utilisateur envoie un nouveau message pour rétablir le contact.

Connexion du bot

Étape 1. Configuration dans le Messageries section.

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

D’abord, allez dans l’onglet Channels dans la section Mavibot pour connecter le chatbot Telegram (s’il n’y en a pas encore un).

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 du jeton, etc. :

Dans la fenêtre modale qui s’ouvre, cliquez sur DONE pour mettre à jour les paramètres de votre bot Telegram (vous n’avez plus 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 », où vous devez aller :

Puis, 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érée).

Dans le même onglet, définissez l’autorisation (case « Répondre aux messages ») pour que le chatbot puisse répondre aux messages.

À ce stade, la configuration du chatbot dans le compte professionnel est terminée. Continuez.

Étape 3. Paramètres de 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 son fonctionnement avec le compte professionnel :

Accédez aux paramètres du bot :

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

C’est prêt ! Tous les paramètres nécessaires du chatbot avec un compte professionnel ont été configurés.

Maintenant, dans les paramètres du canal, vous trouverez le bot Telegram et verrez l’ID Business 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 pour 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 la calculatrice :

tg_callback(platform_id , callback_message,group_id, tg_business)

tg_callback

Paramètres :

! platform_id - ID client Telegram

! callback_message - message de rappel

group_id - ID du bot Telegram

tg_business - pour le travail avec les 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)

tg_send_poll

Paramètres :

! platform_id - identifiant du chat dans Telegram *

! question - question

! options - tableau des options de réponse

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

allows_multiple_answers - 1 - plusieurs réponses autorisées, '' - une seule réponse

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ège contre la copie et les captures d’écran, '' - aucune protection

token - jeton du bot ; s’il n’est pas fourni, celui en cours est utilisé

reply_to_message_id - ID du message cité

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

business_connection_id -valeur utilisée lors de la connexion d’un bot (Business ID, 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 )

tg_send_quiz_poll

! platform_id - identifiant du chat dans Telegram *

! question - question

! options - tableau des options de réponse

! explanation - texte affiché lorsque l’utilisateur sélectionne une mauvaise réponse ou appuie sur l’icône d’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ège 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, celui en cours est utilisé.

reply_to_message_id - ID du message cité

message_thread_id — identifiant du fil de discussion (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 (Business ID, 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)

tg_send_message_1

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 mise en forme 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éfinissez sur 1 pour désactiver, sinon 0 ou laissez vide ("")

protect_content — indicateur de protection du contenu contre la copie ; pour l’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 de discussion (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 mise en forme. 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 (Business ID, 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 transmission du 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.