Lista de espera
Monte uma fila de espera e ofereça horários liberados automaticamente por e-mail — o primeiro que aceitar leva.
Funcionalidade nova
Envio por WhatsApp ainda não está ativo
As mensagens descritas nesta página saem por e-mail. A opção de WhatsApp e o consentimento correspondente existem nas telas, mas ainda não há provedor de envio ligado — nada é entregue por WhatsApp hoje. Ao configurar um aviso que o paciente precise receber, garanta que ele tenha e-mail no cadastro.
A lista de espera guarda pacientes (e leads) que querem uma vaga com preferências de dia, horário e modalidade. Quando um horário é liberado, o sistema pode oferecê-lo automaticamente aos candidatos compatíveis por WhatsApp e/ou e-mail, com um link para o paciente aceitar — vale a regra "primeiro que aceitar leva".
Pré-requisitos
- Papéis/permissões: a feature
waitlistjá vem como WRITE para ADMIN e PROFISSIONAL — ambos veem o botão Espera na agenda e podem adicionar e ofertar. A aba de configuração exige um ADMIN (acesso às Configurações da clínica). - Notificações de agendamento ativas: o modo Oferta automática só fica disponível quando as notificações de agendamento estão ligadas (ative-as na aba Notificações das Configurações). Sem isso, a opção aparece desabilitada com aviso.
- Provedor de mensagens configurado (Resend para e-mail e/ou WhatsApp) e a variável
NEXT_PUBLIC_APP_URLdefinida — é o que monta o link/ofertaenviado ao paciente. Sem provedor, a oferta é criada mas a mensagem pode não chegar. - Consentimento do paciente: a oferta só é enviada a pacientes com consentimento de WhatsApp e/ou e-mail. Sem consentimento, o sistema recusa com a mensagem "Paciente sem consentimento para receber a oferta". Leads (ainda não pacientes) não recebem oferta automática.
Para o administrador
Ativar a oferta automática
- Vá em Configurações → aba "Lista de espera".
- Em "Modo de operação", selecione "Oferta automática" (se estiver desabilitado, ative antes as notificações de agendamento).
- Em "Estratégia de oferta", escolha "Sequencial (um por vez)" ou "Todos de uma vez (primeiro que aceitar leva)".
- Defina o prazo de validade da oferta em "Janela de exclusividade (horas)" e, se quiser, a "Antecedência mínima (horas)". As alterações salvam sozinhas (toast "Configurações da lista de espera salvas").
Gerenciar a fila
- Na Agenda, clique no botão Espera no cabeçalho e depois em Ver tudo (ou acesse a URL
/espera). - Use as abas Ativas / Ofertadas / Convertidas / Removidas para acompanhar.
- Em Ativas você pode reordenar (setas), editar (lápis) ou remover entradas.
Ofertas expiradas voltam para a fila
Ofertas que expiram voltam sozinhas para Ativas por uma rotina automática que roda a cada 15 minutos — você não precisa reprocessá-las manualmente.
Para o profissional
Colocar alguém na fila
- Na Agenda, clique em Espera e depois em Ver tudo para abrir a página da lista.
- Clique em Adicionar. Marque "Ainda não é paciente (lead)" se for um lead (informe nome e telefone) ou busque um paciente existente.
- Escolha o Profissional (ou deixe "Qualquer profissional"), informe as preferências (dias da semana, faixas de horário, modalidade) e, opcionalmente, a "Nota de prioridade".
- Clique em Adicionar (toast "Adicionado à lista de espera").
Ofertar um horário liberado
- Na Agenda, abra a consulta e cancele-a.
- No editor, clique em "Ver correspondências na lista de espera".
- No diálogo, veja os candidatos compatíveis e clique em "Enviar oferta" no escolhido (toast "Oferta enviada").
- A entrada passa para Ofertada (visível na aba Ofertadas de
/espera).
Para o paciente
- Você recebe por WhatsApp e/ou e-mail uma mensagem com um horário disponível e um link.
- Abra o link (página
/oferta). Veja Profissional, Data, Horário, Modalidade e até quando a oferta é válida. - Clique em "Aceitar horário" para confirmar — aparece "Horário confirmado!" e o agendamento é criado.
- Se não tiver interesse, clique em "Não tenho interesse" — você permanece na lista de espera para a próxima oportunidade.
Primeiro que aceitar leva
Na estratégia "Todos de uma vez", se outra pessoa aceitar antes de você, o link mostra que o horário já foi preenchido. Você continua na lista de espera aguardando a próxima vaga.