Saltar al contenido principal
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 salvo apiKey: 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.
No uses un id fijo, tampoco en tus pruebas. La segunda grabación con el mismo id muestra la pantalla.

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 en init().
Cuando el médico inicia la consulta, la tarjeta muestra tu historia. En cada consulta, llama a 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:
  1. Desde tu backend, llama a set consultation context con la clave secreta del médico (sk_…, el par de la pk_… de tu página). Pon la historia en pastMedicalHistory.
  2. Abre el embed para la misma consulta y el mismo paciente: consultation.externalConsultationId es el consultationInternalId que enviaste, y patient.idCountry · idType · idValue es la identidad que enviaste.
  3. Cuando el médico inicia la consulta, la tarjeta muestra tu historia.
Si envías una historia por los dos caminos, gana la de 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 en init({ 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:
Los errores de obtención del backend usan el formato estándar de Telepatia — según el 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.