window.TelepatiaEmbedConfig (leído al cargar) y TelepatiaEmbed.init() toman
la misma forma; init() gana cuando ambos definen un campo. Todo es opcional
salvo la publishable key y, con Scribe, el ID de la consulta.
Configuración rápida
El bloque mínimo para salir en vivo: la llave, un locale, tu marca y las capabilities que quieras. Cada capability se renderiza solo cuando tu institución la tiene habilitada.Configuración completa
Todos los campos, anotados. Todos son opcionales salvoapiKey: sin ella,
init() lanza un error y no monta nada. Con Scribe,
consultation.externalConsultationId también es obligatorio: sin él, init()
no lanza un error, y el panel muestra una pantalla de error. Los valores por
defecto mostrados son los que usa el embed cuando omites un campo.
Campos de configuración
Capabilities
Cada capability es un flag{ show }. Lo que se monta es show Y el permiso
de la institución, así que un flag sin permiso no renderiza nada.
Sin
scribeContext, el embed monta una superficie sin grabador (CDSS y/o
Telepatia Intelligence) sin motor de audio en su grafo. intelligence.documents
agrega una sub-pestaña Documentos dentro del copiloto.
Un id de sesión en cdss.scribeSessionId o en intelligence.chat.recentConsultations[].id
es el id ss_… que devuelven la API pública y los webhooks. Un UUID de sesión
también funciona.
El ID de la consulta
Con Scribe,consultation.externalConsultationId es obligatorio. Es tu id de la
consulta, y con él obtienes el resultado. Cada id tiene una sola grabación, así
que envía un id nuevo para cada consulta.
El embed revisa el id cuando el panel se abre. Si falta el id, si tiene un punto
(.), u otra grabación ya lo usa, el panel muestra solo una pantalla con “Hay un problema con el
identificador de esta consulta.” y “Contacta al soporte de TI de tu
institución.” El médico no puede iniciar una grabación, y las otras pestañas no
se muestran.
init() no lanza un error cuando falta el id: se muestra la pantalla. La
consola del navegador recibe una línea que empieza con [Telepatia Embed]. La
misma pantalla se muestra cuando el médico abre de nuevo una consulta que ya
tiene una grabación. Para grabarla de nuevo, abre el embed con un id nuevo.
Sincroniza los campos de tu EMR
Indica al embed los campos de notas y de historia clínica de la página de tu EMR. El embed los mantiene iguales a sus propias Notas e Historia clínica del paciente, en ambos sentidos: lo que el médico escribe en tu página aparece en el embed, y lo que escribe en el embed aparece en tu página. No escribes código de DOM.El embed ve lo que una persona escribe en tu campo. Si tu propio código cambia el
valor del campo sin un evento
input, el embed lee ese valor solo al iniciar y en
cada nueva consulta. Para un campo dentro de un shadow root cerrado, pasa el
elemento, no un selector. bind necesita scribeContext: { show: true }.Envía la historia clínica del paciente
La tarjeta Historia clínica del paciente muestra al médico lo que ya sabes del paciente, y Telepatia la lee cuando escribe la nota. Para llenarla, pásala eninit().
destroy() y luego a init() con la historia de ese
paciente. El embed guarda la historia solo para ese init(): no la guarda en el
navegador, y la consulta siguiente nunca la muestra.
O envíala desde tu backend
Si tu backend ya tiene la historia, puede enviarla en su lugar:- Desde tu backend, llama a set consultation context
con la clave secreta del médico (
sk_…, el par de lapk_…de tu página). Pon la historia enpastMedicalHistory. - Abre el embed para la misma consulta y el mismo paciente:
consultation.externalConsultationIdes elconsultationInternalIdque enviaste, ypatient.idCountry · idType · idValuees la identidad que enviaste. - Cuando el médico inicia la consulta, la tarjeta muestra tu historia.
init(). Un
pastMedicalHistory vacío en init() mantiene la que envió tu backend.
Envía el contexto una vez por consulta, antes de que el médico abra el embed. Si
envías
scribeSessionModality, la consulta la toma. La plantilla es siempre la de
init() o la elección del médico, nunca una enviada con el contexto.Combina con tu sitio
settings.theme acepta una paleta. El embed pinta con una escala de marca y una
escala neutra. Da un color para cada una (el embed mezcla los otros tonos a
partir de él) o los tonos que ya usas. La paleta reemplaza el CSS que inyectas
en el shadow root: quita ese CSS.
Con una paleta, el ícono del botón de enviar toma negro o blanco, el que se lee mejor sobre tu marca. Sin paleta, mantiene los colores por defecto.
Con
intelligence.fillPhone, por debajo de 640 px el panel llena la pantalla
en todos los layouts, también inline. El campo de texto queda sobre el
teclado. El panel evita el notch y el indicador de inicio cuando tu página
define viewport-fit=cover. Sin él, nada cambia en un teléfono.
Métodos de TelepatiaEmbed
Tras montar el panel, un nuevo
init() aplica solo open, callbacks e
intelligence.onAnswer · onCitationOpen; los demás campos toman efecto
después de destroy() y luego init().
Sin Scribe, init() devuelve un handle:
Callbacks y errores
Regístralos eninit({ callbacks }): onSessionStart(id),
onSessionComplete(event), onError(message), onStateChange(state). El
onSessionComplete del navegador es opcional — el webhook es el disparador
confiable. Ante un problema con el ID de la consulta, onError recibe
"externalConsultationIdMissing", "externalConsultationIdInvalid" o "externalConsultationIdAlreadyUsed" (ve
El ID de la consulta). Las señales de salud disparan
en window:
code: authentication_required (401, llave inválida o expirada),
resource_not_found (404, id equivocado u obtenido muy pronto),
resource_conflict (409, id reusado), rate_limit_exceeded (429). La tabla
completa está en la página de errores de la Scribe API.