> 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/email-trigger-and-send-message/email-trigger.md).

# Email Trigger

### Visão Geral

O **Gatilho de E-mails Receptivos** (identificado na interface pelo título técnico `Trigger email`) é um nó de entrada (*inbound trigger*) baseado em eventos de sincronização de caixa de entrada. Sua função principal é monitorar contas de e-mail corporativas e disparar um fluxo automatizado de processos ou respostas eletrônicas instantaneamente no momento em que a conexão selecionada recebe uma nova mensagem de e-mail de um remetente externo.

### Parâmetros de Configuração

A parametrização do gatilho associa a automação à caixa de correio eletrônico correta configurada na plataforma:

* **Canal:** Menu suspenso utilizado para selecionar qual conta de e-mail integrada (via protocolos IMAP/POP3 ou chaves de provedores homologados) será a responsável por ativar este fluxo específico. O seletor exibe os e-mails corporativos disponíveis na organização (ex: `suporte@empresa.com`).<br>

### Construtor Visual

A interface gráfica segue o padrão enxuto dos blocos de trigger nativos da plataforma:

* **Dropdown de Associação Direta:** Um menu suspenso simplificado que permite vincular a conta de e-mail monitorada de forma direta, garantindo que o motor passe a ler as mensagens da respectiva *Inbox* assim que o nó for salvo.<br>
* **Nó Inicial Sem Entrada:** No editor gráfico de fluxos, este componente posiciona-se na extremidade inicial esquerda da tela. Ele não possui conectores ou portas de entrada recebendo ligações de outros nós, já que a sua execução é ativada 100% por um estímulo externo (a chegada de um e-mail enviado por um cliente).<br>

### Operadores Especiais

As propriedades lógicas deste componente gerenciam a extração de payloads de e-mail, leitura de cabeçalhos e roteamento de arquivos:

* **Injeção de Payload de E-mail (Metadados da Mensagem):** Assim que um e-mail é recebido e processado pelo gatilho, o motor captura automaticamente propriedades cruciais da estrutura MIME e as transforma em variáveis dinâmicas prontas para uso nos blocos posteriores. O payload inclui:
  * `email.remetente`: O endereço de e-mail de quem enviou a mensagem (usado como o identificador do contato).<br>
  * `email.assunto`: O assunto digitado na linha de *Subject*.<br>
  * `email.corpo`: O texto principal contido na mensagem (em formato plano ou HTML).<br>
  * `email.anexos`: Uma lista contendo as URLs dos arquivos anexados à mensagem.<br>
* **Controle de Rastreabilidade por Thread (In-Reply-To):** O componente lê os IDs de cabeçalho do e-mail. Se o e-mail recebido for a resposta de uma conversa anterior disparada pelo sistema, o gatilho consegue associar a mensagem ao mesmo ticket ou contato já existente na base do CRM.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de como estruturar o uso do gatilho de e-mail para automatizar rotinas operacionais:

| **Canal Selecionado (E-mail)**                              | **Assunto do E-mail Recebido** | **Conteúdo / Ação do Remetente**         | **Comportamento do Sistema**                                                                                                                                                                       |
| ----------------------------------------------------------- | ------------------------------ | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**suporte@empresa.com**](mailto:suporte@empresa.com)       | "Problema com meu acesso"      | Enviou texto relatando bug.              | **Dispara o fluxo:** O gatilho captura o remetente, extrai o texto do corpo e inicia um fluxo automatizado que abre um chamado de suporte e envia um e-mail de resposta confirmando o recebimento. |
| [**financeiro@empresa.com**](mailto:financeiro@empresa.com) | "Envio de Comprovante"         | E-mail contendo um arquivo PDF em anexo. | **Dispara o fluxo:** A automação é iniciada, isola o arquivo da variável `email.anexos` e o envia diretamente para um bloco de API de faturamento para validação interna.                          |
| [**vendas@empresa.com**](mailto:vendas@empresa.com)         | "Solicitação de Proposta"      | Texto solicitando catálogo.              | **Dispara o fluxo:** O sistema valida o e-mail do lead e aciona um componente subsequente que responde o cliente de volta anexando o catálogo de produtos de forma 100% autônoma.                  |


---

# 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/email-trigger-and-send-message/email-trigger.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.