Site - Editar Templates de E-mail

O que é

A página concentra todos os e-mails transacionais que o Viagilize dispara automaticamente para os clientes da agência. Cada template tem um proposito fixo (confirmação de reserva, cancelamento, lembrete de viagem, pagamento recebido, cobranca de parcela, contrato pendente, documento pendente, recibo de embarque, pesquisa de satisfacao/NPS, aniversario, recuperacao de senha, entre outros) e um conjunto proprio de tags dinamicas entre chaves (ex.: {cliente_nome}, {excursao}, {valor}) que são substituidas pelos dados reais no momento do envio.

O administrador normalmente chega aqui após configurar a identidade visual do site para ajustar o tom de voz das mensagens, adicionar instruções especificas da agência (regras de embarque, contatos do suporte) e validar que cada e-mail sai com a logo, cores e assinatura corretas. A edição usa um editor de texto rico (TinyMCE) com toolbar simplificada e não exige conhecimento de HTML.

Como usar

1. Va em Site > Templates de E-mail no sidebar.
2. Localize o template desejado na grade (cada card mostra nome, descrição e a lista de tags suportadas).
3. Clique em Editar Textos no rodape do card.
4. Preencha os campos:
   • Assunto do E-mail (obrigatório): texto exibido na caixa de entrada do cliente. Aceita tags (ex.: Reserva Confirmada - {excursao}).
   • Titulo Principal: aparece no cabecalho do corpo do e-mail.
   • Mensagem Personalizada: corpo do e-mail no editor TinyMCE. Use os botoes da toolbar para negrito, italico, listas e links.
   • Cor do Botao e Texto do Botao: define a chamada para ação principal (padrão "Ver Detalhes", azul #3B82F6).
   • Texto do Rodape: se ficar vazio, o sistema usa os dados da empresa cadastrados em Identidade Visual.
   • Template ativo: toggle no rodape do formulario; se desligado, o sistema deixa de enviar esse e-mail.
5. (Opcional) Na sidebar direita, clique em qualquer tag listada em Variaveis Disponíveis para copiar para a area de transferência.
6. (Opcional) Clique em Carregar mensagem sugerida acima do editor para inserir um texto padrão formatado caso o campo esteja vazio.
7. Confirme em Salvar Template ou em Salvar e continuar editando para permanecer na tela.

Como configurar a logomarca dos e-mails

1. No topo da listagem, clique no acordeon Logomarca dos E-mails.
2. Faca upload de uma imagem dedicada em Logo para E-mails (JPG, PNG ou WebP). Se ficar vazio, o e-mail usa a logo padrão do site ou o nome da empresa.
3. Ajuste Altura (px) (20 a 150), Largura Max (px) (50 a 400), Cor de Fundo da Logo, Arredondamento (px) (0 a 30) e Padding interno (px) (0 a 30).
4. A coluna Preview do Cabecalho mostra o resultado em tempo real. As configurações são salvas automaticamente a cada alteracao (mensagem "Configurações salvas!" em verde).

Como enviar e-mail de teste

1. Na tela de edição, va ate o card verde Enviar Teste na sidebar.
2. O campo ja vem preenchido com o e-mail do usuário logado. Altere se necessário.
3. Clique em Enviar Email de Teste. O sistema dispara um e-mail real com o prefixo [TESTE] no assunto e dados fictcios (cliente "Teste", excursão "Viagem de Teste", valor R$ 100,00, etc.) para validar a aparencia e a substituicao das tags antes de ativar o template em producao.

Casos especiais

Tags disponíveis por template

A lista de tags varia conforme o tipo de e-mail. As principais:

• Boas-vindas (welcome): {cliente_nome}, {empresa}, {link_login}.
• Confirmação de Reserva (booking-confirmation): {cliente_nome}, {excursao}, {data_viagem}, {valor}, {link_detalhes}, {link_whatsapp_grupo}, {link_seguro}, {label_seguro}.
• Reserva Cancelada (booking-cancelled): {cliente_nome}, {excursao}, {data_viagem}, {codigo}, {motivo}, {empresa}.
• Lembrete de Viagem (booking-reminder): {cliente_nome}, {excursao}, {data_viagem}, {local_embarque}, {horario}.
• Pagamento Recebido (payment-received): {cliente_nome}, {valor}, {forma_pagamento}, {excursao}, {saldo_restante}, {link_detalhes}, {link_whatsapp_grupo}, {link_seguro}, {label_seguro}.
• Lembrete de Pagamento (payment-reminder): {cliente_nome}, {valor}, {data_vencimento}, {excursao}, {link_pagamento}.
• Contrato Pendente (contract-pending): {cliente_nome}, {excursao}, {link_contrato}.
• Documento Pendente/Aprovado/Reprovado: {cliente_nome}, {tipo_documento}, {motivo_reprovacao}, {data_aprovacao}, {documentos_pendentes}, {link_documentos}, {empresa}.
• Recuperacao de Senha (password-reset): {cliente_nome}, {link_reset}, {empresa}.
• Configuração de Senha (password-setup): {nome}, {link_definir_senha}, {empresa}, {tipo_conta}.
• Cartao de Embarque (boarding-card): {cliente_nome}, {excursao}, {data_viagem}, {local_embarque}, {horario}.
• Aniversario (birthday): {cliente_nome}, {empresa}.
• Pesquisa de Satisfacao/NPS (satisfaction-survey): {cliente_nome}, {excursao}, {data_viagem}, {link_pesquisa}, {empresa}.

A sidebar de Variaveis Disponíveis da tela de edição mostra exatamente quais tags valem para aquele template.

Botoes opcionais de WhatsApp e Seguro Viagem

Nos templates que aceitam {link_whatsapp_grupo} (Confirmação de Reserva, Pagamento Recebido), aparece um toggle verde Mostrar botao do Grupo WhatsApp. Ele so adiciona o botao no e-mail real se a excursão tiver grupo de WhatsApp cadastrado.

Da mesma forma, nos templates com {link_seguro}, o toggle azul Mostrar botao de Seguro Viagem adiciona o botao apenas quando o item tem link de seguro configurado.

Editor HTML avancado (Whitelabel)

empresas no plano Whitelabel veem um botao ambar Editor HTML no rodape de cada card e também na sidebar direita da tela de edição. Ele abre /admin/email-templates/{slug}/edit-advanced, onde e possível colar um HTML completo no campo HTML Customizado e marcar Usar HTML Customizado para sobrescrever o template padrão. As tags continuam sendo substituidas via {tag}.

empresas fora do plano Whitelabel são redirecionados para o editor simples com o aviso "Edição avancada disponível apenas para plano Whitelabel.".

Pre-visualizacao com dados de exemplo

O link Preview no rodape de cada card abre uma nova aba renderizando o e-mail com dados ficticios fixos: cliente "Joao Silva", excursão "Viagem para Gramado", data 15/02/2026, valor R$ 450,00, saldo R$ 200,00, local "Terminal Rodoviario Central", horario 06:00, etc. Util para conferir formatacao sem disparar e-mail real.

Restaurar template ao padrão

Use o link Restaurar Padrão no canto inferior esquerdo da tela de edição para limpar os campos e voltar ao assunto/titulo originais do sistema, com a mensagem vazia, cor #3B82F6 e texto "Ver Detalhes" no botao. Um modal pede confirmação antes de aplicar.

Erros comuns e como resolver

• "Template não encontrado." - Causa: slug invalido na URL (o sistema so conhece os 15 slugs cadastrados na constante TEMPLATES). Solucao: voltar a listagem e abrir pelo botao Editar Textos do card.
• "Edição avancada disponível apenas para plano Whitelabel." - Causa: tentativa de acessar /admin/email-templates/{slug}/edit-advanced ou salvar via PUT /admin/email-templates/{slug}/advanced sem o plano Whitelabel ativo. Solucao: usar o Editor Textos simples ou contratar o plano Whitelabel.
• "Erro ao enviar email: ..." - Causa: falha do servidor SMTP/SES ao enviar o e-mail de teste (geralmente endereço invalido ou indisponibilidade temporaria). Solucao: confirmar o e-mail digitado, aguardar alguns minutos e tentar novamente.
• Tag aparece literal no e-mail (ex.: {cliente_nome} em vez do nome)
  • Causa: a tag usada não esta na lista de Variaveis Disponíveis do template ou foi digitada com erro (chaves duplas {{...}}, espacos internos). Solucao: copiar a tag pela sidebar Variaveis Disponíveis e usar exatamente o formato {nome_da_tag}.
• Logo não aparece no e-mail de teste - Causa: nenhum arquivo enviado em Logo para E-mails e a logo padrão do site também esta vazia. Solucao: subir uma imagem no acordeon Logomarca dos E-mails ou configurar a logo padrão em Identidade Visual.

Onde encontrar

• URL: /admin/email-templates
• Caminho no menu: Site > Templates de E-mail
• Permissão necessária: ver as configurações (listagem e preview) e editar as configurações (editar, restaurar, enviar teste, salvar logo)
• Módulo necessário: nenhum (editor HTML avancado exige plano Whitelabel)

Veja também

• Identidade Visual - ajustar logo padrão, nome do site e cores que alimentam o cabecalho dos e-mails.
• Cores e Aparencia - definir as cores primaria e secundaria usadas no gradiente do cabecalho.
• Template do Site - manter coerencia visual entre o site publico e os e-mails transacionais.