Akesia · Documentação

Agendamento Online

Página pública onde o paciente marca a própria sessão sem login, com confirmação automática ou aprovação da equipe.

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.

O agendamento online é uma página pública em que o paciente escolhe o profissional, um horário livre e preenche os próprios dados de contato — tudo sem precisar de login. Conforme a configuração da clínica, o pedido é confirmado na hora ou fica aguardando aprovação da equipe.

Pré-requisitos

  • Permissões (RBAC): para configurar, o usuário precisa de clinic_settings = WRITE (padrão do ADMIN). Para ver/aprovar solicitações, online_booking = WRITE (padrão de ADMIN e PROFESSIONAL). Definir a própria disponibilidade está liberado para qualquer usuário logado.
  • Slug da clínica: a clínica precisa ter um slug definido (aba Configurações → Clínica) — ele forma a URL pública /agendar/<slug>.
  • Cada profissional precisa de: o campo "Link público" (slug do profissional) preenchido, o checkbox "Listado" marcado e ao menos uma janela de disponibilidade ativa. Faltando qualquer um dos três, o profissional não aparece na página pública.
  • E-mail (Resend): o envio de e-mails de recebimento/confirmação/rejeição depende do Resend estar configurado. Sem a chave, o agendamento continua funcionando na tela, mas os e-mails não são enviados (falha silenciosa) — confirme a configuração de e-mail antes de divulgar o link.

Como usar

Para o administrador (ativar e divulgar)

  1. Abra o menu do seu usuário (canto do menu lateral) e clique em Configurações.
  2. Vá na aba Agenda.
  3. Clique no card "Agendamento online (página pública)".
  4. Marque "Habilitar agendamento online".
  5. Escolha o Modo de confirmação: "Aprovação manual (recomendado)" ou "Confirmação automática".
  6. Ajuste Duração padrão (min), Antecedência mínima (h), Horizonte (dias), Máx. em aberto / telefone e as Modalidades permitidas (Online/Presencial). Clique em Salvar.
  7. Copie a URL pública (/agendar/<slug>) no botão de copiar (aparece o toast "Link copiado").
  8. Na seção Profissionais, para cada profissional que deve aparecer: marque "Listado", preencha "Link público" (ex.: ana-silva) e clique em Salvar; depois copie o deep link do profissional se quiser divulgar direto.
  9. Cole a URL no Instagram/site da clínica.

Para o profissional (definir horários)

  1. Abra o menu do seu usuário e clique em Disponibilidade.
  2. Ative os dias de atendimento e configure as janelas semanais de horário no seletor.
  3. (Opcional) Adicione exceções para bloqueios ou disponibilidade extra em datas específicas.
  4. Clique em Salvar (toast "Disponibilidade salva com sucesso"). Só esses horários passam a ser oferecidos na página pública.

Para o administrador ou profissional (aprovar solicitações)

  1. No menu lateral, observe o item Solicitações — ele mostra um badge com o número de pedidos pendentes.
  2. Clique em Solicitações para abrir /agenda/solicitacoes.
  3. Use o filtro Pendentes e revise nome, telefone, e-mail, profissional, data/hora e modalidade de cada pedido.
  4. Clique em "Aprovar e agendar". Se for um contato novo, escolha vincular a um paciente existente ou criar um novo no painel que abre; a consulta é criada na agenda.
  5. Para recusar, clique em "Rejeitar", escreva um motivo (opcional) e confirme em "Confirmar rejeição".

Para o paciente (marcar e confirmar)

  1. Abra o link /agendar/<slug> recebido.
  2. Escolha o profissional.
  3. Navegue pelas semanas e toque em um horário livre.
  4. Preencha nome, telefone e e-mail e aceite o consentimento; clique em enviar.
  5. Veja a tela "Solicitação enviada!" (aprovação manual) ou "Agendamento confirmado!" (confirmação automática).
  6. Se receber o e-mail/WhatsApp de confirmação, confira data e hora e use os links de confirmar/cancelar presença quando necessário.

Antes de divulgar o link

Se o Resend não estiver configurado, os e-mails de recebimento, confirmação e rejeição não são enviados (falha silenciosa), embora o agendamento continue funcionando na tela. Confirme a configuração de e-mail antes de compartilhar a URL pública.

Nesta página