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.

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.

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 já teve atendimento. 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.
Consentimento LGPD: o envio por E-mail ou WhatsApp exige o consentimento correspondente marcado no cadastro do paciente (aba Dados → Consentimentos LGPD). Sem consentimento, 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.
Entrega de mensagens: e-mail depende do Resend configurado; WhatsApp, do provedor de notificações. 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 Escalas.
Clique em Enviar escala.
Em Escala, escolha PHQ-9 ou GAD-7.
Em Canal, escolha E-mail ou WhatsApp (opções sem consentimento ficam desabilitadas com a marca "(sem consentimento)").
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 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 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 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.

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 aba Escalas.