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