Configurações - Jornada do Cliente

O que é

A página Jornada do Cliente é o painel mestre que define como você se apresenta para o cliente final - do primeiro toque no site até o pós-viagem. Cada card concentra um pedaço dessa jornada: como o cliente faz login e se cadastra, que nome o sistema usa para chamar uma compra ("Reserva" ou "Venda"), que nome usa para a viagem ("Excursão", "Viagem", "Passeio", "Evento", "Pacote" ou "Destino"), o que aparece no carrinho, quais documentos são pedidos, se assentos podem ser escolhidos, quais alertas automáticos disparam por e-mail e WhatsApp, e como fica o cartão de embarque.

Você normalmente chega aqui ao começar a operar uma empresa novo (para ajustar terminologia e fluxo padrão de checkout) e volta sempre que muda a estratégia comercial: ativar contrato digital no checkout, abrir multi-moeda, mudar o modo de exibição de preços, ligar a lista de espera ou refinar os alertas que o cliente recebe antes da viagem.

Como usar

1. Vá em Configurações > Jornada do Cliente no menu lateral.
2. Percorra os cards do topo para baixo e ajuste apenas o que faz sentido para a sua operação. Os principais blocos são:
   • Login e Cadastro - ative/desative login com Google, Apple e Link de Acesso por E-mail, decida se vai pedir Celular/WhatsApp (com sub-toggle Verificar por SMS/WhatsApp), CPF e Data de Nascimento, e se vai exigir verificação do e-mail.
   • Terminologia - escolha entre Reserva e Venda/Compra, entre Excursão, Viagem, Passeio, Evento, Pacote e Destino, e entre Guia e Equipe (essa última afeta só o site público).
   • Login para Reservas - exige login no carrinho antes de pagar.
   • Opções do Checkout - toggles Selecionar cidade de embarque, Múltiplos assentos, Guia registrar pagamento no check-in, Observação no checkout, Pagamento no embarque, Convite por link e Permitir dependentes.
   • Exibição de Preços - escolha entre A partir de e Até e, opcionalmente, Mostrar intervalo (R$ X até R$ Y).
   • Recuperação de Carrinho - habilite os dois fluxos (Carrinho abandonado e Pedido pendente) e escolha o tempo em minutos/horas com os seletores rápidos.
   • E-mail de Confirmação - defina se sai Ao pagar ou Ao reservar.
   • Documentos do Passageiro - torne obrigatório, escolha entre RG, CPF, CNH, Passaporte e Certidão de Nascimento, e diga em que momento o cliente precisa apresentar (Antes do embarque, Antes da confirmação ou Após a compra).
   • Contrato Digital - disponível apenas com o módulo Contratos Digitais ativo; alterna o Momento da assinatura entre Pós-pagamento e Checkout.
   • Escolha de Assentos - ativa a escolha pelo cliente, define o Momento da escolha (antes/após o pagamento ou X dias antes do embarque) e o prazo para Permitir troca.
   • Pontos de Embarque - ajustes de exibição no site: valores, layout (cards/lista), seleção em cards e detalhes extras (idade da categoria, endereço, horário, cidade).
   • Lista de Espera - ativa a fila e define horas de expiração da oferta e se notifica o admin.
   • Alertas Automáticos - define horário único de envio diário, canais (E-mail e WhatsApp) e os alertas individuais de Contrato, Documento, Financeiro, Confirmação, Lembrete e Cartão de Embarque Automático.
3. Clique em Salvar Configurações na barra fixa do rodapé - ela só fica ativa quando há mudanças não salvas. Ao salvar, o sistema mostra a mensagem Configurações salvas com sucesso! e invalida o cache do menu, módulos e páginas da sua empresa.

Casos especiais

Trocar a terminologia (Excursão para Viagem, Passeio, Evento, Pacote ou Destino)

Ao mudar o termo_excursao no card Terminologia, todos os textos personalizados do grupo excursões salvos em site_textos são apagados automaticamente para evitar concordâncias erradas de gênero (por exemplo, "Outras Destinos" depois de uma substituição cega). A mensagem de sucesso passa a indicar quantos textos foram resetados: "Terminologia alterada: N texto(s) personalizado(s) foram resetados pra usar o padrão da nova terminologia. Você pode customizá-los novamente se quiser." Customize de novo em Site > Textos do Site se precisar.

Reserva versus Venda/Compra

O toggle Usar termo Venda/Compra troca o vocabulário em todo o sistema (admin e site). Útil para agências que vendem pacotes/passeios e preferem falar em "Venda" em vez de "Reserva".

Contrato Digital no checkout

O bloco Contrato Digital só aparece quando o módulo contratos-digitais está ativo (ou em período de pendência). Com Momento da assinatura = Checkout, o cliente assina antes de pagar (fluxo pré-pagamento). Com Pós-pagamento, o contrato é gerado e disparado após a confirmação do pagamento (fluxo legado).

Cartão de Embarque Automático com prévia em PDF

Dentro de Alertas Automáticos o bloco Cartão de Embarque Automático tem o botão Visualizar prévia que abre /admin/configuracoes/cartao-embarque/preview em nova aba, gerando um PDF de exemplo com dados fictícios (cliente "Maria Silva Santos", excursão "Excursão Exemplo - Gramado"). A prévia respeita os toggles Mostrar valor, Mostrar categoria e CPF em destaque mesmo antes de salvar - útil para validar o layout. O PDF é gerado via Gotenberg com fallback automático para DomPDF.

Vários gatilhos do Cartão de Embarque

Você pode disparar o cartão em Reserva criada, Pagamento recebido, Apto ao check-in, X dias antes da viagem (1 a 15 dias) e Dia da excursão. Todos os gatilhos são independentes e podem ser combinados.

Login para Reservas e retrocompatibilidade

O valor de Login para Reservas também é gravado em tenant.pagamentos.exigir_login_carrinho para preservar retrocompatibilidade com fluxos antigos. O mesmo vale para Documentos do Passageiro, espelhado em tenant.pagamentos.documentos_passageiro no salvar.

Multi-moeda com taxa adicional

Em Multi-Moeda é possível habilitar até 9 moedas (USD, EUR, GBP, ARS, PYG, UYU, CLP, COP, PEN) e configurar uma Taxa adicional percentual (0% a 50%) que é somada sobre a cotação para formar o spread da sua empresa.

Erros comuns e como resolver

• "Corrija os erros abaixo: ..." - Aparece no topo da página quando alguma validação falha. As mais comuns: valor fora do intervalo nos campos de dias (dias_antes_embarque 1–365, dias_antes_viagem 1–180 nos alertas) ou moeda fora da lista permitida em Multi-Moeda. Ajuste para um valor válido e salve novamente.
• Não vejo o card "Contrato Digital" - O módulo Contratos Digitais não está ativo. Ative em Configurações > Empresa > Módulos para liberar o bloco.
• Mudei a terminologia e meus textos do site sumiram - Comportamento esperado: ao trocar termo_excursao, o sistema apaga os textos personalizados do grupo excursões para usar o fallback com gênero correto. Customize de novo em Site > Textos do Site.
• Mudei a configuração mas o site continua igual - O save invalida o cache do menu, módulos e páginas (tenant_modulos_*, tenant_paginas_*) e do site_textos, mas o navegador do cliente pode ter o site em cache de CDN. Force refresh ou aguarde a expiração da CDN.
• O botão Visualizar prévia não abre PDF - Verifique se o Gotenberg está disponível (porta 3050). O sistema cai automaticamente para DomPDF, mas se nenhum dos dois responder, a aba ficará em branco.

Onde encontrar

• URL: /admin/configuracoes/jornada-cliente
• Caminho no menu: Configurações > Jornada do Cliente
• Permissão necessária: ver as configurações para abrir e editar as configurações para salvar
• Módulo necessário: nenhum para a página em si; Contratos Digitais apenas para o card Contrato Digital

Veja também

• Jornadas - Listagem
• Configurações - Pagamentos
• Configurações - Formulários