Inicio rápido - Telepatia Integration Hub

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

Hazlo una vez por médico con la Scribe API (institucional), con tu llave institucional. ¿No tienes una? Pídesela a tu contacto de Telepatia.

Registra al médico — guarda ambas llaves

Crea una cuenta de médico. La respuesta devuelve dos llaves, mostradas una sola vez: publishableApiKey (pk_…) va en la página; apiKey (sk_…) es la secreta — solo backend, nunca el navegador.

Crea una smart template — guarda su id

Crea una smart template. Guarda el id mrc_… devuelto; lo pasas a init().

Crea un webhook

Suscríbete a scribe_session.completed. Guarda el signingSecret para verificar las llamadas. Así tu backend se entera de que una nota está lista.

Suma el script

Pon 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. El embed lee window.TelepatiaEmbedConfig al cargar y se monta solo.

<script>
  window.TelepatiaEmbedConfig = {
    apiKey: "pk_…",                       // publishable key — never the sk_
    settings: { locale: "en", branding: { name: "Your Brand" } },
    scribeContext: { show: true },        // Scribe: record + note
    intelligence:  { show: true },        // Telepatia Intelligence copilot
    cdss:          { show: true },        // CDSS review on the finished note
  };
</script>
<script src="https://cdn.telepatia.ai/telepatia-embed/v1/telepatia-embed.js"></script>

Cada capability se renderiza solo cuando tu institución la tiene habilitada, así que dejar un flag encendido es seguro. Usa una llave de prueba mientras construyes (sin datos reales) y tu llave de producción para salir en vivo — el mismo código, sin flag de entorno.

Abre el panel

El embed expone window.TelepatiaEmbed. Llama a init() cuando el médico haga clic en grabar — monta y abre el panel. Pasa el contexto que tu app ya tiene para que la nota vuelva ligada a la consulta correcta.

document.getElementById("record").addEventListener("click", () => {
  window.TelepatiaEmbed.init({
    patient:      { name: "Maria Gómez", idCountry: "CO", idType: "CC", idValue: "55544433" },
    template:     { medicalRecordConfigurationId: "mrc_…" },
    consultation: { externalConsultationId: "CONSULT-12345" }, // your encounter id
  });
});

Pasa siempre tu propio externalConsultationId — es como obtienes el resultado después. Sin él, Telepatia genera uno que no puedes ver. init() también abre el panel; un TelepatiaEmbedConfig sin init() monta directamente una capability sin grabador.

Obtén el resultado

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

Busca la sesión — GET /v1/scribe-sessions/{consultationInternalId}
Lista los documentos del registro — GET /v1/scribe-sessions/{consultationInternalId}/medical-record-documents

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

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

​Suma el script

​Abre el panel

​Obtén el resultado

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

Suma el script

Abre el panel

Obtén el resultado