Primeiros Passos - Usuários e Permissões

O que é

A área de Usuários é onde a sua agência libera o acesso ao painel administrativo para cada pessoa da equipe (sócios, atendentes, equipe financeira, equipe operacional, vendedores). Cada usuário entra com e-mail e senha próprios, e o que ele pode ver ou fazer no sistema é determinado pelo Perfil de Acesso (também chamado de papel ou role) que você atribui a ele.

Os Perfis de Acesso são conjuntos nomeados de permissões. O Viagilize já cria automaticamente um conjunto de perfis padrão na primeira vez que a tela é aberta (Proprietário, Gerente, Atendente, Financeiro, Operacional, Vendedor CRM, Gerente CRM, Consultor de Viagens e Vendedor Externo). Você pode usar esses perfis como vêm, ajustá-los ou criar perfis novos do zero com a combinação exata de permissões que faz sentido para o seu time.

Este é o passo do onboarding em que você deixa de operar sozinho e distribui responsabilidades: o financeiro só enxerga financeiro, o atendente cria reservas mas não muda configurações, o vendedor externo recebe link de venda sem permissão de acessar o painel.

Como usar

1. Adicionar um novo usuário

1. No sidebar, vá em Sistema > Usuários (ou abra /admin/usuarios direto).
2. Clique em Novo Usuário (botão flutuante azul no canto superior direito).
3. Preencha os campos do card Informações do Usuário:
   • Nome - nome completo, aparece na listagem e nos registros do sistema.
   • E-mail - usado para login. Precisa ser único e válido.
   • Telefone - opcional por padrão; pode virar obrigatório se a sua agência configurou esse campo como exigido em Cadastros Personalizados.
   • Usuário ativo - toggle verde. Quando desligado, o usuário não consegue logar.
4. No card Acesso ao Sistema, mantenha Enviar email para definir senha ligado para que a pessoa receba um link e crie a senha dela mesma. Se desligar, o usuário precisará usar o fluxo de "esqueci minha senha" para entrar.
5. (Opcional) No card Configurações de Vendedor, ligue Habilitar como Vendedor se essa pessoa for receber link de vendas e ter reservas atribuídas a ela. O sistema gera automaticamente um código de vendedor no momento da criação.
6. No card Perfil de Acesso, marque um ou mais perfis (Proprietário, Gerente, Atendente, etc.). É obrigatório escolher pelo menos um.
7. Clique em Criar Usuário no rodapé. Use Criar e continuar editando se quiser ajustar campos personalizados em seguida, ou Criar e adicionar outro para cadastrar vários em sequência.

2. Filtrar e localizar usuários

Na listagem /admin/usuarios você tem três filtros lado a lado:

• Buscar por nome ou e-mail - busca parcial (ILIKE) em nome e e-mail.
• Status - Todos, Ativos ou Inativos.
• Perfil - qualquer um dos perfis cadastrados.

Os filtros se acumulam e ficam preservados na URL (paginação respeita).

3. Editar, ativar/desativar ou excluir um usuário

No card de cada usuário, abra o menu de ações (três pontinhos) à direita:

• Editar - abre o formulário completo. Para trocar a senha, basta preencher os campos Nova senha e Confirmar senha (deixar em branco mantém a atual).
• Desativar / Ativar - bloqueia ou libera o login sem apagar o cadastro nem o histórico. Recomendado quando o colaborador sai da empresa.
• Excluir - soft delete (mantém histórico no banco). Pede a digitação da palavra EXCLUIR como confirmação.

Você não consegue desativar nem excluir o próprio usuário - o sistema bloqueia para evitar que você se trave fora do painel.

4. Criar um perfil personalizado

Quando os perfis padrão não atendem (por exemplo: alguém que só gerencia hospedagem ou só responde tickets de suporte), crie um perfil novo:

1. No sidebar, vá em Sistema > Perfis de Acesso (ou abra /admin/roles).
2. Clique em Novo Perfil (botão flutuante azul no canto superior direito).
3. Preencha Nome do Perfil (ex: "Apoio Operacional") e, opcionalmente, Descrição.
4. No card Permissões, marque as permissões agrupadas por módulo (Excursões, Reservas, Clientes, CRM, Financeiro, etc.). Use Marcar tudo em cada card de módulo para liberar tudo daquele módulo de uma vez, ou Selecionar tudo no topo para todas.
5. Clique em Criar Perfil no rodapé.

Os módulos exibidos respeitam os módulos contratados pela agência: módulos como CRM, WhatsApp, Contratos Digitais, Ingressos, Hospedagem, Fidelidade e Passeios só aparecem na lista se o módulo estiver ativo (ou em período de avaliação).

5. Duplicar um perfil

Se você quer um perfil parecido com um existente, na listagem /admin/roles abra o menu de ações do card e clique em Duplicar. O sistema cria uma cópia chamada "Nome Original (Cópia)" com as mesmas permissões e abre direto no formulário de edição para você renomear e ajustar.

Casos especiais

Cadastrar um Vendedor Externo (cadastro simplificado)

No topo do formulário de novo usuário existe o toggle roxo Cadastrar como Vendedor Externo. Quando ligado:

• O formulário some quase todos os campos e fica só com o Nome.
• O sistema atribui automaticamente o perfil Vendedor Externo (sem permissões de painel).
• Marca o usuário como vendedor e gera um código de vendedor.
• Gera um e-mail fictício do tipo externo-{uuid}@noreply.invalid caso você não informe um real.
• Não envia e-mail de definição de senha - esse vendedor não acessa o painel.

Use esse modo para parceiros, captadores ou indicadores que só precisam de um link de vendas e do código deles para receber comissão, sem permissão de ver o admin.

Papéis padrão e o que cada um pode

Os perfis criados automaticamente na primeira abertura de /admin/roles têm marcação Sistema (etiqueta roxa) e não podem ser excluídos, mas suas permissões podem ser editadas livremente:

• Proprietário - acesso total a todos os módulos e módulos. Único papel que enxerga Usuários e Perfis de Acesso.
• Gerente - gerenciamento geral, mas sem acesso a Usuários e Perfis.
• Atendente - Dashboard, Excursões (leitura), Reservas (criar/editar/confirmar), Clientes (criar/editar), Tags, Calendário.
• Financeiro - Dashboard, Excursões (leitura), Reservas (leitura), Clientes (leitura), módulo Financeiro completo, Relatórios.
• Operacional - Guias, Transportes, Veículos, Motoristas, Fornecedores, Cotações e Calendário.
• Vendedor CRM - Acessa o módulo CRM (pipeline, leads, oportunidades, tarefas, interações), Clientes, Cotações e Marketing (leitura).
• Gerente CRM - CRM completo (incluindo leads/oportunidades de todos os vendedores), Marketing completo, Automações, Cupons.
• Consultor de Viagens - Perfil do Modo Jornadas (clientes boutique): jornadas, viajantes, pagamentos, documentos, histórico, contratos, cashback e milhagem.
• Vendedor Externo - Sem acesso ao painel. Só serve para atribuição de vendas e comissão por link.

Reenviar e-mail de definição de senha

Se o usuário perdeu ou não recebeu o e-mail inicial, na listagem /admin/usuarios abra o cadastro dele e use a ação Enviar e-mail de redefinição de senha (rota usuarios.send-password-reset). O usuário recebe um link válido para criar uma senha nova.

Usuário cadastrado anteriormente e excluído

Se você tentar cadastrar um e-mail que já existiu mas foi excluído (soft delete), o sistema restaura o cadastro antigo automaticamente com os novos dados (nome, telefone, perfis), em vez de retornar erro de e-mail duplicado.

Erros comuns e como resolver

• "O nome é obrigatório." - Causa: campo Nome em branco. Solução: preencher o Nome no card Informações do Usuário.
• "O e-mail é obrigatório." / "Informe um e-mail válido." - Causa: campo E-mail vazio ou mal formatado. Solução: digitar um e-mail real (ex: [email protected]). Só é dispensado no modo Vendedor Externo.
• "Este e-mail já está em uso." - Causa: existe outro usuário ativo com esse mesmo e-mail. Solução: usar e-mail diferente ou, se for o caso, reativar o cadastro existente.
• "Selecione pelo menos um perfil." - Causa: nenhum checkbox marcado no card Perfil de Acesso. Solução: marcar pelo menos um perfil antes de salvar.
• "As senhas não conferem." / "A senha deve ter no mínimo 8 caracteres." - Causa: senha e confirmação diferentes ou curta demais ao editar. Solução: repetir a mesma senha nos dois campos com no mínimo 8 caracteres.
• "Você não pode excluir seu próprio usuário." / "Você não pode desativar seu próprio usuário." - Causa: tentou excluir/desativar a si mesmo. Solução: peça para outro usuário com perfil Proprietário fazer a operação.
• "Já existe um perfil com este nome." - Causa: tentou criar/renomear um perfil com nome usado por outro. Solução: usar um nome único.
• "Não é possível excluir. Existem N usuário(s) com este perfil." - Causa: o perfil tem usuários vinculados. Solução: editar os usuários afetados, trocar para outro perfil e tentar excluir novamente.
• "Não é possível excluir um perfil de sistema." - Causa: tentou apagar um perfil marcado como Sistema (Proprietário, Gerente, etc.). Solução: perfis de sistema não são excluíveis, mas você pode editar as permissões deles ou duplicar e personalizar a cópia.

Onde encontrar

• URL principal (usuários): /admin/usuarios
• URL principal (perfis): /admin/roles
• Caminho no menu: Sistema > Usuários e Sistema > Perfis de Acesso
• Permissões necessárias: ver os usuários (listar), criar os usuários (criar usuários e perfis), editar os usuários (editar e ativar/desativar), excluir os usuários (excluir)
• Módulo necessário: nenhum (faz parte do núcleo). Módulos de módulo (CRM, WhatsApp, Hospedagem, etc.) só aparecem na lista de permissões dos perfis se o módulo estiver ativo.

Veja também

• Bem-vindo ao Viagilize - visão geral do onboarding
• Conhecendo o Painel Admin - como navegar pelo sistema depois de receber acesso
• Dados da Empresa - primeiro cadastro fiscal da agência
• Próximos Passos - roteiro completo após o onboarding inicial