> 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/receptivo.md).

# Receptivo

### Visão Geral

O **Gatilho de Mensagens Receptivas do Instagram** é um nó de entrada (*inbound trigger*) baseado em eventos de conversação social. Sua função principal é monitorar o canal de mensagens diretas (DM) de perfis comerciais e disparar um fluxo de automação ou chatbot instantaneamente no momento em que um usuário envia uma nova mensagem privada para a marca.

**Regra de Retenção de Atendimento:** Mantendo o padrão de inteligência de estado dos outros canais, este componente possui uma trava nativa de segurança. Ele só iniciará a execução da automação se o contato **não possuir nenhum atendimento humano ou ticket em aberto** no sistema. Caso o usuário já esteja sendo atendido por um operador, as mensagens enviadas por ele continuarão caindo direto na tela do atendente humano, ignorando este gatilho para evitar loops ou quebras na experiência de suporte.

### Parâmetros de Configuração

A parametrização do gatilho vincula a automação à conta oficial da marca através do seguinte critério:

* **Canal:** Menu suspenso utilizado para selecionar qual Conta do Instagram Business integrada à plataforma será monitorada por este fluxo específico. Ele lista todos os perfis comerciais vinculados que possuem permissão de recebimento de mensagens habilitada via API de Mensageria do Instagram.

### Construtor Visual

A interface gráfica foca no isolamento do ponto inicial e na simplicidade de busca para a arquitetura de canais:

* **Busca Textual de Perfis:** O menu suspenso oferece um campo de pesquisa interno (*Digite aqui sua busca*) para localizar rapidamente a conta comercial correta em workspaces que administram múltiplas marcas ou filiais.
* **Nó Inicial Sem Entrada:** No editor gráfico de fluxos, este componente se posiciona na extremidade inicial esquerda da tela. Ele não possui conectores de entrada subsequentes, visto que a energia que inicia a sua execução vem exclusivamente de um estímulo externo (a mensagem enviada pelo usuário na DM).

### Operadores Especiais

As propriedades lógicas deste componente gerenciam a captura de identidades sociais e o controle de janelas de conversação:

* **Injeção de Payload de Perfil Social:** Assim que o usuário envia a mensagem, o motor do gatilho captura os dados públicos autorizados pela API da Meta, como o **Nome de Usuário (Instagram Username)** e o **ID do Usuário (IGSID)**, disponibilizando essas variáveis imediatamente para personalização e saudação nos próximos blocos.
* **Janela de Resposta Padrão (Regra das 24 horas da Meta):** A ativação do componente registra o timestamp exato de entrada do usuário. O sistema utiliza esse marcador para controlar a janela padrão de 24 horas estipulada pela Meta, garantindo que as respostas automatizadas subsequentes do fluxo sejam enviadas dentro do prazo elegível de comunicação.

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de comportamento do gatilho de acordo com o status atual do usuário na plataforma:

| **Conta Selecionada (Canal)** | **Status do Usuário no Painel**         | **Ação do Usuário na DM**                           | **Comportamento do Gatilho**                                                                                             |
| ----------------------------- | --------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **@loja\_ficticia**           | Sem chamados abertos.                   | Enviou "Gostaria de saber o preço daquele produto". | **Dispara o fluxo:** O gatilho captura o contato e inicia o menu do chatbot de autoatendimento.                          |
| **@marca\_suporte**           | Em atendimento com a Atendente Mariana. | Enviou uma foto ou print na DM.                     | **Ignora o gatilho:** O conteúdo cai direto na tela da Mariana; a automação não interfere na conversa.                   |
| **@loja\_ficticia**           | Aguardando na Fila de Espera Comercial. | Enviou a mensagem "Ainda tem alguém aí?".           | **Ignora o gatilho:** O contato permanece na fila de espera do painel humano, mantendo a prioridade de chegada original. |


---

# 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/receptivo.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.
