Visão Geral da Entrevista da Triagem
A entrevista da triagem é uma conversa guiada por IA, conduzida pelo profissional que está com o paciente. A cada turno o assistente formula uma pergunta a partir do caso — queixa, sinais vitais, exames já lidos, atendimentos anteriores e a conversa até ali —, o profissional registra a resposta, e o assistente decide se pergunta mais ou se já tem o suficiente. Com o consentimento do paciente, o áudio da conversa é gravado (LiveKit) e, ao final, vira um resumo clínico.
Base
https://api-dev.imagemais.com.br/api/triages/{id}/interview
A entrevista pertence a uma triagem e exige que ela tenha o motivo (consultationReason) preenchido.
Esta é a entrevista por voz, turno a turno. A rota POST /triages/{id}/interview (sem /start) é outra coisa: cria uma sessão do Assistente Virtual, em que o paciente responde por texto a um plano de perguntas.
Fluxo típico
- Opcionalmente, conferir o que o assistente vai receber com Contexto da Entrevista — paciente, queixa, vitais e resumos dos exames. Funciona antes de abrir a entrevista.
- Abrir a entrevista informando
recordingConsent. A resposta traz a sala e o token do LiveKit (para o áudio) e o primeiro turno, com a pergunta de abertura já formulada a partir do caso. Chamar de novo com uma entrevista em andamento devolve a mesma, sem abrir outra sala. - Para cada turno, Responder Turno com a
positiondo turno atual e a resposta do paciente. A resposta traznextAction:next_turn— há uma nova pergunta emturn;end— o assistente considerou que já tem o suficiente e a entrevista foi encerrada.
- O profissional pode encerrar antes com Encerrar Entrevista.
- O resumo clínico é gerado sozinho quando a gravação termina. Buscar Entrevista traz os turnos, o resumo e o estado da gravação; Refazer Resumo gera o resumo de novo.
Não há teto de turnos: quem decide o fim é o assistente (ou o profissional). Se a geração de uma pergunta falhar — ou o assistente repetir uma pergunta já feita —, o turno entra com um texto de apoio e source: "SUPPORT", devolvendo a condução ao profissional.
Estados
Entrevista (status)
| Valor | Quando |
|---|---|
IN_PROGRESS | Aberta, recebendo turnos |
FINISHED | Encerrada pelo assistente ou pelo profissional |
ABANDONED | A sala de áudio fechou com a entrevista ainda aberta (aba fechada, queda de rede) |
Motivo do encerramento (finishReason)
| Valor | Quando |
|---|---|
SUFFICIENT | O assistente declarou que já tem o necessário (encerramento normal) |
MANUAL | O profissional encerrou |
ABANDONED | A sala fechou antes de alguém encerrar |
COVERAGE, TURN_LIMIT | Legado — só aparecem em entrevistas antigas |
Gravação (recordingState)
| Valor | Quando |
|---|---|
DISABLED | Sem consentimento (ou gravação desligada) — ausência esperada, não é falha |
PENDING | Sala criada, gravação ainda não começou |
RECORDING | Gravando |
UPLOADING | Enviando o arquivo ao storage |
STORED | Áudio salvo |
FAILED | A gravação falhou |
Origem da pergunta (source do turno): AI quando o assistente formulou a pergunta; SUPPORT quando entrou o texto de apoio.
Rotas
| Método | Rota | Permissão | Descrição |
|---|---|---|---|
GET | /triages/{id}/interview/context | read_triages | O que o assistente recebe |
POST | /triages/{id}/interview/start | update_triages | Abre a entrevista |
POST | /triages/{id}/interview/turn | update_triages | Responde o turno atual |
POST | /triages/{id}/interview/finish | update_triages | Encerra a entrevista |
POST | /triages/{id}/interview/summary | update_triages | Refaz o resumo clínico |
GET | /triages/{id}/interview | read_triages | Turnos, resumo e gravação |