Guias - Cadastrar Guia

O que é

Esta página é o formulário de cadastro de um novo guia de turismo no Viagilize. Cada guia cadastrado fica disponível para ser vinculado a excursões, pode ser exibido publicamente no site da agência e, se configurado, recebe acesso ao Portal do Guia para realizar check-in e check-out de passageiros por QR Code.

Você normalmente chega aqui quando precisa registrar um novo profissional na equipe - seja contratado, freelancer ou parceiro - antes de poder selecioná-lo em uma excursão. Cargos, especialidades e idiomas usados no formulário precisam estar previamente cadastrados em seus respectivos catálogos.

Como usar

1. Vá em Cadastros > Guias no menu lateral.
2. Clique em Novo Guia (botão no canto superior direito da listagem).
3. No bloco Dados Pessoais, clique na área circular Foto do Guia para enviar a foto de perfil (opcional, fica circular no preview).
4. Preencha os campos obrigatórios:
   • Nome Completo - nome civil completo do guia.
   • Email - usado como login no Portal do Guia e para comunicações. Não pode repetir e-mail de outro guia ativo.
5. Decida o acesso ao sistema no toggle Enviar email para definir senha (vem ligado por padrão). Quando marcado, o guia recebe um e-mail com link para criar a própria senha.
6. Preencha os demais dados pessoais conforme a necessidade: Apelido, CPF (com validação automática e checagem de duplicidade), RG, Data de Nascimento, Telefone, Celular, Instagram (sem o @, ele já aparece como prefixo no campo).
7. Mantenha o toggle Guia Ativo marcado para que o guia possa acessar o sistema e ser vinculado a excursões.
8. No bloco Dados Profissionais, preencha:
   • Cargo / Função - seleção a partir dos cargos ativos cadastrados.
   • Número CADASTUR - registro no Ministério do Turismo.
   • Experiência - texto livre (ex.: "5 anos em turismo regional").
   • Biografia - texto descritivo sobre o profissional.
   • Frase de Destaque - frase curta exibida no site público.
9. No bloco Especialidades, marque uma ou mais especialidades pré-cadastradas (grid com checkboxes).
10. No bloco Idiomas, marque os idiomas falados pelo guia. A lista aparece ordenada com Português, Inglês, Espanhol, Francês, Alemão e Italiano no topo.
11. No bloco Visibilidade, configure:
    • Mostrar no Site - exibe o guia publicamente na página da agência.
    • Guia Destaque - adiciona uma badge especial ao guia no site.
12. Finalize com uma das ações no rodapé do formulário:
    • Cadastrar Guia - salva e volta para a lista.
    • Cadastrar e continuar editando - salva e abre o formulário de edição do mesmo guia.
    • Cadastrar e adicionar outro - salva e abre um novo formulário em branco.

Casos especiais

CPF já cadastrado para outro guia

Ao sair do campo CPF, o sistema valida o número e consulta se já existe outro guia com o mesmo CPF. Se houver, aparece um aviso amarelo com o nome do guia existente e um link para abrir o cadastro dele diretamente. Confirme se realmente é uma nova pessoa antes de continuar - o sistema bloqueia o salvamento de CPF duplicado entre guias ativos.

Guia sem acesso ao Portal do Guia

Se este profissional não precisa acessar o sistema (ex.: cadastro apenas para histórico ou para aparecer no site), desmarque o toggle Enviar email para definir senha. O guia é criado mesmo assim, sem e-mail de boas-vindas, e ninguém consegue logar com aquela conta enquanto não houver redefinição manual de senha.

Campos personalizados (cadastros personalizados)

Se a sua agência cadastrou campos personalizados para a entidade "guia" em Configurações > Cadastros Personalizados, eles aparecem automaticamente nas seções Dados Pessoais e Dados Profissionais (ou em blocos próprios no fim do formulário). Campos marcados como obrigatórios nessa configuração passam a exigir preenchimento aqui.

Guia que não aparecerá no site público

Desmarque os toggles Mostrar no Site e Guia Destaque no bloco Visibilidade. O guia continua existindo no sistema e pode ser vinculado normalmente a excursões internas, mas não aparece na vitrine pública.

Erros comuns e como resolver

• "O campo email é obrigatório." - Causa: e-mail em branco. Solução: preencha um e-mail válido (será também o login no Portal do Guia).
• "O campo email já está sendo usado." - Causa: outro guia ativo já usa este e-mail. Solução: confirme se não é a mesma pessoa já cadastrada; se for outro profissional, use um e-mail diferente.
• "CPF inválido" (aviso vermelho abaixo do campo CPF) - Causa: o número digitado não passou na validação de dígitos verificadores. Solução: confira se digitou todos os 11 dígitos corretamente.
• "CPF já cadastrado para [Nome do Guia]" (aviso amarelo) - Causa: já existe outro guia com este CPF. Solução: clique no nome para abrir o cadastro existente ou corrija o CPF se for outra pessoa.
• "O campo data nascimento deve ser uma data anterior a hoje." - Causa: data igual ou posterior ao dia atual. Solução: informe a data de nascimento real do guia.
• "O campo cargo selecionado é inválido." - Causa: o cargo escolhido não existe mais (foi excluído). Solução: cadastre o cargo em Configurações > Guias > Cargos ou escolha outro disponível.

Onde encontrar

• URL: /admin/guias/create
• Caminho no menu: Cadastros > Guias > Novo Guia
• Permissão necessária: criar os guias
• Módulo necessário: nenhum

Veja também

• Visão Geral dos Guias
• Lista de Guias
• Editar Guia
• Vincular Guia à Excursão
• Cadastrar Cargo
• Cadastrar Especialidade
• Cadastrar Idioma