ESTA DOCUMENTAÇÃO ESTÁ EM DESENVOLVIMENTO E CONSTANTE ATUALIZAÇÃO.

E-mail Marketing & Campaigns

Envie e-mails transacionais e campanhas automatizadas utilizando a infraestrutura do DevCod Mail, com suporte a escrita por IA e tracking nativo de engajamento.

A Stack de Envio (DevCod Mail Integration)

O sistema utiliza o DevCod Mail como gateway oficial para entrega de e-mails transacionais, sequências e newsletters.

  • DKIM e SPF: O tenant configura os registros DNS (MX, TXT e CNAME) fornecidos pelo DevCod Mail no painel admin para autenticar o domínio remetente próprio, garantindo a máxima entregabilidade na caixa de entrada.
  • Throttling e Limites: O disparo em lote respeita limites configurados no banco por tenant (budget mensal) para precaver abusos financeiros das contas.

Editor de Templates de E-mail (Visual Email Builder)

O DevCod Agency conta com um construtor de templates drag-and-drop completo na área administrativa de e-mails (/admin/crm/email). Ele permite estruturar e-mails marketing ricos sem tocar em HTML:

  • Blocos de Design Reutilizáveis: Suporte a arrastamento de colunas estruturadas, imagens hospedadas na biblioteca do tenant, blocos de texto formatado, botões de chamada para ação (CTA) e links de mídias sociais.
  • Compilação para HTML Responsivo: O backend compila dinamicamente a estrutura de blocos do editor em um arquivo HTML otimizado para exibição perfeita em dispositivos móveis e clientes de e-mail variados (Outlook, Gmail, Apple Mail).
  • Personalização Dinâmica de Variáveis: Permite injetar campos de contato do banco direto no conteúdo de forma segura.

Escrita por IA (AI Copywriting)

A rota /api/admin/email/ai-generate permite que os agentes escrevam as campanhas automaticamente:

  • Tom de Voz do Tenant: A IA consome a identidade de marca resgatada do BrandProfile do banco, adaptando o e-mail para tons como "profissional", "educativo" ou "agressivo".

Rastreamento Nativo (Email Tracking)

O DevCod Agency conta com telemetria interna para registrar o engajamento sem dependência de trackers externos:

  • Pixel de Abertura (Open Tracking): Cada e-mail enviado anexa no final um pixel oculto apontando para a rota pública /api/email/track?c=[campaignId]&l=[leadId]. O servidor computa a abertura no banco e responde com um arquivo GIF de 1x1 pixel transparente de alta performance.
  • Rastreamento de Cliques (Click Tracking): Todos os links do e-mail são redirecionados para a rota /api/email/click?c=[campaignId]&l=[leadId]&url=[linkOriginalEncodado], gravando o evento de clique antes de redirecionar o usuário final.
  • Sincronização de Opt-Out (Unsubscribe): O rodapé do e-mail contém obrigatoriamente a tag {{unsubscribeUrl}} ligada a /api/email/unsubscribe. Clicar nela desativa o recebimento e altera o status do contato no CRM para inativo de forma imediata.

Webhooks de Eventos de E-mail (Bounces & Spams)

O endpoint /api/webhooks/email-events monitora o recebimento e a integridade de entrega no destino final:

{`
Fluxo de Webhook de Retorno:
┌────────────────────────┐      ┌────────────────────────┐      ┌────────────────────────┐
│ DevCod Mail API             │─────▶│ API /webhooks/email-events│─────▶│ CRM Database           │
│ Dispara log:           │      │ Valida assinatura do   │      │ Altera contato para:   │
│ bounce, spam ou click  │      │ webhook                │      │ "bounced" ou "complaint"│
└────────────────────────┘      └────────────────────────┘      └────────────────────────┘
          `}

Variáveis Dinâmicas de Template

Ao criar templates de e-mail, as seguintes variáveis são resolvidas em tempo de compilação do envio:

Marcador (Placeholder) Valor Substituído
{"{{firstName}}"} Primeiro nome do contato cadastrado no CRM
{"{{email}}"} E-mail do destinatário
{"{{company}}"} Empresa vinculada ao contato
{"{{unsubscribeUrl}}"} Link único e seguro para descadastramento (opt-out)
Próximo: Agentes IA →