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://app1.frontengine.net/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>"
}'
Primeiros Passos¶
- Crie uma chave de API no Portal do Cliente em Serviços > Email Transacional > Chaves de API
- Configure seu domínio de envio com registros SPF, DKIM e DMARC — consulte o Guia de Autenticação
- Envie uma mensagem de teste usando SMTP ou a API REST
- 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¶
- Referência da API — Documentação completa dos endpoints
- Autenticação — SPF, DKIM e DMARC para domínios de envio
- Webhooks — Notificações de eventos de entrega em tempo real