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

# Modelos de Design de E-mail

> Define a moldura dos e-mails de aviso que o painel manda: cores, logo, rodapé, e onde entra o texto de cada aviso.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Modelos** >
**Modelos de Design de E-mail**. A tela
[Notificações](/keyhelp-admin/notificacoes) também leva para cá, pelo
link **aqui** do texto dela.

A tela explica: *"Aqui você pode personalizar o design de todas as notificações
por e-mail enviadas pelo painel de controle."* O texto de cada aviso não fica
aqui, e sim nas mensagens de [Notificações](/keyhelp-admin/notificacoes).

![Prévia do design de fábrica: fundo escuro, o logo no alto, o texto do aviso entre duas linhas e o link KeyHelp Control Panel no rodapé](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/design-email-previa.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=c4c414a93fd12bfe06a097f218b1dc40)

De fábrica, o e-mail é o da imagem acima: fundo escuro, o logo, o texto do aviso
e um rodapé com o link **KeyHelp Control Panel**.

> [!NOTE]
>
> **O design de fábrica leva o nome KeyHelp no rodapé, mesmo com White Label**
>
> Medido num e-mail de teste com o White Label ligado: o logo era o do White
> Label, e o rodapé dizia **KeyHelp Control Panel**, nas versões HTML e texto da
> mensagem. Para tirar o nome, é preciso mudar o design nesta tela.

## Mudar o design

![Tela Modelos de Design de E-mail: o aviso sobre e-mails HTML, o espaço reservado content e o começo de um design gravado no editor](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/design-email.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=21b68b20288febc1a6b9e1f17bd5b32e)

1. Em **Código**, escreva o HTML do e-mail, com o `##content##` onde o texto do aviso deve entrar.
2. Clique em **Salvar**.

O painel responde *"As configurações foram atualizadas."*, e o design novo vale
para os e-mails seguintes.

A tela avisa: *"Observe que a criação de e-mails HTML não é trivial. A fim de
garantir que seu projeto personalizado seja compatível com uma ampla gama de
clientes de e-mail, certas diretrizes devem ser seguidas."* O editor tem os
atalhos *"Busca: Crtl + F, Substituir: Crtl + H, Tela cheia: F11, Sair da tela
cheia: F11 / Esc"*.

### Os três espaços reservados

A ajuda da tela fala só do `##content##`. O código de fábrica usa mais dois, e os
três foram trocados num e-mail de teste:

| Espaço reservado | Virou |
| - | - |
| `##content##` | o texto do aviso |
| `##panel_url##` | o endereço do painel, com `https://` |
| `##logo_url##` | o endereço do **Logo para as notificações por e-mail**, do [White Label](/keyhelp-admin/white-label) |

### Sem o `##content##`, não salva

**Medido:** um código sem o `##content##`, e também o código vazio, foram
recusados com *"O espaço reservado necessário ##content## está ausente."*

> [!WARNING]
>
> **A recusa descarta o código que você escreveu**
>
> Depois da mensagem, o editor volta com o design que estava gravado. Antes de
> salvar um design longo, copie o código para fora do painel.

## O que o e-mail leva, medido

Com um design próprio salvo, foi enviado o e-mail de teste da tela
[Notificações](/keyhelp-admin/notificacoes), para uma caixa de e-mail
do próprio servidor, e a mensagem foi lida lá:

* **A mensagem tem duas versões, HTML e texto**, e o design entrou nas duas. O programa de e-mail de quem recebe mostra uma ou outra.
* O logo e o endereço do painel entraram nos lugares do `##logo_url##` e do `##panel_url##`.

**O e-mail de verdade leva o design do mesmo jeito.** Medido criando uma conta com
**Enviar dados de acesso por e-mail**: a mensagem *"Sua conta de usuário foi
criada"* chegou com o design nas duas versões, HTML e texto. Nela, os espaços
reservados do texto do aviso foram trocados, e o nome da conta aparece, ao
contrário do e-mail de teste de [Notificações](/keyhelp-admin/notificacoes).

### "Texto simples" não tira a versão HTML

A ajuda diz: *"Para um e-mail de texto simples, remova tudo, exceto o espaço
reservado ##content##."* **Medido com o código só com `##content##`:** o e-mail
chegou sem logo, sem cores e sem rodapé, só com o texto do aviso. Mas continuou
com as duas versões: a HTML virou o texto com quebras de linha, sem layout.

## Ver o design antes

A introdução da tela tem o link **pré-visualização**, que abre numa aba nova o
design gravado, com um texto de enchimento (*Lorem ipsum*) no lugar do
`##content##` e com o logo. É de onde vem a imagem do começo deste artigo.

## Voltar ao design de fábrica

![Botões Voltar a visão geral, Redefinir configurações e Salvar](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/design-email-redefinir.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=7707902590df95e0981ba3c1a6455177)

O botão **Redefinir configurações** só aparece depois do primeiro **Salvar**,
**mesmo que nada tenha mudado**. Medido: salvar o design de fábrica sem mexer
gravou uma cópia dele, e o botão apareceu. Cada gravação fica anotada no Registro
de Eventos como *"Email design template updated."*

1. Clique em **Redefinir configurações**.
2. Na janela *"Tem certeza de que deseja redefinir as configurações?"*, clique em **Sim**.

O painel responde *"As configurações foram redefinidas."*, o design de fábrica
volta, e o botão some. Conferido com um e-mail de teste depois: voltou a moldura
de fábrica, com o rodapé **KeyHelp Control Panel**.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Os clientes veem "KeyHelp Control Panel" nos e-mails** | é o rodapé do design de fábrica | mudar o design nesta tela |
| **O logo do e-mail é outro** | o `##logo_url##` usa o logo de e-mail do White Label | trocar o **Logo para as notificações por e-mail** no White Label |
| **Não salva, e o código sumiu** | faltou o `##content##`, e a recusa descarta o que foi escrito | escrever de novo com o `##content##`, copiando antes para fora do painel |
| Pedi texto simples e o e-mail continua HTML | o painel sempre manda as duas versões | é o comportamento do painel: a versão HTML sai sem layout |
| Quero mudar o que o aviso diz | o texto é da mensagem do evento, e não do design | mudar em [Notificações](/keyhelp-admin/notificacoes) |
| O **Redefinir configurações** apareceu sem ninguém ter mudado o design | alguém clicou em **Salvar**, e isso já faz o painel tratar o design como personalizado | nada, se o design é o de fábrica; o Registro de Eventos diz quando foi |

## Ver também

* [Notificações](/keyhelp-admin/notificacoes), os avisos, o texto de cada um e o e-mail de teste
* [White Label](/keyhelp-admin/white-label), de onde vem o logo do e-mail
* [Importar/Exportar as Configurações](/keyhelp-admin/importar-exportar-as-configuracoes), que leva o design para outro servidor


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.