Skip to main content

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.

Só com token de usuário

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​

StatusQuem pode escreverComo chega aqui
OPENColetaCriar Triagem
WAITING_DOCTORMédicoEnviar Triagem ao Médico — exige motivo e prioridade
RESOLVEDNinguém (só retificação)Registrar Desfecho sem consulta imediata
CONVERTEDNinguém (só retificação)Registrar Desfecho com CONSULTATION e scheduling: NOW — cria a consulta na hora
DISCARDEDNinguémDescartar 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)

  1. Criar a triagem com o patientId. A criação é idempotente: se o paciente já tem uma triagem em OPEN, ela é devolvida em vez de criar outra.
  2. Preencher vitais e motivo com Atualizar Coleta.
  3. Opcionalmente:
  4. Enviar ao médico: a triagem passa a WAITING_DOCTOR e entra na fila.

Decisão (decide_triages)

  1. 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.
  2. 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.
  3. Registrar o desfecho.
  4. Anexar os PDFs gerados (prescrição, encaminhamento, orientação) com Anexar Documento do Desfecho.
  5. Corrigir depois só com Retificar Desfecho, informando o motivo — cada campo alterado vira uma linha de histórico, com o valor anterior.

Desfechos​

DesfechoCamposEfeito
PRESCRIPTIONprescriptionNotesGrava a prescrição na triagem
EXAMSexamNotesGrava os exames solicitados
REFERRALreferralSpecialty, referralUrgency, referralReasonGrava o encaminhamento
GUIDANCEguidanceTemplate, guidanceText, printed, sentByWhatsappGrava a orientação entregue ao paciente
CONSULTATIONscheduling, consultationType, consultationNoteCom 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étodoRotaPermissãoDescrição
POST/triagescreate_triagesCria a triagem
GET/triagesread_triagesLista com filtros e contadores
GET/triages/queuedecide_triagesFila do médico
GET/triages/{id}read_triagesDetalhe completo
PATCH/triages/{id}update_triagesAtualiza a coleta
POST/triages/{id}/submitupdate_triagesEnvia ao médico
DELETE/triages/{id}delete_triagesDescarta
GET/triages/{id}/audio-presigned-urlupdate_triagesURL para enviar o áudio
PATCH/triages/{id}/audio-urlupdate_triagesRegistra o áudio enviado
POST/triages/{id}/transcriptionupdate_triagesTranscreve um áudio
POST/triages/{id}/extractupdate_triagesExtrai campos de um texto
POST/triages/{id}/interviewupdate_triagesEntrevista por texto (Assistente Virtual)
GET/triages/direct-upload/configcreate_triages ou update_triagesRegras de upload de exames
POST/triages/{id}/direct-upload/initiateupdate_triagesGera URLs de upload
POST/triages/{id}/direct-upload/completeupdate_triagesRegistra os exames enviados
POST/triages/{id}/direct-upload/abortupdate_triagesAborta um upload multipart
PUT/triages/{id}/decision/diagnosis-draftdecide_triagesRascunho das hipóteses
POST/triages/{id}/decisiondecide_triagesRegistra o desfecho
PATCH/triages/{id}/decisiondecide_triagesRetifica o desfecho
POST/triages/{id}/documentsdecide_triagesAnexa PDF do desfecho
DELETE/triages/{id}/documents/{fileId}decide_triagesExclui PDF do desfecho
Exames e OCR

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.