# Criar agendamento recorrente pelo painel admin

Fonte: https://docs.barbeiro.app/business-admin/bookings/admin-recurring-booking
Perfil: Administrador
Verificado em: 2026-09-03

Você pode marcar um agendamento como **recorrente** direto pelo painel admin, sem pedir para o cliente abrir o site do estabelecimento. O agendamento principal é criado imediatamente; os demais (próximos 6 meses) entram automaticamente na agenda.

## 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](business-admin/billing/upgrade-for-recurring-bookings).
-   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

1. 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.

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

3. Toque em **Ajustes** e depois em **Repetir**.

4. 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.

5. 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"**.

> **Atençã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)](business-admin/bookings/recurring-series-lifecycle) 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](business-admin/bookings/recurring-series-lifecycle). 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.

## Leia também

- [Gerenciar séries recorrentes (pausar, retomar, cancelar, reagendar)](https://docs.barbeiro.app/business-admin/bookings/recurring-series-lifecycle)
- [Agendamento recorrente — quando aparece e como liberar](https://docs.barbeiro.app/business-admin/billing/upgrade-for-recurring-bookings)