Aparência
Telemedicina (teleconsulta por vídeo)
Para que serve
A telemedicina permite fazer uma consulta por vídeo, sem o paciente se deslocar à clínica. O médico e o paciente veem-se e ouvem-se no navegador de internet.
O médico continua a escrever o prontuário durante a chamada: o registo clínico aparece ao lado da imagem de vídeo.
Esta funcionalidade depende do plano contratado (a partir do plano Avançado). Sem esse plano, todas as páginas de telemedicina devolvem erro 404 — página não encontrada, sem qualquer explicação. Ver o capítulo 97 — Resolução de problemas.
Quando usar
- Consultas de seguimento, em que não é preciso examinar o paciente.
- Entrega e explicação de resultados de exames.
- Pacientes que vivem longe da clínica.
- Situações em que a deslocação do paciente é difícil.
Não use teleconsulta quando for necessário exame físico.
Quem pode usar
| Ação | Permissão | Perfis que têm |
|---|---|---|
| Abrir a sala e conduzir a teleconsulta | start-telemedicine-session | admin, superadmin, médico |
| Gerar e enviar o link ao paciente | start-telemedicine-session | admin, superadmin, médico |
| Terminar a sessão | start-telemedicine-session | admin, superadmin, médico |
| Ver o histórico de teleconsultas | view-telemedicine-history | admin, superadmin, médico, receção |
Além da permissão, existe uma regra importante: só o médico da consulta pode conduzir a teleconsulta. Outro médico, mesmo com a permissão, recebe a mensagem «Apenas o médico da consulta pode conduzir a teleconsulta.»
O paciente não precisa de conta nem de palavra-passe. Entra pela ligação que recebe.
Ecrãs e funcionalidades
1. Sala de chamada (médico)
Endereço: /telemedicina/consultas/{id da consulta}/sala
Abre-se a partir da janela do agendamento, na agenda.
[CAPTURA: sala de teleconsulta do médico, com o vídeo do paciente ao centro, o vídeo próprio ao canto e o painel "Registo clínico" à direita]
O que a sala mostra:
- O vídeo do paciente, em grande.
- O seu próprio vídeo, em pequeno.
- Uma etiqueta de estado da chamada, no topo.
- Os controlos de microfone, terminar e câmara, em baixo.
- À direita, o painel Registo clínico, onde escreve o prontuário durante a chamada.
Em ecrãs pequenos (telemóvel), o painel do registo clínico não está aberto. Aparece uma etiqueta Registo que o abre.
2. Página de entrada do paciente
Endereço: /telemedicina/entrar/{código}
O paciente abre a ligação que recebeu. Conforme a situação, vê uma de quatro páginas:
| Situação | Título | Texto |
|---|---|---|
| Ainda é cedo | A sua teleconsulta ainda não começou | «A chamada abre à hora marcada (…). Volte a abrir este link nessa altura.» |
| A chamada já foi encerrada | Esta teleconsulta já terminou | «A chamada foi encerrada. Se precisar, contacte a clínica para mais informações.» |
| Ligação errada ou fora do prazo | Link inválido ou expirado | «Este link de acesso não é válido. Peça à clínica um novo link para a sua teleconsulta.» |
| Está na hora | — | Entra diretamente na sala de vídeo |
Cada botão, o que faz
Na sala de chamada
| Botão | O que faz |
|---|---|
| Botão do microfone | Liga e desliga o microfone. Ao passar o rato aparece Silenciar ou Ativar microfone |
| Botão central (vermelho) | Termina a chamada. Ao passar o rato aparece Terminar. Se for o médico, encerra a sessão para os dois |
| Botão da câmara | Liga e desliga a câmara. Ao passar o rato aparece Desligar câmara ou Ligar câmara |
| Registo (só em ecrãs pequenos, só para o médico) | Abre o painel do registo clínico |
| Sair (aparece só depois de a chamada terminar) | Volta à página anterior |
Na janela do agendamento (agenda)
| Botão | O que faz |
|---|---|
| Iniciar teleconsulta | Abre a sala de chamada do médico |
| Enviar link de vídeo | Gera a mensagem de WhatsApp com a ligação para o paciente e abre o WhatsApp |
O botão Enviar link de vídeo fica desativado se o paciente não tiver telefone. Ao passar o rato aparece «Paciente sem telefone».
Estados da chamada
A etiqueta no topo da sala muda conforme a ligação evolui:
| Etiqueta | Significado |
|---|---|
| A preparar a câmara… | O navegador está a pedir acesso à câmara e ao microfone |
| À espera do outro participante… | Está sozinho na sala |
| A ligar… | A estabelecer a ligação de vídeo |
| Em chamada | A chamada está a decorrer |
| Chamada terminada | A chamada foi encerrada |
| Erro | Houve uma falha; ver a mensagem apresentada |
Enquanto espera, aparece também «À espera de …» e «A chamada começa assim que … entrar.», com o nome do outro participante. Se o nome não for conhecido, aparece Paciente ou Médico.
Janela de acesso do paciente
Esta é a parte que mais dúvidas gera. Há duas regras diferentes.
Regra 1 — não pode entrar demasiado cedo. O paciente só consegue entrar a partir de 15 minutos antes da hora marcada. Antes disso vê a página «A sua teleconsulta ainda não começou».
Regra 2 — a ligação tem validade. A ligação é gerada com uma validade contada a partir da hora marcada (ou da hora em que é gerada, se já for mais tarde), acrescida de 120 minutos.
Consequência prática: se a consulta atrasar, a ligação continua a funcionar. E se gerar a ligação já depois da hora marcada, ela é válida a partir desse momento.
A ligação não é de uso único. O paciente pode recarregar a página durante a chamada sem perder o acesso. O que a invalida é o prazo terminar ou o médico encerrar a sessão.
Estes tempos (15 minutos antes, 120 minutos de validade) são valores configuráveis pela instalação. Confirme com o administrador se a sua clínica usa outros.
Cada campo do formulário
A telemedicina não tem formulários próprios de preenchimento. A única coisa que o médico gera é a ligação para o paciente, e essa é criada com um clique.
A mensagem que o sistema prepara para o WhatsApp é sempre esta:
«A {nome da clínica} convidou-o para uma teleconsulta por vídeo ({data e hora}). Entre pelo link à hora marcada: {ligação}»
Importante: o sistema abre o WhatsApp com a mensagem escrita. Não envia sozinho. É preciso carregar em enviar dentro do WhatsApp.
Exemplo prático
Situação: o Dr. Manuel tem uma teleconsulta de seguimento com a Sra. Domingas, marcada para as 15h00 de dia 12.
Na véspera ou no próprio dia, antes da consulta:
- O Dr. Manuel abre Agenda → Calendario.
- Clica no agendamento das 15h00 da Sra. Domingas.
- Na janela que abre, clica em Enviar link de vídeo.
- Abre-se o WhatsApp, já com a mensagem escrita e o número da paciente preenchido.
- O Dr. Manuel carrega em enviar, dentro do WhatsApp.
Às 14h58:
- A Sra. Domingas abre a ligação no telemóvel. Como já faltam menos de 15 minutos, entra diretamente na sala.
- O navegador pergunta se pode usar a câmara e o microfone. Ela autoriza.
- Vê a mensagem À espera do outro participante…
Às 15h00:
- O Dr. Manuel abre o mesmo agendamento e clica em Iniciar teleconsulta.
- A etiqueta muda para A ligar… e depois para Em chamada.
- À direita, o Dr. Manuel tem o painel Registo clínico. Escreve o prontuário enquanto conversa.
No fim:
- O Dr. Manuel clica no botão vermelho central (Terminar).
- A sessão fica encerrada. Se a Sra. Domingas voltar a abrir a ligação, vê «Esta teleconsulta já terminou».
Fluxo completo
- Marcar a consulta na agenda, como qualquer outra consulta.
- Confirmar que o paciente tem telefone registado na ficha.
- Abrir o agendamento e clicar em Enviar link de vídeo.
- Enviar a mensagem dentro do WhatsApp.
- À hora marcada, abrir o agendamento e clicar em Iniciar teleconsulta.
- Autorizar a câmara e o microfone no navegador.
- Esperar que o paciente entre.
- Conduzir a consulta e escrever o prontuário no painel lateral.
- Clicar em Terminar.
- Faturar a consulta normalmente (Mais opções → Nota de pagamento ou Faturação).
Erros comuns e como resolver
| Mensagem ou situação | Porquê | O que fazer |
|---|---|---|
| A página de telemedicina dá 404 | O plano contratado não inclui telemedicina | Fale com o administrador da clínica |
| «Telefone do paciente em falta ou inválido.» | O paciente não tem telefone, ou o número não é um número angolano válido | Edite a ficha do paciente e corrija o telefone |
| «Apenas o médico da consulta pode conduzir a teleconsulta.» | Está a tentar abrir a sala de uma consulta de outro médico | A teleconsulta tem de ser feita pelo médico marcado |
| «Não foi possível aceder à câmara/microfone. Verifique as permissões do navegador.» | O navegador não tem autorização, ou outro programa está a usar a câmara | Autorize a câmara e o microfone no navegador. Feche outros programas de vídeo |
| «A ligação de vídeo falhou. Tente recarregar a página.» | A ligação entre os dois participantes caiu | Recarregue a página. Se repetir, verifique a ligação à internet |
| «Não foi possível ligar ao servidor de signaling.» | Problema de rede ou de configuração do servidor | Contacte o administrador da clínica |
| O paciente diz que vê «A sua teleconsulta ainda não começou» | Está a tentar entrar com mais de 15 minutos de antecedência | Peça-lhe para voltar a abrir a ligação mais perto da hora |
| O paciente diz que vê «Link inválido ou expirado» | O prazo da ligação terminou, ou a ligação foi mal copiada | Gere e envie uma nova ligação |
| O paciente vê-se a si próprio mas não vê o médico | O médico ainda não entrou, ou tem a câmara desligada | Confirme que o médico clicou em Iniciar teleconsulta |
| O paciente não consegue ouvir | O microfone está silenciado de um dos lados | Verifique o botão do microfone nos dois lados |
| A chamada funciona em casa mas não na clínica | A rede da clínica pode estar a bloquear o vídeo | Contacte o administrador; pode ser preciso configurar o servidor de retransmissão |
Dicas e boas práticas
- Envie a ligação com antecedência, mas avise o paciente de que só consegue entrar 15 minutos antes da hora.
- Faça um teste de câmara e microfone antes da primeira teleconsulta do dia.
- Use auscultadores. Evita o eco que se ouve quando o som das colunas volta a entrar pelo microfone.
- Sente-se com uma fonte de luz à frente, não atrás. Uma janela nas costas transforma-o numa sombra.
- Escreva o prontuário durante a chamada, no painel lateral. Não deixe para depois — o prazo de edição do prontuário é de 24 horas.
- Termine sempre a chamada com o botão Terminar, e não fechando o separador. Assim a sessão fica corretamente encerrada.
- O paciente nunca vê o painel de registo clínico. Essa informação nunca lhe é enviada.
Por confirmar
- O botão que leva da agenda para a sala de teleconsulta foi confirmado na janela do agendamento (Iniciar teleconsulta). Não foi possível confirmar se existe outro ponto de entrada, por exemplo a partir do ecrã de atendimento.
- Existe no código uma página com o título «O período desta teleconsulta terminou», mas não foi possível encontrar nenhuma situação em que ela seja apresentada. Uma ligação fora de prazo mostra «Link inválido ou expirado».
- Não foi possível confirmar onde é que se consulta o histórico de teleconsultas (permissão
view-telemedicine-history). Não foi encontrado um ecrã de listagem. - Não foi possível confirmar se a chamada é gravada. Nada no código indica que seja.
- Os tempos de 15 e 120 minutos vêm da configuração da instalação e podem ser diferentes na sua clínica.