E2a: Gateway de E-mail Open-Source para Agentes de IA com Verificação SPF/DKIM e Entrega via Webhook/WebSocket

E2a é um gateway de e-mail de código aberto projetado para permitir que agentes de IA enviem e recebam e-mails como gatilhos. Ele fornece transporte autenticado — o e-mail recebido é verificado com SPF/DKIM, e cada entrega inclui cabeçalhos X-E2A-Auth-* assinados com HMAC. Os agentes recebem e-mail via webhook (modo nuvem) ou WebSocket (modo local, sem necessidade de URL público). O envio de e-mail é feito por uma API HTTP, suportando fluxos agente-para-agente (relé SMTP) e agente-para-humano (SMTP upstream como SES ou Resend).

Principais recursos da fonte:

• Encadeamento de e-mail permanece consistente com o encadeamento de conversas do agente.
• Revisão humana para e-mails enviados, com aprovação via painel, link mágico por e-mail ou CLI.
• Onboarding/offboarding rápido de endereços de e-mail para agentes em minutos.
• WebSocket para agentes locais e entrega de webhook pelo menos uma vez para agentes na nuvem.
• API de envio com retenção opcional HITL.
• Versão hospedada em e2a.dev com domínio compartilhado agents.e2a.dev para onboarding instantâneo baseado em slug.

Auto-hospedagem requer Docker. Clone o repositório e execute:

git clone https://github.com/Mnexa-AI/e2a.git
cd e2a
docker compose up -d

Isso inicia Postgres (com migrações automáticas), o servidor API na porta 8080, relé SMTP na 2525 e um painel (Caddy + Next.js) na porta 3000. Verificação de saúde: curl http://localhost:8080/api/health.

Crie um usuário e chave de API (sem OAuth):

docker compose exec e2a e2a -config /etc/e2a/config.yaml -bootstrap-email [email protected]

Registre um agente e confirme:

KEY=e2a_...
curl -X POST http://localhost:8080/api/v1/agents \
  -H " Authorization: Bearer $KEY " -H " Content-Type: application/json " \
  -d ' {"slug":"meu-bot","agent_mode":"local"} '
curl -H " Authorization: Bearer $KEY " http://localhost:8080/api/v1/agents

Para receber e-mails reais, aponte o registro MX do seu domínio para o host do relé. O projeto atualmente carece de suporte a DMARC (apenas SPF/DKIM), chaves de API com escopo, HA/multirregião, criptografia de dados de e-mail em nível de aplicação e atestados de conformidade (SOC 2/HIPAA).