> 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/fluxos-de-automacoes/todos-os-componentes/instagram-components/instagram.md).

# Instagram

### Visão Geral

O **Componente de Integração e Recursos do Instagram** é um nó de ação modular e multifuncional baseado no grafo de dados da API da Meta. Sua função principal é estender os recursos do chatbot para além das mensagens privadas, permitindo interagir diretamente com a linha do tempo, analisar métricas e realizar automações baseadas no comportamento social do usuário. Com ele, o fluxo consegue validar o status de relacionamento do contato (como verificar se ele segue a página) e interagir com mídias públicas e menções à marca.

### Parâmetros de Configuração

A parametrização do componente é dinâmica e se adapta de acordo com o nível de ação escolhido pelo administrador do fluxo:

* **Credencial:** Menu suspenso para selecionar o token de acesso ou conta institucional autenticada do Instagram Business que executará o comando na API.<br>
* **Recurso:** Define a categoria macro de dados que sofrerá a intervenção do componente. As opções listadas na interface em `image_348b2b.png` incluem:
  * `Seguidores`: Validações de vínculo e auditoria de base de usuários.<br>
  * `Publicações`: Criação, monitoramento ou leitura de posts tradicionais do feed.<br>
  * `Comentários`: Moderação ou respostas automáticas em posts públicos.<br>
  * `Reels`: Publicação ou leitura de dados de vídeos do formato Reels.<br>
  * `Stories`: Postagem e monitoramento de mídias temporárias.<br>
  * `Insights`: Coleta de métricas e relatórios de performance de engajamento.<br>
  * `Menções`: Rastreamento de postagens de terceiros que citam o @ da marca.<br>
* **Operação:** Campo contextualizado que exibe ações específicas dependendo do recurso selecionado. Conforme exemplificado na `image_3477eb.png` (quando o recurso está definido como *Menções*), as operações abrangem:
  * `Obter postagens em que você foi mencionado`<br>
  * `Obter dados de um comentário em que você foi mencionado`<br>
  * `Obter dados de um post em que você foi mencionado`<br>
  * `Comentar em um post em que você foi mencionado`<br>
  * `Responder um comentário em que você foi mencionado`<br>

### Construtor Visual

A interface gráfica deste componente opera sob um modelo de formulário em cascata altamente responsivo:

* **Layout Cascata Inteligente:** Os campos de configuração aparecem de forma condicional. Selecionar o item *Recurso* destrava instantaneamente o menu *Operação*. Se o usuário escolher uma operação de postagem (como "Criar um Reel"), o formulário expande para exibir os campos obrigatórios de upload de arquivo e digitação de legenda (*caption*).<br>
* **Mapeamento de Retornos Condicionais:** Caso a operação selecionada seja de consulta (como obter dados de um post), o nó adiciona metadados de saída ao editor de fluxos, permitindo que os blocos subsequentes consumam os textos ou IDs retornados pela Graph API.<br>

### Operadores Especiais

As propriedades lógicas deste componente lidam com auditorias transacionais e gatilhos de engajamento público:

* **Validador de Status de Engajamento (Follower Check):** Quando configurado no recurso `Seguidores`, o motor realiza uma chamada síncrona para checar se o ID do usuário que iniciou o chat pertence à lista de followers da marca. O componente gera duas saídas booleanas, permitindo, por exemplo, liberar cupons de desconto apenas para quem já segue o perfil de forma ativa.<br>
* **Interpolação de Strings em Comentários e Legendas:** Nos blocos focados em responder ou criar conteúdo, os campos aceitam o uso de chaves duplas `{{...}}` para que o bot publique textos dinâmicos de forma automatizada no feed (ex: "Obrigado pelo carinho, `{{nome}}`!").<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de como utilizar este componente modular em estratégias de marketing e atendimento automatizado:

| **Recurso Selecionado** | **Operação Escolhida**                               | **Variável / Payload Destino** | **Caso de Uso Prático**                                                                                                                                          |
| ----------------------- | ---------------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Seguidores**          | *Verificar se usuário é seguidor*                    | Saída condicional binária      | O cliente solicita um brinde no chat. O bot valida se ele segue a página; se sim, entrega o link, se não, pede para ele seguir primeiro.                         |
| **Menções**             | *Responder um comentário em que você foi mencionado* | Texto fixo com tags dinâmicas  | Um influenciador menciona a marca em um comentário de um post. O bot detecta o webhook e envia uma resposta pública automática de agradecimento.                 |
| **Reels**               | *Criar uma publicação de Reel*                       | `{{video_url}}` + legenda      | Ao finalizar o processamento de um vídeo promocional em um sistema externo, o fluxo do robô faz a publicação automática no feed do Instagram.                    |
| **Insights**            | *Obter métricas de engajamento*                      | Variável `dados_metricas`      | Um fluxo programado por tempo (*Cron*) roda o componente toda madrugada para extrair as métricas de alcance e enviar um relatório resumido para o grupo interno. |


---

# 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/fluxos-de-automacoes/todos-os-componentes/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.