Skip to content
🚀 EDDI 6.7.0

19 provedores LLM, bases de conhecimento que rastreiam o seu site e leem os seus arquivos, e conversas que acompanham as versões compatíveis do agenteNovidades

Cloud Gerenciada Começar
Todas as integrações
CanaisIMAP · SMTP

Email

Conecte uma caixa de correio a um agente. Cada novo e-mail inicia um turno do agente ou uma discussão em grupo e, no modo conversa, o agente responde na mesma thread, somente a um remetente cujo e-mail passou em DKIM e DMARC.

O que você recebe

  • Modo trigger para caixas de processos (faturas, pedidos, currículos, sinistros): o agente age por meio das suas ferramentas e nunca responde a ninguém
  • Modo conversa para a caixa de suporte ou de informações de uma equipe pequena: responde na mesma thread via SMTP, e a resposta do remetente continua a mesma conversa
  • Anexos entregues ao agente como arquivos, com os tipos permitidos que você escolher
  • Exchange Online e Microsoft 365 via OAuth (XOAUTH2), ou qualquer servidor IMAP com uma senha de app
  • Um orçamento de custo diário e um limite diário por remetente, para que uma enxurrada de e-mails não faça a conta disparar

Como funciona no EDDI

  1. Crie uma conexão SERVICE para a caixa de correio. A sua baseUrlAllowlist deve incluir a origem IMAP (imaps://host) e, no modo conversa, também a origem SMTP. O segredo permanece no cofre.
  2. Crie uma integração de canal com channelType: "email", o address da caixa de correio, um mode e o agente ou grupo para o qual ela encaminha. Ao salvar, o agendamento de verificação (poll) é criado.
  3. Restrinja quem pode acioná-la: requireAuthentication e uma senderAllowlist. Ao salvar, são retornados avisos quando qualquer pessoa poderia fazer o agente ser executado, ou quando o agente tem ferramentas mas nenhuma aprovação.
  4. Envie um e-mail de teste após a primeira verificação. E-mails que já estavam na pasta quando a integração foi criada não são processados.

Configuração

Extraída da documentação do EDDI. Marcadores como your-agent-id devem ser substituídos pelos seus próprios valores.

POST /connectionstore/connectionsUma conexão de caixa de correio para o Exchange Online com credenciais de cliente OAuth. O segredo do cliente é uma referência ao cofre.
{
  "name": "exo-invoices-mailbox",
  "authType": "OAUTH2_CLIENT_CREDENTIALS",
  "binding": "SERVICE",
  "oauth": {
    "tokenUrl": "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token",
    "clientId": "<application-id>",
    "clientSecret": "${vault:exo-invoices-client-secret}",
    "scopes": ["https://outlook.office365.com/.default"]
  },
  "baseUrlAllowlist": ["imaps://outlook.office365.com"]
}
POST /channelstore/channelsUma integração em modo trigger que só aceita e-mails autenticados de dois domínios de fornecedores e armazena anexos PDF e de imagem.
curl -X POST http://localhost:7070/channelstore/channels \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Invoice intake",
    "channelType": "email",
    "platformConfig": {
      "mode": "trigger",
      "transport": "imap",
      "connection": "exo-invoices-mailbox",
      "host": "outlook.office365.com",
      "address": "invoices@contoso.com",
      "processedAction": "move:EDDI/Processed",
      "senderAllowlist": "*@supplier-a.com,*@supplier-b.de",
      "requireAuthentication": "true",
      "attachments": "store",
      "attachmentMimeTypes": "application/pdf,image/png,image/jpeg",
      "dailyCostBudgetUsd": "20"
    },
    "targets": [ { "name": "intake", "type": "AGENT", "targetId": "your-agent-id" } ],
    "defaultTargetName": "intake"
  }'

Governança

  • E-mail é uma entrada não confiável. Dê a um agente de e-mail o mínimo de ferramentas de que ele precisa e coloque aprovações em toda ferramenta que altere algo. Quando um turno é pausado para aprovação, o remetente é informado de que uma pessoa precisa aprovar o próximo passo, nunca de qual ferramenta ou de quais argumentos.
  • O modelo nunca escolhe um destinatário. O modo trigger não envia nada, e o modo conversa responde somente ao remetente autenticado, com no máximo cinco respostas por thread por hora por padrão e um aviso de IA anexado a cada resposta.
  • Cada e-mail recusado e cada resposta enviada, com falha ou devolvida deixa uma entrada no registro de auditoria com o remetente apenas como domínio e hash. Nenhum e-mail bruto é armazenado, e a exclusão por endereço alcança as conversas e as linhas do registro.
  • Os servidores de e-mail são acessados somente por nome DNS, nunca em endereços privados ou de metadados, com TLS sempre verificado.

Bom saber

  • O EDDI não é um servidor de e-mail. Ele faz login em uma caixa de correio existente como um cliente de e-mail: sem registro MX e sem entrada pública.
  • Gmail e Google Workspace ainda não são suportados, nem um Exchange on-premises em um endereço privado. As respostas são em texto simples.
  • Se um helpdesk como Zendesk ou Freshdesk já recebe os e-mails, mantenha-o: acione o EDDI pelo canal de webhook assinado e responda pela API do helpdesk.

Precisa que construam e operem isso para você?

A EDDI Solutions constrói e mantém conectores, opera o EDDI como instância gerenciada ou co-operada e oferece suporte na sua própria nuvem ou on-premises.

Fale com a EDDI Solutions ↗

Integrações relacionadas

A configuração e o comportamento desta página seguem a documentação do EDDI, verificada em 2026-11-06. Nomes de campos e valores padrão podem mudar entre versões, portanto confirme-os na documentação da sua versão.