WhatsApp - Catálogo de Templates Disponíveis

O que é

Esta página de referência lista todos os templates de mensagem que o Viagilize traz prontos para o WhatsApp e mostra, para cada um, quais variáveis (tags entre chaves) podem ser usadas no corpo da mensagem. Cada template tem um conjunto específico de variáveis suportadas - usar uma tag que não consta na lista do template resulta em texto literal sendo enviado ao cliente (a substituição não acontece).

Você normalmente chega aqui antes de editar o texto de um template: primeiro consulta o catálogo para saber quais informações da reserva, pagamento ou viagem estão disponíveis, depois vai para a aba de edição em WhatsApp > Configurações > Templates e escreve o conteúdo inserindo as tags adequadas.

Catálogo de templates

A lista abaixo segue exatamente os templates retornados por WhatsAppConfig::getDefaultTemplates() e a configuração da aba Templates (/admin/whatsapp/config#templates).

Confirmação de Reserva (reserva_confirmada)

Disparada após confirmar uma reserva de excursão. Variáveis aceitas:

• {nome}, {codigo}, {data}, {destino}, {horario}
• {local_embarque}, {horario_embarque}, {referencia_embarque}, {endereco_embarque}
• {empresa}

Cancelamento de Reserva (reserva_cancelada)

Avisa o cliente que a reserva foi cancelada. Variáveis aceitas:

• {nome}, {codigo}, {data}, {destino}, {empresa}

Confirmação de Pagamento (pagamento_confirmado)

Enviada quando o pagamento da reserva é recebido. Variáveis aceitas:

• {nome}, {codigo}, {valor}, {empresa}

Lembrete de Viagem (lembrete_viagem)

Disparada nos crons D-1, D-3 ou D-7 antes do embarque. Variáveis aceitas:

• {nome}, {codigo}, {data}, {destino}, {horario}
• {local_embarque}, {horario_embarque}, {referencia_embarque}, {endereco_embarque}
• {link_cartao_embarque}, {status_embarque}
• {empresa}

Lembrete de Cobrança (cobranca)

Cobrança de pagamento pendente. Variáveis aceitas:

• {nome}, {codigo}, {valor}, {vencimento}, {link_pagamento}, {empresa}

Lembrete de Vencimento (lembrete_vencimento)

Avisa sobre parcela com vencimento próximo. Variáveis aceitas:

• {nome}, {codigo}, {destino}, {parcela}, {valor}, {vencimento}, {link_pagamento}, {empresa}

Aniversário (aniversario)

Mensagem de aniversário do cliente. Variáveis aceitas:

• {nome}, {empresa}

Pesquisa de Satisfação (pesquisa_satisfacao)

Disparada após o retorno da viagem. Variáveis aceitas:

• {nome}, {destino}, {link_pesquisa}, {empresa}

Carrinho Abandonado (carrinho_abandonado)

Recupera vendas com carrinho sem checkout. Variáveis aceitas:

• {nome}, {itens_resumo}, {valor}, {quantidade}, {link_carrinho}, {empresa}

Pedido Pendente (pedido_pendente)

Lembra o cliente de finalizar um pedido aguardando pagamento. Variáveis aceitas:

• {nome}, {codigo}, {itens_resumo}, {valor}, {link_pagamento}, {empresa}

Aviso ao Comprador (aviso_comprador_telefone)

Mensagem interna enviada ao comprador quando o sistema não consegue notificar um passageiro por telefone inválido. Variáveis aceitas:

• {nome}, {tipo_notificacao}, {nome_passageiro}, {destino}, {data}, {empresa}

Experiência Confirmada (passeio_confirmado)

Voucher emitido para uma experiência turística (módulo Passeios). Variáveis aceitas:

• {nome}, {passeio}, {voucher}, {data}, {horario}
• {categoria}, {quantidade}, {ponto_encontro}, {empresa}

Experiência Cancelada (passeio_cancelado)

Cancelamento de venda de experiência. Variáveis aceitas:

• {nome}, {passeio}, {voucher}, {empresa}

Lembrete de Experiência (passeio_lembrete)

Lembrete enviado um dia antes da experiência. Variáveis aceitas:

• {nome}, {passeio}, {data}, {horario}, {ponto_encontro}, {voucher}, {empresa}

Voucher da Experiência (passeio_voucher)

Reenvio do voucher para o cliente. Variáveis aceitas:

• {nome}, {passeio}, {voucher}, {data}, {horario}, {ponto_encontro}, {empresa}

Casos especiais

Variável {empresa} é preenchida automaticamente

Mesmo que você não passe dados, {empresa} sempre é substituída pelo nome da empresa da sua empresa (prioridade: nome_site > nome_fantasia > razao_social). Não precisa configurar nada para isso funcionar.

Tags fora da lista do template

Se o template em uso aceita {nome}, {codigo}, {valor} e você inserir {destino}, o sistema não substitui essa tag e ela aparece literalmente para o cliente (ex: "viagem para {destino}"). Confira sempre o catálogo do template específico antes de incluir uma variável nova.

Variáveis opcionais e linhas em branco

Quando uma variável opcional está vazia (ex: {referencia_embarque} em um embarque sem referência), o sistema colapsa as quebras extras de linha em apenas uma quebra de parágrafo, evitando blocos vazios no meio da mensagem.

Provider Meta Cloud API

No modo Meta, o texto do template é apenas para referência local: o conteúdo enviado é o que estiver aprovado pelo WABA. Sempre que você editar um template aqui no Viagilize, o template precisa ser resubmetido ao Meta para aprovação (leva de 1 a 48h). O aviso é exibido no topo da aba Templates quando você usa provider Meta.

Erros comuns e como resolver

• Tag aparece literal na mensagem (ex: "Valor: R$ {valor}") - Causa: a tag não pertence ao catálogo desse template. Solução: conferir a seção do template no catálogo acima e usar apenas as variáveis listadas.
• Mensagem chega com nome do cliente em branco - Causa: o cadastro do passageiro não tem nome preenchido. Solução: corrigir o cadastro do cliente ou usar fallback no texto (ex: "Olá, cliente!").
• Sumiu uma seção inteira da mensagem - Causa: todas as variáveis daquele parágrafo estavam vazias e o colapso de quebras de linha removeu o bloco. Solução: incluir texto fixo no parágrafo ou checar se os dados estão chegando do gatilho que disparou a mensagem.
• "Mensagem de resposta automática e obrigatória quando ativada." - Causa: tentou ativar resposta automática Meta sem preencher o texto. Solução: não se aplica aos templates do catálogo, mas vale lembrar que mensagens automáticas Meta seguem regra parecida - não deixe o campo vazio.

Onde encontrar

• URL: /admin/whatsapp/config (aba Templates)
• Caminho no menu: Módulos > WhatsApp > Configurações > Templates
• Permissão necessária: ver o WhatsApp (ler) e gerenciar o WhatsApp para salvar alterações
• Módulo necessário: WhatsApp Mensagens (whatsapp-mensagens)

Veja também

• WhatsApp - Personalizar Templates
• Configurar Automações
• Configurações do WhatsApp