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.

WhatsApp: para clínicas que ativaram

As mensagens ao paciente — avisos de consulta, formulários, escalas, assinaturas, lista de espera, documentos e NFS-e — podem sair por WhatsApp quando a clínica ativa o WhatsApp em Configurações → Integrações (veja como) e marca WhatsApp em cada mensagem em Configurações → Notificações. Documentos e NFS-e vão como link para baixar, nunca como anexo. Cobranças por WhatsApp dependem de liberação da Akesia.

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 (Configurações → Dados da 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.
Agendamento online: o paciente marca sozinhoAssistir no YouTube ↗

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. Escolha Agenda e sessões (grupo Agenda).
  3. Clique no card "Agendamento online (página pública)" (ou escolha direto Agendamento online no menu).
  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". Se Recusa de agendamento online não estiver como Automático em Configurações → Notificações, abre uma janela para você escolher se envia a mensagem de recusa ao contato e por qual canal (veja Rejeitar uma solicitaçã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 (no WhatsApp, os botões Confirmar e Cancelar) 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

Como usarPara o administrador (ativar e divulgar)Para o profissional (definir horários)Para o administrador ou profissional (aprovar solicitações)Para o paciente (marcar e confirmar)