# Mode inline dans Telegram

## Qu’est-ce que le mode inline dans Telegram ?

En plus du fait que le bot peut répondre directement à n’importe quelle demande dans un chat privé ou un groupe, en utilisant le mode en ligne, vous pouvez accéder globalement au bot dans un chat, un groupe ou une chaîne.

Pour contacter un bot dont le mode en ligne est activé, il suffit de saisir @\*nom\_du\_bot\* dans le **Message** .

L’exemple le plus frappant et le plus populaire d’un bot fonctionnant en ligne est @gif, avec lequel vous pouvez sélectionner et envoyer des images gif :

<div data-with-frame="true"><figure><img src="/files/78a0124cacbf58da6fd239b5231bff250518419a" alt="" width="563"><figcaption><p>Le bot @gif fonctionnera dans n’importe quel chat.</p></figcaption></figure></div>

Le bot @gif fonctionnera dans n’importe quel chat.

## Comment activer le mode inline ?

Pour que le bot fonctionne en mode hors ligne, vous devez activer cette option dans les paramètres du bot dans [BotFather](https://t.me/BotFather).

Sélectionnez le bot souhaité et allez dans le **Paramètres du bot**.

<div data-with-frame="true"><figure><img src="/files/0bfff05260b04f61a2f76ab695a717e6a20a3c16" alt="" width="315"><figcaption></figcaption></figure></div>

Puis choisissez **Mode inline**

<figure><img src="/files/34f473c910c7f2c2f719b2e2692d500ee2a72a35" alt="" width="375"><figcaption></figcaption></figure>

Ici, vous devez activer le mode hors ligne s’il n’est pas activé.

<figure><img src="/files/8442e28b6fbde9a9847b95c752eba0e2e0fc8586" alt="" width="375"><figcaption></figcaption></figure>

## Comment modifier le texte de substitution ?

Si vous le souhaitez, vous pouvez modifier le texte de substitution affiché avant la saisie de la requête de recherche. Par défaut, c’est ***Rechercher…***

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

Pour le modifier, cliquez sur **Modifier le texte de substitution inline** bouton :

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

Définissez le contenu exact du texte de substitution.

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

## Comment configurer les résultats de sortie

Après avoir cliqué sur une option de la liste en mode inline, un message sera envoyé, indiqué dans l’en-tête de l’option sélectionnée, et vous pouvez ajuster la réaction dans l’entonnoir à cette valeur.

Pour spécifier les données à afficher en mode inline, vous devez définir la variable inline\_bot. En mode inline, la recherche des valeurs dans la variable inline\_bot s’effectue presque en temps réel.

Les données de la variable peuvent être définies de trois façons. Examinons-les de la plus simple à la configuration la plus avancée.

### Un tableau avec des données textuelles

Par exemple, la recherche s’effectuera dans un tableau de produits.

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

La variable inline\_bot est spécifiée dans les paramètres du projet. La recherche correspond à toute variante du tableau contenant la phrase saisie.

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

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

Lorsque vous saisissez « @nom\_\_de\_votre\_\_bot » et les premières lettres des commandes, un menu s’ouvre avec les valeurs que vous avez spécifiées dans la variable du projet.

Après avoir cliqué sur l’élément souhaité, un message de l’utilisateur sera envoyé au bot, pour lequel vous pouvez configurer la réaction dans le bot.

La configuration du bloc ressemble à ceci :

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

Exemple de données :

\["Lait", "Pain", "Pâtes", "Chocolat", "Œufs", "Beurre", "Petit pain", "Thé", "Légumes", "Fruits"]

### Sortie en l’absence de filtrage

Vous pouvez définir une clé vide et lui attribuer un tableau de valeurs en minuscules ou un tableau de dictionnaires. Le bot accédera au dictionnaire à l’aide d’une clé vide et affichera des boutons avec les valeurs du tableau attribué.

### Un bouton inline avec la valeur de recherche spécifiée

{% hint style="warning" %}
Veuillez noter !

Les boutons inline dans Telegram ne sont pas des callbacks.

Si vous avez besoin de recevoir des callbacks, alors lisez à propos de [boutons callback dans Telegram.](/doc/fr/chatbot/messageries/telegram/buttons.md#callback-button)

Le bouton ne fonctionne que dans Telegram.
{% endhint %}

Pour définir une phrase de recherche, ajoutez le paramètre inline\_query au bouton inline avec une valeur qui sera automatiquement insérée dans la requête.

Il est recommandé d’utiliser cette option pour le mode hors ligne, car elle évitera les erreurs et fonctionnera plus rapidement.

Par exemple, ajoutez trois boutons qui correspondent à l’exemple du chapitre précédent.

\[{"line":0,"index\_in\_line":0,"text":"Afficher le menu","type":"inline","inline\_query":"menu"},{"line":0,"index\_in\_line":1,"text":"Articles","type":"inline","inline\_query":"posts"},{"line":2,"index\_in\_line":0,"text":"Liste des produits","type":"inline","inline\_query":"products"}]

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

Lorsque vous cliquez sur un bouton, par exemple, un **Article,** la liste des boutons trouvés sera affichée (lors de l’ajout, vous avez spécifié "inline\_query":"posts" pour ce bouton) :

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

Les options sont prises à partir d’une variable donnée, comme décrit ci-dessus dans le **« Dictionnaire avec une liste »**  :

<figure><img src="/files/5ea22da4686816a7bd2f2ad4dd55450ff4de42a1" alt="" width="563"><figcaption></figcaption></figure>

### Remarques

* La variable inline\_bot peut être définie non seulement dans les variables générales, mais aussi comme une variable simple, mais dans ce cas sa valeur doit être mise entre guillemets simples.

Exemple dans le champ calcul :

inline\_bot = '\["Milk", "Bread", "Pasta", "Chocolate", "Eggs", "Butter", "Puff Pastry", "Tea", "Vegetables", "Fruits", "#{aa}"]'

Vous pouvez également transmettre n’importe quelle valeur comme variable pour une configuration plus flexible.

Par exemple, une option simple dans un tableau :

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


---

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