Configurações - Templates de E-mail

O que é

Esta página concentra todos os modelos de e-mail transacional que o Viagilize dispara em nome da agência: boas-vindas, confirmação de reserva, reserva cancelada, lembrete de viagem, pagamento recebido, lembrete de pagamento, contrato pendente, documentos pendentes, documento aprovado, documento reprovado, recuperação de senha, configuração de senha, cartão de embarque, feliz aniversário e pesquisa de satisfação. Cada modelo pode ser personalizado em Assunto do Email, Título Principal, Mensagem Personalizada, Cor do Botão, Texto do Botão e Texto do Rodapé, e também pode ser ligado ou desligado individualmente pelo toggle Template ativo dentro de cada um.

O usuário normalmente chega aqui logo depois de configurar a identidade visual da empresa, quando quer alinhar a comunicação automática ao tom da marca, quando precisa trocar uma palavra específica em um e-mail recorrente, quando deseja desativar um modelo temporariamente ou quando quer reposicionar e estilizar a logo que aparece no cabeçalho de todos os e-mails. Os empresas do plano Whitelabel ganham acesso adicional ao Editor HTML para reescrever o template inteiro em código.

Como usar

1. Vá em Vitrine > Templates de E-mail no menu lateral (precisa da permissão de ver as configurações).
2. (Opcional) Configure a logo dos e-mails antes de editar qualquer template: clique no cabeçalho roxo Logomarca dos Emails para abrir o accordion e ajuste:
   • Logo para Emails - faça upload da imagem (JPG, JPEG, PNG ou WebP). Se nada for enviado, o sistema usa a logo padrão da empresa ou, na falta dela, o nome do site em texto.
   • Altura (px) - de 20 a 150, padrão 60.
   • Largura Máx (px) - de 50 a 400, padrão 200.
   • Cor de Fundo da Logo - color picker; deixe vazio para fundo transparente.
   • Arredondamento (px) - slider de 0 a 30 para deixar a logo com bordas arredondadas.
   • Padding interno (px) - slider de 0 a 30 para folga entre a logo e o fundo colorido. Cada alteração é salva automaticamente via Ajax (mensagem "Configurações salvas!" aparece logo abaixo dos campos).
3. Na grade de cards, identifique o template desejado pelo nome, descrição e ícone, e clique em Editar Textos no rodapé do card.
4. No formulário de edição, preencha os campos:
   • Assunto do Email - obrigatório, até 255 caracteres. Pode usar variáveis como {cliente_nome} ou {excursao}.
   • Título Principal - texto que aparece em destaque no cabeçalho do corpo do e-mail.
   • Mensagem Personalizada - editor TinyMCE com formatação básica (negrito, itálico, sublinhado, listas, link). Use Carregar mensagem sugerida (botão azul com ícone de varinha mágica acima do editor) para começar a partir do texto padrão; depois de ter conteúdo, o botão vira Resetar para padrão.
   • Cor do Botão - color picker (padrão #3B82F6).
   • Texto do Botão - rótulo do botão principal do e-mail (padrão "Ver Detalhes").
   • Mostrar botão do Grupo WhatsApp - aparece apenas em templates que possuem a variável link_whatsapp_grupo (Confirmação de Reserva, Pagamento Recebido). Quando ativo, adiciona um botão verde ao lado de "Ver Detalhes" se a excursão tiver grupo WhatsApp configurado.
   • Mostrar botão de Seguro Viagem - aparece em templates que possuem a variável link_seguro. Quando ativo, adiciona um botão azul de seguro se a excursão tiver link de seguro configurado.
   • Texto do Rodapé - opcional; em branco, o sistema usa os dados da empresa.
   • Template ativo - toggle azul. Quando desligado, o e-mail deste tipo deixa de ser enviado.
5. Use a barra lateral direita para validar antes de salvar:
   • Variáveis Disponíveis - clique em qualquer variável para copiar (toast "Copiado!").
   • Ver Preview - abre o e-mail renderizado em nova aba com dados de exemplo.
   • Enviar Email de Teste - digite um destinatário e clique em Enviar Email de Teste; o assunto chega com o prefixo [TESTE].
6. Clique em Salvar Template para voltar à listagem ou em Salvar e continuar editando para permanecer na mesma página.

Casos especiais

empresa Whitelabel - Editor HTML

Quando a sua empresa está no plano Whitelabel, cada card mostra também o botão amarelo Editor HTML e a página de edição ganha a barra lateral Whitelabel com o atalho Abrir Editor HTML. Nessa tela é possível colar um HTML completo no campo Código HTML, clicar em Carregar Template Base para começar a partir de um esqueleto, e ligar o toggle Usar HTML Customizado para que o sistema use o HTML colado no lugar do template padrão. empresas fora do Whitelabel são redirecionados de volta para o editor simples com a mensagem "Edição avançada disponível apenas para plano Whitelabel.".

Restaurar template para o padrão

Dentro da edição de qualquer template, o link Restaurar Padrão no rodapé esquerdo abre um modal de confirmação. Ao confirmar, o sistema repõe assunto com o padrão da constante EmailTemplate::TEMPLATES, título com o nome do template, mensagem, rodapé e html_customizado vazios, cor do botão em #3B82F6, texto do botão em "Ver Detalhes" e desliga Usar HTML Customizado. As personalizações anteriores são perdidas - não há histórico.

Variáveis específicas por template

Cada template aceita apenas as variáveis listadas no card e na barra lateral Variáveis Disponíveis. Algumas ({link_whatsapp_grupo}, {link_seguro}) só são preenchidas quando a excursão correspondente tiver esses campos configurados; caso contrário, o botão extra controlado pelos toggles Mostrar botão do Grupo WhatsApp e Mostrar botão de Seguro Viagem simplesmente não aparece no e-mail final.

Logo do e-mail vs. logo do site

A logo configurada no accordion Logomarca dos Emails é independente da logo do site. Se você deixar a logo de e-mail em branco, o sistema usa, nessa ordem: a logo padrão da empresa e, se não houver, o nome do site em texto branco sobre o gradiente das cores primária e secundária. O preview ao lado dos campos mostra exatamente como o cabeçalho ficará.

Lista fixa de templates

Não é possível criar novos templates pelo admin: a lista vem da constante EmailTemplate::TEMPLATES (15 modelos hoje). Templates ausentes no banco da sua empresa são criados automaticamente com valores padrão na primeira vez que a página é aberta (getAllTemplates chama getOrCreate para cada slug).

Erros comuns e como resolver

• "Template não encontrado." - Causa: o slug informado na URL não está em EmailTemplate::TEMPLATES. Solução: volte para /admin/email-templates e clique em Editar Textos a partir do card correto.
• "Edição avançada disponível apenas para plano Whitelabel." - Causa: tentativa de abrir /admin/email-templates/{slug}/edit-advanced em empresa que não está no plano Whitelabel. Solução: contrate o plano Whitelabel ou use o Editor Simples padrão.
• "Erro ao enviar email: ..." - Causa: falha na entrega do e-mail de teste (configuração SMTP/SES indisponível ou e-mail destino inválido). Solução: confirme se o e-mail digitado em Enviar Teste está correto e, se persistir, verifique com o suporte se a entrega de e-mail da sua empresa está saudável.
• "O campo assunto é obrigatório." - Causa: o Assunto do Email ficou em branco. Solução: preencha com um texto, podendo usar variáveis entre chaves.
• Logo não aparece no preview - Causa: nenhuma logo de e-mail enviada e a empresa também não tem logo padrão cadastrada. Solução: faça upload em Logo para Emails ou cadastre a logo principal em Configurações > Identidade Visual.
• Configurações de logo não salvam - Causa: valores fora dos limites (altura 20-150, largura 50-400, padding 0-50, arredondamento 0-30). Solução: ajuste os campos numéricos para dentro dos intervalos válidos; o salvamento automático normaliza valores ao recarregar.

Onde encontrar

• URL: /admin/email-templates
• Caminho no menu: Vitrine > Templates de E-mail
• Permissão necessária: ver as configurações para abrir a lista e os previews; editar as configurações para editar, restaurar, enviar teste e configurar a logo
• Módulo necessário: nenhum (o editor HTML avançado depende apenas do plano Whitelabel estar ativo na sua empresa)

Veja também

• Configurações - Notificações Automáticas
• Editar Template de E-mail