Formulário de profissional: campo por campo
Atualizado em quarta-feira, 9 de setembro de 2026
Referência completa de cada campo do formulário de membro da equipe / profissional.
Referência de cada campo em Equipe → Novo ou Equipe → Editar (/admin/<slug>/team_members/new ou /admin/<slug>/team_members/:id/edit).
Só Dono(a) e Administrador(a) conseguem abrir esta tela. Os papéis Gerente e Profissional não a veem.
Identidade
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Foto de perfil | Upload PNG / JPG / WEBP / GIF | Não | Até 8 MB. É cortada em círculo. Aparece no calendário, na sua página pública e nos e-mails. Dependendo da sua conta, além do arquivo próprio você pode buscar uma imagem em uma galeria. |
| Nome de exibição | Texto | Sim | Como a pessoa aparece para os clientes. Ex.: “María B.” ou “María Benítez”. |
| Função | Texto | Não | Especialidade. Ex.: “Cabeleireira”, “Colorista”. Aparece abaixo do nome na página pública. |
| Bio | Textarea | Não | 2-3 frases exibidas junto ao profissional na página pública. |
| Comissão padrão (%) | Número, 0 a 100 | Não | Percentual que essa pessoa ganha em cada serviço que realiza. Em branco = usa-se a comissão padrão do negócio. Não afeta reservas já concluídas. |
| Cor | Seletor de 12 cores | Não | Cor que identifica as reservas e bloqueios dela no calendário. |
Paleta de cores disponível
1. #EF4444 (vermelho) 5. #84CC16 (verde-limão) 9. #3B82F6 (azul)
2. #F97316 (laranja) 6. #22C55E (verde) 10. #8B5CF6 (violeta)
3. #F59E0B (âmbar) 7. #14B8A6 (turquesa) 11. #EC4899 (rosa)
4. #EAB308 (amarelo) 8. #06B6D4 (ciano) 12. #64748B (cinza)
Se uma cor já estiver em uso por outro profissional, o seletor indica com o nome de quem a tem, mas você pode usá-la assim mesmo.
Contato
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Não | Necessário só se você quiser que essa pessoa entre no Citauno. Se deixar vazio, a ficha funciona igual: você gerencia a agenda dela. | ||
| Telefone | Telefone com código do país | Não | Só interno. Não aparece na página pública. |
O campo de email fica bloqueado (cinza, não editável) quando já está atrelado a uma conta vinculada ou a um convite pendente — mudá-lo deixaria órfão o link do convite ou a conta. Para liberá-lo, revogue o convite ou desvincule a conta primeiro.
Acesso ao app (seção dinâmica)
Esta seção aparece só em fichas já salvas e muda conforme o estado:
| Estado | O que você vê |
|---|---|
| Sem conta nem convite | Texto explicativo + botão “Salvar e enviar convite”. Com o email vazio, avisa que falta preenchê-lo. |
| Convite pendente | “Convite pendente para email. Expira em data”, mais dois botões abaixo do formulário: um para reenviar o convite e outro para revogá-lo. |
| Conta vinculada | “✓ Nome já tem acesso para entrar”, mais o botão “Desvincular acesso”, abaixo do formulário. |
Desvincular a conta também desativa o acesso dela como Profissional neste negócio e revoga os convites pendentes desta ficha. O histórico de reservas é preservado.
Local atribuído
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Local atribuído | Seletor com busca | O formulário não valida, mas na prática sim | A filial onde a pessoa trabalha. Em fichas novas vem pré-selecionada a primeira do negócio. |
Cada ficha guarda um único local: ao escolher outro, ele substitui o anterior. Sem local atribuído, a pessoa não aparece no fluxo de reserva e a seção de serviços avisa que é preciso escolher um primeiro.
Serviços que realiza
Botão com dois modos:
| Modo | Comportamento |
|---|---|
| Pode realizar todos os serviços (padrão) | Atende qualquer serviço ativo do negócio. |
| Desligado | Aparecem os serviços como chips. Você toca nos que ela realiza. |
Ligar o botão de novo apaga a seleção específica.
Caixas de seleção
| Caixa | Padrão | O que faz |
|---|---|---|
| Ativo | Marcado | Se desmarcar, a pessoa some do calendário, das listagens e das reservas novas. Ocupa um assento do plano só enquanto está ativa. |
| Aceitar reservas | Marcado | Se desmarcar, o cliente não consegue escolhê-la pelo link público; a equipe ainda pode cadastrar reservas manualmente. |
| Receber convites de calendário por email | Marcado | Envia um email com evento de calendário a cada agendamento, reagendamento ou cancelamento das reservas dela. A reserva aparece igual no calendário do Citauno. |
Horário do membro
Não existe botão de “herdar o horário do local”: cada ficha tem a própria grade semanal, sempre. Ao criar a ficha, ela já vem preenchida de segunda a sábado das 09:00 às 20:00, com domingo fechado.
Para cada dia, de segunda a domingo:
- Caixa Fechado.
- Abertura e fechamento no formato HH:MM.
- Intervalos: você pode adicionar quantos precisar (almoço, lanche).
- Uma referência 📍 com o horário que o local atribuído tem naquele dia.
- A mensagem “Excede o horário do local” quando a faixa do membro é maior que a do local. É um aviso: dá para salvar assim mesmo, e o sistema recorta pelo horário do local na hora de oferecer vagas.
Dois atalhos:
- Copiar do local (canto superior direito): copia de uma vez o horário e os intervalos do local para os sete dias. É uma cópia pontual, não um vínculo permanente.
- Copiar (em cada dia): abre um painel para replicar aquele dia — horário e intervalos — nos dias que você marcar.
Veja Horários excepcionais por profissional para o detalhe de como isso se cruza com o horário do local.
Bloqueios
O formulário de edição não lista os bloqueios: ele tem um link “Ver bloqueios →” que leva à ficha da pessoa, aba Bloqueios, onde você vê os próximos bloqueios dela e pode criar um novo.
A ficha do profissional
Ao tocar em alguém na lista de Equipe você entra na ficha dela, com quatro abas:
| Aba | O que mostra |
|---|---|
| Resumo | Contato, locais, horário de trabalho, serviços e bio. |
| Reservas | As reservas recentes dela. |
| Bloqueios | Os bloqueios dela que ainda não terminaram. |
| Desempenho | Reservas totais, receita do mês, comissão do mês, dia mais movimentado e ocupação das últimas semanas. |
Validações
| Validação | Quando dispara |
|---|---|
| Nome de exibição obrigatório | Se você deixar vazio. |
| Formato de email | Se você digitar algo que não parece um email. Vazio é permitido. |
| Email bloqueado | Se você tentar mudar um email já atrelado a um convite ou conta. |
| Formato de cor | A cor precisa ser um hexadecimal de 6 dígitos. |
| Comissão entre 0 e 100 | Fora desse intervalo não salva. |
| Foto: tipo e tamanho | Só PNG, JPG, WEBP ou GIF, e menos de 8 MB. |
| Assentos disponíveis | Ao criar (ou reativar) um profissional ativo sem assentos livres, você é levado a comprar um: “Você não tem assentos disponíveis”. |
Pré-preenchido ao criar
| Campo | Valor padrão |
|---|---|
| Foto | Vazia (placeholder com as iniciais) |
| Comissão | A comissão padrão do negócio |
| Cor | A primeira cor da paleta que nenhum outro profissional esteja usando |
| Local | A primeira filial do negócio |
| Serviços | “Pode realizar todos os serviços” |
| Horário | Segunda a sábado 09:00 – 20:00, domingo fechado |
| Ativo | Sim |
| Aceitar reservas | Sim |
| Receber convites de calendário | Sim |
Erros comuns
| Mensagem ou sintoma | Causa |
|---|---|
| “Você não tem assentos disponíveis” | Você chegou ao limite de assentos do plano. Adicione um assento ou desative outro profissional. |
| O email aparece cinza e não dá para editar | Está atrelado a uma conta vinculada ou a um convite pendente. Desvincule ou revogue primeiro. |
| Não aparecem serviços para marcar | Falta escolher o local atribuído, ou aquela filial não tem serviços disponíveis. |
| Salvei e a pessoa não aparece no link público | Confira Aceitar reservas, Ativo, o local atribuído e se o horário dela tem dias abertos. |
| Excluí um profissional e ele continua na lista | O botão de excluir o desativa: ele fica como “Inativo” e conserva o histórico. |