Processar emails de entrada

Crie um fluxo de trabalho que receba e-mails, extraia campos-chave e rotule cada mensagem com base no conteúdo para sistemas downstream apropriados.

O que você criará: um fluxo de trabalho que é acionado automaticamente quando um novo email chega, extrai campos-chave da mensagem e roteia-o para a ação subsequente correta com base no conteúdo, por exemplo, registrar solicitações de suporte em um sistema de emissão de tíquetes ou escalonamento urgente para um canal do Slack.

O que você precisa

• Uma conta do UiPath Automation Cloud com acesso ao Maestro Flow.
• Uma caixa de correio conectada por meio do Integration Service (plataforma de conector da UiPath). Os provedores compatíveis incluem Microsoft 365 e Gmail. Para configurar uma conexão, acesse Integration Service na UiPath Platform e configure o conector para seu provedor de email.

Nós usados

• Gatilho de integração de e-mail — disparado quando um novo e-mail chega à caixa de correio conectada
• Transformação de dados — extrai remetente, assunto e corpo da carga do email
• Decisão — roteia o email com base no conteúdo
• Encerrar — termina o fluxo de trabalho corretamente se a carga estiver malformada

Etapas

1. Crie um novo fluxo e adicione um gatilho de e-mail

1. Abra o Maestro → Flow e crie um novo fluxo de trabalho.
2. No painel nó, abra Nós de integração e encontre seu conector de e-mail (Microsoft 365 ou Gmail).
3. Arraste o gatilho de Email recebido para a tela.
4. No painel de configuração, selecione a Conexão para usar e configure quaisquer filtros (por exemplo, uma pasta de caixa de entrada específica).

2. Extrair campos do email

1. Arraste um nó de Transformação de dados para a tela e conecte-o ao gatilho.
2. Mapeie os campos de que você precisa da carga de saída do gatilho:
   • trigger.body.from → senderEmail
   • trigger.body.subject → emailSubject
   • trigger.body.body.content → emailBody

Os nomes de campos exatos variam de acordo com o conector — verifique o esquema de saída do gatilho no painel de configuração.

3. Rota baseada no conteúdo

1. Arraste um nó de decisão para a tela e conecte-o ao nó de transformação de dados.
2. Defina a condição para avaliar o conteúdo do email. Por exemplo, para capturar mensagens urgentes: $vars.emailSubject.toLowerCase().includes("urgent").
3. Conecte a ramificação Verdadeiro a uma ação de alta prioridade (por exemplo, um nó de notificação do Slack).
4. Conecte a ramificação False a uma ação padrão (por exemplo, criar um ticket em seu sistema de suporte).

4. Lidar com cargas malformadas

Nem todo email terá os campos que você espera. Proteja-se contra cargas malformadas antes que elas interrompam o fluxo de trabalho:

1. Adicione um nó de Decisão após a Transformação de dados e verifique se os campos obrigatórios estão presentes — por exemplo $vars.senderEmail != null
2. Conecte a ramificação válida à Decisão de roteamento da etapa 3.
3. Conecte a ramificação inválida a um nó de Script que registre o problema.
4. Conecte o nó do Script a um nó Encerrar definido como Failed.

Para qualquer nó que exponha um identificador de erro, você também pode conectá-lo ao mesmo caminho de erro. Consulte Tratamento de erros.

5. Teste e depure

Para testar sem esperar um e-mail real:

1. Adicione um Disparo manual ao lado do gatilho de e-mail temporariamente.
2. Configure-o com um esquema de entrada de amostra que corresponda ao formato da carga do e-mail.
3. Execute o teste com valores de amostra e verifique a lógica de roteamento no trace de execução.
4. Remova o Disparo manual antes de publicar.

Resultado

Seu fluxo de trabalho é acionado automaticamente quando um novo email chega, extrai o remetente, o assunto e o corpo e roteia a mensagem para a ação downstream correta. As cargas malformadas terminam corretamente no caminho de erro em vez de interromper o fluxo de trabalho.

Estender este fluxo de trabalho

• Invocar um agente de IA — Antes do nó de Decisão, adicione um nó de agente para classificar o email com IA em vez de uma correspondência de palavra-chave.
• Loop sobre anexos — Se o email tiver anexos, adicione um nó Loop para processar cada um.
• Responder ao remetente — Após o roteamento, adicione um nó de ação de integração de e-mail para enviar uma resposta de confirmação a {{ $vars.senderEmail }}.