WhatsApp - Personalizar Templates de Mensagens

O que é

A aba Templates dentro de Configurar WhatsApp concentra o texto de todas as mensagens automáticas que o Viagilize envia em nome da sua empresa: confirmação de reserva, confirmação de pagamento, lembrete de viagem, lembrete de cobrança, lembrete de vencimento, aniversário, pesquisa de satisfação, carrinho abandonado e pedido pendente.

O usuário normalmente chega aqui logo após conectar o WhatsApp e ativar as automações na aba Automações, quando quer que as mensagens saiam com a voz da própria empresa em vez do texto padrão do Viagilize. Cada template aceita placeholders entre chaves (por exemplo {nome}, {codigo}, {valor}) que são substituídos pelos dados reais da reserva no momento do envio.

Como usar

1. Vá em Comunicação > WhatsApp Mensagens no sidebar.
2. Clique em Configurar WhatsApp (ou no botão de configurações dentro do dashboard do WhatsApp).
3. Selecione a aba Templates no card branco do topo.
4. Clique no card do template que deseja editar (por exemplo Confirmação de Pagamento). O bloco expande mostrando:
   • Variáveis disponíveis - chips azuis listando exatamente os placeholders que aquele template aceita (por exemplo {nome}, {codigo}, {valor}, {empresa}).
   • Caixa de texto com a mensagem atual, em fonte monoespaçada.
   • Botão Visualizar Preview.
5. Reescreva o texto na caixa. Use as variáveis entre chaves exatamente como aparecem nos chips azuis. Você também pode usar formatação do WhatsApp: *texto* para negrito, _texto_ para itálico e ~texto~ para riscado.
6. Clique em Visualizar Preview para abrir um mockup de celular com a mensagem renderizada usando dados de exemplo (cliente "Maria Silva", destino "Gramado - RS", etc.). Feche o preview no X ou clicando fora.
7. Repita para os demais templates que quiser mudar - todos ficam dentro da mesma aba e só são gravados quando você confirma no botão final.
8. Clique em Salvar Templates (botão verde no final da aba) para gravar todas as alterações de uma vez.

Placeholders por tipo de template

Cada template aceita um conjunto específico de variáveis (controlado pelo Viagilize para evitar que você insira um campo que o sistema não sabe preencher). As variáveis suportadas em cada um:

• Confirmação de Reserva: {nome}, {codigo}, {data}, {destino}, {horário}, {local_embarque}, {horario_embarque}, {referencia_embarque}, {endereco_embarque}, {empresa}.
• Reserva Cancelada: {nome}, {codigo}, {data}, {destino}, {empresa}.
• Confirmação de Pagamento: {nome}, {codigo}, {valor}, {empresa}.
• Lembrete de Viagem: {nome}, {codigo}, {data}, {destino}, {horário}, {local_embarque}, {horario_embarque}, {referencia_embarque}, {endereco_embarque}, {link_cartao_embarque}, {status_embarque}, {empresa}.
• Lembrete de Cobrança: {nome}, {codigo}, {valor}, {vencimento}, {link_pagamento}, {empresa}.
• Lembrete de Vencimento: {nome}, {codigo}, {destino}, {parcela}, {valor}, {vencimento}, {link_pagamento}, {empresa}.
• Aniversário: {nome}, {empresa}.
• Pesquisa de Satisfação: {nome}, {destino}, {link_pesquisa}, {empresa}.
• Carrinho Abandonado: {nome}, {itens_resumo}, {valor}, {quantidade}, {link_carrinho}, {empresa}.
• Pedido Pendente: {nome}, {codigo}, {itens_resumo}, {valor}, {link_pagamento}, {empresa}.

Variáveis fora dessa lista para o template em questão não são substituídas - aparecem literalmente no celular do cliente como {algumacoisa}.

Casos especiais

Restaurar todos os templates ao padrão

Se as personalizações ficaram muito longe do ideal e você quer voltar ao texto original do Viagilize:

1. Na aba Templates, clique em Restaurar Padrão (link cinza no canto superior direito da seção).
2. Confirme o aviso "Deseja restaurar todos os templates para o padrão? Suas personalizações serão perdidas.".
3. Todos os templates voltam ao texto padrão imediatamente e a tela atualiza com o novo conteúdo. A ação grava na hora - não precisa clicar em Salvar Templates depois.

A restauração é global: não dá para restaurar um único template, sempre são todos de uma vez. Para reverter apenas um, edite o texto manualmente em vez de usar o botão.

empresa usando Meta Cloud API (WhatsApp Business oficial)

Quando o provider conectado é o Meta Cloud API, aparece um aviso âmbar no topo da aba avisando que as mudanças aqui não entram em vigor automaticamente - o Meta exige que cada template seja resubmetido para aprovação (processo que leva de 1 a 48 horas). Enquanto o novo texto não for aprovado, o WhatsApp continua entregando a versão anteriormente homologada.

Nesse cenário, depois de Salvar Templates aqui, use o link Ir para gerenciamento Meta dentro do mesmo aviso para abrir a tela de templates do Meta e submeter os ajustes para aprovação.

Preview com dados fictícios

O Visualizar Preview sempre usa um conjunto fixo de dados de exemplo (nome "Maria Silva", destino "Gramado - RS", valor "1.250,00", etc.). Isso serve só para conferir o layout, a formatação e se as variáveis estão escritas certo. Não há como simular o preview com um cliente ou reserva real a partir desta tela - para validar o envio real, use Enviar mensagem de teste dentro do dashboard do WhatsApp.

Erros comuns e como resolver

• Variável aparece como {nome} no celular do cliente - Causa: o template não tem essa variável na lista permitida (por exemplo, usar {valor} no template de Aniversário, que só aceita {nome} e {empresa}). Solução: olhar os chips azuis "Variáveis disponíveis" daquele template e usar somente o que está listado.
• "Erro ao salvar templates" (modal vermelho) - Causa: falha de rede ou sessão expirada. Solução: recarregar a página, fazer login de novo se necessário, e tentar Salvar Templates novamente. As alterações na caixa de texto se perdem ao recarregar - copie o texto antes.
• Salvei mas o cliente continua recebendo o texto antigo - Causa: provider Meta Cloud API exige aprovação do novo template; ou existe cache ainda servindo a mensagem anterior. Solução: se o provider for Meta, resubmeter o template em Gerenciar Meta; se for Evolution Go, aguardar a próxima fila de envio (a mudança é instantânea para envios novos, mas mensagens já agendadas mantêm o texto antigo).
• Botão Restaurar Padrão apagou tudo sem querer - Causa: a ação grava imediatamente e não tem desfazer. Solução: reeditar manualmente os textos personalizados. Para evitar, mantenha um backup em arquivo de texto antes de clicar.

Onde encontrar

• URL: /admin/whatsapp/config (aba Templates)
• Caminho no menu: Comunicação > WhatsApp Mensagens > Configurar WhatsApp > Templates
• Permissão necessária: gerenciar o WhatsApp
• Módulo necessário: WhatsApp Mensagens (whatsapp-mensagens) - a página só abre se o módulo estiver ativo e os termos de uso já aceitos.

Veja também

• Configurações WhatsApp - visão geral da página de configuração (aba Automações + aba Templates)
• Conectar seu WhatsApp - pré-requisito de conexão antes de personalizar templates
• Configurar Automações - ativar quais eventos disparam cada template
• Histórico de Mensagens - conferir se as mensagens personalizadas estão sendo entregues