Pular para o conteúdo principal
Uma sessão de scribe pode produzir um ou mais documentos de registro médico — um por purpose (ex.: primary para o registro do médico, rpa para injeção no EMR). Cada documento é a saída preenchida dos templates de sessão.

Listar os documentos

Use o mesmo id de sessão que você usou com o endpoint de sessão de scribe — seu consultationInternalId ou o id da sessão (ss_...) que a API retorna:
Resposta:

Edições do médico

O medicalRecord é o prontuário que o médico tem no Scribe, incluindo o texto que ele digitou ou ditou depois que a IA o gerou. Quando o médico edita um prontuário finalizado, a Telepatia envia um webhook scribe_session.updated; consulte os documentos de novo para ler o texto novo e compare updatedAt para saber que o prontuário mudou. Os items não chegam em uma ordem garantida de purpose. Selecione o prontuário de que precisa pelo seu purpose (primary é o prontuário da consulta), não pela sua posição na lista.

Transcrição

A resposta traz a transcript da sessão ao lado de items: uma transcrição por sessão, a mesma para todos os documentos. transcript.text é a transcrição completa da consulta em texto simples: o texto que a Telepatia leu para preencher os registros. transcript.updatedAt indica quando a transcrição armazenada mudou pela última vez. transcript é null nestes casos. Uma transcript null não muda os documentos: a resposta os retorna do mesmo jeito.

Códigos de seletores

Um campo do template pode limitar a resposta a uma lista de opções, como um seletor do seu EMR. Cada opção é um par { label, value } no enum do campo (veja Opções de enum): o label é o texto que uma pessoa lê, e o value é o seu código para a opção (por exemplo, o id da opção no catálogo do seu EMR).
  • Onde: o código é o valor do campo em medicalRecord, em medicalRecord.<sectionKey>.<fieldKey>. As chaves são as que você definiu no template.
  • Formato: a string value exatamente como você a definiu. Um campo de seleção múltipla (um array cujos items têm enum) retorna uma lista de strings value. Um campo sem resposta na consulta retorna null, ou o seu default quando você o define.
  • Como a Telepatia seleciona: o modelo lê transcript.text, recebe a lista de pares label e value do campo e seleciona as opções cujo label corresponde ao que o médico e o paciente disseram. O registro guarda só o value, então você pode mudar ou traduzir um label e a sua integração continua recebendo o mesmo código.

Códigos de diagnóstico

Cada documento inclui seus diagnosisCodes — os códigos de diagnóstico ICD-10 (CIE-10 / CID-10), como o conjunto curado pelo médico (as sugestões do modelo mais os códigos que o médico adicionou, menos os que removeu). Cada entrada tem um type de primary ou secondary. A lista fica vazia quando a sessão não tem códigos de diagnóstico. As condições médicas pregressas carregam seus próprios códigos resolvidos em medicalRecordSummaryStructured.pastMedicalConditionsCoded: cada entrada associa o content da condição a um objeto code contendo o code de melhor correspondência e as options com pontuação. É null até que a resolução de códigos tenha sido executada para o registro.
Aguarde até que o status da sessão seja completed ou completedWithErrors (veja Ciclo de vida da sessão) antes de buscar seus documentos — eles só são produzidos depois que o pipeline de IA termina.

Alertas de CDSS

Quando o suporte à decisão clínica está habilitado para a sessão, cada documento inclui seus cdssAlerts — alertas corretivos que sinalizam omissões, dosagens incorretas ou condutas não pertinentes no registro. Cada alerta tem um id opaco e estável (use-o como está; não faça parsing), o elementId clínico ao qual se refere, um actionCategory (add | remove | replace | modify), uma severity (red | orange | yellow) e um status que reflete a decisão do médico (pending | accepted | rejected). É null quando o CDSS está desabilitado para a sessão ou nenhum alerta foi gerado, e [] quando executou e não produziu nenhum. Veja Suporte à decisão clínica para o modelo completo do alerta.

Filtrar por purpose

Passe ?purpose=primary para obter apenas o documento do médico. Outros valores válidos incluem rpa (para injeção no EMR) e emr.

Referência de campos

A resposta também tem estes campos ao lado de items: