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

# Receptivo

### Visão Geral

O **Gatilho de Mensagens Receptivas do WhatsApp** é um nó de entrada (*inbound trigger*) baseado em eventos de comunicação. Sua função principal é escutar canais de comunicação ativos e disparar um fluxo de automação ou chatbot instantaneamente no momento em que um cliente envia uma nova mensagem.

**Regra de Retenção de Atendimento:** O gatilho possui uma inteligência nativa de controle de estado. Ele só iniciará a automação se o cliente em questão **não possuir nenhum atendimento humano ou ticket já aberto** no sistema. Caso o cliente já esteja em atendimento com um operador, as mensagens enviadas por ele continuarão direto na tela do atendente, ignorando este gatilho para evitar interrupções ou loops na conversa humana.

### Parâmetros de Configuração

A parametrização do gatilho vincula a automação à linha telefônica oficial ou canal de comunicação da empresa através do seguinte critério:

* **Canal:** Menu suspenso utilizado para selecionar qual número de telefone ou API oficial do WhatsApp será monitorada por este fluxo específico. O componente realiza uma varredura nas contas integradas no painel da plataforma para disponibilizá-las no seletor.<br>

### Construtor Visual

A interface gráfica é desenhada para um acoplamento rápido e seguro, isolando o ponto inicial da jornada:

* **Seletores de Instâncias Homologadas:** O menu suspenso exibe os codinomes das conexões e seus respectivos números internacionais de telefone (ex: `Nome da Conexão (+55 11 99999-9999)`), permitindo associar facilmente o número de produção ou de homologação à automação.<br>
* **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, pois a energia que inicia a sua execução vem exclusivamente de um estímulo externo (a mensagem enviada pelo usuário final).<br>

### Operadores Especiais

As propriedades lógicas deste componente lidam com controle de sessões, injeção de dados cadastrais e tratamento de mídias:

* **Injeção de Payload de Contato (Dados Nativos):** Assim que a mensagem ativadora é recebida, o motor do gatilho captura automaticamente os dados públicos disponibilizados pelo perfil do WhatsApp do cliente, como o **Número de Telefone** e o **Nome de Exibição** (*PushName*), disponibilizando essas variáveis imediatamente para os próximos blocos do fluxo.<br>
* **Abertura de Janela de Sessão (Janela de 24 horas):** A ativação bem-sucedida deste componente valida e abre a janela de conversação da API do WhatsApp. Isso garante que os blocos de mensagens subsequentes da automação consigam enviar textos, mídias e botões interativos sem custos de templates pré-aprovados (mensagens de sessão).<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de como este gatilho se comporta de acordo com o status atual do usuário no sistema:

| **Canal Selecionado**            | **Status do Cliente no Sistema**                 | **Ação do Cliente**              | **Comportamento do Gatilho**                                                                                    |
| -------------------------------- | ------------------------------------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **WhatsApp Comercial Principal** | Sem atendimentos ativos (Novo ou Concluído).     | Enviou um "Olá, boa tarde!".     | **Dispara o fluxo:** O gatilho captura o contato e inicia o menu do chatbot de autoatendimento.                 |
| **WhatsApp Suporte Técnico**     | Em atendimento com o Operador Carlos.            | Enviou uma foto do comprovante.  | **Ignora o gatilho:** A imagem cai direto na tela do Carlos; a automação não interfere na conversa.             |
| **WhatsApp Vendas Matriz**       | Aguardando na Fila de Espera do Setor Comercial. | Enviou "Quero falar com alguém". | **Ignora o gatilho:** O contato permanece na fila de espera do painel humano, mantendo a prioridade de chegada. |


---

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