--- title: "Agenda" slug: "agenda" updated: 2026-09-09T19:19:18Z published: 2026-09-09T19:19:18Z canonical: "docs.omnisiga.ai/agenda" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.omnisiga.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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. ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(809).png) --- ### 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. ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(807).png) --- ## 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. ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(810).png) --- ## 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. ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(811).png) --- ## 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. ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(812).png) --- ## 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). ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(813).png) --- ## 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. ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(814).png) --- ## 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-`). ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(815).png) --- ## 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. --- Dicas e Regras para a configuração - **Janela Semanal Obrigatória:** Uma nova agenda deve conter obrigatoriamente pelo menos um horário semanal cadastrado antes de ser salva. - **Atenção ao Salvar Agendas em Uso:** Alterar uma agenda que já possui horários agendados por clientes pode cancelar atendimentos existentes. O sistema exibirá um aviso detalhado de confirmação caso isso aconteça. - **Valores em Minutos:** Todos os campos de tempo (antecedência, tolerância e duração) são preenchidos em minutos inteiros. - **Valores de Feriados:** Para aplicar feriados estaduais, use a sigla da UF com 2 letras. Para feriados municipais, utilize o código IBGE com 6 ou 7 dígitos.