Reservas
Visão geral
As Reservas são os compromissos agendados que vinculam um cliente a um serviço, local, prestador e horário específicos. A seção de Reservas oferece uma visualização de calendário FullCalendar com filtros avançados, um assistente de criação em 4 etapas e gerenciamento completo do ciclo de vida de cada compromisso.
Como acessar
- Navegue até Agendamento > Reservas (quarta aba na navegação lateral).
- Também acessível diretamente pela barra lateral como Agendamento (visualização simplificada apenas com reservas).
- Funções: Administradores/Gerentes veem todas as reservas. Prestadores veem apenas as suas.
Visão geral da interface
A seção de Reservas mostra:
- Cabeçalho — Título, botão de nova reserva e link para configurações (na visualização simplificada).
- Filtros — Quatro menus suspensos para filtrar por serviço, local, prestador e status.
- Legenda de status — Indicadores de cor para cada status de reserva.
- Calendário — Visualização FullCalendar que mostra as reservas como blocos coloridos. Suporta visualizações de mês, semana, dia e lista.
Status das reservas
| Status | Cor | Descrição |
|---|---|---|
| Pendente | Amarelo | Aguardando confirmação (quando o serviço requer aprovação) |
| Confirmada | Azul | Compromisso confirmado |
| Concluída | Verde | O compromisso foi realizado com sucesso |
| Cancelada | Vermelho | Cancelada pelo cliente ou prestador |
| Não compareceu | Cinza | O cliente não se apresentou |
| Reagendada | Roxo | Substituída por uma nova reserva |
Transições de status válidas
Pendente → Confirmada, Cancelada
Confirmada → Concluída, Cancelada, Não compareceu, Reagendada
Concluída → (estado final)
Cancelada → (estado final)
Não compareceu → (estado final)
Reagendada → (estado final)
Funcionalidades e ações
Criar uma nova reserva
O que faz: Cria um novo compromisso seguindo um assistente de 4 etapas.
Passos:
Etapa 1 — Serviço e Local:
- Clique no botão + Nova Reserva.
- Selecione o Serviço desejado.
- Selecione o Local (mostra apenas locais onde o serviço selecionado é oferecido).
- Clique em Próximo.
Etapa 2 — Data e Horário:
- Selecione uma Data no seletor de data.
- O sistema calcula e exibe os horários disponíveis como botões.
- Selecione um horário disponível. Cada botão mostra o horário de início e término, e quantos prestadores estão disponíveis.
- Clique em Próximo.
Etapa 3 — Prestador:
- É exibida a lista de prestadores disponíveis para o horário selecionado.
- Selecione um prestador da lista.
- Clique em Próximo.
Etapa 4 — Informações do cliente:
- Opcionalmente, busque um contato existente para vincular a reserva a uma conversa.
- Se o contato tiver múltiplas conversas, selecione a conversa a vincular.
- Preencha os dados do cliente:
- Nome do cliente (obrigatório)
- Telefone (opcional)
- Email (opcional)
- Notas (opcional)
- Clique em Criar Reserva.
Notas importantes:
- Se o serviço tiver "Requer aprovação" ativado, a reserva é criada com status Pendente.
- Se não requerer aprovação, a reserva é confirmada automaticamente e um evento é criado no calendário do prestador.
- Ao vincular um contato, os dados (nome, telefone) são preenchidos automaticamente.
Filtrar reservas
O que faz: Filtra as reservas exibidas no calendário.
Passos:
- Use os menus suspensos de filtro na parte superior:
- Serviço — Mostra apenas reservas de um serviço específico.
- Local — Filtra por local.
- Prestador — Filtra por prestador atribuído.
- Status — Filtra por um ou mais status (seleção múltipla).
- O calendário atualiza automaticamente.
Ver detalhes de uma reserva
O que faz: Abre um diálogo com os detalhes completos da reserva.
Passos:
- Clique em qualquer reserva no calendário.
- Um diálogo é aberto mostrando:
- Informações do serviço, local e prestador
- Dados do cliente (nome, telefone, email)
- Data e hora do compromisso
- Status atual
- Notas
- Quem criou a reserva e quando
Editar informações do cliente
O que faz: Modifica os dados do cliente de uma reserva existente.
Passos:
- Abra o detalhe da reserva.
- Clique em Editar.
- Modifique o nome, telefone, email ou notas do cliente.
- Clique em Salvar.
Notas importantes:
- Apenas os dados do cliente podem ser editados, não a data/hora ou prestador. Para alterar a data, use a função de reagendamento.
Alterar o status de uma reserva
O que faz: Move uma reserva para o próximo estado no seu ciclo de vida.
Passos:
- Abra o detalhe da reserva.
- Dependendo do status atual, você verá os botões de ação disponíveis:
- Confirmar — Move de Pendente para Confirmada (cria evento no calendário).
- Concluir — Marca como concluída.
- Cancelar — Cancela a reserva (exclui o evento do calendário). Um motivo é solicitado.
- Não compareceu — Marca que o cliente não se apresentou.
- Clique no botão da ação desejada.
Reagendar uma reserva
O que faz: Altera a data/hora de uma reserva existente.
Passos:
- Abra o detalhe da reserva.
- Clique em Reagendar.
- Selecione a nova data e horário (o sistema verifica a disponibilidade).
- Opcionalmente selecione um novo prestador.
- Confirme o reagendamento.
Notas importantes:
- A reserva original é marcada como "Reagendada" e uma nova reserva é criada com o novo horário.
- O evento do calendário da reserva original é excluído e um novo é criado.
Fontes de reservas
| Fonte | Descrição |
|---|---|
| Manual | Criada por um membro da equipe pela interface |
| Agente de IA | Criada automaticamente pelo agente de IA durante uma conversa |
| API | Criada através da API da plataforma |
Integração com o calendário
- Ao confirmar uma reserva → um Evento é criado no calendário do prestador com o formato:
[Nome do Serviço] - [Nome do Cliente]. - Ao cancelar uma reserva → o Evento vinculado é automaticamente excluído.
- Os eventos criados por reservas aparecem no calendário pessoal do prestador e são sincronizados com o Google Calendar se conectado.
Notificações em tempo real
Quando uma reserva é criada, modificada ou tem seu status alterado, todos os membros da equipe recebem uma notificação em tempo real (via SignalR). O calendário de reservas atualiza automaticamente sem necessidade de recarregar a página.
Perguntas frequentes
P: O que acontece se eu tentar reservar um horário que não está mais disponível? R: O sistema verifica a disponibilidade em tempo real no momento de criar a reserva. Se o horário já foi ocupado, você receberá um erro e deverá selecionar outro horário.
P: Posso ver as reservas de todos os prestadores? R: Administradores e gerentes de reservas veem todas as reservas. Prestadores veem apenas as reservas dos serviços aos quais estão atribuídos.
P: As reservas canceladas desaparecem do calendário? R: As reservas canceladas continuam visíveis se você filtrar pelo status "Cancelada". Por padrão, o calendário mostra todos os status.
P: Posso vincular uma reserva a uma conversa do WhatsApp? R: Sim, na etapa 4 do assistente de criação você pode buscar um contato e vincular a reserva à sua conversa. Isso permite que o agente de IA tenha contexto sobre os compromissos do cliente.