Pular para o conteúdo
⚙️ HOW-TO

Personalizar templates de email

Adapte os emails transacionais de auth com a identidade visual do seu produto.

Templates disponíveis

O SuperDB Auth envia emails automáticos em 4 situações:

  • magic_link — link de login sem senha (válido por 1 hora)
  • otp — código numérico de 6 dígitos para login ou verificação
  • welcome — boas-vindas após o primeiro signup confirmado
  • password_changed — notificação quando a senha é alterada

Variáveis disponíveis

Use estas variáveis no corpo HTML ou texto do template. O sistema substitui automaticamente no momento do envio:

Variáveis de template
{{user_name}}    — nome do usuário (ou email se nome não preenchido)
{{user_email}}   — endereço de email do usuário
{{otp_code}}     — código OTP de 6 dígitos (apenas no template otp)
{{link}}         — URL do magic link (apenas no template magic_link)
{{brand_name}}   — nome da plataforma configurado em Settings → Branding
{{brand_logo}}   — URL do logo configurado em Settings → Branding
{{year}}         — ano atual (para rodapé legal)

Como customizar via Admin UI

  1. Acesse admin.superdb.com.br → Auth → Email Templates.
  2. Selecione o template que deseja editar (ex: magic_link).
  3. Edite o campo Subject (assunto do email).
  4. Edite o campo HTML Body com o conteúdo do email em HTML.
  5. Opcionalmente, edite o Text Body (fallback para clientes que não renderizam HTML).
  6. Clique em Preview para ver como ficará com dados reais.
  7. Clique em Salvar.
💡

Preview com dados reais: O preview usa os dados da sua conta platform_admin para preencher as variáveis. Veja o email como o usuário verá antes de salvar.

html — template magic_link customizado
<!DOCTYPE html>
<html>
<body style="font-family: sans-serif; max-width: 480px; margin: 0 auto;">
  <img src="{{brand_logo}}" alt="{{brand_name}}" height="40" />
  <h2>Seu link de acesso, {{user_name}}</h2>
  <p>Clique no botão abaixo para entrar. O link expira em 1 hora.</p>
  <a href="{{link}}" style="background:#3ecf8e; color:#fff; padding:12px 24px;
     text-decoration:none; border-radius:6px; display:inline-block;">
    Entrar agora
  </a>
  <p style="color:#888; font-size:12px;">
    Se você não solicitou este acesso, ignore este email.
  </p>
</body>
</html>

Troubleshooting

Email cai na spam

Configure SPF, DKIM e DMARC para o domínio remetente. No Admin UI → Settings → Email, configure um SMTP próprio (ex: SendGrid, AWS SES) em vez do SMTP padrão do SuperDB para melhorar reputação de entrega.

Link do magic_link expirado

O prazo padrão é 1 hora. Ajuste em Auth → Settings → magic_link_expiry_seconds (máximo: 86400 = 24h).

Variável não substituída (aparece literal)

Verifique se a variável está escrita exatamente com duplas chaves: {{user_name}}. Espaços extras dentro das chaves causam falha na substituição.

Essa página ajudou?