Escalas Clínicas (PHQ-9 / GAD-7)

Envie, aplique e acompanhe escalas de rastreio como PHQ-9 e GAD-7, com escores, severidade e gráfico de trajetória.

WhatsApp, se a clínica ligar

As mensagens desta página podem sair por WhatsApp nas clínicas que ativaram o WhatsApp (saiba mais) e marcaram WhatsApp para cada uma em Configurações → Notificações. Desligado lá, a tela mostra "não enviado — desligado nas configurações de notificação", nunca "enviado". Documentos e NFS-e vão como link para baixar, válido por 7 dias. Cobranças por WhatsApp dependem de liberação da Akesia.

As escalas clínicas permitem enviar instrumentos de rastreio como PHQ-9 e GAD-7 para o paciente responder pelo celular, ou aplicá-los na própria sessão. Cada aplicação gera escore, faixa de severidade e alerta de risco, e a evolução ao longo do tempo aparece em um gráfico de Trajetória. Também é possível programar reaplicações automáticas.

Pré-requisitos

Permissões: o Profissional já tem acesso total às escalas por padrão (feature escalas = WRITE). O Admin/recepção vê apenas o status dos envios (sem escores) — para enviar, pontuar ou agendar, o admin precisa de um override de permissão por usuário (escalas = READ ou WRITE) concedido em Configurações → usuários.
Vínculo com o paciente: o profissional só vê e gerencia escalas de pacientes de quem é profissional de referência ou com quem tem ao menos um atendimento não cancelado. Se o paciente não tiver profissional de referência e o operador não for um profissional, defina um profissional de referência antes de enviar.
Quem recebe e consentimento LGPD: o link vai para as pessoas escolhidas em Enviar para — já vêm marcadas as que estão em Documentos em Contatos e quem recebe o quê (o contato principal, quando ninguém está marcado). O envio por E-mail ou WhatsApp exige o consentimento daquela pessoa no canal. Se ninguém pode receber, gere o link ou use Aplicar em sessão.
Envio automático (agendamentos): só dispara em produção, pelo cron diário /api/jobs/scale-sends (requer CRON_SECRET). Localmente os agendamentos ficam registrados, mas não enviam sozinhos. Clínicas com assinatura cancelada, não paga ou com período de teste vencido não recebem os envios automáticos até reativar a assinatura.
Entrega de mensagens: e-mail depende do Resend configurado. Pelo WhatsApp, a escala sai quando a clínica marcou Escala clínica com WhatsApp em Configurações → Notificações; desligado, o aviso diz "WhatsApp: não enviado — desligado nas configurações de notificação". Se a mensagem não sair, o link continua disponível em Copiar link para envio manual.

Para o profissional

Enviar a escala para o paciente responder

No menu lateral, abra Pacientes e clique no paciente; em seguida, na aba Documentos, seção Escalas.
Clique em Enviar escala.
Em Escala, escolha PHQ-9 ou GAD-7.
Em Canal, escolha E-mail ou WhatsApp (um canal em que ninguém pode receber fica desabilitado com a marca "(ninguém pode receber)"). Em Enviar para, confira quem recebe o link.
Clique em Enviar. Aparece o toast "Escala enviada." e o link gerado.
Para enviar manualmente, clique em Copiar link e cole no canal desejado; senão, clique em Fechar.
A aplicação aparece na tabela Administrações com status "Enviada".

Aplicar a escala na sessão (com o paciente)

Na aba Documentos do paciente, seção Escalas, clique em Aplicar em sessão.
Escolha a escala e responda cada item clicando na opção "<valor> — <texto>".
Clique em Salvar pontuação (habilita só quando todos os itens têm resposta). Surge o toast "Escala registrada."
O resultado entra imediatamente na tabela Administrações e no gráfico Trajetória.

Ver resultado e evolução

Na aba Documentos do paciente, seção Escalas, na tabela Administrações, a linha respondida mostra Pontuação (ex.: 12/27) e Severidade colorida; um triângulo vermelho indica resposta de risco.
Clique em Ver respostas para abrir o detalhe: escore, faixa de severidade e cada item; o item de risco (ex.: item 9 do PHQ-9) aparece em vermelho com "⚠".
Na seção Trajetória, veja o gráfico de escores ao longo do tempo (bandas de severidade ao fundo). Com mais de uma escala, use o seletor; exporte em PDF.

Programar reaplicação automática (ex.: GAD-7 mensal)

Na aba Documentos do paciente, seção Escalas, clique em Agendar envios.
Escolha a escala (GAD-7).
Em Cadência, escolha A cada N semanas e defina Intervalo (semanas) = 4 para uma cadência ~mensal (ou Antes de cada sessão).
Clique em Agendar. Surge o toast "Envio automático agendado."
O agendamento aparece em Envios automáticos, onde é possível pausar ou excluir. Em produção, o paciente passa a receber o link automaticamente na data programada. Os envios automáticos vão para as pessoas marcadas em Documentos (ou o contato principal). Se o único canal consentido de quem recebe for o WhatsApp, o agendamento é pausado com o motivo "Pausado — WhatsApp indisponível" no primeiro envio, porque nada é entregue por WhatsApp hoje.

Para o paciente

Abra o link /escala/... recebido por e-mail ou WhatsApp.
Na tela inicial, leia a instrução e toque em Começar.
Responda cada pergunta tocando na opção; use Voltar se precisar corrigir. O progresso é salvo automaticamente.
Ao responder a última pergunta, o envio é automático. Aparece a mensagem de conclusão ("Obrigado! Suas respostas foram enviadas para <profissional>.").

O paciente nunca vê o escore

O escore clínico e a faixa de severidade nunca são exibidos ao paciente — ele vê apenas a confirmação de que as respostas foram enviadas. Os resultados ficam disponíveis somente para o profissional na seção Escalas da aba Documentos.