# E-mails padrão

> Como o proprietário e o administrador trocam o texto dos e-mails que a plataforma envia em nome da comunidade (boas-vindas, convites, importação, pedido de acesso aprovado, compra confirmada e inscrição em evento), com uma versão por idioma, blocos fixos, variáveis permitidas, ligações e o que acontece quando a versão da comunidade não pode ser usada.

Há e-mails que a plataforma envia sozinha, em nome da comunidade: as boas-vindas a quem se regista, o convite, o recibo da compra. Em **E-mails padrão**, o proprietário e o administrador trocam o texto deles pelo da comunidade, no mesmo editor das [campanhas de e-mail](/notificacoes/campanhas-de-email), sem mudar quando nem para quem são enviados.

**Onde fica:** **Administração › Campanhas › E-mails padrão**. Só o proprietário e o administrador veem o separador; o moderador e o financeiro, não.

## Os e-mails que é possível trocar

São seis famílias, em três grupos:

| Grupo | E-mail | Quem recebe |
|---|---|---|
| **Entrada** | **Boas-vindas ao registo** | Quem se regista na comunidade |
| **Entrada** | **Convite (conta nova)** e **Convite (já tem conta)** | Quem é convidado |
| **Entrada** | **Importação (conta nova)** e **Importação (já tem conta)** | Quem foi importado por folha de cálculo |
| **Entrada** | **Pedido de acesso aprovado** | Quem pediu para criar uma comunidade e foi aprovado |
| **Compras** | **Compra confirmada** | O recibo de quem comprou |
| **Eventos** | **Inscrição em evento** | A confirmação do **Vou**, com o bilhete quando há check-in |

A lista mostra se cada um está **Padrão** ou **Personalizado** e em que idiomas (*"Personalizado em: …"*). **Compra confirmada** e **Inscrição em evento** levam a etiqueta **Sempre enviado**: não têm ligação para cancelar a subscrição e não aceitam blocos de divulgação. Os outros respeitam a categoria do e-mail em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade) e trazem a ligação para a desligar.

## Como funciona

### Uma versão por idioma

Cada e-mail padrão tem uma versão da comunidade por idioma. Quem lê num idioma sem versão da comunidade recebe o e-mail padrão da plataforma nesse idioma. Com **Usar a versão da comunidade** desligado, sai o padrão em todos os idiomas, e as versões ficam guardadas.

**Restaurar padrão** apaga a versão da comunidade no idioma aberto e pede confirmação: quem lê nesse idioma volta a receber o padrão.

### Blocos fixos

Cada e-mail tem **blocos fixos**, que a plataforma preenche: o botão de definir a palavra-passe ou de entrar, o botão de aceder à comunidade, a origem do contacto e a ligação *"não quero participar"* na importação, o resumo da compra no recibo, e a data, o local e o bilhete com QR Code na inscrição em evento. No editor, aparecem como **Fixo**: é possível mudá-los de lugar, mas não retirá-los. Uma versão sem um bloco fixo não é guardada.

O e-mail padrão aceita texto, botão, imagem e os blocos fixos; os blocos com o conteúdo da comunidade (posts, cursos, eventos, produtos) não entram.

### Variáveis

Todos aceitam `{{nome}}`, `{{nome_completo}}`, `{{comunidade}}` e `{{membro_desde}}`, e cada um tem as suas:

| E-mail | Variáveis próprias |
|---|---|
| Boas-vindas ao registo | `{{link_comunidade}}` |
| Convite (conta nova) | `{{convidado_por}}`, `{{validade_dias}}` |
| Convite (já tem conta) | `{{convidado_por}}`, `{{link_login}}` |
| Importação (conta nova) | `{{origem}}`, `{{validade_dias}}` |
| Importação (já tem conta) | `{{origem}}`, `{{link_login}}` |
| Compra confirmada | `{{produto}}`, `{{valor}}`, `{{metodo}}`, `{{link_acesso}}` |
| Inscrição em evento | `{{evento}}`, `{{data_hora}}`, `{{local}}`, `{{link_evento}}` |

Uma variável que não pertence ao e-mail é recusada ao guardar, e uma variável não pode ficar dentro de uma ligação ou do endereço de uma imagem.

### Ligações

Ligações e imagens só com `https://`. No recibo (**Compra confirmada**) e na **Inscrição em evento**, ligações e botões só podem apontar para o domínio da própria comunidade.

### Quando a versão da comunidade não é usada

Se a versão da comunidade não puder ser usada no momento do envio (por exemplo, o e-mail da biblioteca ligado a ela foi eliminado), a pessoa recebe o e-mail padrão da plataforma, e nada deixa de chegar. Os proprietários recebem um aviso, *"o e-mail … saiu no padrão"*, com o motivo, no máximo uma vez por dia para cada e-mail.

### Envio e teste

O e-mail padrão sai da mesma forma e à mesma hora que sairia o da plataforma: não conta para a quota de campanhas. **Enviar teste para mim** envia a versão aberta só para quem tem a sessão iniciada.

## Passo a passo

1. Em **Administração › Campanhas**, abra **E-mails padrão**.
2. Clique no e-mail que quer trocar e escolha o **Idioma**.
3. Escreva o assunto e o texto, com as variáveis da lista e os blocos fixos onde quiser.
4. **Guardar**. Confira com **Enviar teste para mim**.
5. Deixe **Usar a versão da comunidade** ligado.

## Erros comuns e como resolver

| Mensagem | Porquê | O que fazer |
|---|---|---|
| *Faltam os blocos bloqueados: … Não podem sair do e-mail.* | Foi retirado um bloco fixo | Desfaça a remoção ou use **Restaurar padrão** |
| *A variável … não existe neste e-mail.* | Variável de outro e-mail | Use só as variáveis da tabela |
| *Ligações e imagens só com https://.* | Ligação ou imagem com `http://` | Troque por `https://` |
| *No recibo e no bilhete, ligações e botões só para o domínio da comunidade.* | Ligação para outro site no recibo ou na inscrição em evento | Aponte para uma página da comunidade |
| *O e-mail padrão só leva texto, botão, imagem e os blocos bloqueados.* | Bloco de conteúdo da comunidade | Retire o bloco |

## Pelo assistente (MCP)

O proprietário e o administrador consultam, editam, ligam, desligam, restauram e testam os e-mails padrão pelo assistente; restaurar pede confirmação, e o teste vai só para quem o pede. Ver [Ferramentas · Comunidade](/mcp/ferramentas-comunidade#biblioteca-de-e-mails-e-e-mails-padrao).

## Na API

`GET /api/email-overrides` lista os e-mails padrão; `GET` e `PATCH /api/email-overrides/{emailKey}` leem e ligam ou desligam a versão da comunidade; `GET`, `PUT` e `DELETE /api/email-overrides/{emailKey}/{language}` leem, guardam e restauram uma versão; `POST …/preview` e `POST …/test` mostram e testam. Só proprietário e administrador (`403` para os outros). Os blocos fixos são `{ "type": "systemSlot", "slot": "…" }`.

## Relacionados

- [Campanhas de e-mail](/notificacoes/campanhas-de-email)
- [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)
- [E-mails da plataforma](/notificacoes/emails-da-plataforma)