> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Templates

> Defina como a Telepatia gera o prontuário para as suas consultas

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.

<Tip>
  **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.
</Tip>

## Ciclo de vida

1. **Defina** as seções que você precisa — veja [Seções](/pt-BR/scribe-api/smart-templates-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

| 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.                                                                                                                                       |

<Note>
  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.
</Note>

## Criar um Smart Template

```bash theme={null}
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:**

```json theme={null}
{
  "id": "mrc_a1b2c3d4e5f6g7h8",
  "name": "General Consultation",
  "hash": "sha256:…",
  "createdAt": "2026-06-02T10:00:00Z",
  "created": true
}
```

## Listar Smart Templates

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/medical-record-configurations \
  -H "Authorization: Bearer SUA_CHAVE_API"
```

## Buscar um Smart Template por id

```bash theme={null}
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.

```bash theme={null}
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.                         |

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

**Resposta:**

```json theme={null}
{
  "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](/pt-BR/scribe-api/smart-templates-nodes) — como os prompts são resolvidos por seção.
* [Catálogo de Prompts Telepatia](/pt-BR/scribe-api/telepatia-nodes) — referência de `telepatiaPromptId` curados.
* [Referência de OutputSchema](/pt-BR/scribe-api/smart-templates-output-schema) — tipos, exemplos, limites.