Agenda

A Agenda é a regra principal responsável por gerar automaticamente os horários disponíveis para que o cliente possa realizar agendamentos. Nela, você combina o tipo de atendimento, os horários de funcionamento semanal, a antecedência mínima para marcação ou cancelamento, as regras de chegada e tolerância, além dos bloqueios por feriados.

Quando você salva ou altera uma agenda, o sistema recalcula a disponibilidade de horários com base em todas as regras configuradas.

Guia passo a passo

Identificação Básica

Informações para identificar a agenda dentro do sistema.

• Nome da Agenda
  Obrigatório | Digite o nome de identificação da agenda nas listagens e no painel administrativo.
  Exemplo: Atendimento Presencial — Unidade Centro

• Tipo de Atendimento
  Seleção | Classifica a modalidade do atendimento.

  • Qualquer: Atendimento genérico.
  • Presencial: Atendimento físico na unidade.
  • Vídeo: Atendimento por videochamada.
    (Nota: Este campo é informativo para a organização e buscas).

• Descrição
  Opcional | Texto explicativo com detalhes adicionais sobre o local, orientações ou público-alvo da agenda.
  Exemplo: Horários para atendimento presencial e emissão de documentos na Unidade Centro.

• Agenda Ativa
  Interruptor (Ativo/Inativo) | Define se a agenda continuará gerando novos horários no sistema público. Desativar uma agenda impede novos agendamentos sem apagar o histórico existente.

Período de Geração de Horários

Define o fuso horário oficial e a quantidade de dias futuros em que os horários ficarão abertos.

• Fuso Horário
  Seleção | Define o fuso horário oficial da agenda (padrão de Brasília). Determina o momento exato em que os horários do dia começam e encerram.

• Horizonte em Dias
  Número (1 a 365) | Quantidade de dias futuros para os quais o sistema gerará horários disponíveis de forma contínua.
  Exemplo: Preencher com 30 mantém sempre os próximos 30 dias abertos para agendamento.

• Data Inicial
  Opcional (Data) | Primeiro dia em que a agenda começará a funcionar. Se mantida em branco, os horários serão liberados a partir do dia atual.

• Data Final
  Opcional (Data) | Último dia de funcionamento da agenda. Se mantida em branco, a agenda continuará gerando horários continuamente respeitando apenas o horizonte em dias.

Antecedência de Agendamento e Cancelamento

Controla os limites de tempo para que o cliente possa marcar ou cancelar um horário.

• Antecedência para Agendar (minutos)
  Número | Tempo mínimo necessário entre o momento do acesso do cliente e o horário do atendimento.
  Exemplo: Preencher com 60 impede que o cliente agende um horário que começará em menos de 1 hora. Preencher com 0 libera a marcação imediata.

• Antecedência para Cancelar (minutos)
  Número | Tempo mínimo de antecedência exigido para que o cliente possa cancelar a consulta ou atendimento.
  Exemplo: Preencher com 120 impede o cancelamento nas 2 horas que antecedem o horário marcado. Preencher com 0 permite cancelamento até o momento do atendimento.

Configurações de Check-in e Chegada

Define como o agendamento se transforma em um atendimento presencial ou fila de espera.

• Modo de Check-in
  Seleção | Escolha a forma de confirmação de presença do cliente:

  • Manual: A presença é registrada pela recepção ou balcão de atendimento.
  • Automático: A confirmação ocorre automaticamente ao atingir o horário marcado.

• Fluxo do Atendimento
  Obrigatório | Selecione o fluxo de atendimento que será executado no momento da chegada do cliente.

• Antecedência do Check-in Automático (minutos)
  (Exibido apenas no modo Automático) | Quantos minutos antes do horário marcado o atendimento é iniciado na fila.

• Aceitar Chegada a Partir de (minutos antes)
  (Exibido apenas no modo Manual) | Quantos minutos antes do horário a recepção pode registrar a chegada do cliente. Preencher com 0 não permite recepção antecipada.

• Tolerar Atraso de até (minutos depois)
  (Exibido apenas no modo Manual) | Tempo máximo de atraso tolerado após o horário marcado para permitir o registro de chegada. Preencher com 0 cancela a tolerância.

• Aguardar o Horário Marcado
  Interruptor |

  • Ligado: O cliente faz o check-in, mas só fica disponível para chamada do atendente no horário exato da marcação.
  • Desligado: O cliente entra imediatamente na fila de chamada assim que realiza o check-in.

Horários Semanais de Atendimento

Tabela de horários recorrentes de funcionamento da agenda.

• Dia da Semana: Selecione o dia (de Segunda-feira a Domingo).
• Horário de Início e Fim: Informe o período de atendimento (Ex: 08:00 às 12:00).
• Capacidade: Número máximo de atendimentos simultâneos permitidos no mesmo intervalo (Ex: 1 para atendimento individual; 10 para turmas ou atendimento coletivo).
• Duração da Vaga (minutos): Intervalo de tempo de cada horário (Ex: 30 gera vagas a cada 30 minutos).

Exceções, Inclusões e Feriados

Ajustes para dias específicos fora do padrão semanal.

• Datas a Desconsiderar
  Lista de Datas | Adicione datas específicas em que não haverá atendimento (Ex: recessos internos, reformas ou datas festivas locais).

• Datas a Incluir
  Lista de Datas | Adicione datas extraordinárias em que haverá atendimento mesmo fora da regra normal (Ex: um sábado de mutirão).

• Aplicar Feriados Nacionais
  Interruptor | Quando ligado, bloqueia automaticamente a oferta de horários nos feriados nacionais.

• UF (Feriados Estaduais)
  Texto (2 Letras) | Sigla do estado para bloqueio de feriados estaduais (Ex: MG, SP). Deixe em branco para não aplicar.

• Código IBGE (Feriados Municipais)
  Texto (6 ou 7 dígitos) | Código IBGE do município para bloqueio de feriados municipais (Ex: 3106200). Deixe em branco para não aplicar.

• Descrição da Política de Feriados
  Texto livre | Espaço informativo para registrar observações sobre o calendário de feriados adotado.

Regras e Contadores

• Política do Cliente
  Seleção | Selecione a regra cadastrada de limites de agendamento (Ex: número máximo de marcações ativas ou intervalo entre agendamentos por CPF).

• Nome do Contador
  Texto Opcional | Nome da sequência numérica que gerará o número de protocolo do agendamento. Agendas com o mesmo nome compartilham a mesma numeração.

• Prefixo do Contador
  Texto Opcional | Texto exibido antes do número do protocolo (Ex: ATD-2026-).

Alertas sobre Agendas em Uso

⚠️ Aviso de Alteração em Horários Existentes:
Se você alterar horários, capacidade ou dias de funcionamento de uma agenda que já possui marcações de clientes, o sistema reavaliará os agendamentos.

Caso a mudança remova um horário que já possuía cliente agendado, o sistema exibirá uma tela de alerta contendo:

• A quantidade total de agendamentos afetados.
• A lista dos horários que serão cancelados.
• O aviso de que os clientes impactados receberão uma notificação automática por e-mail.