Visão Geral
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.
Criar Pré-consulta
Cria uma pré-consulta para um paciente, independente de já existir uma consulta. Nasce com status: "OPEN".
Buscar Pré-consulta por ID
Retorna uma pré-consulta da conta.
Buscar Última Pré-consulta do Paciente
Retorna a pré-consulta mais recente (por createdAt) de um paciente, em qualquer status. Um paciente pode ter várias pré-consultas em aberto; esta rota devolve só a última.
Atualizar Pré-consulta
Atualiza os sinais vitais e/ou o motivo da consulta. Apenas os campos enviados são alterados. Continua editável mesmo depois de a pré-consulta virar consulta (status: "CONVERTED").
Deletar Pré-consulta
Exclui uma pré-consulta (soft delete — o registro é mantido com deletedAt preenchido e some das buscas).
Gerar URL Pré-assinada para Áudio
Gera uma URL pré-assinada para o cliente enviar o áudio do relato diretamente ao storage (Cloudflare R2), sem passar pelo backend.
Salvar URL do Áudio
Registra o áudio enviado ao storage como arquivo da pré-consulta. Cada chamada cria um novo arquivo (a pré-consulta pode ter vários áudios).
Transcrever Áudio
Envia um áudio para transcrição por IA e devolve o texto. É o ponto único de transcrição da pré-consulta. O áudio não é salvo nem vinculado à pré-consulta — para isso use o fluxo de Salvar URL do Áudio.
Extrair Campos do Texto
Pede à IA que transforme um texto livre (normalmente a transcrição do relato) em um objeto JSON com os campos desejados. A rota não grava nada na pré-consulta — o cliente usa o resultado para preencher o formulário e depois chama Atualizar Pré-consulta.
Iniciar Entrevista Guiada por IA
Cria uma sessão do assistente de entrevista a partir dos sinais vitais e do motivo da consulta já salvos na pré-consulta, e vincula a sessão à pré-consulta. A IA gera o plano de perguntas (e, quando identifica uma especialidade pelo motivo, acrescenta perguntas específicas); a sessão já começa no estado ASKING_QUESTION.
Configuração do Upload de Exames
Retorna as regras do upload direto de exames — use como fonte de verdade para validar os arquivos no cliente antes de enviar.
Iniciar Upload Direto de Exames
Gera URLs pré-assinadas para o cliente enviar os exames do paciente diretamente ao storage (Cloudflare R2). Arquivos até 10 MB recebem uma única URL (mode "multipart").
Completar Upload Direto de Exames
Finaliza o upload: completa as sessões multipart, confere o conteúdo de cada arquivo, registra os arquivos e os vincula à pré-consulta.
Abortar Upload Direto de Exames
Descarta as partes já enviadas de uma sessão de upload multipart. Use quando o usuário cancelar o envio de um arquivo grande. Uploads single não precisam ser abortados — basta não completá-los.