Akesia · Documentação

Área do Paciente (portal sem senha)

Portal onde o paciente entra por código enviado ao e-mail para ver sessões, faturas, recibos e pedir alterações.

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 Área do Paciente é um portal onde o paciente entra sem senha — usando um código de 6 dígitos enviado ao e-mail cadastrado. Lá dentro ele acompanha as próximas sessões, cancela ou pede reagendamento, baixa faturas e recibos e solicita a atualização dos próprios dados. A clínica ativa o portal e aprova as solicitações que chegam por ele.

Pré-requisitos

  • Plano: o Portal do Paciente precisa estar incluído no plano da clínica. Se não estiver, a aba Portal mostra apenas um aviso de upgrade e o portal fica indisponível.
  • Envio do código (OTP) por e-mail: o servidor precisa da RESEND_API_KEY configurada e do AUTH_SECRET definido. Sem a chave da Resend, o código não é enviado (falha silenciosa). O canal WhatsApp é apenas mock em desenvolvimento e não entrega — na prática o paciente recebe o código por e-mail.
  • Cadastro do paciente: para conseguir entrar, o paciente precisa ter e-mail cadastrado e o consentimento de e-mail ativo. A clínica marca isso no cadastro; o paciente também controla em Preferências de contato dentro do portal.
  • Permissões (equipe): abrir Configurações e a aba Portal exige permissão de gestão (ADMIN por padrão). Para aprovar/aplicar solicitações, é necessário acesso de escrita em Pacientes.

Para o administrador

  1. Abra o menu do usuário (canto superior/lateral) e clique em Configurações.
  2. Na barra de abas, clique em Portal.
  3. Ligue o Habilitar portal.
  4. Ajuste Cancelamento permitido até (horas antes) (entre 1 e 168) — é o prazo mínimo para o paciente cancelar sozinho.
  5. No campo Link do portal, clique no botão de copiar (ícone de cópia) — aparece o toast "Link copiado!".
  6. Cole esse link (/paciente/<slug>) na mensagem de WhatsApp ou e-mail que você envia ao paciente.

Aprovar as solicitações do portal

  1. Abra Pacientes e clique na aba Solicitações do Portal.
  2. Deixe o filtro em Pendentes (use a busca por nome se precisar). Itens parados há mais de 2 dias exibem a etiqueta Atrasada.
  3. Para um pedido de atualização de dados, clique em Aplicar para gravar as mudanças no cadastro; use Resolver ou Rejeitar para os demais casos. O toast "Solicitação atualizada." confirma a ação.

Para o paciente

Entrar sem senha

  1. Abra o link /paciente/<slug> enviado pela clínica.
  2. Em "Telefone ou e-mail cadastrado na clínica", digite o e-mail que a clínica tem no seu cadastro.
  3. Clique em Receber código.
  4. Abra seu e-mail e copie o código de 6 dígitos ("Seu código de acesso à área do paciente...").
  5. Digite o código nos campos. Ao validar, você entra na home "Próximas sessões".

Cancelar ou pedir reagendamento

  1. Na aba Sessões, localize a sessão futura.
  2. Para cancelar, clique em Cancelar. Se estiver dentro do prazo mínimo, aparece um aviso explicando até quando é possível cancelar; caso contrário, você vê "Sessão cancelada. A clínica foi avisada.".
  3. Para remarcar, clique em Solicitar reagendamento, escreva sua preferência de dia/horário e clique em Enviar solicitação ("Solicitação enviada! A clínica entrará em contato.").

Ver e baixar faturas e recibos

  1. Na aba Financeiro ("Minhas faturas"): veja as faturas com status e vencimento; clique em Baixar fatura (PDF) (e Baixar NFS-e quando disponível).
  2. Na aba Documentos: para faturas já pagas, use Baixar no cartão "Recibo MM/AAAA".

Pedir atualização de dados

  1. Abra a aba Dados ("Meus dados").
  2. Clique em Solicitar alteração.
  3. Ajuste os campos (telefone, endereço etc.) e clique em Enviar.
  4. Aparece "Alteração enviada para aprovação da clínica." — a mudança só vale após a clínica aprovar.

A alteração passa por aprovação

Os pedidos de atualização de dados feitos pelo paciente não são gravados automaticamente: eles só valem depois que a clínica clica em Aplicar na aba Solicitações do Portal.

Nesta página