Akesia · Documentação

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

Este recurso faz parte das funcionalidades de mercado recém-lançadas.

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 waitlist já 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_URL definida — é o que monta o link /oferta enviado 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

  1. Vá em Configurações → aba "Lista de espera".
  2. Em "Modo de operação", selecione "Oferta automática" (se estiver desabilitado, ative antes as notificações de agendamento).
  3. Em "Estratégia de oferta", escolha "Sequencial (um por vez)" ou "Todos de uma vez (primeiro que aceitar leva)".
  4. 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

  1. Na Agenda, clique no botão Espera no cabeçalho e depois em Ver tudo (ou acesse a URL /espera).
  2. Use as abas Ativas / Ofertadas / Convertidas / Removidas para acompanhar.
  3. 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

  1. Na Agenda, clique em Espera e depois em Ver tudo para abrir a página da lista.
  2. Clique em Adicionar. Marque "Ainda não é paciente (lead)" se for um lead (informe nome e telefone) ou busque um paciente existente.
  3. 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".
  4. Clique em Adicionar (toast "Adicionado à lista de espera").

Ofertar um horário liberado

  1. Na Agenda, abra a consulta e cancele-a.
  2. No editor, clique em "Ver correspondências na lista de espera".
  3. No diálogo, veja os candidatos compatíveis e clique em "Enviar oferta" no escolhido (toast "Oferta enviada").
  4. A entrada passa para Ofertada (visível na aba Ofertadas de /espera).

Para o paciente

  1. Você recebe por WhatsApp e/ou e-mail uma mensagem com um horário disponível e um link.
  2. Abra o link (página /oferta). Veja Profissional, Data, Horário, Modalidade e até quando a oferta é válida.
  3. Clique em "Aceitar horário" para confirmar — aparece "Horário confirmado!" e o agendamento é criado.
  4. 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.

Nesta página