> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/composants-instagram/instagram.md).

# Instagram

### Vue d'ensemble

Le **Composant d'intégration et de fonctionnalités Instagram** est un nœud d'action modulaire et multifonctionnel basé sur le graphe de données de l'API Meta. Sa fonction principale est d'étendre les capacités du chatbot au-delà des messages privés, en permettant d'interagir directement avec le fil, d'analyser des métriques et d'effectuer des automatisations basées sur le comportement social de l'utilisateur. Avec lui, le flux peut valider le statut de relation du contact (comme vérifier s'il suit la page) et interagir avec des médias publics et des mentions de la marque.

### Paramètres de configuration

La paramétrisation du composant est dynamique et s'adapte en fonction du niveau d'action choisi par l'administrateur du flux :

* **Identifiant :** Menu déroulant permettant de sélectionner le token d'accès ou le compte institutionnel authentifié d'Instagram Business qui exécutera la commande dans l'API.<br>
* **Fonctionnalité :** Définit la catégorie macro des données qui subiront l'intervention du composant. Les options listées dans l'interface en `image_348b2b.png` comprennent :
  * `Abonnés`: Validations de lien et audit de base d'utilisateurs.<br>
  * `Publications`: Création, suivi ou lecture de publications traditionnelles du fil.<br>
  * `Commentaires`: Modération ou réponses automatiques sur des publications publiques.<br>
  * `Reels`: Publication ou lecture de données de vidéos au format Reel.<br>
  * `Stories`: Publication et suivi de médias temporaires.<br>
  * `Insights`: Collecte de métriques et rapports de performance d'engagement.<br>
  * `Mentions`: Suivi des publications de tiers qui citent le @ de la marque.<br>
* **Opération :** Champ contextualisé qui affiche des actions spécifiques en fonction de la fonctionnalité sélectionnée. Comme illustré dans `image_3477eb.png` (lorsque la fonctionnalité est définie sur *Mentions*), les opérations couvrent :
  * `Obtenir les publications dans lesquelles vous avez été mentionné`<br>
  * `Obtenir les données d'un commentaire dans lequel vous avez été mentionné`<br>
  * `Obtenir les données d'une publication dans laquelle vous avez été mentionné`<br>
  * `Commenter une publication dans laquelle vous avez été mentionné`<br>
  * `Répondre à un commentaire dans lequel vous avez été mentionné`<br>

### Constructeur visuel

L'interface graphique de ce composant fonctionne selon un modèle de formulaire en cascade hautement réactif :

* **Disposition en cascade intelligente :** Les champs de configuration apparaissent de manière conditionnelle. Sélectionner l'élément *Fonctionnalité* déverrouille instantanément le menu *Opération*. Si l'utilisateur choisit une opération de publication (comme « Créer un Reel »), le formulaire se déploie pour afficher les champs obligatoires de téléversement de fichier et de saisie de légende (*légende*).<br>
* **Mappage des retours conditionnels :** Si l'opération sélectionnée est une requête (comme obtenir les données d'une publication), le nœud ajoute des métadonnées de sortie à l'éditeur de flux, permettant aux blocs suivants de consommer les textes ou les ID renvoyés par la Graph API.<br>

### Opérateurs spéciaux

Les propriétés logiques de ce composant gèrent des audits transactionnels et des déclencheurs d'engagement public :

* **Validateur de statut d'engagement (vérification des abonnés) :** Lorsqu'il est configuré sur la fonctionnalité `Abonnés`, le moteur effectue un appel synchrone pour vérifier si l'ID de l'utilisateur qui a lancé le chat appartient à la liste des abonnés de la marque. Le composant génère deux sorties booléennes, permettant par exemple de débloquer des coupons de réduction uniquement pour ceux qui suivent déjà activement le profil.<br>
* **Interpolation de chaînes dans les commentaires et les légendes :** Dans les blocs axés sur la réponse ou la création de contenu, les champs acceptent l'utilisation de doubles accolades `{{...}}` afin que le bot publie automatiquement des textes dynamiques dans le fil (ex. : « Merci pour votre affection, `{{nome}}`!").<br>

### Exemples pratiques

Le tableau ci-dessous présente des scénarios classiques d'utilisation de ce composant modulaire dans des stratégies de marketing et de service automatisé :

| **Fonctionnalité sélectionnée** | **Opération choisie**                                           | **Variable / charge utile de destination** | **Cas d’utilisation pratique**                                                                                                                                      |
| ------------------------------- | --------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Abonnés**                     | *Vérifier si l'utilisateur est abonné*                          | Sortie conditionnelle binaire              | Le client demande un cadeau dans le chat. Le bot vérifie s'il suit la page ; si oui, il fournit le lien, sinon, il lui demande de suivre d'abord.                   |
| **Mentions**                    | *Répondre à un commentaire dans lequel vous avez été mentionné* | Texte fixe avec des balises dynamiques     | Un influenceur mentionne la marque dans un commentaire d'une publication. Le bot détecte le webhook et envoie automatiquement une réponse publique de remerciement. |
| **Reels**                       | *Créer une publication Reel*                                    | `{{video_url}}` + légende                  | Une fois le traitement d'une vidéo promotionnelle terminé dans un système externe, le flux du robot publie automatiquement dans le fil Instagram.                   |
| **Insights**                    | *Obtenir des métriques d'engagement*                            | Variable `dados_metricas`                  | Un flux planifié dans le temps (*Cron*) fonctionne chaque nuit pour extraire les métriques de portée et envoyer un rapport récapitulatif au groupe interne.         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/composants-instagram/instagram.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.