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étodo | Rota | Permissão | Descrição |
|---|---|---|---|
POST | /pre-consultations | create_preconsultations | Cria uma pré-consulta |
GET | /pre-consultations/{id} | read_preconsultations | Busca uma pré-consulta |
GET | /pre-consultations/patient/{patientId}/last | read_preconsultations | Pré-consulta mais recente do paciente |
PATCH | /pre-consultations/{id} | update_preconsultations | Atualiza sinais vitais e motivo |
DELETE | /pre-consultations/{id} | delete_preconsultations | Exclui (soft delete) |
GET | /pre-consultations/{id}/audio-presigned-url | update_preconsultations | URL para enviar o áudio |
PATCH | /pre-consultations/{id}/audio-url | update_preconsultations | Registra o áudio enviado |
POST | /pre-consultations/{id}/transcription | update_preconsultations | Transcreve um áudio |
POST | /pre-consultations/{id}/extract | update_preconsultations | Extrai campos estruturados de um texto |
POST | /pre-consultations/{id}/interview | update_preconsultations | Inicia a entrevista guiada por IA |
GET | /pre-consultations/direct-upload/config | create_preconsultations + update_preconsultations | Regras de upload de exames |
POST | /pre-consultations/{id}/direct-upload/initiate | update_preconsultations | Gera URLs de upload de exames |
POST | /pre-consultations/{id}/direct-upload/complete | update_preconsultations | Registra os exames enviados |
POST | /pre-consultations/{id}/direct-upload/abort | update_preconsultations | Aborta um upload multipart |
Fluxo típico
- Criar a pré-consulta com o
patientIde os sinais vitais disponíveis. - Registrar o relato: enviar o áudio (URL pré-assinada →
PUTno storage → salvar URL), transcrever e extrair os campos do texto para preencher o formulário. - Anexar exames que o paciente trouxe pelo upload direto.
- Opcionalmente, iniciar a entrevista guiada por IA (exige
consultationReason). - Converter em consulta: Criar Consulta com
preConsultationId. A pré-consulta passa astatus: "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
| Valor | Quando |
|---|---|
OPEN | Estado inicial, após a criação |
CONVERTED | Uma 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.