Embora o ideal seja deixar o link público fazer o trabalho, vai ter cliente que liga, manda mensagem, ou aparece sem agendar antes. Pra esses casos, você cria o agendamento direto pelo painel.
Como criar
Há duas portas:
1. Pela visão diária da agenda
- Abra Agenda → visão diária.
- Clique numa área livre da coluna do barbeiro, no horário que você quer.
- Abre um modal/gaveta de criação.
2. Pela lista
- Abra Agendamentos.
- Botão + Novo agendamento no topo.
- Abre formulário em tela cheia ou gaveta.
Campos obrigatórios
Cliente
Você pode escolher de duas formas:
- Buscar existente — digite telefone ou nome. O sistema procura na base de clientes e mostra resultados. Selecione e os dados (nome/e-mail) preenchem.
- Cliente novo — preencha nome, telefone e (opcional) e-mail.
Sempre cheque se já existe cliente com aquele telefone antes de criar novo. Se houver, o sistema deduplica automaticamente pelo telefone normalizado, mas selecionar o existente preserva o histórico junto. Detalhes em Base de clientes.
Serviço
Lista os serviços que aquele barbeiro atende (serviços por barbeiro). Se a lista vier vazia, é porque o barbeiro não tem serviço marcado.
A duração e o preço aparecem ao lado de cada serviço pra te ajudar.
Barbeiro
Por padrão preenche com o barbeiro escolhido na visão (ou com você, se você é membro). Pode trocar.
Data e horário
- Data — picker comum.
- Horário — só os horários disponíveis pro barbeiro aparecem (já considerando agendamentos existentes, bloqueios e duração do serviço).
Se nenhum horário aparece, é porque o barbeiro não tem janela aberta naquele dia ou tudo já está ocupado.
Notas internas (opcional)
Texto livre. Não vai pro cliente. Bom pra:
- "Cliente quer corte mais curto que da última vez".
- "Pagamento adiantado em PIX".
- "Pediu pra evitar máquina muito alta".
O que acontece ao salvar
- Sistema valida em transação que o horário ainda está disponível (concorrência).
- Cria o agendamento com
status = scheduled. - Gera o link público permanente (
access_token) — você pode copiá-lo pelo painel pra mandar pro cliente via WhatsApp. - Dispara as notificações por e-mail (cliente, se tiver e-mail; barbeiro; owner).
- Agenda o lembrete 24h e (se WhatsApp ativo) o lembrete 2h antes.
Se outra pessoa marcou o mesmo horário entre o momento que você abriu o formulário e clicou em salvar, você recebe erro 409 ("horário não disponível mais"). O painel recarrega a grade — escolha outro horário.
Por que não existe modal de "confirmar substituição"
Se o cliente já tem agendamento futuro na mesma barbearia, o sistema avisa mas não bloqueia — o painel mostra um banner "Esse cliente já tem 1 agendamento em [data/hora]. Pode continuar se for pra outra pessoa."
A intenção é deixar você decidir: pode ser cabeleireiro do mesmo cliente em horário diferente, pode ser pra parente que tem mesmo telefone, ou pode ser engano. Você que sabe.
Cancelar antes de salvar
A ação só persiste quando você clica em Confirmar agendamento. Fechar o modal/gaveta descarta tudo.
Próximos passos
- Atender, cancelar e marcar no-show — fechar o agendamento depois.
- Reagendar e edição silenciosa — mudar horário depois de criado.