Visão Geral da Triagem
A triagem organiza o atendimento em duas mãos: quem coleta (enfermagem, recepção) registra sinais vitais, motivo, áudio, exames e, opcionalmente, uma entrevista com IA; o médico recebe a triagem numa fila por prioridade e registra o desfecho — prescrição, exames, encaminhamento, orientação ou consulta.
Base
https://api-dev.imagemais.com.br/api/triages
Todas as rotas exigem autenticação e são isoladas pela conta (accountId) do token.
A triagem registra quem coletou e quem decidiu. Por isso criar, decidir, retificar, salvar o rascunho das hipóteses, anexar documentos e iniciar a entrevista exigem um usuário no token (JWT). Autenticadas só com API Key, essas rotas respondem 403 "Ação disponível apenas para usuários autenticados".
Estados
| Status | Quem pode escrever | Como chega aqui |
|---|---|---|
OPEN | Coleta | Criar Triagem |
WAITING_DOCTOR | Médico | Enviar Triagem ao Médico — exige motivo e prioridade |
RESOLVED | Ninguém (só retificação) | Registrar Desfecho sem consulta imediata |
CONVERTED | Ninguém (só retificação) | Registrar Desfecho com CONSULTATION e scheduling: NOW — cria a consulta na hora |
DISCARDED | Ninguém | Descartar Triagem — só em OPEN ou WAITING_DOCTOR |
O status é a trava entre as duas mãos: em OPEN a triagem é da coleta (o médico não a vê na fila); em WAITING_DOCTOR é do médico (a coleta não edita mais). Rotas chamadas no status errado respondem 409, por exemplo "Triagem no status RESOLVED não pode ser descartada".
Fluxo típico
Coleta (create_triages / update_triages)
- Criar a triagem com o
patientId. A criação é idempotente: se o paciente já tem uma triagem emOPEN, ela é devolvida em vez de criar outra. - Preencher vitais e motivo com Atualizar Coleta.
- Opcionalmente:
- gravar o relato: URL pré-assinada →
PUTno storage → Salvar URL do Áudio; ou transcrever um arquivo e extrair os campos do texto; - anexar exames pelo upload direto (regras);
- fazer uma entrevista com IA — por voz, turno a turno ou por texto, com o Assistente Virtual. Ambas exigem o motivo preenchido.
- gravar o relato: URL pré-assinada →
- Enviar ao médico: a triagem passa a
WAITING_DOCTORe entra na fila.
Decisão (decide_triages)
- O médico acompanha a Fila do Médico, ordenada por prioridade (
EMERGENCY,URGENT,LOW_URGENCY,NOT_URGENT) e hora de chegada, e abre a triagem. - Opcionalmente pede apoio da IA: hipóteses diagnósticas e sugestão de desfecho. As hipóteses marcadas podem ser guardadas com Salvar Rascunho das Hipóteses para não se perderem ao recarregar a página.
- Registrar o desfecho.
- Anexar os PDFs gerados (prescrição, encaminhamento, orientação) com Anexar Documento do Desfecho.
- Corrigir depois só com Retificar Desfecho, informando o motivo — cada campo alterado vira uma linha de histórico, com o valor anterior.
Desfechos
| Desfecho | Campos | Efeito |
|---|---|---|
PRESCRIPTION | prescriptionNotes | Grava a prescrição na triagem |
EXAMS | examNotes | Grava os exames solicitados |
REFERRAL | referralSpecialty, referralUrgency, referralReason | Grava o encaminhamento |
GUIDANCE | guidanceTemplate, guidanceText, printed, sentByWhatsapp | Grava a orientação entregue ao paciente |
CONSULTATION | scheduling, consultationType, consultationNote | Com scheduling: NOW, cria a consulta na hora e a triagem vira CONVERTED. Com FIT_TODAY ou SCHEDULE, fica registrado para a recepção agendar e a triagem vira RESOLVED |
Os desfechos de prescrição, exames, encaminhamento e orientação podem ser combinados; CONSULTATION vai sozinho. A hipótese diagnóstica (diagnosis, diagnosisCid, diagnosisSelection) vale para qualquer desfecho.
Rotas
| Método | Rota | Permissão | Descrição |
|---|---|---|---|
POST | /triages | create_triages | Cria a triagem |
GET | /triages | read_triages | Lista com filtros e contadores |
GET | /triages/queue | decide_triages | Fila do médico |
GET | /triages/{id} | read_triages | Detalhe completo |
PATCH | /triages/{id} | update_triages | Atualiza a coleta |
POST | /triages/{id}/submit | update_triages | Envia ao médico |
DELETE | /triages/{id} | delete_triages | Descarta |
GET | /triages/{id}/audio-presigned-url | update_triages | URL para enviar o áudio |
PATCH | /triages/{id}/audio-url | update_triages | Registra o áudio enviado |
POST | /triages/{id}/transcription | update_triages | Transcreve um áudio |
POST | /triages/{id}/extract | update_triages | Extrai campos de um texto |
POST | /triages/{id}/interview | update_triages | Entrevista por texto (Assistente Virtual) |
GET | /triages/direct-upload/config | create_triages ou update_triages | Regras de upload de exames |
POST | /triages/{id}/direct-upload/initiate | update_triages | Gera URLs de upload |
POST | /triages/{id}/direct-upload/complete | update_triages | Registra os exames enviados |
POST | /triages/{id}/direct-upload/abort | update_triages | Aborta um upload multipart |
PUT | /triages/{id}/decision/diagnosis-draft | decide_triages | Rascunho das hipóteses |
POST | /triages/{id}/decision | decide_triages | Registra o desfecho |
PATCH | /triages/{id}/decision | decide_triages | Retifica o desfecho |
POST | /triages/{id}/documents | decide_triages | Anexa PDF do desfecho |
DELETE | /triages/{id}/documents/{fileId} | decide_triages | Exclui PDF do desfecho |
Os exames anexados na triagem só são enviados para leitura (OCR) quando a triagem vira consulta. O resumo do OCR aparece em Buscar Triagem e em OCR dos Exames da Triagem.