Pular para o conteúdo principal

​
Pré-requisitos

  • Uma chave de API da Telepatia (fale com seu gerente de conta para obtê-la)
  • A URL base (veja a visão geral)
Os exemplos abaixo usam a URL de produção.

​
Passo 0: Listar templates de sessão (opcional)

Os templates de sessão de scribe definem a estrutura da documentação médica produzida durante a consulta (ex. “Consulta de Cardiologia”, “Medicina Geral”). Buscar a lista antes da consulta permite apresentar um seletor de templates pro médico ou atribuir um automaticamente com base na especialidade. 
curl https://synapse.telepatia.ai/v1/scribe-session-configurations \
  -H "Authorization: Bearer SUA_CHAVE_API"
Resposta: 
{
  "items": [
    { "id": "ssc_a1b2c3d4e5f6g7h8", "name": "Consulta de Cardiologia" },
    { "id": "ssc_i9j0k1l2m3n4o5p6", "name": "Medicina Geral" }
  ],
  "total": 2,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}
Salve o id do template desejado — você vai passá-lo como scribeSessionConfigurationId no Passo 1.

​
Passo 1: Definir contexto da consulta

Antes da consulta, envie os dados do paciente pra Telepatia. Você deve incluir um consultationInternalId — esse é o seu identificador interno que vincula a sessão ao seu sistema. Se não enviar, a Telepatia vai gerar um automaticamente. Opcionalmente passe um scribeSessionConfigurationId (do Passo 0) pra pré-selecionar o template de documentação pra essa sessão. 
curl -X POST https://synapse.telepatia.ai/v1/set-consultation-context \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "idCountry": "CO",
    "idType": "CC",
    "idValue": "123456789",
    "notes": "Paciente relata dor de cabeça recorrente e tontura",
    "pastMedicalHistory": "Hipertensão diagnosticada em 2020. Diabetes Tipo 2 controlada com metformina.",
    "consultationInternalId": "CONSULT-12345",
    "scribeSessionModality": "IN_PERSON",
    "scribeSessionConfigurationId": "ssc_a1b2c3d4e5f6g7h8"
  }'
Resposta: 
{
  "success": true,
  "consultationInternalId": "CONSULT-12345"
}
Guarde o consultationInternalId da resposta. Você vai precisar dele nos próximos passos — tanto pra gerar o link de login quanto pra buscar os resultados da sessão depois.
Gere um código de verificação pra abrir o scribe da Telepatia. Passe o consultationInternalId pra que a sessão fique vinculada ao contexto da consulta que você definiu no Passo 1. 
curl -X POST https://synapse.telepatia.ai/v1/auth/login \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{"consultationInternalId": "CONSULT-12345"}'
Resposta: 
{
  "code": "a1b2c3d4e5",
  "expiresAt": "2026-02-20T18:30:00+00:00",
  "expiresIn": 300,
  "redirectUrl": "https://scribe.telepatia.ai/#/onboarding/sign-in?code=a1b2c3d4e5&consultationInternalId=CONSULT-12345"
}
Redirecione o usuário pra redirectUrl pra abrir o scribe da Telepatia.

​
Passo 3: Realizar a sessão

Quando o usuário for redirecionado, ele vai chegar na interface do scribe da Telepatia. A partir daí:
  1. O scribe começa a gravar a consulta
  2. O médico realiza o atendimento normalmente
  3. Ao terminar, o médico finaliza a sessão no scribe
Nenhuma chamada de API é necessária durante esse passo — tudo acontece no app da Telepatia.

​
Passo 4: Buscar a sessão de scribe

Depois que a sessão for finalizada, busque os resultados usando o consultationInternalId: 
curl https://synapse.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
  -H "Authorization: Bearer SUA_CHAVE_API"
Resposta: 
{
  "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",
  "medicalRecordMutable": {
    "chiefComplaint": {
      "title": "Chief Complaint",
      "type": "text",
      "status": "completed",
      "content": "Patient reports headache"
    }
  }
}
Se a sessão ainda estiver em andamento, o campo status vai refletir isso. Você pode consultar esse endpoint até que o status seja completed.