Pular para conteúdo

Email Transacional (FrontEngine)

O FrontEngine é a plataforma de email transacional da InteSys, desenvolvida especificamente para mensagens geradas por aplicações, como confirmações de pedidos, redefinições de senha, notificações de envio e alertas de conta.

Visão Geral

Diferente das plataformas de email marketing, o FrontEngine é otimizado para alta entregabilidade de mensagens individuais e acionadas por eventos. Cada email é enviado a partir de endereços IP gerenciados com reputação de remetente ativamente mantida.

Métodos de Envio

Método Ideal Para
SMTP Relay Substituição direta para configurações SMTP existentes; funciona com qualquer linguagem ou framework
API REST Aplicações modernas que preferem integração baseada em HTTP com payloads JSON

Principais Recursos

  • Endereços IP dedicados com reputação gerenciada e aquecimento
  • Alta entregabilidade através do alinhamento de SPF, DKIM e DMARC
  • Webhooks em tempo real para eventos de entrega, rejeição, abertura e clique
  • Análises detalhadas — acompanhe taxas de entrega, aberturas, cliques e rejeições por mensagem ou domínio
  • Suporte a templates — defina templates HTML reutilizáveis com substituição de variáveis
  • Limitação de taxa — taxas de envio configuráveis para acompanhar a reputação do seu domínio
  • Multi-domínio — envie de múltiplos domínios em uma única conta

SMTP Relay

Conecte sua aplicação ao FrontEngine usando credenciais SMTP padrão:

Configuração Valor
Servidor smtp.frontengine.intesys.io
Porta 587 (STARTTLS) ou 465 (SSL)
Nome de usuário Sua chave de API
Senha Seu segredo de API
Autenticação PLAIN ou LOGIN
import smtplib
from email.mime.text import MIMEText

msg = MIMEText("Seu pedido #12345 foi enviado.")
msg["Subject"] = "Pedido Enviado"
msg["From"] = "[email protected]"
msg["To"] = "[email protected]"

with smtplib.SMTP("smtp.frontengine.intesys.io", 587) as server:
    server.starttls()
    server.login("your-api-key", "your-api-secret")
    server.send_message(msg)

API REST

Envie mensagens via HTTP POST com payloads JSON. A API suporta envios individuais e em lote, renderização de templates e manipulação de anexos.

curl -X POST https://api.frontengine.intesys.io/api/v1/send/message \
  -H "X-Server-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Pedido Enviado",
    "html_body": "<h1>Seu pedido foi enviado!</h1><p>Rastreamento: ABC123</p>"
  }'

→ Referência Completa da API

Primeiros Passos

  1. Crie uma chave de API no Portal do Cliente em Serviços > Email Transacional > Chaves de API
  2. Configure seu domínio de envio com registros SPF, DKIM e DMARC — consulte o Guia de Autenticação
  3. Envie uma mensagem de teste usando SMTP ou a API REST
  4. Configure webhooks para rastrear eventos de entrega — consulte Webhooks

Modo de Teste

Use o cabeçalho X-Test-Mode: true para validar requisições à API sem realmente enviar o email. Mensagens em modo de teste retornam uma resposta 200, mas não são entregues.

Boas Práticas de Entregabilidade

  • Sempre autentique seu domínio de envio com SPF, DKIM e DMARC
  • Use um endereço "From" consistente — mudanças frequentes prejudicam a reputação
  • Inclua uma versão em texto simples junto com o HTML
  • Processe rejeições prontamente e remova endereços inválidos
  • Aqueça novos endereços IP gradualmente (comece com 100-500 emails/dia)

Próximos Passos