Skip to main content

Visão Geral da Pré-consulta

A pré-consulta registra a etapa anterior ao atendimento médico: sinais vitais, motivo da consulta, áudio do relato, exames trazidos pelo paciente e, opcionalmente, uma entrevista guiada por IA. Ela é criada de forma independente (não precisa existir consulta) e depois serve de origem para Criar Consulta via preConsultationId.


Base​

https://api-dev.imagemais.com.br/api/pre-consultations

Todas as rotas exigem autenticação e são isoladas pela conta (accountId) do token.


Rotas​

MétodoRotaPermissãoDescrição
POST/pre-consultationscreate_preconsultationsCria uma pré-consulta
GET/pre-consultations/{id}read_preconsultationsBusca uma pré-consulta
GET/pre-consultations/patient/{patientId}/lastread_preconsultationsPré-consulta mais recente do paciente
PATCH/pre-consultations/{id}update_preconsultationsAtualiza sinais vitais e motivo
DELETE/pre-consultations/{id}delete_preconsultationsExclui (soft delete)
GET/pre-consultations/{id}/audio-presigned-urlupdate_preconsultationsURL para enviar o áudio
PATCH/pre-consultations/{id}/audio-urlupdate_preconsultationsRegistra o áudio enviado
POST/pre-consultations/{id}/transcriptionupdate_preconsultationsTranscreve um áudio
POST/pre-consultations/{id}/extractupdate_preconsultationsExtrai campos estruturados de um texto
POST/pre-consultations/{id}/interviewupdate_preconsultationsInicia a entrevista guiada por IA
GET/pre-consultations/direct-upload/configcreate_preconsultations + update_preconsultationsRegras de upload de exames
POST/pre-consultations/{id}/direct-upload/initiateupdate_preconsultationsGera URLs de upload de exames
POST/pre-consultations/{id}/direct-upload/completeupdate_preconsultationsRegistra os exames enviados
POST/pre-consultations/{id}/direct-upload/abortupdate_preconsultationsAborta um upload multipart

Fluxo típico​

  1. Criar a pré-consulta com o patientId e os sinais vitais disponíveis.
  2. Registrar o relato: enviar o áudio (URL pré-assinada → PUT no storage → salvar URL), transcrever e extrair os campos do texto para preencher o formulário.
  3. Anexar exames que o paciente trouxe pelo upload direto.
  4. Opcionalmente, iniciar a entrevista guiada por IA (exige consultationReason).
  5. Converter em consulta: Criar Consulta com preConsultationId. A pré-consulta passa a status: "CONVERTED" e os exames anexados são transferidos para a consulta e enviados para leitura (OCR).
Continua editável depois de convertida

A pré-consulta pode ser atualizada mesmo com status: "CONVERTED". Um paciente pode ter várias pré-consultas em aberto ao mesmo tempo.


Status​

ValorQuando
OPENEstado inicial, após a criação
CONVERTEDUma consulta foi criada a partir dela (preConsultationId)
DISCARDED não é usado

O enum do banco também tem DISCARDED, mas nenhuma rota grava esse valor — a exclusão só preenche deletedAt e mantém o status atual.