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 mesmoid 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:
Edições do médico
OmedicalRecord é 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 atranscript 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, emmedicalRecord.<sectionKey>.<fieldKey>. As chaves são as que você definiu no template. - Formato: a string
valueexatamente como você a definiu. Um campo de seleção múltipla (umarraycujositemstêmenum) retorna uma lista de stringsvalue. Um campo sem resposta na consulta retornanull, ou o seudefaultquando você o define. - Como a Telepatia seleciona: o modelo lê
transcript.text, recebe a lista de pareslabelevaluedo campo e seleciona as opções cujolabelcorresponde ao que o médico e o paciente disseram. O registro guarda só ovalue, então você pode mudar ou traduzir umlabele a sua integração continua recebendo o mesmo código.
Códigos de diagnóstico
Cada documento inclui seusdiagnosisCodes — 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.
Alertas de CDSS
Quando o suporte à decisão clínica está habilitado para a sessão, cada documento inclui seuscdssAlerts — 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: