Configurações Básico 10 min de leitura

Configurações - Templates de E-mail

Tela que lista todos os modelos de e-mail transacional disparados pelo Viagilize (boas-vindas, confirmação e cancelamento de reserva, lembrete de viagem, pagamento recebido, lembrete de pagamento, contrato pendente, documentos, senha, cartão de embarque, aniversário e pesquisa de satisfação) e permite editar textos, ativar/desativar cada template, configurar a logo do cabeçalho dos e-mails, enviar um e-mail de teste e, para empresas num plano com marca própria, abrir um editor de HTML completo.

Atualizado em 12/08/2026

Templates de e-mail

Tutorial em vídeo · 4:03 · gravado em 20/09/2026

Abrir na biblioteca de vídeos

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 planos com marca própria 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.
    • E-mail ligado (ou Template ativo) - toggle azul. Quando desligado, o e-mail deste tipo deixa de ser enviado. Os e-mails de acesso, como recuperação de senha, não têm essa opção.
  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 numa janela sobre a tela, com os dados da sua empresa e da próxima viagem cadastrada e um cliente de exemplo. Mostra o que está salvo: salve antes para ver as mudanças. Há também o link Abrir em nova aba.
    • 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

Marca própria - Editor HTML

Quando a sua empresa está num plano com marca própria, cada card mostra também o botão amarelo Editor HTML e a página de edição ganha a barra lateral Marca própria 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 dos planos com marca própria são redirecionados de volta para o editor simples com a mensagem "Edição avançada disponível apenas para planos com marca própria.".

Quais modelos existem e quando cada um sai

Todos os modelos da lista valem de verdade: o que você salvar é o que seus clientes recebem. Os que dependem de um módulo só aparecem quando a sua empresa tem o módulo (por exemplo, os de experiências, fidelidade, contratos e gift card).

  • Reservas: confirmação, reserva criada aguardando pagamento, cancelamento, convite ao passageiro, convite preenchido, carrinho abandonado, pedido aguardando pagamento, lista de espera (inscrição e vaga disponível), cobrança manual.
  • Pagamentos: pagamento recebido, lembrete de pagamento, recibo.
  • Contratos: assinatura eletrônica e link do contrato (viagem, experiência, jornada e fretamento).
  • Viagem: cartão de embarque, pesquisa de satisfação.
  • Acesso: boas-vindas, confirmação de e-mail, link de acesso, primeiro acesso, recuperação e definição de senha, link enviado pela equipe e ficha médica.
  • Outros: inscrição recebida e aprovada, cotação vencendo, experiência paga, gift card, indicação da fidelidade, aniversário, orçamento recebido, documentos aprovado e reprovado.

Na lista, o card mostra a situação de cada modelo: Personalizado (borda azul) quando seus clientes recebem o seu texto, Personalizado, ainda não vale (borda âmbar) quando o texto foi escrito antes de o modelo passar a valer e precisa ser salvo de novo, e Desligado quando o e-mail não é enviado.

Ao editar:

  • a caixa de texto abre com o e-mail que o cliente recebe hoje, para você editar a partir dele;
  • logo, cores e o rodapé com os contatos da empresa entram sozinhos, como em todos os e-mails;
  • as partes prontas do e-mail (botões, caixas, tabelas) são blocos, como {botao_redefinir_senha}. Insira pela lista Blocos da lateral. Os marcados como obrigatório não podem sair do texto, porque sem eles o cliente não conclui a ação (redefinir a senha, assinar o contrato, ver o voucher);
  • variável escrita errado (por exemplo {nome_cliente}) não é salva, para o cliente não receber o texto entre chaves;
  • os e-mails de acesso, de contrato e os que a equipe envia por clique não podem ser desligados.

Histórico e restaurar

Cada vez que você salva, a versão anterior fica guardada no quadro Histórico da lateral. Em cada versão, Ver mostra como ela era e Restaurar volta para ela (a versão atual também fica guardada, então dá para desfazer).

O link Restaurar Padrão, no rodapé esquerdo da edição, volta o modelo inteiro ao padrão do sistema, e o texto anterior também vai para o 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 planos com marca própria." - Causa: tentativa de abrir /admin/email-templates/{slug}/edit-advanced em empresa que não está num plano com marca própria. Solução: contrate um plano com marca própria 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 planos com marca própria estar ativo na sua empresa)

Veja também

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

Quer ver a documentação completa?

Acesse sua conta para ver screenshots, vídeos tutoriais e soluções de erros comuns.

1 vídeos

Este artigo foi útil?

Obrigado pelo seu feedback!

Neste artigo

Comece a usar agora

Crie sua conta e teste grátis por 7 dias, com acesso a todas as funcionalidades.

Testar Grátis