# Comment gérer manuellement les commentaires

{% hint style="success" %}
Cela fonctionne lorsque Instagram est activé
{% endhint %}

## Configuration d'une réponse à un callback Instagram

Vous devez activer le bouton dans le compte Instagram connecté dans la **Messageries** section pour permettre à votre bot de répondre aux commentaires.

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

Si Instagram affiche « Reconnecter pour fonctionner avec les commentaires » sous votre connexion Instagram officielle, vous devez reconnecter Instagram pour mettre à jour les autorisations nécessaires. Pour ce faire, cliquez sur l'icône de corbeille dans le coin inférieur droit (supprimer le bot).

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

Reconnectez à nouveau le compte Instagram. Pour savoir comment connecter Instagram, [voir ici.](/doc/fr/chatbot/messageries/instagram/chatbot.md)

{% hint style="warning" %}
Lors de la publication de posts en tant que co-auteur, toutes les notifications de commentaires seront envoyées au compte **à partir duquel vous créez** le post.
{% endhint %}

{% hint style="info" %}
Cela fonctionne avec les commentaires sous les Reels ainsi que sous les posts.
{% endhint %}

Lorsqu'un utilisateur commente un post, un callback est envoyé au bot (vous pouvez le voir dans la **« Clients »** section dans la conversation de l'utilisateur).

Le callback a le format suivant : `client_wall_reply_new link id: text`

où :

* `lien` est le lien du post
* `id` est l'ID de l'enregistrement
* `text` est le texte du commentaire

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

Nous pouvons traiter les commentaires de deux manières : répondre avec votre commentaire ou écrire un message dans Direct.

**client\_wall\_reply\_new** - est une partie commune du callback.&#x20;

**client\_wall\_reply\_new\_comment -** si nous ne nous intéressons qu'aux commentaires sur le post

**client\_wall\_reply\_new\_live -** si les commentaires ne concernent que la diffusion en direct

### Comment configurer une réponse automatique aux commentaires dans Direct

{% hint style="warning" %}
La réponse automatique à un commentaire n'ouvre PAS une fenêtre de 24 heures.
{% endhint %}

Copiez le callback et allez dans la section Constructeur de Funnel. Créez un bloc du type « Vérification de condition primaire » ou « Condition sans état » et collez le callback copié dans la condition. Nous configurons une vérification « Pour la présence de mots-clés »

{% hint style="warning" %}
ATTENTION ! Il est **déconseillé** d'utiliser **des nombres** comme déclencheur pour lancer un bot. \
\
L'ID du post peut contenir ces nombres. Le bot peut répondre à n'importe quel callback contenant ces nombres s'il choisit une correspondance basée sur la présence de mots-clés.
{% endhint %}

Si vous souhaitez configurer une réaction aux commentaires sous n'importe quel post pour n'importe quel commentaire, alors dans les conditions vous spécifiez uniquement **client\_wall\_reply\_new\_comment.**&#x20;

Lors de la sélection d'une correspondance, il définit « Correspondance des mots-clé&#x73;**".**

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

{% hint style="danger" %}

#### **Remarque importante :**<br>

Nous vous recommandons d'utiliser le **« Correspondance des mots-clés »** type de recherche lors de la configuration d'une réponse à un callback.

N'oubliez pas que la logique de correspondance pour la condition d'un bloc doit être choisie en fonction des paramètres et des exigences de votre projet. Par conséquent, assurez-vous de tester soigneusement le flux de votre chatbot !

Lisez l'article «[Type de déclencheur et de correspondance](/doc/fr/chatbot/builder/setting/trigger/type.md)".
{% endhint %}

Si vous prévoyez de configurer une réaction à un post spécifique, incluez `client_wall_reply_new_comment` suivi de l'ID du post dans le champ de déclenchement.

{% hint style="warning" %}

#### **ATTENTION !**

Il n'est pas recommandé d'utiliser des nombres comme déclencheurs pour lancer votre bot.

Un ID de post se compose souvent de nombres. Si votre bot utilise une correspondance basée sur des mots-clés, il pourrait répondre par erreur à *n'importe quel* callback contenant ces nombres.
{% endhint %}

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

Si vous prévoyez de configurer une réaction à un post spécifique, incluez `client_wall_reply_new_comment` suivi de l'ID du post dans le champ de déclenchement.

{% hint style="warning" %}

#### **ATTENTION !**

Il n'est pas recommandé d'utiliser des nombres comme déclencheurs pour lancer votre bot.

Un ID de post se compose souvent de nombres. Si votre bot utilise une correspondance basée sur des mots-clés, il pourrait répondre par erreur à *n'importe quel* callback contenant ces nombres.
{% endhint %}

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

Dans le champ de réponse, saisissez le texte que vous souhaitez envoyer en réponse à ce commentaire.

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

Au-dessus du message, il est indiqué qu'il a été envoyé en réponse à un commentaire. Si vous cliquez sur **« Voir le post »**, vous serez redirigé vers le post que vous avez commenté.

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

Si un utilisateur laisse un commentaire pour lequel vous n'avez pas configuré de réponse (ou si vous n'avez configuré aucune réponse), vous pouvez lui répondre avec un seul message Direct dans la **« Clients »** section.

{% hint style="warning" %}
Cependant, si vous essayez d'envoyer un autre message Direct à l'utilisateur, le deuxième message ne sera pas livré car répondre à un commentaire ne rouvre pas la fenêtre de messagerie de 24 heures.
{% endhint %}

### Comment utiliser les liens directs des posts Instagram lors du traitement des commentaires

{% hint style="info" %}
Pour traiter les commentaires, vous devez activer l'option **« Répondre aux commentaires »** dans la section Canaux Instagram.
{% endhint %}

Lorsqu'un utilisateur commente un post, une notification apparaît dans le chat de la **section Clients** contenant le texte du commentaire, et la `instagram_media_url` variable est générée avec un lien vers la publication.

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

Vous pouvez utiliser la `instagram_media_url` variable pour configurer des réactions aux commentaires sur des posts Instagram spécifiques.

Prenons un exemple.

#### Configuration de différentes réponses en fonction du post sur lequel le commentaire a été laissé

**Tâche :** Le compte contient plusieurs posts, dont trois présentant des produits à des prix différents. Configurez des réponses aux commentaires sur ces trois posts pour répondre avec le prix exact. Pour tous les autres posts, répondez par « Prix sur accord ». La réponse doit être envoyée à la fois sous forme de message Direct et de commentaire sous le post.

**Solution :**

1. Configurez des réactions basées sur des mots-clés pour les commentaires sur les posts. Cela signifie que le bot réagira à tout post où un commentaire contient les mots-clés spécifiés.
2. Utilisez la `insta_create_comment` fonction dans la **Calculatrice** pour publier un commentaire sous le post concerné, tout en définissant également le texte de réponse dans le champ **Texte du message** pour envoyer un message Direct. Cela permet à l'utilisateur de recevoir le prix simultanément dans les commentaires et dans les messages Direct.
3. Si un commentaire contenant les mots-clés apparaît sous un autre post, l'utilisateur recevra un message indiquant **« prix sur accord ».**

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

Étape 1. Dans le **bloc Départ** déclencheur champ, saisissez `client_wall_reply_new` suivi des mots-clés qui doivent déclencher une réponse. Réglez le type de correspondance sur **« Correspondance des mots-clés »**.

Exemple à copier :

`client_wall_reply_new_comment (price|how many|cost|find out)`

{% hint style="info" %}
Si vous souhaitez répondre uniquement aux commentaires sous les posts, utilisez `client_wall_reply_new_comment`. Si vous souhaitez répondre uniquement aux commentaires pendant une diffusion en direct, utilisez `client_wall_reply_new_live`.
{% endhint %}

{% hint style="info" %}
Les commentaires sous les Reels fonctionnent de la même manière que sous les posts classiques.
{% endhint %}

Étape 2. Dans le **« Calculatrice »** champ, déclarez une `text` variable. Sa valeur est déterminée par une condition IF qui vérifie la `instagram_media_url` variable.

*Exemple à copier (n'oubliez pas de remplacer les liens par les URL réelles de vos posts). Vous pouvez copier l'URL depuis la `instagram_media_url` variable dans le chat du client (section Clients) après qu'il a commenté le post concerné :*

`text = if(instagram_media_url == "https://www.instagram.com/reel/Cagzkx", "$10", if(instagram_media_url == "https://www.instagram.com/p/CqvCq4", "$29", if(instagram_media_url == "https://www.instagram.com/p/CocLhN", "$35", "Other")))`&#x20;

Étape 3. Utilisez la `insta_create_comment` méthode pour publier un commentaire.

Exemple à copier :&#x20;

`insta_create_comment("#{text}")`

où `#{text}` est le texte de réponse que nous envoyons à l'utilisateur.

Étape 4. Dans le **Texte du message** champ, saisissez la variable contenant la réponse pour le message Direct.

Dans cet exemple, la variable est `#{text}`. La même réponse est publiée comme commentaire et dupliquée dans le message Direct. Vous pouvez configurer des réponses différentes pour chacun si nécessaire.

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

{% hint style="info" %}
`client_wall_reply_new` est le préfixe commun du callback. Pour cibler uniquement les commentaires sous les posts, utilisez `client_wall_reply_new_comment`. Pour cibler uniquement les commentaires pendant une diffusion en direct, utilisez `client_wall_reply_new_live`.
{% endhint %}

### Comment publier un commentaire en réponse à un message sous un post ou pendant une diffusion en direct

{% hint style="info" %}
Lors du traitement des commentaires et de la configuration des réponses sous un post, utilisez une fonction aléatoire et envoyez un texte variable. Si le bot envoie de manière répétée un texte identique, vous pouvez rencontrer l'erreur : « Cet appel API ne prend pas en charge le format de réponse demandé. » Vous pouvez en savoir plus sur le travail avec [la fonction aléatoire ici.](/doc/fr/chatbot/builder/responses.md)
{% endhint %}

Étape 1. Dans le **section Clients** section, copiez le callback (notification) indiquant qu'un commentaire a été publié, puis allez dans le Builder.

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

Étape 2. Créez un **« Départ »** ou **« Déclencheur »** bloc et collez le callback copié dans le champ **Déclencheur** .

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

Il existe plusieurs façons de configurer la condition de déclenchement du bot.

Dans cet exemple, le bot répond aux commentaires sous **tous les posts** avec le message « répondre dans les commentaires ». Pour configurer cela, saisissez le préfixe principal du callback et le mot-clé dans le champ de condition :

`client_wall_reply_new_comment reply in comments`

**Important :** réglez le type de correspondance sur **« Correspondance des mots-clés »**.

{% hint style="warning" %}

#### ATTENTION !

Il n'est pas recommandé d'utiliser des nombres comme déclencheurs pour lancer votre bot.

Un ID de post se compose souvent de nombres. Si votre bot utilise une correspondance basée sur des mots-clés, il pourrait répondre par erreur à n'importe quel callback contenant ces nombres.
{% endhint %}

{% hint style="info" %}
`client_wall_reply_new` est le préfixe commun du callback qui se déclenche à la fois pour les posts et pour les diffusions en direct.

Pour répondre uniquement aux commentaires sous les posts, utilisez :\
`client_wall_reply_new_comment`

Pour répondre uniquement aux commentaires pendant une diffusion en direct, utilisez :\
`client_wall_reply_new_live`
{% endhint %}

{% hint style="warning" %}
Il existe un comportement particulier pour les callbacks de diffusion en direct (`client_wall_reply_new_live`) : le bot ne réagira **que** pendant la diffusion en direct. Une fois la diffusion terminée, le bot ne détectera plus les commentaires sous celle-ci et ne pourra pas répondre.
{% endhint %}

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

Étape 3. Dans le **réponse** champ, saisissez `#{none}`.

Étape 4. Dans le **« Calculatrice »** champ, écrivez :

`insta_create_comment("texte de votre commentaire en réponse")`

Le texte de votre commentaire doit être placé entre parenthèses.

Ensuite, cliquez sur **« Terminé »**.

Avec cette configuration, comme dans l'exemple, le commentaire généré par le bot sera publié en réponse à tout commentaire sous un post contenant les mots-clés « reply in the comments ».

*Exemple de réponse du bot à un commentaire dans les commentaires.*

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

*<mark style="color:green;">**Réponse du bot à N'IMPORTE QUEL commentaire sous N'IMPORTE QUEL post.**</mark>*

Si vous ne saisissez que le préfixe général du callback `client_wall_reply_new` dans le **« Déclencheur »** champ, votre commentaire sera publié en réponse aux commentaires sous **tous les posts** (quel que soit le texte écrit par l'utilisateur).

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

*<mark style="color:green;">**Réponse du bot à UNE PHRASE SPÉCIFIQUE sous N'IMPORTE QUEL post.**</mark>*

Si vous laissez dans le champ « Déclencheur » **`client_wall_reply_new`**` ``et le mot-clé`, alors votre commentaire sera envoyé **en réponse aux commentaires contenant le mot-clé sous tous les posts.**

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

*<mark style="color:green;">**Réponse du bot à UNE PHRASE SPÉCIFIQUE sous UN post SPÉCIFIQUE.**</mark>*

Copiez le callback complet depuis la section clients et mettez-le dans le champ du **Départ** bloc :

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

{% hint style="warning" %}
Vous pouvez répondre aux commentaires laissés par les utilisateurs pendant une diffusion en direct (il existe une clé distincte pour cela **client\_wall\_reply\_new\_live)**.

Il existe une particularité pour les diffusions en direct : le bot réagira uniquement pendant la diffusion. Si la diffusion est terminée, le bot ne verra pas les commentaires sous cette diffusion et ne pourra pas répondre.
{% endhint %}

### Comment enregistrer le texte d'un commentaire dans une variable

Pour enregistrer le texte du commentaire d'un utilisateur, utilisez `comment_text()` fonction.

Insérez le callback `client_wall_reply_new` dans le **Déclencheur** champ. Ensuite, dans le **« Calculatrice »** champ, attribuez le texte à une variable — par exemple, `comm` (vous pouvez utiliser n'importe quel autre nom) :

`comm = comment_text()`

Ensuite, cliquez sur **« Ajouter une condition »** dans la calculatrice et spécifiez :

`comm = comment_text()`

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

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

### Comment supprimer un commentaire&#x20;

La fonction `insta_delete_comment(comment_id)` supprime un commentaire.

Si `comment_id` n'est pas fourni, la fonction utilise la variable client `instagram_last_comment_id`.

En cas de succès, elle renvoie `{"success":true}`. Si un `comment_id` inexistant est fourni, elle renvoie `{"Une erreur inattendue s'est produite. Veuillez réessayer votre demande plus tard."}`.

## Travailler avec les mentions de compte

### Comment mentionner dans les médias

Lorsqu'un utilisateur identifie votre profil dans son post, votre bot recevra le callback suivant :

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

Les variables suivantes apparaissent :

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

**mention\_caption** — légende du post

**post\_url** — lien du post

**mention\_comments\_count** — nombre de commentaires

**mention\_like\_count** — nombre de mentions J'aime

**mention\_media\_id** — id du post

Configurons une réaction pour répondre à une mention.

Pour ce faire, créez un bloc **« Vérification de condition principale »** ou **« État avec condition »** . Dans le **« Condition »** champ, saisissez `mention_in_media` et réglez le type de correspondance sur **« Correspondance des mots-clés »**.

Dans l’onglet **« Calculatrice »** champ, saisissez la méthode suivante :

**reply\_to\_mention**(text)

où `text` est le commentaire qui apparaîtra sous le post mentionné. Vous pouvez spécifier une variable (insérée sans guillemets à l'intérieur des parenthèses) ou saisir le texte directement (entre guillemets).

**Exemple :**

Étape 1. Allez dans le builder et créez un bloc avec un déclencheur (**Départ** bloc ou **Déclencheur** bloc). Ensuite, dans le **Déclencheur** champ, spécifiez le callback `mention_in_media`.

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

Sélectionnez **« Mention dans le post »** dans la liste des déclencheurs, et comme méthode de la calculatrice, choisissez **« Répondre au commentaire d'un post »**. Ensuite, saisissez le texte du commentaire de réponse.

Étape 2. Cliquez sur **« Ajouter un déclencheur »**. Le déclencheur ainsi que la méthode seront alors saisis dans le bloc :

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

### Comment mentionner dans un commentaire

Lorsqu'un utilisateur identifie votre compte dans les commentaires, le chat recevra un callback comme :

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

{% hint style="info" %}
Si votre compte est identifié dans un profil privé, le callback ne sera pas reçu.
{% endhint %}

Les variables suivantes apparaîtront également dans la fiche client :

* `mention_like_count` — nombre de mentions J'aime
* `mention_media_id` — ID du post

Configurons une réaction pour répondre à une mention dans un commentaire.

Pour ce faire, créez un bloc **« Départ »** ou **« Déclencheur »** . Dans le **« Condition »** champ, saisissez `mention_in_comment` et réglez le type de correspondance sur **« Correspondance des mots-clés »**.

Dans l’onglet **« Calculatrice »** champ, saisissez la méthode suivante :

**reply\_to\_mention**(text)

où `text` est le commentaire qui sera publié en réponse à la mention. Vous pouvez spécifier une variable (insérée sans guillemets à l'intérieur des parenthèses) ou saisir le texte directement (entre guillemets).

**Exemple :**

Étape 1. Allez dans le builder, créez un bloc avec un déclencheur (**Départ** bloc ou **Déclencheur** bloc) et saisissez le callback suivant dans le **« Déclencheur »**  :

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

Ensuite, sélectionnez la condition **« Mention dans un commentaire »**.

Étape 3. Cliquez sur **Calculatrice** et dans le champ qui apparaît, saisissez la méthode :

`reply_to_mention("Texte de réponse pour la mention dans le commentaire")`

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

{% hint style="warning" %}
Si la fenêtre de 24 heures n'est pas ouverte dans le chat avec l'utilisateur, vous **ne pouvez pas** envoyer un message Direct en réponse à la mention. Vous ne pouvez répondre qu'avec un commentaire.

Si la fenêtre de 24 heures **est** ouverte, vous pouvez saisir du texte dans le champ **Réponse** que l'utilisateur recevra sous forme de message Direct après la mention de votre compte.
{% endhint %}

### Comment mentionner d'autres profils dans les commentaires sous vos posts

Si quelqu'un est identifié dans les commentaires sous votre compte, la variable `mentioned_in_comment` est créée dans la fiche client.

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

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

Elle stocke le nom d'utilisateur de la personne qui a été identifiée.&#x20;&#x20;Si plus de deux personnes sont identifiées, les noms d'utilisateur sont stockés dans un tableau.

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

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

Si vous devez segmenter les utilisateurs qui ont identifié deux amis ou plus, vous pouvez attribuer une variable comme `len = arr_len(mentioned_in_comment)` puis comparer cette variable avec la valeur souhaitée.

{% hint style="warning" %}
Si la fenêtre de messagerie de 24 heures n'est pas ouverte dans le chat avec l'utilisateur, vous ne pouvez pas envoyer de message Direct en réponse à la mention. Vous ne pouvez répondre qu'avec un commentaire.
{% 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/instagram/settings/comment-gerer-manuellement-les-commentaires.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.
