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

# Início rápido

> Das chaves à sua primeira nota gravada

## Configuração (uma vez, via Scribe API)

Faça isto uma vez por médico através da [Scribe API (institucional)](https://docs.telepatia.ai/scribe-api-institutional/institutional/create-a-doctor-account),
usando sua chave de API institucional. Não tem uma? Fale com seu contato na Telepatia.

<Steps>
  <Step title="Registre o médico — salve ambas as chaves">
    [Crie uma conta de médico](https://docs.telepatia.ai/scribe-api-institutional/institutional/create-a-doctor-account). A resposta retorna duas chaves, exibidas uma única vez: a `publishableApiKey` (`pk_…`) vai na página; a `apiKey` (`sk_…`) é o segredo — apenas no backend, nunca no navegador.
  </Step>

  <Step title="Crie um smart template — salve o id dele">
    [Crie um smart template](https://docs.telepatia.ai/scribe-api-institutional/medical-record-configurations/create-a-smart-template). Salve o id `mrc_…` retornado; você o passa para o `init()`.
  </Step>

  <Step title="Crie um webhook">
    [Assine](https://docs.telepatia.ai/scribe-api-institutional/webhooks/create-a-webhook-subscription) o evento `scribe_session.completed`. Salve o `signingSecret` para verificar as chamadas. É assim que o seu backend fica sabendo que uma nota está pronta.
  </Step>
</Steps>

## Adicione o script

Coloque o bloco de configuração antes da tag da CDN. Sirva a página sobre `https`
ou `localhost` — o microfone precisa de um contexto seguro.

```html theme={null}
<script>
  window.TelepatiaRecorderConfig = {
    apiKey: "pk_…",              // chave publicável — nunca a sk_
    branding: { name: "Your Brand" },
    locale: "en",                // "en" · "es" · "pt"
  };
</script>
<script src="https://cdn.telepatia.ai/telepatia-embed/v0/embed.js"></script>
```

Use uma chave de teste enquanto desenvolve (sem dados reais) e sua chave de
produção para ir ao ar. Mesmo código, sem flag de ambiente.

## Abra o painel

Chame `init()` quando o médico clicar em gravar — ele monta e abre o painel.
Passe o contexto que seu app já possui (o paciente e o template do médico) para
que a nota volte vinculada à consulta correta.

```js theme={null}
document.getElementById("record").addEventListener("click", () => {
  window.TelepatiaRecorder.init({
    patient:      { name: "Maria Gómez", idCountry: "CO", idType: "CC", idValue: "55544433" },
    template:     { medicalRecordConfigurationId: "mrc_…" },
    consultation: { externalConsultationId: "CONSULT-12345" }, // o id do seu atendimento
  });
});
```

<Warning>
  Sempre passe seu próprio `externalConsultationId` — é assim que você busca o
  resultado depois. Sem ele, a Telepatia gera um que você não consegue ver. E use
  `init()` para abrir: `show()` só expande um painel que já está montado.
</Warning>

## Obtenha o resultado

Seu `externalConsultationId` é o `consultationInternalId` da Scribe API —
mesmo valor, nome diferente. Quando o webhook `scribe_session.completed` disparar,
busque o registro no seu backend com a chave secreta (`sk_`), nunca no navegador:

* [Consulte a sessão](https://docs.telepatia.ai/scribe-api-institutional/session-scribes/look-up-scribe-session) — `GET /v1/scribe-sessions/{consultationInternalId}`
* [Liste os documentos do registro](https://docs.telepatia.ai/scribe-api-institutional/medical-record-documents/list-medical-record-documents) — `GET /v1/scribe-sessions/{consultationInternalId}/medical-record-documents`

O schema completo do registro e o formato de erro ficam no produto **Scribe API**
neste Hub.