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

# Inicio rápido

> De las claves a tu primera nota grabada

## Configuración (una vez, vía la Scribe API)

Haz esto una vez por médico a través de la [Scribe API (institucional)](https://docs.telepatia.ai/scribe-api-institutional/institutional/create-a-doctor-account),
con tu API key institucional. ¿No tienes una? Pídesela a tu contacto en Telepatia.

<Steps>
  <Step title="Registra al médico — guarda ambas claves">
    [Crea una cuenta de médico](https://docs.telepatia.ai/scribe-api-institutional/institutional/create-a-doctor-account). La respuesta devuelve dos claves, mostradas una sola vez: `publishableApiKey` (`pk_…`) va en la página; `apiKey` (`sk_…`) es la secreta — solo backend, nunca el navegador.
  </Step>

  <Step title="Crea una plantilla inteligente — guarda su id">
    [Crea una plantilla inteligente](https://docs.telepatia.ai/scribe-api-institutional/medical-record-configurations/create-a-smart-template). Guarda el id `mrc_…` devuelto; se lo pasas a `init()`.
  </Step>

  <Step title="Crea un webhook">
    [Suscríbete](https://docs.telepatia.ai/scribe-api-institutional/webhooks/create-a-webhook-subscription) a `scribe_session.completed`. Guarda el `signingSecret` para verificar las llamadas. Así se entera tu backend de que una nota está lista.
  </Step>
</Steps>

## Agrega el script

Coloca el bloque de configuración antes de la etiqueta del CDN. Sirve la página por
`https` o `localhost` — el micrófono necesita un contexto seguro.

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

Usa una clave de prueba mientras desarrollas (sin datos reales) y tu clave de
producción para salir a producción. Mismo código, sin flag de entorno.

## Abre el panel

Llama a `init()` cuando el médico haga clic en grabar — monta y abre el panel.
Pasa el contexto que tu app ya tiene (el paciente y la plantilla del médico) para
que la nota vuelva enlazada a la consulta correcta.

```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" }, // tu id de encuentro
  });
});
```

<Warning>
  Siempre pasa tu propio `externalConsultationId` — es como obtienes el resultado
  después. Sin él, Telepatia genera uno que no puedes ver. Y usa `init()` para
  abrir: `show()` solo expande un panel que ya está montado.
</Warning>

## Obtén el resultado

Tu `externalConsultationId` es el `consultationInternalId` de la Scribe API —
mismo valor, distinto nombre. Cuando el webhook `scribe_session.completed` se
dispara, obtén el registro en tu backend con la clave secreta (`sk_`), nunca el navegador:

* [Consulta la sesión](https://docs.telepatia.ai/scribe-api-institutional/session-scribes/look-up-scribe-session) — `GET /v1/scribe-sessions/{consultationInternalId}`
* [Lista los documentos del registro](https://docs.telepatia.ai/scribe-api-institutional/medical-record-documents/list-medical-record-documents) — `GET /v1/scribe-sessions/{consultationInternalId}/medical-record-documents`

El esquema completo del registro y el formato de errores viven en el producto
**Scribe API** dentro de este Hub.