Agenda: visualizações, filtros e popup rápido

Referência completa da Agenda (/admin/<slug>/calendar) — o painel operacional onde você gerencia o seu dia a dia.

Visualizações

Você troca no botão Dia / Semana. Sua escolha fica salva por negócio e por tipo de dispositivo: se escolher “Semana” no computador, no celular vai continuar abrindo em “Dia”.

Na visualização semana, o cabeçalho de cada dia é um link: toque nele e você vai para a visualização dia daquela data.

A data não é salva. A agenda sempre abre no dia de hoje.

Navegar entre datas

Filtros

Dois filtros ficam sempre visíveis acima da agenda, e o resto está no painel “Mais filtros”.

Filtros principais

Mais filtros (painel recolhível)

Por padrão a agenda mostra Pendente, Confirmada, Remarcada e Concluída. As canceladas, rejeitadas e no-show ficam ocultas até você marcar o chip delas.

Os filtros ficam salvos na sua sessão, por negócio e por tipo de dispositivo — voltam a valer na próxima vez que você abrir a agenda. O botão “Limpar filtros” devolve tudo aos valores iniciais.

Status visuais

Abaixo da agenda há uma legenda com as mesmas cores dos blocos:

Cada bloco de reserva mostra:

• O horário de início e o nome do cliente (com o avatar do profissional).
• Os serviços, se o bloco for alto o bastante.
• Duração e preço, se for ainda mais alto.
• Uma barra vertical colorida na borda esquerda, com a cor do profissional.

A altura do bloco é a duração: uma reserva de 60 min ocupa o dobro de uma de 30.

Os bloqueios são desenhados com listras diagonais e um ícone conforme o alcance: Todo o negócio, Unidade inteira ou o avatar do membro da equipe.

Detalhe de uma reserva

Ao tocar um bloco abre um popup flutuante (dá para movê-lo arrastando o cabeçalho; Esc fecha) com:

• Status e código da reserva.
• Nome do cliente, data e horário.
• Profissional atribuído.
• Serviços com a duração e o total.
• Email e WhatsApp do cliente (ou a etiqueta “Sem e-mail” se não tiver).
• Observações do cliente, se ele deixou alguma ao reservar.
• Notas internas: as notas que a equipe foi deixando sobre essa reserva, cada uma com data e autor, e um campo com o botão Adicionar nota para incluir outra sem sair da agenda. Só a equipe do negócio vê; o cliente nunca vê.

Ações disponíveis no popup

Rejeitar não está no popup da agenda: está na página da reserva e na lista “Pendentes de confirmação” do Dashboard.

Uma reserva confirmada cujo atendimento terminou há mais de 2 horas é marcada como concluída sozinha. Se o cliente não veio, o popup continua oferecendo Marcar no-show. Veja Status de reserva.

Criar reserva arrastando

1. Em um espaço vazio, arraste para baixo com o mouse a duração que quiser. O intervalo se ajusta de 15 em 15 minutos.
2. Ao soltar, abre o formulário rápido com data, hora e intervalo já preenchidos.

Se você só clicar em um espaço vazio (sem arrastar), abre o mesmo formulário com aquele horário de início; o fim é calculado pelo serviço que você escolher.

Os espaços clicáveis são de meia hora. Na visualização por dia eles aparecem só dentro do horário da unidade e do horário daquele profissional naquele dia, e pulam os horários em que o profissional já tem uma reserva em outra unidade. Se a unidade está fechada naquele dia, a coluna não tem nenhum espaço clicável. Na visualização por semana o recorte é só pelo horário da unidade: não há coluna por profissional para estreitar mais.

Os intervalos não são removidos: o card de “Intervalo” é desenhado por cima do espaço, mas deixa o clique passar, então o espaço é clicável do mesmo jeito e o formulário rápido abre. É ali que você é barrado — ele avisa que aquele profissional não está disponível nesse horário e não deixa criar a reserva.

Reagendar uma reserva

1. Toque na reserva na agenda.
2. Toque em Reagendar.
3. No popup você muda data, hora, serviços, profissional e observações. O cliente não se troca aqui: para isso existe Editar reserva, que abre o formulário completo.
4. Toque em Salvar alterações.

O que o sistema faz ao reagendar:

• Mantém o status: uma reserva confirmada continua confirmada, uma pendente continua pendente.
• Se mudou o horário, o profissional, o local ou os serviços, reenvia ao cliente o email da reserva, com um .ics que atualiza o evento no calendário dele em vez de duplicar. Se você só mudou as observações, nenhum email sai.
• Move o lembrete para o novo horário.
• Se você trocou de profissional, o anterior recebe um cancelamento de calendário e o novo recebe o convite. A cópia do email de Convites de calendário das Configurações, se você cadastrou um, também é atualizada.
• Escreve uma linha no Histórico da reserva com o horário antigo e o novo.

Só dá para reagendar reservas pendentes ou confirmadas. Uma concluída, cancelada, rejeitada ou no-show não se move: o botão não aparece.

Se o profissional não estiver livre no novo horário, ou o local estiver fechado naquele dia da semana, o formulário recusa a mudança e diz o motivo. Também não dá para mover uma reserva para um dia que já passou.

Trocar o cliente de uma reserva

Em Editar reserva (no popup ou na página da reserva) dá para passar a reserva para outra pessoa: você escolhe outro cliente ou cadastra um novo, como ao criar. Ao salvar, o cliente novo recebe o email da reserva com o convite de calendário, e o anterior recebe o email de cancelamento, que tira o horário do calendário dele.

Não dá para trocar o cliente de uma reserva que já tem um pagamento online, uma sessão de pacote ou um código de desconto aplicado: o formulário diz o motivo e não salva a mudança.

Criar bloqueio pela agenda

No formulário rápido, no alto à esquerda, há duas abas: Reserva e Bloqueio. Ao passar para “Bloqueio”, o intervalo que você arrastou é mantido.

O formulário de bloqueio pede:

Os bloqueios recorrentes são um módulo que ativamos sob pedido e sem custo: peça em Mais funções. Ao editar ou excluir uma data de uma repetição, você escolhe se a mudança vale para Só este bloqueio ou para Este e os seguintes. Sem o módulo, uma parada fixa toda semana (o almoço, por exemplo) se cadastra como intervalo no horário de trabalho do profissional. Veja Bloquear horários.

Sincronização com calendário externo

Não há sincronização de ida e volta com o Google Agenda: o que a Citauno faz é enviar convites de calendário (.ics) por email. Ao abrir, o evento entra no Google Agenda, Apple Calendar, Outlook ou qualquer app que suporte .ics. Recebem:

Se a reserva mudar de horário, sai um novo .ics com o mesmo identificador — os calendários atualizam o evento em vez de duplicar. Se for cancelada, sai o cancelamento. O que você muda no calendário externo não volta para a Citauno.

Atalhos de teclado

A agenda não tem atalhos de teclado. Não existem teclas para trocar de visualização, navegar entre datas ou abrir o formulário, e o duplo clique não faz nada diferente de um clique.

A única tecla que responde é Esc, que fecha o popup aberto.

Os espaços da agenda são botões, então dá para navegar com Tab e abrir com Enter.

Comportamento no celular

Atualização automática

A agenda se atualiza sozinha a cada dois minutos e meio, sem recarregar a página, sem perder sua posição de rolagem e sem mexer num popup aberto.

Permissões por papel

Problemas comuns