Inicio rápido - Telepatia Integration Hub

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

Haz esto una vez por médico a través de la Scribe API (institucional), con tu API key institucional. ¿No tienes una? Pídesela a tu contacto en Telepatia.

Registra al médico — guarda ambas claves

Crea una cuenta de médico. 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.

Crea una plantilla inteligente — guarda su id

Crea una plantilla inteligente. Guarda el id mrc_… devuelto; se lo pasas a init().

Crea un webhook

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

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.

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

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
  });
});

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.

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 — 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 errores viven en el producto Scribe API dentro de este Hub.

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

​Agrega el script

​Abre el panel

​Obtén el resultado

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

Agrega el script

Abre el panel

Obtén el resultado