Saltar al contenido principal

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

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

Crea una smart template — guarda su id

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

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

Si tu página define una Content-Security-Policy

El embed envía eventos de uso a https://posthog.telepatia.ai: los ids del médico y de la institución, cuándo se abre el panel y los errores. Envía sus propios registros de errores, con los mismos ids, a https://datadog.telepatia.ai. Nunca datos del paciente ni texto de la nota. Si tu página define una Content-Security-Policy, suma estos hosts a connect-src:
Si la política los bloquea, el embed funciona igual. Solo dejamos de ver el uso y los errores.

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.
Pasa siempre tu propio externalConsultationId, y uno nuevo para cada consulta — es como obtienes el resultado después. Si falta el id, u otra grabación ya lo usa, el panel muestra una pantalla que le dice al médico que contacte al soporte de TI de su institución, y no se inicia ninguna grabación. Ve El ID de la consulta. 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: El esquema completo del registro y el formato de error viven en el producto Scribe API de este Hub.