Bloqueios de horário: como travar um período na agenda (sala, profissional ou clínica inteira)

Um bloqueio é um período travado na agenda: ninguém consegue criar agendamento que conflite com ele. Use para almoço do profissional, reforma de sala, feriado, folga, manutenção de aparelho ou qualquer outra janela em que a clínica não pode atender.

Este guia cobre o que cada campo do bloqueio faz, como escolher entre bloqueio e lembrete, como agendar bloqueios recorrentes (ex.: todo sábado de manhã) e como gerenciar os que já existem.

O que é um bloqueio (e o que não é)

Tipo	O que faz	Quando usar
Bloqueio	Trava o horário. Nenhum agendamento novo pode ser criado em cima.	Almoço, reforma, feriado, manutenção, folga
Lembrete	Apenas um marcador visual chamativo. Não impede agendamentos.	”Reunião de equipe”, “Capacitação”, qualquer aviso que você quer ver mas que não trava a agenda

A diferença importa: use lembrete quando o que você quer é lembrar a equipe de algo sem fechar a agenda. Use bloqueio quando o horário realmente não pode ser usado.

Como criar um bloqueio

Há dois caminhos:

• Direto na agenda — clique com o botão direito no horário que quer bloquear (ou use o atalho do FullCalendar) e escolha Novo bloqueio. O modal abre já com data, hora e profissional/sala preenchidos.
• Lista de bloqueios — em Agenda → Lista de Bloqueios, clique em + Novo bloqueio.

Campos do bloqueio

1. Tipo — escolha Bloqueio ou Lembrete (veja a diferença acima).
2. Data — dia de início e dia de fim (se for um período) ou só início (se for de um dia só).
3. Horário — hora inicial e hora final. Aceita “do almoço ao almoço”, “dia inteiro” (00:00 → 23:59) e qualquer janela entre.
4. Motivo — texto livre que aparece como etiqueta na agenda. Use algo curto que a recepção entenda (ex.: “Almoço Dra. Ana”, “Reforma sala 2”, “Feriado — Carnaval”).
5. Cor — escolha na paleta ou deixe em branco para usar a cor padrão do tipo (cinza para bloqueio, amarelo para lembrete). Cores ajudam a distinguir visualmente: vermelho para emergenciais, azul para manutenção, verde para eventos especiais.
6. Recorrência semanal — marque Recorrente se o bloqueio se repete toda semana. Defina em quais dias da semana (Seg a Dom) a recorrência vale. A recorrência continua valendo “para sempre” até você excluir — útil para “toda quarta à tarde é reunião de equipe”.
7. Escopo — escolha o que o bloqueio afeta:
   • Todos os profissionais e todas as salas — fecha a clínica inteira.
   • Apenas os profissionais marcados — só quem está na lista fica travado (outros profissionais continuam podendo agendar).
   • Apenas as salas marcadas — só as salas selecionadas ficam travadas (outras salas continuam livres).
   • Profissionais E salas marcados — combinação dos dois (só fica travado quem está nos dois filtros ao mesmo tempo).

Para criar um bloqueio de um único profissional (ex.: médico X em férias), marque o profissional e deixe “todas as salas” desmarcado — o bloqueio afeta o médico em qualquer sala, mas outros profissionais continuam podendo usar as salas.

Validações

• Conflito com agendamento existente — se já existe um agendamento no período, o sistema avisa e pede confirmação. O bloqueio é criado mesmo assim; o agendamento existente continua valendo (você precisa decidir separadamente o que fazer com ele).
• Conflito com outro bloqueio — não é permitido sobrepor bloqueios do mesmo escopo. O sistema pede para ajustar.
• Data final antes da inicial — erro de validação, corrija antes de salvar.

Como editar ou excluir um bloqueio

Abra o Menu da agenda → Lista de Bloqueios (ou clique direto no bloqueio na agenda). Cada bloqueio tem:

• Editar — abre o mesmo modal de criação, com tudo preenchido. Você pode ajustar data, horário, escopo, motivo, cor, recorrência. Toda edição fica registrada no histórico.
• Excluir — remove o bloqueio. O histórico registra quem removeu e quando. Agendamentos existentes que estavam no período permanecem (a remoção do bloqueio só libera novos agendamentos).

Edições em bloqueios recorrentes podem valer só para aquela ocorrência específica ou para toda a série — o modal pergunta antes de salvar.

Lista de bloqueios

Agenda → Lista de Bloqueios mostra todos os bloqueios da clínica, com filtros:

• Escopo — ativos (futuros), todos, passados.
• Profissional — filtrar por profissional.
• Sala — filtrar por sala.
• Busca livre — por motivo ou criador.

Tudo isso com filtros persistidos na URL — você pode favoritar uma consulta (ex.: “bloqueios recorrentes ativos só da Dra. Ana”) e voltar sempre para a mesma visão.

A lista exporta CSV para conferência externa (ex.: controle de horas extras dos profissionais).

Cores disponíveis

A paleta padrão tem 8 cores, suficientes para a maioria dos casos sem poluir a agenda:

Cor	Valor	Uso comum
Cinza	#787878	Bloqueios neutros (padrão)
Amarelo	#F59E0B	Lembretes (padrão)
Laranja	#F97316	Atenção intermediária
Vermelho	#EF4444	Emergenciais, fechamentos críticos
Rosa	#EC4899	Eventos especiais
Roxo	#8B5CF6	Capacitações, eventos internos
Azul	#3B82F6	Manutenções, reformas
Verde	#10B981	Aberturas, datas comemorativas

Escolha a cor com critério — o objetivo é a equipe bater o olho e saber do que se trata sem precisar abrir.

Boas práticas

• Motivo curto e claro. “Almoço” é melhor que “A equipe vai almoçar nesse horário” — a etiqueta aparece em letra pequena na agenda.
• Recorrência para padrão, edição para exceção. Se todo sábado de manhã é fechado, crie um bloqueio recorrente. Em um sábado específico que abre, edite só aquela ocorrência.
• Lembrete em vez de bloqueio quando o que importa é lembrar. “Reunião de equipe 14h” como lembrete amarelo não trava a agenda mas mantém a equipe avisada.
• Conferir bloqueios no fim do mês. A lista de passados mostra se algum bloqueio foi esquecido de remover (ex.: bloqueio temporário que virou permanente sem querer).
• Cuidado com escopo amplo. Bloquear “todos os profissionais e todas as salas” fecha a clínica inteira — use com cuidado e motivo claro.

Permissões

• Criar / editar / excluir bloqueio: exige a permissão agenda (grupo Agenda).
• Visualizar a lista e a agenda: leitura da agenda.
• Exclusões ficam registradas na auditoria da agenda com o usuário e o horário.

Perguntas rápidas

Posso bloquear só um profissional e deixar os outros atenderem no mesmo horário? Sim — marque o profissional na lista e deixe “todas as salas” desmarcado. Outros profissionais continuam podendo usar as salas nesse horário.

Criei um bloqueio recorrente errado. Como apago todos os futuros de uma vez? Abra a lista, edite o bloqueio original e desmarque a recorrência; em seguida, exclua cada ocorrência passada/futura individualmente. Para o futuro, crie o bloqueio correto.

O bloqueio trava o auto-agendamento (link público) também? Sim — o auto-agendamento respeita bloqueios, expediente e férias. O paciente só vê horários realmente disponíveis.

Por que meu agendamento existente continua aparecendo em cima do bloqueio? Porque o bloqueio só impede novos agendamentos. O que já existe precisa ser movido manualmente — use reagendar para um horário livre.

Posso bloquear um horário só para uma sala específica? Sim — marque a sala na lista e deixe “todos os profissionais” desmarcado. Outros profissionais podem usar o horário em outras salas.

Precisa de ajuda para configurar bloqueios recorrentes ou entender como o auto-agendamento interage com eles? Chame o suporte pelo WhatsApp — a gente configura junto com você.