Uma sessão de scribe é criada quando um médico realiza uma consulta através da interface da Telepatia. Quando a sessão é finalizada, aqui você consulta o ciclo de vida e os metadados da consulta, e em seguida busca o registro preenchido no endpoint de Documentos de Registro Médico.
Ciclo de vida da sessão
Uma sessão passa por vários estados. Os valores abaixo são retornados literalmente no campo status.
| Status | Fase | Descrição |
|---|
created | em andamento | Sessão aberta, gravação ainda não começou |
recording | em andamento | O médico está gravando ativamente a consulta |
stopped | em andamento | Gravação encerrada; o áudio está sendo enviado e colocado na fila para processamento |
processing | em andamento | Pipeline de IA (transcrição + geração do registro) rodando |
completed | pronto | Pipeline finalizado — os documentos estão disponíveis |
completedWithErrors | pronto | Pipeline finalizado com erros não fatais — os documentos continuam disponíveis |
reviewed | pronto | O médico revisou e finalizou o registro |
error | terminal | Erro fatal no processamento — nenhum documento será produzido |
cancelled | terminal | O usuário cancelou a sessão |
unknown | — | Valor padrão quando o estado upstream não é reconhecido |
Recuperar uma sessão
Use o consultationInternalId que você forneceu (ou recebeu) ao configurar o contexto de consulta:
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
-H "Authorization: Bearer SUA_CHAVE_API"
{
"id": "session-abc-123",
"status": "completed",
"createdAt": "2026-02-20T10:00:00Z",
"completedAt": "2026-02-20T10:30:00Z",
"patientName": "John Doe",
"scribeSessionModality": "IN_PERSON",
"consultationInternalId": "CONSULT-12345",
"specialty": "Cardiology"
}
Enquanto status estiver em andamento (created, recording, stopped, processing), faça polling nesse endpoint até chegar a um estado pronto (completed, completedWithErrors, reviewed) antes de buscar o registro preenchido. error e cancelled são estados terminais — nenhum documento será produzido.
Recuperar o registro preenchido
Este endpoint retorna apenas o ciclo de vida e os metadados da consulta. O registro preenchido — a saída dos templates da sessão, com todas as seções — é obtido separadamente no endpoint de documentos de registro médico, usando o mesmo consultationInternalId:
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents \
-H "Authorization: Bearer SUA_CHAVE_API"
purpose — ex.: primary para o registro do médico, rpa para injeção no EMR). Filtre com ?purpose=primary para obter apenas o principal. Veja Documentos de Registro Médico para o formato completo da resposta e a referência de campos. 
