> 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/hablla-docs-en/automation-flows/all-components/instagram-components/instagram.md).

# Instagram

### Overview

The **Instagram Integration and Features Component** is a modular, multifunctional action node based on Meta API data graph. Its main function is to extend the chatbot's capabilities beyond private messages, allowing direct interaction with the timeline, analysis of metrics, and automations based on the user's social behavior. With it, the flow can validate the contact's relationship status (such as checking whether they follow the page) and interact with public media and brand mentions.

### Configuration Parameters

The component's configuration is dynamic and adapts according to the action level chosen by the flow administrator:

* **Credential:** Dropdown menu to select the access token or authenticated Instagram Business institutional account that will execute the command in the API.<br>
* **Feature:** Defines the macro category of data that will be handled by the component. The options listed in the interface in `image_348b2b.png` include:
  * `Followers`: Relationship validations and user base auditing.<br>
  * `Posts`: Creation, monitoring, or reading of traditional feed posts.<br>
  * `Comments`: Moderation or automatic replies on public posts.<br>
  * `Reels`: Publishing or reading data from Reels-format videos.<br>
  * `Stories`: Posting and monitoring temporary media.<br>
  * `Insights`: Collection of metrics and engagement performance reports.<br>
  * `Mentions`: Tracking third-party posts that mention the brand's @.<br>
* **Operation:** Contextual field that displays specific actions depending on the selected feature. As exemplified in `image_3477eb.png` (when the feature is set to *Mentions*), the operations include:
  * `Get posts in which you were mentioned`<br>
  * `Get data from a comment in which you were mentioned`<br>
  * `Get data from a post in which you were mentioned`<br>
  * `Comment on a post in which you were mentioned`<br>
  * `Reply to a comment in which you were mentioned`<br>

### Visual Builder

The graphical interface of this component operates under a highly responsive cascading form model:

* **Smart Cascade Layout:** The configuration fields appear conditionally. Selecting the item *Feature* instantly unlocks the menu *Operation*. If the user chooses a posting operation (such as "Create a Reel"), the form expands to display the required file upload and caption input fields (*caption*).<br>
* **Conditional Return Mapping:** If the selected operation is a query (such as getting data from a post), the node adds output metadata to the flow editor, allowing subsequent blocks to consume the texts or IDs returned by the Graph API.<br>

### Special Operators

The logical properties of this component handle transactional audits and public engagement triggers:

* **Engagement Status Validator (Follower Check):** When configured on the feature `Followers`, the engine performs a synchronous call to check whether the user ID that started the chat belongs to the brand's follower list. The component generates two boolean outputs, allowing, for example, discount coupons to be released only to those who actively follow the profile.<br>
* **String Interpolation in Comments and Captions:** In blocks focused on replying or creating content, the fields accept the use of double braces `{{...}}` so that the bot can publish dynamic texts automatically on the feed (ex: "Thanks for the love, `{{name}}`!").<br>

### Practical Examples

The table below shows classic scenarios of how to use this modular component in marketing and automated service strategies:

| **Selected Feature** | **Chosen Operation**                             | **Variable / Target Payload** | **Practical Use Case**                                                                                                                                             |
| -------------------- | ------------------------------------------------ | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Followers**        | *Check if user is a follower*                    | Binary conditional output     | The customer requests a giveaway item in the chat. The bot checks whether they follow the page; if so, it delivers the link, if not, it asks them to follow first. |
| **Mentions**         | *Reply to a comment in which you were mentioned* | Fixed text with dynamic tags  | An influencer mentions the brand in a comment on a post. The bot detects the webhook and sends an automatic public thank-you reply.                                |
| **Reels**            | *Create a Reel post*                             | `{{video_url}}` + caption     | When processing of a promotional video is finished in an external system, the robot flow automatically publishes it to the Instagram feed.                         |
| **Insights**         | *Get engagement metrics*                         | Variable `metrics_data`       | A time-based flow (*Cron*) runs the component every night to extract reach metrics and send a summary report to the internal group.                                |


---

# 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/hablla-docs-en/automation-flows/all-components/instagram-components/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.