Configurações - Formulário de Inscrição

O que é

A página Formulário de Inscrição Pública controla o conteúdo do formulário que o cliente vê quando recebe o link de inscrição de uma excursão (a URL pública compartilhada via WhatsApp, e-mail ou redes). Aqui você escolhe quais dados pessoais serão pedidos, se o formulário inclui endereço, quais textos aparecem no topo e na tela de sucesso, e se a agência opera em modo individual (cada inscrito viaja) ou em modo responsável (um adulto inscreve filhos/dependentes - caso de excursão escolar).

Você costuma chegar aqui antes de divulgar a primeira excursão, ou quando precisa ajustar o formulário porque a operação mudou - por exemplo, passou a aceitar inscrições internacionais (passaporte), começou a atender escolas (modo responsável) ou quer começar a coletar endereço para emissão de contrato.

Como usar

1. Vá em Configurações > Inscrição no menu lateral.
2. (Opcional) Ative Modo Responsável se um adulto vai inscrever outras pessoas (filhos, sobrinhos, alunos):
   • Aparece o sub-toggle Página inicial escolar - quando ligado, o site público mostra apenas a listagem simplificada de excursões abertas, e o site completo (carrinho, checkout) não é exibido.
   • Dentro de Página inicial escolar, o toggle Listar excursões na página inicial decide se a tela mostra a lista de excursões ou apenas dados de contato com botão de WhatsApp.
   • Surge o cartão Campos dos Participantes para configurar o que cada dependente preenche. Nome Completo é sempre obrigatório (marcado como "Sempre obrigatório") e fica desabilitado para edição.
3. No cartão Dados Pessoais, para cada campo:
   • Use a caixa à esquerda para decidir se ele aparece no formulário.
   • Use a caixa Obrigatório à direita para decidir se o preenchimento é exigido.
   • Os campos Nome Completo, E-mail e Celular/WhatsApp vêm com o selo Fixo e ficam sempre visíveis e obrigatórios - não dá para desligar.
   • Campos disponíveis: Nome Completo, E-mail, Celular/WhatsApp, CPF, RG, Data de Nascimento, Telefone Fixo, Passaporte e Instagram.
4. No cartão Endereço, ative o toggle Incluir endereço para acrescentar a seção de endereço ao formulário. Quando ligado:
   • O CEP preenche os demais campos automaticamente via consulta externa (banner verde informa isso).
   • O toggle Endereço obrigatório torna obrigatórios os campos CEP, Logradouro, Número, Bairro, Cidade e Estado (Complemento continua opcional).
5. No cartão Personalização de Textos, ajuste:
   • Título da Página - texto exibido em destaque no topo do formulário público (padrão: "Inscrição").
   • Subtítulo da Página - linha explicativa abaixo do título (opcional).
   • Mensagem de Sucesso - texto que aparece após o cliente enviar o formulário.
   • Mostrar botão do WhatsApp na página de sucesso - quando marcado, o cliente recebe um botão para falar com a agência logo depois da inscrição.
6. Use o cartão Prévia do Formulário (lado inferior da página) para conferir em tempo real como o formulário fica para o cliente. A prévia atualiza conforme você marca e desmarca opções, inclusive mostrando o accordion Dados adicionais (opcional) quando há campos visíveis mas não obrigatórios.
7. Clique em Salvar Configurações no rodapé. O botão só fica ativo quando você alterou algo. Após salvar, aparece o toast "Configurações de inscrição salvas com sucesso!" e a página recarrega já com os valores aplicados.

Casos especiais

Modo Responsável (excursão escolar)

Ative quando o adulto que se cadastra não viaja - apenas inscreve filhos, sobrinhos ou alunos. O formulário público passa a mostrar duas seções: dados do responsável (Dados Pessoais) e os participantes (Campos dos Participantes). Cada inscrição entra na fila Tarefas > Inscrições, onde o operacional aprova e decide se cria passageiros para os dependentes. Os campos disponíveis para o participante são: Nome Completo, Data de Nascimento, Parentesco, CPF, RG, Celular, E-mail, Passaporte e Turma.

Página inicial escolar

Só aparece quando Modo Responsável está ativo. Quando ligado, o site público da agência exibe uma página simplificada (sem carrinho, sem checkout, sem catálogo padrão). Os links curtos de inscrição (/i/...) continuam funcionando mesmo se o site completo estiver despublicado - útil para agências que vendem 100% por inscrição manual.

Listar excursões na página inicial

Sub-opção da página escolar. Se desligado, a página inicial mostra apenas a identidade da empresa e um botão de contato via WhatsApp - sem listar excursões abertas. Útil quando a agência prefere divulgar excursões por link direto em vez de deixar tudo aberto no site.

Campos fixos x campos personalizados

Esta página não cria campos novos - ela apenas controla a visibilidade/obrigatoriedade dos campos pré-definidos no sistema. Para coletar dados específicos da operação (tamanho de camiseta, restrição alimentar, observações livres etc.), use Configurações > Formulários, que permite criar campos personalizados ligados ao formulário de reserva, contato ou CRM.

Endereço opcional vs obrigatório

Ao ligar Incluir endereço, todos os sete campos de endereço passam a aparecer no formulário. Se você desligar a chave Endereço obrigatório, eles ficam visíveis mas o cliente pode pular sem preencher. Se ligar a obrigatoriedade, somente o campo Complemento permanece opcional - os demais (CEP, Logradouro, Número, Bairro, Cidade, Estado) viram obrigatórios automaticamente quando você salva.

Erros comuns e como resolver

• Após salvar, os campos Nome/E-mail/Celular continuam marcados como obrigatórios mesmo que você tente desmarcá-los - Causa: são campos com obrigatorio_fixo no controller; o backend força a visibilidade e obrigatoriedade ao salvar. Solução: não há como removê-los; são essenciais para criar o cliente.
• Desliguei Modo Responsável mas o site escolar continuou ligado no banco - Causa: ao salvar, o controller força site_escolar = false e listar_excursoes = true quando modo_responsavel está desligado. Solução: salve a página novamente para sincronizar as preferências.
• Os campos de endereço sumiram do formulário público depois que desliguei o toggle Incluir endereço - Causa: ao salvar com Incluir endereço desligado, o backend remove todos os campos de endereço das listas campos_visiveis e campos_obrigatorios. Solução: é o comportamento esperado - religue Incluir endereço e salve para restaurar.
• As alterações não foram salvas (botão Salvar não respondeu) - Causa: o componente x-form-actions com track-changes=true mantém o botão desabilitado enquanto nenhum campo foi alterado. Solução: mexa em algum toggle/campo para habilitar o botão antes de clicar.

Onde encontrar

• URL: /admin/configuracoes/inscricao
• Caminho no menu: Configurações > Inscrição
• Permissão necessária: ver as configurações (abrir) e editar as configurações (salvar)
• Módulo necessário: nenhum

Veja também

• Formulários
• Inscrições - Listagem