Smart Templates

Um Smart Template (medicalRecordConfiguration) define o prontuário que a sua consulta produz: um mapa de seções, onde cada seção tem um schema de saída e uma estratégia de prompt.

Prefira Smart Templates com Seções 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 seção. Templates de Sessão (scribeSessionConfigurationId) continuam suportados para integrações legadas.

Ciclo de vida

Defina as seções que você precisa — veja Seções.
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).
Referencie em POST /v1/set-consultation-context usando um dos dois campos abaixo.

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

Modo	Campo no `set-consultation-context`	Quando usar
Smart Template inline	`medicalRecordConfiguration`	Envie 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 id	`medicalRecordConfigurationId`	Você já criou via `POST /v1/medical-record-configurations` e quer reutilizar o id.
Template de Sessão	`scribeSessionConfigurationId`	Fluxos 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",
  "name": "General Consultation",
  "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"

Excluir um Smart Template

Exclui logicamente (soft-delete) um template pelo seu id público. Retorna 204 No Content e sai da lista padrão; as consultas históricas que o referenciaram não são afetadas. A exclusão é bloqueada com 409 enquanto uma sessão vinculada ainda está processando, e retorna 404 se o id não for encontrado.

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

Status do template

As respostas de listagem e detalhe expõem um status por template:

Status	Significado
`active`	Ativo e utilizável em uma consulta.
`inactive`	Arquivado — não oferecido por padrão.
`deleted`	Excluído logicamente; mantido apenas para referência histórica.

Templates excluídos saem da lista padrão. Use o parâmetro de consulta ?status para mudar a visão:

`?status`	Retorna
(omitido)	Apenas templates não excluídos (padrão).
`deleted`	Apenas templates excluídos logicamente (visão de auditoria).
`all`	Templates não excluídos e excluídos.

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

Resposta:

{
  "items": [
    {
      "id": "mrc_a1b2c3d4e5f6g7h8",
      "name": "General Consultation",
      "hash": "sha256:…",
      "createdAt": "2026-06-02T10:00:00Z",
      "specialties": [],
      "status": "active"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}

Próximos passos

Seções — como os prompts são resolvidos por seção.
Catálogo de Prompts Telepatia — referência de telepatiaPromptId curados.
Referência de OutputSchema — tipos, exemplos, limites.

Primeiros Passos

Consultas

Sessões de Scribe

Suporte à Decisão Clínica

Webhooks

Templates de Sessão

Contas

Pacientes

Referência

Smart Templates

Ciclo de vida

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

Criar um Smart Template

Listar Smart Templates

Buscar um Smart Template por id

Excluir um Smart Template

Status do template

Próximos passos

​Ciclo de vida

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

​Criar um Smart Template

​Listar Smart Templates

​Buscar um Smart Template por id

​Excluir um Smart Template

​Status do template

​Próximos passos

Ciclo de vida

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

Criar um Smart Template

Listar Smart Templates

Buscar um Smart Template por id

Excluir um Smart Template

Status do template

Próximos passos