# 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.

{% hint style="warning" %}
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.
  {% endhint %}

## Connexion du bot

Étape 1. Configuration dans le **Messageries** section.

1.  **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).

<div data-with-frame="true"><figure><img src="/files/dcacf2174b33db7f54f44954060a277244632ef4" alt="" width="563"><figcaption></figcaption></figure></div>

Ensuite, nous connectons le bot Telegram selon les[ instructions](/doc/fr/chatbot/messageries/telegram/chatbot.md) .&#x20;

2. **Si Telegram est connecté**.&#x20;

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

<div data-with-frame="true"><figure><img src="/files/84a2c90ce95c3fdaac58b181f45357129da5e60e" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/5a23e8e18c8762425a08b2dd1fc3227cf59d0c2a" alt="" width="563"><figcaption></figcaption></figure></div>

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) :

<div data-with-frame="true"><figure><img src="/files/7a028dfb72e26f47efce21df1bfe8398063e4288" alt="" width="563"><figcaption></figcaption></figure></div>

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

É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 » :

<div data-with-frame="true"><figure><img src="/files/2f1331818cfdb84155b128eccbd231a454c317f1" alt="" width="375"><figcaption></figcaption></figure></div>

Ensuite, vous verrez l’onglet « Chatbots », où vous devez aller :

<div data-with-frame="true"><figure><img src="/files/ff23b11b65ac539fba85e3d5895132fe15efb8e6" alt="" width="375"><figcaption></figcaption></figure></div>

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).

<div data-with-frame="true"><figure><img src="/files/430f1d99138fe1fdb904afba8e0a18a46a48b5a6" alt="" width="375"><figcaption></figcaption></figure></div>

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 :

<div data-with-frame="true"><figure><img src="/files/dc0e60e88925aa60485474718ff9d74b26a8875b" alt="" width="375"><figcaption></figcaption></figure></div>

Accédez aux paramètres du bot :

<div data-with-frame="true"><figure><img src="/files/8b3ae230f354faeb7aade46bf56a44737165b9d1" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/e1d0eb1c26e162f6e84467c9abcee9752ec28a7b" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
C’est prêt ! Tous les paramètres nécessaires du chatbot avec un compte professionnel ont été configurés.
{% endhint %}

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 :

<div data-with-frame="true"><figure><img src="/files/da2d1ecc3b3acf1bbc17c84e505fe4565a39d11f" alt=""><figcaption></figcaption></figure></div>

### Comment désactiver&#x20;

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 :

<div data-with-frame="true"><figure><img src="/files/ac56bb3d0d50ec1f5c19bcebbe191a51bf15c2d5" alt=""><figcaption></figcaption></figure></div>

Cliquez sur le bouton « Désactiver le compte professionnel ».

<div data-with-frame="true"><figure><img src="/files/3208b17fb2e5470018b910b5e01ad8efd943121d" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Si vous désactivez votre compte professionnel, le chatbot continuera à fonctionner en mode standard.
{% endhint %}

## Fonctions disponibles

1. (API) Fonction dans la calculatrice :

**tg\_callback(platform\_id , callback\_message,group\_id, tg\_business)**

<details>

<summary><strong>tg_callback</strong></summary>

Paramètres :

**! platform\_id** - ID client Telegram

**! callback\_message** - message de rappel&#x20;

**group\_id** - ID du bot Telegram

**tg\_business -** pour le travail avec les clients professionnels, prend la valeur « 1 ».

</details>

**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)**

<details>

<summary><strong>tg_send_poll</strong></summary>

Paramètres :&#x20;

**! platform\_id** - identifiant du chat dans Telegram [**\***](/doc/fr/chatbot/messageries/telegram/api.md)

**! 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 -**&#x76;aleur 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

</details>

**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 )**

<details>

<summary><strong>tg_send_quiz_poll</strong></summary>

**! platform\_id** - identifiant du chat dans Telegram [**\***](/doc/fr/chatbot/messageries/telegram/api.md)

**! 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

</details>

**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)**

<details>

<summary><strong>tg_send_message_1</strong></summary>

Paramètres :

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

**! platform\_id** — identifiant du client Telegram auquel le message doit être envoyé [**\***](/doc/fr/chatbot/messageries/telegram/api.md)

**! text** - texte du message

**client\_message\_id** - ID du message cité

**reply\_markup** — paramètres des boutons [**\*\***](/doc/fr/chatbot/messageries/telegram/api.md)

**parse\_mode** — mode de mise en forme du texte pour le gras ou l’italique dans la description du message [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)**.** 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"}]`&#x20;

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.

</details>

2. Méthodes

\- [tg\_send\_chat\_action](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-raboty-v-chatakh-i-kanalakh-telegram#tg_send_chat_action)

\- [tg\_send\_message](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-dlya-otpravki-i-redaktirovaniya-soobshenii)

\- [tg\_send\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_quiz\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_video\_note](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_sticker](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_contact](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-kontakt-tg_send_contact)

\- [tg\_send\_venue](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-geotochku-tg_send_venue)

\- [tg\_send\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii?q=#primer-koda-dlya-kopirovaniya-6)

\- [tg\_send\_animation](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_voice](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_media\_group](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_photo](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_audio](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_dice ](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

Ils fonctionnent automatiquement avec les clients qui ont écrit au compte Telegram Business de la même manière qu’avec les bots.

{% hint style="info" %}
Pour plus d’informations sur ces méthodes, consultez l’article [API Telegram](/doc/fr/chatbot/messageries/telegram/api.md)"
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/chatbot/messageries/telegram/business.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.