Pular para o conteúdo principal

Templates de E-mail

Templates de e-mail permitem personalizar as comunicações transacionais enviadas aos clientes.

Campos do Template

CampoDescrição
NomeNome do template
SlugIdentificador único
TipoTipo de notificação associada
AssuntoLinha de assunto (suporta variáveis)
Corpo HTMLConteúdo HTML do e-mail (suporta variáveis)
Corpo textoVersão em texto puro (fallback)
VariáveisLista de variáveis utilizadas
PadrãoUm template padrão por tipo de notificação
AtivoSe o template está disponível

Variáveis

Variáveis são substituídas no assunto e corpo usando a sintaxe {{ nome_variavel }}:

VariávelDescrição
{{ customer_name }}Nome do cliente
{{ invoice_number }}Número da fatura
{{ amount }}Valor em moeda
{{ due_date }}Data de vencimento
{{ verification_url }}Link de verificação de e-mail
{{ reset_url }}Link de reset de senha
{{ subscription_name }}Nome do plano
{{ trial_end_date }}Data de fim do trial

Operações

  • Criar: Novo template com nome, slug, tipo e conteúdo
  • Atualizar: Editar assunto, corpo e variáveis
  • Duplicar: Copiar template com novo slug
  • Deletar: Não é possível deletar o template padrão
  • Preview: Visualizar o template com dados de exemplo
  • Definir como padrão: Marca como template padrão para o tipo

Renderização

  1. Obtém o template por ID ou pelo tipo (usa o padrão)
  2. Carrega todas as variáveis do contexto
  3. Substitui todos os padrões {{ chave }} pelos valores
  4. Retorna assunto e corpo HTML renderizados

Segurança

  • Caracteres especiais são escapados via regex para prevenir ReDoS
  • Input do usuário é sanitizado antes da renderização