> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillfactory.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Templates de Email

> Personalize os emails transacionais enviados pela plataforma

## Templates de email

Personalize os emails enviados automaticamente pela plataforma. Cada tipo de email possui um template padrão que pode ser customizado com HTML e variáveis dinâmicas.

## Templates disponíveis

A plataforma possui os seguintes tipos de email:

| Template                 | Quando é enviado                                                | Editável           |
| ------------------------ | --------------------------------------------------------------- | ------------------ |
| **Boas-vindas**          | Quando um novo membro é criado (com credenciais de acesso)      | Sim                |
| **Redefinição de senha** | Quando o usuário solicita recuperação de senha (com código OTP) | Sim                |
| **Reenvio de senha**     | Quando o admin gera uma nova senha para o membro                | Não (interno)      |
| **Novo conteúdo**        | Quando novas aulas ou cursos são publicados                     | Não (desabilitado) |
| **Certificado pronto**   | Quando um certificado de conclusão é gerado                     | Sim                |

<Note>
  Não é possível criar novos tipos de template. No painel administrativo, você pode personalizar 3 templates: Boas-vindas, Redefinição de senha e Certificado pronto. O template de reenvio de senha é um template interno do sistema, e o template de novo conteúdo está temporariamente desabilitado.
</Note>

## Variáveis dinâmicas

Cada template tem acesso a variáveis que são substituídas automaticamente no momento do envio:

### Boas-vindas

| Variável                | Descrição            |
| ----------------------- | -------------------- |
| `{{ email }}`           | Email do novo membro |
| `{{ password }}`        | Senha gerada         |
| `{{ nome }}`            | Nome do membro       |
| `{{ nome_plataforma }}` | Nome da plataforma   |
| `{{ site_url }}`        | URL da plataforma    |
| `{{ logo_image }}`      | URL do logo          |

### Redefinição de senha

| Variável                | Descrição                 |
| ----------------------- | ------------------------- |
| `{{ email }}`           | Email do usuário          |
| `{{ otp }}`             | Código OTP de verificação |
| `{{ nome }}`            | Nome do usuário           |
| `{{ nome_plataforma }}` | Nome da plataforma        |
| `{{ site_url }}`        | URL da plataforma         |

### Certificado pronto

| Variável                 | Descrição                  |
| ------------------------ | -------------------------- |
| `{{ nome }}`             | Nome do estudante          |
| `{{ course_title }}`     | Nome do curso concluído    |
| `{{ completion_date }}`  | Data de conclusão          |
| `{{ certificate_code }}` | Código de validação        |
| `{{ validation_url }}`   | URL para validação pública |
| `{{ nome_plataforma }}`  | Nome da plataforma         |

## Editar um template

<Steps>
  <Step title="Acesse Admin → Templates de email">
    Veja a lista de templates disponíveis.
  </Step>

  <Step title="Selecione o template">
    Clique em "Editar" no template que deseja personalizar.
  </Step>

  <Step title="Edite o conteúdo">
    Use o editor para modificar o assunto e o corpo HTML do email. Insira variáveis usando a sintaxe `{{ variavel }}`.
  </Step>

  <Step title="Salve">
    Suas alterações ficam salvas como versão customizada. O template original é preservado.
  </Step>
</Steps>

### Editor

O editor utiliza o Lexical como base e suporta:

* Edição de HTML direto
* Formatação básica de texto
* Inserção de variáveis dinâmicas
* Visualização das tags disponíveis para cada tipo de template

<Info>
  O sistema valida que as variáveis obrigatórias estão presentes no template antes de salvar.
</Info>

## Restaurar template padrão

Se você customizou um template e deseja voltar ao original:

1. Acesse o template
2. Clique em "Restaurar padrão"
3. A versão customizada é removida e o template padrão volta a ser utilizado

## Segurança

Os templates passam por sanitização automática para prevenir vulnerabilidades:

* **Scripts removidos** - Tags `<script>` são eliminadas
* **Event handlers bloqueados** - Atributos como `onclick`, `onerror` são removidos
* **Protocolos perigosos** - Links `javascript:`, `data:text/html` são bloqueados
* **Tags permitidas** - Apenas HTML seguro para email (h1-h6, p, a, img, table, etc.)

## Provedor de email

A plataforma utiliza o **Resend** como provedor de envio de emails.

Os emails são enviados a partir de `noreply@get.skillfactory.com.br`. Se o logo da plataforma estiver configurado, ele é incluído automaticamente no cabeçalho dos emails.

### Estrutura do email

Cada email segue esta estrutura:

1. **Cabeçalho** - Logo e nome da plataforma (quando disponível)
2. **Corpo** - Conteúdo do template com variáveis substituídas
3. **Rodapé** - Copyright e aviso de email automático

Se o template customizado contiver um HTML completo (com `<!DOCTYPE html>` ou `<html>`), ele é usado diretamente sem o wrapper padrão.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Certificados" icon="certificate" href="/pt-br/admin/certificates">
    Configure o template de email de certificado
  </Card>

  <Card title="Personalização visual" icon="palette" href="/pt-br/admin/appearance">
    Configure o logo que aparece nos emails
  </Card>
</CardGroup>