Formulário de profissional: campo por campo
Atualizado em sexta-feira, 22 de maio 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).
Identidade
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Foto | Upload PNG/JPG/WEBP | Não | Imagem quadrada (mínimo 200x200). Aparece no calendário, na página pública e nos e-mails. |
| Nome visível | Texto | Sim | Como a pessoa aparece para os clientes. Ex.: “María B.” ou “María Benítez”. |
| Cargo | Texto | Não | Especialidade. Ex.: “Cabeleireira”, “Colorista”. Aparece abaixo do nome na página pública. |
| Bio | Textarea | Não | 2-3 frases que aparecem ao tocar no nome do profissional na página pública. |
| Cor de identificação | Seletor de 12 cores | Não | Cor que representa o profissional no calendário e nos bloqueios. |
Paleta de cores disponíveis
1. Vermelho (#ef4444) 5. Verde-limão (#84cc16) 9. Magenta (#d946ef)
2. Laranja (#f97316) 6. Verde (#22c55e) 10. Rosa (#ec4899)
3. Âmbar (#f59e0b) 7. Ciano (#06b6d4) 11. Slate (#64748b)
4. Amarelo (#eab308) 8. Azul (#3b82f6) 12. Stone (#78716c)
Se uma cor já estiver sendo usada por outro profissional, aparece um ponto ao lado do nome da cor, mas você pode usá-la mesmo assim.
Contato e acesso
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Não | Se você quiser que essa pessoa acesse a Citauno. Se deixar em branco, ela fica como “ficha manual” sem acesso. | ||
| Telefone | Telefone com código do país | Não | Apenas interno. Não aparece na página pública. |
O campo e-mail fica bloqueado (somente leitura, fundo cinza) se a pessoa já tiver uma conta vinculada ou um convite pendente. Para alterá-lo, primeiro remova o acesso em Contas e acessos.
Acesso e convites (seção dinâmica)
Esta seção muda conforme o status:
| Status | O que você vê |
|---|---|
| Sem e-mail preenchido | Mensagem “Esta pessoa não tem acesso à Citauno”. Botão “Convidar para a equipe” que aparece depois de preencher o e-mail. |
| Com e-mail preenchido, não convidado | Botão “Enviar convite” + seletor de papel. |
| Convite pendente | Badge “Pendente” + botões “Reenviar” e “Revogar”. |
| Acesso aceito | Badge “Acesso ativo” + papel atribuído + botão “Desvincular acesso”. |
Disponibilidade e serviços
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Filial | Seletor | Sim | A filial onde a pessoa trabalha. Se você tiver apenas uma, ela vem pré-selecionada. |
| Reservável | Checkbox | Não | Se estiver ativo, o cliente pode reservar com este profissional pelo link público. Se estiver desligado, só é possível criar reservas manualmente pelo calendário. |
| Ativo | Checkbox | Não | Se estiver desligado, o profissional desaparece do calendário, das listagens e das reservas novas. |
| Receber convites de calendário | Checkbox | Não | Se estiver ativo, cada reserva nova envia um arquivo .ics por e-mail ao profissional para que ele o adicione ao Google Calendar / Apple Calendar. |
Serviços
Toggle entre dois modos:
| Modo | Comportamento |
|---|---|
| Todos os serviços (padrão) | O profissional atende qualquer serviço do negócio. |
| Serviços específicos | Aparece uma grade com todos os serviços. Você marca quais ele atende. |
Se a filial atribuída não tiver serviços disponíveis, aparece um aviso pedindo que você atribua serviços à filial primeiro.
Horário de trabalho
Toggle entre:
| Modo | Comportamento |
|---|---|
| Usar o horário da filial | Herda o horário configurado na filial. Se a filial mudar, este profissional também muda. |
| Horário personalizado | Aparece uma grade semanal igual à da filial. Você cadastra horários diferentes para este profissional. |
Se o profissional trabalha em várias filiais, aparece uma subseção para cada filial com o próprio horário.
Bloqueios (seção dinâmica)
Lista os próximos 5 bloqueios programados para este profissional, com:
- Data + hora.
- Motivo.
- Botão “Editar” ou “Excluir”.
Se houver mais de 5, aparece “Ver todos”, que abre a tela de Horários bloqueados filtrada por este profissional.
O botão ”+ Adicionar bloqueio” cria um novo a partir daqui, sem sair do formulário.
Permissões por papel
| Papel do editor | O que pode modificar |
|---|---|
| Proprietário | Todos os campos. |
| Administrador | Todos os campos. |
| Membro | Apenas a própria ficha (nome visível, foto, bio, cor) — não pode alterar e-mail, serviços, filial nem papel. |
Validações
| Validação | Mensagem de erro |
|---|---|
| Nome visível obrigatório | “Preencha o nome visível do profissional.” |
| E-mail mal formatado | “O e-mail não parece válido.” |
| Cor já usada por outro profissional | Aviso (não erro): “Esta cor já está em uso por X”. |
| Serviços marcados, mas nenhum disponível na filial | “Esta filial não tem serviços cadastrados. Atribua serviços primeiro.” |
Pré-preenchimento ao criar
| Campo | Padrão |
|---|---|
| Foto | Vazia (placeholder com as iniciais) |
| Cor | Próxima cor disponível (não usada) |
| Filial | Primeira filial (se houver apenas uma, pré-selecionada) |
| Serviços | “Todos os serviços” |
| Horário | “Herdar da filial” |
| Reservável | Sim |
| Ativo | Sim |
| Receber convites de calendário | Sim |
Erros comuns
| Mensagem | Causa |
|---|---|
| “Este e-mail já tem uma conta Citauno em outro negócio” | A pessoa já pertence a outro negócio — ao convidá-la, ela é vinculada sem criar uma conta nova. |
| “A cor já está em uso” | Apenas um aviso, você pode ignorá-lo. |
| “Não é possível excluir — tem reservas futuras” | Há reservas atribuídas a este profissional. Reatribua ou cancele antes de excluir. |
| “Esta filial não aceita mais profissionais” (em planos por assento) | Você atingiu o limite do plano — adicione um assento ou remova outro profissional. |