For the complete documentation index, see llms.txt. This page is also available as Markdown.

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).

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.

  • 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).

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).

    • email.assunto: O assunto digitado na linha de Subject.

    • email.corpo: O texto principal contido na mensagem (em formato plano ou HTML).

    • email.anexos: Uma lista contendo as URLs dos arquivos anexados à mensagem.

  • 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.

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

"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.

"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.

"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.

Atualizado

Isto foi útil?