Canal de Email — Recebimento

Email de Entrada para um Agente A REDA AI vem com um handler de Email Service em Apex que recebe emails em um endereço gerenciado pelo Salesforce e os entrega ao agente mapeado para esse endereço — totalmente de forma assíncrona. Qualquer email enviado a um endereço encaminhado chega ao agente, com ou sem anexos: o corpo, o assunto e o remetente se tornam a mensagem do agente. Quando o processamento de anexos está habilitado, os arquivos qualificados também são arquivados como registros de ContentVersion e passados ao agente. Isso atende tanto à entrada de documentos (faturas de fornecedores, formulários assinados, relatórios digitalizados) quanto à entrada conversacional (uma mensagem para uma caixa de entrada que você encaminhou a um agente).

O Que Este Canal É — E O Que Não É

O canal de Email de Recebimento entrega cada email ao agente mapeado para o endereço receptor. Quando um email chega a um endereço de Email Service configurado e encaminhado:

A plataforma corresponde o endereço a um agente e enfileira um job assíncrono — independentemente de o email trazer anexos ou não
Se o processamento de anexos estiver habilitado, os anexos qualificados são arquivados como registros de ContentVersion e passados ao agente junto com o corpo
Se o endereço não tiver um registro de roteamento ativo, o email é ignorado
A plataforma nunca devolve (bounce) o email nem responde automaticamente ao remetente — se você quiser uma resposta, o agente envia uma através do canal de saída

A própria configuração de roteamento — o Email Service mais um registro de roteamento ativo — é o que ativa o canal para um endereço. Não há um botão de recurso separado para habilitar o roteamento de recebimento.

Este é um canal de entrada unidirecional: a plataforma não responde automaticamente. Para que o agente responda por email, veja Canal de Email — Envio, e Tratamento de Respostas de Email para rastrear respostas a emails iniciados pelo agente.

Arquitetura

O email chega
A infraestrutura de Email Service do Salesforce recebe a mensagem e invoca a classe handler da REDA AI.
Anexos tratados (se habilitado)
Se Processamento de Arquivos de Email Habilitado estiver ativado, os anexos abaixo do limite mínimo de tamanho de 10 KB (assinaturas e logotipos típicos de email) são ignorados, e os anexos restantes são validados contra a lista de extensões permitidas e o limite máximo de tamanho, sendo então inseridos como registros de ContentVersion. Essa configuração é desativada por padrão e controla apenas o tratamento de anexos — não controla o canal. Com ela desativada, os anexos são ignorados, mas o email ainda é roteado.
Correspondência com o agente
A plataforma consulta o endereço de entrada nos registros de roteamento ativos para encontrar qual agente deve tratar o email. A correspondência é exata — no endereço completo ou na parte local.
Job assíncrono enfileirado
A plataforma enfileira um job Queueable quando o endereço corresponde a um agente — independentemente de anexos terem sido arquivados. Um email sem anexos é entregue ao agente como um turno de conversa. O handler do Email Service retorna imediatamente para que o Salesforce não devolva (bounce) o email caso o processamento demore.
O agente processa
O Queueable abre uma nova conversa e entrega ao agente o corpo, o remetente e o assunto do email como contexto. Quaisquer anexos arquivados são processados usando o pipeline padrão de Processamento de Documentos.

Configurando

Etapa 1 — Decida se vai processar anexos

Na guia REDA AI Admin, Processamento de Arquivos de Email Habilitado controla se os anexos de arquivos em emails de entrada são processados. Ela é desativada por padrão e é um controle de segurança, não um botão de canal:

Deixe desativada para entrada conversacional — o agente recebe o corpo, o assunto e o remetente do email, e quaisquer anexos são ignorados.
Ative-a para também arquivar os anexos qualificados como registros de ContentVersion e passá-los ao agente para processamento de documentos.

De qualquer forma, o canal é habilitado pela configuração de roteamento nas Etapas 2–3 — um email encaminhado chega ao agente independentemente desta configuração.

Etapa 2 — Crie o Email Service na Configuração do Salesforce

Email Services › Novo
Escolha o handler de recebimento da REDA AI como a classe Apex. Marque o serviço como Ativo.
Permitir anexos
Defina Accept Attachments como All (binário mais texto) para que o handler consiga ver os arquivos.
Comportamento em caso de falha
Para entrada de documentos, defina o Email Service como Discard em caso de falha. O handler nunca lança exceção; isso é puramente uma defesa em profundidade.
Crie os endereços
Cada endereço é um endpoint — o email real que um remetente usa. A parte local pode ser o que você quiser (por exemplo, invoices, contracts, onboarding-docs) e o endereço completo é gerado pelo Salesforce. Você também pode encaminhar endereços do seu próprio domínio para ele.

Etapa 3 — Crie os registros de roteamento

Os registros de roteamento mapeiam cada endereço de entrada para um agente específico. Gerencie-os na guia REDA AI Admin › Operations › Email Routing.

Abra o aplicativo REDA AI e selecione a guia REDA AI Admin.
Role até o card Email Routing em Operations.
Clique em + Add Routing.
Preencha o formulário e salve:

Campo	O que informar
Label	Um nome amigável para o roteamento (por exemplo, “Invoices Inbox”). Exibido na tabela para consulta rápida.
Endereço de email	O Email Service Address completo ou apenas sua parte local (o trecho antes do `@`). A correspondência não diferencia maiúsculas/minúsculas e testa primeiro o endereço completo, depois a parte local. Cada email mapeia para exatamente um registro de roteamento.
Agente	Escolha na lista suspensa. Somente agentes ativos do canal API são listados — o pipeline de email chama o agente no servidor, então outros canais não são elegíveis.
Ativo	Ativado por padrão. Registros de roteamento inativos são ignorados em tempo de execução.

Endereços de entrada sem correspondência geram uma entrada no Registro de incidentes de IA e são descartados silenciosamente — nenhuma resposta automática é enviada. Não há correspondência por domínio ou caractere curinga; um registro de roteamento para cada endereço que você quiser suportar.

Editando, desativando e reativando

Editar — ícone de lápis na linha. Abra o formulário, altere qualquer campo, salve.
Desativar — ícone de proibição em uma linha ativa. O registro permanece na tabela (esmaecido) para que você possa reativá-lo depois ou reaproveitá-lo para um email diferente.
Reativar — ícone de marca de seleção em uma linha desativada.
Sem exclusão definitiva — as entradas de roteamento são desativadas em vez de excluídas. Entradas inativas não afetam o comportamento em tempo de execução e permanecem visíveis para reutilização.

Os registros de roteamento que você cria são armazenados como configuração de propriedade do assinante e sobrevivem a upgrades de pacote. Novas versões da REDA AI não sobrescreverão nem removerão seus roteamentos.

Etapa 4 — Configure o agente

O agente encaminhado deve ser configurado com este canal em mente:

Dê a ele uma persona clara que saiba que está processando um documento, não conversando com o remetente.
Atribua as ferramentas certas. A maioria dos agentes de entrada de email precisa de ferramentas nativas de leitura, além de uma ferramenta específica de domínio, de Mapeamento de Arquivos ou de Classe Apex, que transforma os dados extraídos em registros do Salesforce.
Considere habilitar Auto Execute Actions — não há um humano diante de um cartão de confirmação neste canal. Execute automaticamente ou restrinja o conjunto de ferramentas para que o agente só possa gravar através de ferramentas em que você confia.
Confirme que todas as ferramentas que você quer que o agente use incluem API em seu escopo de canal, já que o pipeline de email chama o agente no servidor.

O Que o Agente Vê

Para cada email de entrada, o agente recebe uma nova conversa contendo:

O endereço do remetente (como texto na mensagem)
O assunto do email (como texto na mensagem)
O corpo do email, truncado a um tamanho razoável — a parte em texto simples, ou o HTML depurado quando o email é somente HTML
Quando o processamento de anexos está habilitado, a lista de anexos qualificados, disponível através do mesmo pipeline de Processamento de Documentos usado por qualquer outro canal

A plataforma não corresponde atualmente o remetente a um Contato ou Lead automaticamente, e não encadeia emails por Message-Id. Cada email de entrada inicia uma nova conversa. Se você precisar de resolução de remetente ou encadeamento, incorpore isso a uma ferramenta Apex personalizada que o agente possa chamar — por exemplo, uma ferramenta que pesquisa Contatos por endereço de email e retorna a correspondência.

Filtragem de Anexos

Filtro	Comportamento
Tamanho mínimo	Anexos abaixo de ~10 KB são ignorados — isso filtra logotipos e imagens de assinatura que preenchem a maioria dos emails comerciais.
Tamanho máximo	Limitado pela Configuração de Plataforma Max File Size (MB). Anexos que excedem o limite são ignorados e um incidente é registrado.
Lista de extensões permitidas	Limitado por Allowed File Extensions. Qualquer coisa fora da lista é descartada.
Anexos de texto minúsculos	Anexos em texto simples e JSON abaixo de um pequeno limite de caracteres são ignorados — a mesma lógica antirruído do mínimo binário.

Veja Configurações de Plataforma para os valores configuráveis que regem esses filtros e Processamento de Documentos para o que acontece com um arquivo depois que ele chega ao agente.

Execução Assíncrona

O handler do Email Service sempre retorna success imediatamente. O processamento real acontece em um job Queueable executado em segundo plano. Duas implicações importam:

O remetente não verá uma falha em linha. Se o email estiver malformado, o endereço não estiver roteado, ou o agente apresentar erro, a plataforma registra um incidente, mas não devolve (bounce) nem responde automaticamente. Planeje para isso — se você precisar confirmar o recebimento, configure o agente para enviar um email de confirmação através do canal de saída.
Remetentes podem enviar grande volume. O Email Service do Salesforce tem seus próprios limites diários; além disso, os limites de créditos e concorrência da REDA AI se aplicam por execução do agente. Para remetentes de alto volume, acompanhe o Registro de incidentes de IA em busca de falhas e considere uma revisão dedicada de concorrência do Queueable.

Observabilidade

Registros de Conversa — um por email de entrada que gerou uma execução do agente. Filtre por automatedSource = o rótulo do pipeline de email para encontrá-los.
Registro de incidentes de IA — captura de emails com falha ou sem roteamento: um email que não correspondeu a nenhum registro de roteamento mas ainda assim chegou ao processamento, um erro do agente, um tempo limite de solicitação assíncrona excedido. Veja Registros de incidentes de IA.
Depurador de Conversa — para qualquer execução individual, o Depurador mostra o prompt montado, os blocos de arquivo que o agente viu e cada chamada de ferramenta que fez.

Segurança e Governança

Endereços gerenciados pelo Salesforce. O tráfego de entrada termina no Email Service do Salesforce antes de chegar à REDA AI. SPF/DKIM e a segurança de email padrão se aplicam nessa fronteira.
Os arquivos permanecem na sua organização. Os anexos se tornam registros de ContentVersion sujeitos às suas regras padrão de compartilhamento e retenção. Nada é copiado para um armazenamento externo.
O agente é executado como um usuário real do Salesforce. O handler do Email Service é executado como o usuário configurado no serviço; as permissões desse usuário regem o que o agente pode ler e gravar.
O processamento de anexos é desativado por padrão. O controle de segurança Processamento de Arquivos de Email Habilitado torna o tratamento de arquivos de entrada uma decisão explícita — até que você o ative, os anexos são ignorados mesmo em um endereço encaminhado. (O canal em si entra em operação somente quando você cria um Email Service e um registro de roteamento ativo, então nada processa email de entrada silenciosamente após a instalação.)

Boas Práticas

Use um endereço por tipo de entrada. Endereços separados para faturas, contratos e documentos de integração permitem encaminhar cada um a um agente focado com um conjunto restrito de ferramentas, em vez de um agente geral que precisa descobrir a finalidade do email.

Confirme o recebimento enviando uma resposta. Como o canal nunca responde automaticamente, uma configuração bem-feita inclui uma ferramenta de email de saída que o agente chama ao final de sua execução para confirmar o processamento — sucesso ou falha.

Mantenha os agentes cientes de arquivos. O prompt do agente deve mencionar que ele está lendo documentos que chegaram por email. Isso muda o estilo de resposta: mais curto, estruturado, focado na ação tomada em vez de conversar.

Acompanhe o Registro de incidentes de IA no primeiro dia. A maioria dos erros de configuração — registros de roteamento ausentes, Ids de agente incorretos, agentes desativados — aparece ali. Faça a triagem do registro na primeira semana de operação.

Planeje a resolução de remetente se precisar dela. Se o agente precisar saber qual Contato ou Lead enviou o email, disponibilize uma ferramenta personalizada que faça a busca; a plataforma não faz isso automaticamente.

Perguntas frequentes

Não automaticamente. O canal de recebimento nunca envia uma resposta automática. Para enviar uma, o agente precisa de uma ferramenta de email de saída — a ferramenta nativa send_email ou uma ferramenta personalizada que use o endereço do remetente. Veja Canal de Email — Envio.

Se o endereço estiver encaminhado a um agente, o email é entregue a esse agente como um turno de conversa — o corpo, o assunto e o remetente se tornam a mensagem. Anexos não são obrigatórios. Se o endereço não tiver um registro de roteamento ativo, o email é ignorado.

Não. Essa configuração é estritamente o controle de segurança de anexos — ela rege apenas se os arquivos anexados são processados, nada mais. Um email encaminhado chega ao agente independentemente de essa configuração estar ativada ou não; com ela desativada, quaisquer anexos são simplesmente ignorados.

O email não é entregue a nenhum agente. Se ele trouxe anexos que foram arquivados, uma entrada no Registro de incidentes de IA registra o roteamento ausente; um email apenas com corpo enviado a um endereço sem roteamento é simplesmente ignorado. De qualquer forma, não há devolução (bounce) nem resposta — adicione um registro de roteamento ativo para o endereço para começar a processá-lo.

Não. O roteamento corresponde apenas ao endereço completo ou à sua parte local. Crie um registro de roteamento para cada endereço que você quiser suportar.

Não. Cada email de entrada inicia uma nova conversa. Para emails de acompanhamento que devem continuar uma conversa — por exemplo, uma resposta a uma mensagem iniciada pelo agente — veja Tratamento de Respostas de Email.

A maioria dos emails comerciais traz pequenas imagens embutidas — logotipos, banners, gráficos de assinatura — que não são o documento que o remetente pretendia enviar. Filtrá-los facilita o trabalho do agente e evita créditos de processamento indevidos.

Apenas como texto — o endereço de email do remetente é incluído no contexto da mensagem. A plataforma não corresponde automaticamente o remetente a um Contato ou Lead. Se você precisar dessa resolução, crie uma ferramenta personalizada que o agente possa chamar.

O recebimento é imediato; o processamento é assíncrono. O handler do Email Service armazena os arquivos e enfileira o trabalho, depois retorna; o agente é executado em segundo plano como um job Queueable.

Próximos passos

Configure o Canal de Email — Envio para que o agente possa responder, ou leia Tratamento de Respostas de Email para saber como a plataforma rastreia respostas a emails iniciados pelo agente.

← Anterior: Integração de Canal de Mensagens

Próximo: Canal de Email — Envio →