Pular para o conteúdo
⚙️ HOW-TO

Personalizar templates de email

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

Quais e-mails o SuperDB envia

O Auth manda quatro e-mails automáticos, e cada um tem um template que você pode editar:

  • Código de verificação: o código de 6 dígitos do login sem senha. Vale 10 minutos.
  • Link mágico: o link de login sem senha. Vale 15 minutos e só pode ser usado uma vez.
  • Redefinição de senha: o link do "esqueci minha senha". Vale 1 hora.
  • Senha alterada: o aviso de segurança depois de uma troca de senha.

O editor mostra mais dois, Confirmação de cadastro e Convite, marcados como Não enviado: hoje nenhum fluxo manda esses e-mails. Dá para deixá-los prontos; eles passam a valer quando o envio existir.

Variáveis de cada template

Escreva a variável entre chaves duplas, como {{url}}. Cada template recebe só as suas, e uma variável que o template não recebe sai em branco no e-mail.

TemplateVariáveis
Código de verificação{{code}}, {{expires_in_minutes}}
Link mágico{{url}}, {{email}}, {{expires_in_minutes}}
Redefinição de senha{{url}}, {{email}}, {{expires_in_minutes}}
Senha alterada{{email}}, {{occurred_at}} (data e hora de Brasília)
Confirmação de cadastro (não enviado){{url}}, {{email}}, {{expires_in_minutes}}
Convite (não enviado){{url}}, {{org_name}}, {{inviter_name}}

Não existe variável com o nome da pessoa: nenhum desses envios sabe como ela se chama. Se o projeto tiver logo e cor de destaque configurados (hoje pela equipe do SuperDB; peça pelo suporte), todo template recebe também {{logo_url}} e {{accent_color}}, e o molde padrão já os usa.

Como editar

  1. No painel, abra o projeto e vá em Emails.
  2. Escolha o template.
  3. Edite o assunto e o corpo, no modo visual (blocos) ou em HTML. Os botões de inserir variável mostram só as do template aberto.
  4. A prévia ao lado preenche as variáveis com valores de exemplo.
  5. Salve. Para ver o e-mail de verdade na sua caixa, use Enviar teste: ele vai para o seu próprio e-mail, com os valores de exemplo.

A versão em texto puro (para quem não abre HTML) continua sendo a do template padrão.

O HTML que o template aceita

Ao salvar, o HTML do template passa pela mesma limpeza que o e-mail passa ao ser enviado:

  • Ficam as tags comuns de e-mail (texto, títulos, listas, tabelas, imagens e links), com estilo inline.
  • Saem <script>, <iframe>, atributos de evento (onclick, onerror e parecidos) e links javascript:. Link só aceita http, https e mailto.
  • As variáveis continuam funcionando, inclusive dentro de href e de style, como em background-color:{{accent_color}}.
  • Se não sobrar nada depois da limpeza (um template só com <script>, por exemplo), ele não é salvo.

A prévia mostra o e-mail isolado do painel, sem executar nada do que estiver no template.

html: link mágico customizado
<h2>Seu link de acesso</h2>
<p>Clique no botão para entrar como {{email}}.</p>
<a href="{{url}}" style="background:#18181b; color:#fff; padding:12px 24px;
   text-decoration:none; border-radius:6px; display:inline-block;">
  Entrar agora
</a>
<p style="color:#888; font-size:12px;">
  O link expira em {{expires_in_minutes}} minutos e só pode ser usado uma vez.
  Se você não pediu, ignore este e-mail.
</p>

Troubleshooting

O e-mail cai no spam

Em Emails → Remetente dos emails, verifique o domínio do seu produto: os e-mails passam a sair assinados por ele. Não há SMTP para configurar.

O link mágico expirou

Ele vale 15 minutos e só pode ser usado uma vez. Peça um novo pelo app.

Uma variável saiu em branco

O template não recebe essa variável: confira a tabela acima. O link é sempre {{url}}, e não existe variável de nome.

Essa página ajudou?