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

# Instagram Message

### Overview

The **Instagram Message Sending Component** is an action node focused on outbound session interactions. Its main function is to transmit informative messages, greetings, or media files directly to the end user's direct message inbox (DM) on Instagram during the execution of an automation. It is used to provide fluid responses, share visual materials, and enrich the conversational journey without holding the user up in response validations.

### Configuration Parameters

The block configuration defines the format of the content that will be delivered to Meta's messaging API:

* **Message type:** Dropdown menu that determines the structure of the content bubble that the client will see in the chat. The options include:
  * `Text`: Messages composed strictly of text, with full support for emojis and hyperlinks.<br>
  * `Audio`: Sending sound files or voice messages.<br>
  * `Image`: Sharing visual files and corporate graphic cards (PNG, JPG).<br>
  * `Video`: Sending audiovisual media in formats compatible with the application (MP4).<br>
* **Message (\* Required Field):** The main body of the text that will be sent to the client (when configured in media formats such as `Image` or `Video`, this field acts as the supporting caption attached to the file).<br>

### Visual Builder

The builder interface adapts dynamically to provide the correct fields based on the chosen format:

* **Input Type Controls (Fixed / Expression):** Displays a toggle key next to the selector that allows switching the message type configuration between the *Fixed* (static selected in the dropdown) or *Expression* (injection of dynamic variables to change the type programmatically).<br>
* **Current Required Fields:** The asterisk (`*`) in the field *Message* serves as a pre-validation in the graphical editor, preventing the administrator from publishing a flow containing completely empty bubbles or text blocks.<br>
* **Advanced Media Fields:** When selecting visual or audio options (such as `Image`), the builder adds blocks for including the `File URL` and the button to perform *Upload* directly to the platform's servers.<br>

### Special Operators

The logical properties of this component handle the compilation and agile interpolation of data in the DM interface:

* **Scope Tag Interpolation:** The field *Message* is fully compatible with the insertion of dynamic data using double braces `{{...}}`. This makes it possible to inject saved contact properties directly into the text they will read (e.g.: "Here is your discount code, `{{name}}`!").<br>
* **Free Linear Processing:** Unlike question nodes, this component does not generate a waiting state (*standby*). The automation engine sends the data payload to Instagram's servers and releases the contact instantly to the next step connected to the block's output port.<br>

### Practical Examples

The table below demonstrates classic use cases for this component to structure rich interactions in Instagram Direct:

| **Selected Message Type** | **File URL / Upload**  | **Configured Content (Message)**                                                                                  | **Practical Use Case**                                                                                        |
| ------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `Text`                    | *None*                 | "You are very welcome to our store! How can I help you today?"                                                    | Send a standard welcome greeting as soon as an incoming flow is triggered.                                    |
| `Image`                   | *Upload of coupon.jpg* | "Use the coupon above to get 10% off your first purchase! 🛍️"                                                    | Trigger a promotional graphic card with an explanatory caption right after the lead goes through a screening. |
| `Text`                    | *None*                 | "Please wait a moment. I'm transferring you to one of our specialists in the department `{{setor_escolhido}}`..." | Display a contextualized informational transition message before the human handoff component.                 |


---

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