Akesia · Documentação

Teleconsulta (sala de vídeo integrada)

Atenda o paciente por vídeo direto da agenda, com sala integrada, link externo e acesso do paciente sem login.

Funcionalidade nova

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

A teleconsulta permite atender o paciente por vídeo sem instalar nada: o profissional abre a sala com um clique a partir do agendamento e o paciente entra por um link enviado no e-mail de confirmação e no lembrete. Também é possível usar seu próprio Google Meet ou Zoom, se preferir.

Pré-requisitos

  • Ambiente configurado: TELEHEALTH_JITSI_DOMAIN (domínio Jitsi) e AUTH_SECRET (assina os tokens da sala) precisam estar definidos. NEXT_PUBLIC_APP_URL define a base das URLs enviadas ao paciente; sem ela, em produção, essa base é o domínio canônico — nunca localhost. Sem TELEHEALTH_JITSI_DOMAIN, o provedor fica "não configurado": o toggle em Configurações aparece desabilitado com a mensagem "Indisponível no momento — fale com o suporte." e nenhum link de vídeo é gerado nas notificações.
  • Ativação por clínica: o administrador precisa ligar o toggle "Teleconsulta integrada" em Configurações → aba Agendamento.
  • Permissões: iniciar/gerenciar a sala exige acesso agenda_own com nível de escrita (WRITE). Admins com agenda_others podem iniciar a sala de consultas de outros profissionais.
  • E-mail/lembretes: o link do paciente chega pelos templates de Confirmação e Lembrete (variável "Link da Teleconsulta"). O envio de lembretes depende do cron send-reminders e do consentimento do paciente.
  • Contrato (opcional): para consultas online sem contrato terapêutico assinado, aparece um aviso da Res. CFP 09/2024 — ele não bloqueia o agendamento.

Para o administrador

  1. Abra Configurações e vá até a aba Agendamento.
  2. Na seção "Teleconsulta integrada", marque o checkbox para ativar. Se estiver esmaecido com "Indisponível no momento — fale com o suporte.", o provedor de vídeo ainda não foi configurado no ambiente.

Para o profissional

Agendar uma consulta online

  1. Na Agenda, clique para criar uma nova consulta.
  2. Selecione o paciente, a data e o horário.
  3. Em "Modalidade *", escolha "Online".
  4. Se aparecer o aviso laranja de contrato de telepsicologia, use "Gerar contrato" / "Enviar para assinatura" no paciente (opcional; não impede salvar).
  5. Salve. A confirmação enviada ao paciente já inclui a linha "💻 Teleconsulta — acesse no horário" com o link.

Entrar na sala na hora da sessão

  1. Na Agenda, abra o card/detalhe da consulta online de hoje.
  2. Clique em "Iniciar teleconsulta".
  3. A sala Jitsi abre em modal de tela cheia; realize o atendimento.
  4. Ao encerrar a chamada, clique em "Marcar como finalizada" (ou "Agora não").

Usar seu próprio Google Meet/Zoom

  1. Abra a consulta online e entre em modo de edição.
  2. No campo "Link externo (Zoom/Meet) — opcional", cole a URL (ex.: https://meet.google.com/...).
  3. Salve. O botão passa a ser "Abrir link da reunião" (abre em nova aba) e o paciente recebe esse mesmo link nas notificações.

Para o paciente

  1. Abra o e-mail/lembrete de confirmação e toque no link da teleconsulta.
  2. A página /teleconsulta/<token> abre sem login.
  3. Se for cedo, a tela informa a data/hora e que "a sala abre 15 minutos antes do horário".
  4. Dentro da janela, confirme seu nome e toque em entrar. Se o profissional ainda não chegou, aguarde na tela de espera — a entrada acontece automaticamente quando ele inicia a sala.

Consultas online sem contrato assinado

Para consultas online sem contrato terapêutico assinado, o sistema exibe um aviso da Res. CFP 09/2024. Ele é apenas informativo e não bloqueia o agendamento.

Nesta página