# Agendamento

> O espaço onde as pessoas da comunidade oferecem horários (mentoria, aula, atendimento) e os membros marcam. Quem oferece, aprovação da agenda, horários gratuitos e pagos em créditos, pesquisa por pessoa, página do anfitrião, Meus agendamentos, convite de calendário e lembrete.

O módulo **Agendamento** permite ao membro **marcar um horário com uma pessoa da comunidade**: uma mentoria, uma aula, um atendimento, uma conversa. Cada pessoa que oferece horários tem a sua **agenda** (o horário semanal em que atende); quem quer marcar pesquisa por pessoa, escolhe um horário livre e reserva. Funciona sobre o mesmo núcleo das [Reservas](/espacos/reservas): a diferença é que o que se reserva aqui é o tempo de **uma pessoa**, o **anfitrião**.

## Para que serve

| Comunidade | Agendamento |
|---|---|
| Comunidade de mentoria | Cada mentor abre a agenda e os mentorandos marcam 30 minutos |
| Escola | Os professores oferecem horários de esclarecimento de dúvidas, por créditos |
| Coworking | Os membros oferecem horários de consultoria uns aos outros, grátis |
| Associação | A direção atende os associados em horários fixos |

## Como funciona

### Quem oferece horários

Na configuração do espaço, **Quem pode oferecer horários** escolhe:

| Escolha | Quem tem agenda no espaço |
|---|---|
| **Dono e administradores** (predefinição) | Proprietário e administrador |
| **Equipe** | Proprietário, administrador, moderador e financeiro |
| **Todos os membros do espaço** | Qualquer membro com acesso ao espaço |

Duas opções completam as regras:

- **Aprovar antes de aparecer.** A agenda de um membro só aparece na pesquisa depois de o proprietário ou o administrador a aprovar.
- **Permitir horários pagos.** O proprietário e o administrador podem cobrar créditos pelos próprios horários. Desligar não cancela o que já foi marcado e, com a opção desligada, **nenhum horário é cobrado**, mesmo que tenha faixa de preço.

**O horário que um membro oferece é sempre gratuito**, em qualquer configuração. Alterar estas opções não cancela agendamentos existentes. Quem perde o papel exigido (ou o acesso ao espaço) mantém as reservas já feitas, mas a agenda sai da pesquisa e ninguém marca horário novo.

### A agenda de uma pessoa

Quem oferece abre o separador **Ofereça seus horários** e **Criar minha agenda**. A agenda tem:

| Separador | O que define |
|---|---|
| **Horário semanal** | Os dias e horas em que atende, no relógio da comunidade. Sem horário, ninguém marca |
| **Exceções** | Bloqueios e horários extra |
| **Dados e regras** | Nome da agenda, descrição, **Link online** (vai no e-mail de quem marcar), duração do atendimento, menor e maior atendimento, folga, antecedência mínima, até quantos dias à frente, janela de cancelamento e **Recebendo agendamentos** (desligado, pausa a agenda) |
| **Preço** | Faixas de preço em créditos (só proprietário e administrador, e só com **Permitir horários pagos**) |
| **Quem marcou** | As reservas feitas consigo |

A situação da agenda aparece como **Aparece na busca**, **Fora da busca** (à espera de aprovação ou retirada da lista) ou **Pausada**.

### O que o membro faz

O espaço tem os separadores **Pessoas**, **Meus agendamentos** e, para quem oferece, **Ofereça seus horários**; para o proprietário e o administrador, **Aprovações**.

1. Em **Pessoas**, pesquise por nome, dia, janela (**A partir de** e **Até**) e duração. A pesquisa lista **só quem tem horário livre**, com os próximos horários, o custo em créditos (ou **Gratuito**) e o seu saldo.
2. Abra a **página da pessoa** para ver a grelha de horários por dia e o próximo horário livre.
3. Escolha o horário e **Reservar**. A reserva sai confirmada; se o horário custa créditos, o custo é debitado e o convite chega por e-mail.

Em **Meus agendamentos**, **Como cliente** lista o que marcou e **Como anfitrião**, o que marcaram consigo. Remarcar e cancelar funcionam como nas [Reservas](/espacos/reservas#remarcar), com as mesmas regras de [créditos](/monetizacao/creditos).

### Aprovações

Com **Aprovar antes de aparecer** ligado, as agendas novas de membros ficam à espera em **Aprovações** (e a barra **Gerenciar agendamento** mostra quantas). O proprietário e o administrador **aprovam** (a agenda passa a aparecer na pesquisa) ou **retiram da lista** (a agenda desaparece da pesquisa; as reservas já feitas continuam, e dá para aprovar de novo).

### Ausência, e-mails e lembrete

O anfitrião, a equipa, ou ambos, podem marcar a **ausência** de quem não apareceu, com a mesma regra de créditos das Reservas. Os e-mails de confirmação, remarcação, cancelamento e o **lembrete 1 hora antes** vão para quem marcou **e** para o anfitrião, com o convite de calendário (o evento é atualizado e cancelado na agenda da pessoa). O convite sai do endereço da Memberfy e mostra só o nome do anfitrião.

## Quem pode o quê

| Ação | Proprietário | Administrador | Moderador | Financeiro | Membro |
|---|---|---|---|---|---|
| Pesquisar pessoas e marcar horário | ✔ | ✔ | ✔ | ✔ | ✔ |
| Oferecer horários | conforme **Quem pode oferecer horários** | | | | |
| Aprovar ou retirar uma agenda | ✔ | ✔ | — | — | — |
| Cobrar créditos pelo próprio horário | ✔ | ✔ | — | — | — |
| Configurar o espaço | ✔ | ✔ | — | — | — |

## Na API

As rotas ficam em `/api/scheduling` (configuração, pesquisa de anfitriões, página do anfitrião, aprovações) e a reserva do horário usa `/api/bookings`, documentadas na [referência da API](/api/referencia).

## Relacionados

- [Reservas](/espacos/reservas)
- [Créditos](/monetizacao/creditos)
- [Módulos](/conceitos/modulos)