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

# Receptivo

### Visão Geral

O **Gatilho de Mensagens Receptivas do Telegram** é um nó de entrada (*inbound trigger*) baseado em eventos de comunicação por mensageria. Sua função principal é escutar um bot específico do Telegram e disparar um fluxo de automação ou chatbot instantaneamente no momento em que um usuário envia uma nova mensagem ou interage com o bot pela primeira vez (comando `/start`).

**Regra de Retenção de Atendimento:** Assim como nos canais de WhatsApp e Facebook, o gatilho possui uma inteligência integrada de controle de estado. Ele só iniciará a automação se o contato **não tiver um atendimento humano ou ticket aberto** no sistema. Caso a conversa já esteja sob a responsabilidade de um operador, as mensagens enviadas pelo usuário serão direcionadas direto para a tela de chat do atendente, ignorando este gatilho para evitar duplicidade ou interferências na conversa humana.

### Parâmetros de Configuração

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

* **Canal:** Menu suspenso utilizado para selecionar qual Bot do Telegram integrado à plataforma será monitorado por este fluxo específico. Ele lista todos os bots que foram conectados através do token de API fornecido pelo *BotFather*.<br>

### Construtor Visual

A interface gráfica é desenhada para ser enxuta, isolando o ponto inicial de partida da automação:

* **Busca Textual de Instâncias:** O menu suspenso possui um campo de busca interna (*Digite aqui sua busca*) para localizar rapidamente o bot correto em workspaces que gerenciam múltiplas contas e robôs de atendimento.<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 sua execução é disparada exclusivamente por um estímulo externo (a mensagem enviada pelo usuário final para o bot).<br>

### Operadores Especiais

As propriedades lógicas deste componente gerenciam a captura de identidades de perfis e o controle de variáveis nativas do ecossistema do Telegram:

* **Injeção de Payload de Perfil (Metadados do Telegram):** Assim que o usuário envia a mensagem ativadora, o motor do gatilho captura os dados fornecidos publicamente pela API do Telegram, como o **ID do Usuário (Chat ID)**, o **Username** (nome de usuário iniciado por `@`), o **Primeiro Nome** (*First Name*) e o **Sobrenome** (*Last Name*), disponibilizando essas variáveis imediatamente para uso nos próximos blocos.<br>
* **Abertura de Janela de Comunicação Sem Restrições:** Diferente de outros canais baseados em recargas ou templates aprovados (HSM), a ativação do gatilho do Telegram abre um canal de comunicação livre. A automação pode responder ao usuário com blocos de mensagens de qualquer formato e sem limites de tempo de sessão, desde que o bot não tenha sido bloqueado pelo usuário.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários de comportamento do gatilho de acordo com o status atual do usuário no sistema:

| **Bot Selecionado (Canal)**     | **Status do Usuário no Painel**       | **Ação do Usuário no Telegram**                | **Comportamento do Gatilho**                                                                                             |
| ------------------------------- | ------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **@Bot\_Atendimento\_Ficticio** | Sem chamados abertos.                 | Clicou em "Começar" ou enviou um "Olá".        | **Dispara o fluxo:** O gatilho captura o contato e inicia o menu do chatbot de autoatendimento.                          |
| **@Bot\_Suporte\_Ficticio**     | Em atendimento com o Operador Daniel. | Enviou um arquivo de log ou mensagem de texto. | **Ignora o gatilho:** O conteúdo cai direto na tela do Daniel; a automação não interfere na conversa.                    |
| **@Bot\_Atendimento\_Ficticio** | Aguardando na Fila de Espera Geral.   | Enviou a mensagem "Preciso de ajuda".          | **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/telegram-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.