Criar agendamento recorrente pelo painel admin

Pré-requisitos

Plano com o recurso Agendamentos recorrentes habilitado. Se o plano não tiver, a seção "Agendamento recorrente" no formulário não aparece — veja como liberar.
O agendamento precisa ter um cliente cadastrado (não funciona com visitante anônimo / sem cadastro) — uma série exige um cliente para associar as próximas ocorrências.
Não é possível marcar como recorrente:
- um agendamento passado (retroativo)
- um encaixe / walk-in com cliente avulso (sem cadastro). Encaixe com cliente cadastrado funciona — veja abaixo.
- uma edição de um agendamento já criado

Onde aparece o controle

A seção "Agendamento recorrente" fica disponível em duas formas de criar agendamento pelo painel:

Nova reserva (agendamento programado para uma data/hora futura): controle visível e habilitado assim que você preenche cliente, serviço e horário.
Atender agora (encaixe / walk-in): controle visível somente quando você seleciona um cliente cadastrado. Com visitante anônimo (campos "Nome" e "Telefone" preenchidos manualmente), o controle aparece desabilitado com a dica "Selecione um cliente registrado para criar série".

A engine por trás é a mesma nos dois fluxos — depois de salvar, a série gera as próximas ocorrências automaticamente independente de qual formulário a criou.

Como ativar

Abra Nova reserva pela agenda ou pelo botão de criar agendamento. Funciona também em Atender agora (encaixe), desde que você selecione um cliente cadastrado em vez de digitar nome/telefone manualmente.

Preencha cliente, serviço, profissional, data e horário normalmente.

Toque em Ajustes e depois em Repetir.

Escolha a frequência tocando na linha — não há chave para ligar antes:

Não repete (o padrão)
Toda semana (no mesmo dia)
A cada 2 semanas (quinzenal)
A cada 3 semanas
A cada 4 semanas (mensal por semana — sempre no mesmo dia da semana)

Escolhendo qualquer uma delas, aparece embaixo Até quando a série vai.

Salve. O sistema cria o primeiro agendamento (visível na agenda) e fica gerando os próximos automaticamente até cobrir os próximos 6 meses.

O que acontece depois

O sistema cria a série e vincula o primeiro agendamento a ela.
As próximas ocorrências são criadas imediatamente, cobrindo o horizonte de 6 meses configurado para o seu negócio. O limite de "Configurações > Regras > Antecedência máxima" não se aplica às séries recorrentes: aquele limite controla só até quando um cliente pode agendar sozinho pelo site. Uma série recorrente é um compromisso que você define como operador, então ela gera todas as ocorrências dos próximos 6 meses mesmo que sua antecedência máxima para clientes seja menor (ex.: 7 dias).
Todos os dias o sistema completa a série automaticamente, mantendo sempre 6 meses de agendamentos pré-marcados à frente. Ele olha para todas as recorrências ativas todo dia, não só para as que estão perto de acabar — então uma série nunca fica sem horários à frente esperando a próxima checagem.
Conflitos de horário em datas futuras são ignorados (a série pula a data conflitante sem cancelar a série inteira).
Se o primeiro agendamento cair em cima de outro e você usar sobrescrever conflito para forçar o horário, a série continua sendo criada normalmente. A sobrescrita vale só para o primeiro horário; cada ocorrência futura é checada de forma independente e as que estiverem ocupadas são puladas.

Duração dos agendamentos da série

A duração de cada ocorrência segue o serviço cadastrado — mas você pode fixar uma duração diferente para a série inteira:

Na criação: se você ajustar a duração total do primeiro agendamento (Ajustes → Duração) antes de ativar a recorrência, todas as ocorrências da série herdam essa duração — inclusive as que forem geradas no futuro. Útil para clientes fixos que sempre levam mais (ou menos) tempo que o padrão do serviço.
Editando uma ocorrência depois: ao abrir um agendamento que faz parte de uma série e mudar a duração total, aparece a pergunta "Aplicar duração a" com três opções:
- Apenas este agendamento — muda só a ocorrência aberta (padrão).
- Este e os próximos — muda esta e todas as ocorrências futuras da série, incluindo as que ainda nem foram geradas.
- Toda a série — muda todas as ocorrências agendadas da série.

Ao escolher "Este e os próximos" ou "Toda a série", a duração fica fixada na série: mudanças futuras na duração do serviço no catálogo não afetam mais essa série (você fixou um valor manualmente). Para voltar a seguir o catálogo, edite a duração de novo e use "Voltar ao padrão".

Estender a duração de várias ocorrências de uma vez pode criar sobreposição com agendamentos vizinhos. O sistema aplica a mudança mesmo assim (foi uma escolha sua) e a sobreposição fica visível na agenda para você ajustar.

Gerenciar a série depois

Veja Gerenciar séries recorrentes (pausar, retomar, cancelar, reagendar) para os controles de ciclo de vida da série (pausar para férias, reagendar para outro dia da semana, cancelar inteira).

Diferenças vs. o agendamento recorrente do cliente

O recurso é o mesmo — o cliente pelo site do estabelecimento e o admin pelo painel batem na mesma engine. As únicas diferenças:

Cliente: marca pelo card "Repetir agendamento" na etapa de confirmação do site — ele fica entre as opções do fim da tela (junto de "Tenho um cupom" e "Adicionar uma observação"), e a frequência só aparece depois que ele liga a chave.
Admin: marca pela seção "Agendamento recorrente" no formulário de nova reserva.
IA (chat / WhatsApp): quando o cliente pede "marca toda semana", o assistente cria a série. A mesma exigência de plano vale aqui.

Os três caminhos criam a série do mesmo jeito: a quantidade de ocorrências, o tratamento de conflitos e a renovação automática se comportam exatamente igual, não importa por onde a série nasceu.

O que aparece depois de criar

Ao criar uma recorrência, o painel mostra um resumo do que foi feito — em vez de apenas confirmar que o agendamento foi salvo:

Quantos agendamentos foram criados de uma vez.
Até que data eles foram gerados.
Que a série renova sozinha, sempre mantendo cerca de 6 meses à frente.
Quais datas não couberam, uma a uma, com o motivo.

O resumo fica na tela até você fechar. Ele não é um aviso passageiro justamente porque a lista de datas puladas é a única chance de você agir sobre elas.

Datas que não couberam continuam sem agendamento

Quando o horário da recorrência já está ocupado, aquela semana não é criada — o sistema não marca por cima de ninguém. Ele também não tenta outro horário sozinho, porque o horário fixo é justamente o que o cliente combinou. Para não perder a vaga, agende aquela data à mão (ajustando a duração, se precisar encaixar antes do próximo cliente).

Motivos possíveis para uma data ser pulada:

Motivo	O que aconteceu
horário ocupado	Já existe outro agendamento nesse horário com o mesmo profissional.
fechado neste dia	A data cai fora do horário de funcionamento, ou num fechamento cadastrado.
data ignorada de propósito	Você mesmo marcou essa data para ser pulada na série.

Até quando a recorrência vai

A recorrência não tem data para acabar. Ela segue gerando enquanto você não pausar ou cancelar.

O que você vê na agenda é o quanto o sistema já gerou, não o fim da série. Ele mantém cerca de 6 meses à frente e renova sozinho conforme o tempo passa.

O último horário na agenda não é o fim da série

Se a última quarta-feira do seu cliente semanal na agenda é 16/09, isso não quer dizer que a recorrência dele terminou — quer dizer que o sistema ainda não gerou as próximas. Marcar outro cliente em 23/09 nesse horário faz com que a semana do cliente fixo seja pulada quando a renovação rodar.

Definir quando a recorrência acaba

Depois de escolher a frequência, o grupo Até quando aparece logo abaixo:

Sem data para acabar (padrão) — segue gerando até você pausar ou cancelar.
Repetir um número de vezes — toque na linha e use − e +; começa em 10, contando a primeira.
Repetir até uma data — toque na linha e escolha a data no calendário. A data escolhida entra na conta: "repetir até 23/09" inclui o dia 23.

São alternativas: escolher uma limpa a outra.

Repetições, não sessões

"Repetir 10 vezes" conta repetições do padrão, não atendimentos realizados. Se um dos horários for cancelado, ele já foi gasto — a série não ganha uma repetição extra no fim. Para vender um pacote de N sessões, use assinatura/plano, que é onde essa contagem existe de verdade.

Você também pode mudar o fim de uma recorrência depois de criada — veja Gerenciar séries recorrentes. Mudar o limite para mais perto cancela os horários que ficarem fora dele; para mais longe, os novos são gerados na próxima rotina.

Limitações conhecidas

A interface expõe frequência semanal com intervalo de 1 a 4 semanas. O banco já suporta frequência mensal e datas excluídas (pular um feriado específico sem mexer no resto da série), mas nenhuma das duas tem controle na tela ainda.