Pular para o conteúdo principal
Um Smart Template (medicalRecordConfiguration) define o prontuário que a sua consulta produz: um mapa de seções, onde cada seção é um node com um schema de saída e uma estratégia de prompt.
Prefira Smart Templates com nodes Telepatia. Esse é o caminho recomendado: você controla o formato da saída orientado ao EMR, a Telepatia mantém os prompts médicos curados por trás de cada node. Templates de Sessão (scribeSessionConfigurationId) continuam suportados para integrações legadas.

Ciclo de vida

  1. Defina as seções (nodes) que você precisa — veja Nodes.
  2. Crie via POST /v1/medical-record-configurations. A Telepatia faz hash do conteúdo; configurações idênticas retornam o mesmo id com created: false (idempotente).
  3. Referencie em POST /v1/set-consultation-context usando um dos dois campos abaixo.

Três formas de anexar um template a uma sessão

ModoCampo no set-consultation-contextQuando usar
Smart Template inlinemedicalRecordConfigurationEnvie o JSON completo a cada sessão. A Telepatia persiste e deduplica automaticamente por hash de conteúdo. Recomendado para fluxos guiados pelo cliente.
Smart Template por idmedicalRecordConfigurationIdVocê já criou via POST /v1/medical-record-configurations e quer reutilizar o id.
Template de SessãoscribeSessionConfigurationIdFluxos curados legados.
Passe exatamente um dos três. Um futuro campo scribeTemplates aceitará qualquer um dos dois tipos de id — nenhuma quebra de contrato planejada nas variantes atuais.

Criar um Smart Template

curl -X POST https://scribe-api.telepatia.ai/v1/medical-record-configurations \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "General Consultation",
    "configuration": {
      "chiefComplaint": {
        "instructionSet": { "telepatiaPromptId": "CHIEF_COMPLAINT" },
        "schema": {
          "type": "object",
          "instructions": "Chief complaint",
          "properties": {
            "chiefComplaint": { "type": "string", "instructions": "Patient words" }
          }
        }
      }
    }
  }'
Resposta:
{
  "id": "mrc_a1b2c3d4e5f6g7h8",
  "hash": "sha256:…",
  "createdAt": "2026-06-02T10:00:00Z",
  "created": true
}

Listar Smart Templates

curl https://scribe-api.telepatia.ai/v1/medical-record-configurations \
  -H "Authorization: Bearer SUA_CHAVE_API"

Buscar um Smart Template por id

curl https://scribe-api.telepatia.ai/v1/medical-record-configurations/mrc_a1b2c3d4e5f6g7h8 \
  -H "Authorization: Bearer SUA_CHAVE_API"

Próximos passos