Reference - Telepatia Integration Hub

init() options

Grouped by topic; everything is optional. window.TelepatiaRecorderConfig (set before the script loads) accepts the same fields, and init() wins when both set one.

Field	Value
`settings.locale` · `settings.branding`	`"en"·"es"·"pt"` · name shown in the panel
`patient.name`	display name
`patient.idCountry · idType · idValue`	identity — registers the patient on start (e.g. `CO · CC · 55544433`)
`template.medicalRecordConfigurationId`	smart template (`mrc_…`)
`template.configurationDocumentId`	selected template (SSC)
`consultation.scribeSessionModality`	`"in-person"` · `"telemedicine"`
`consultation.externalConsultationId`	your encounter id — always pass it
`open` · `callbacks`	open the panel now · lifecycle callbacks

Endpoint overrides (baseUrl, data-*) exist for white-label setups only; you normally set nothing here.

TelepatiaRecorder methods

Method	Does
`init(config?)`	mounts and opens (overlay); collapsed in launcher mode unless `open: true`. Safe to call on every click.
`show()` / `hide()`	expand / collapse a panel that’s already mounted
`destroy()`	tears down the Shadow DOM
`version`	loaded bundle version (e.g. `"0.2.0"`)

After the panel mounts, a new init() applies only open and callbacks; other fields take effect after destroy() then init().

Callbacks and errors

Register them in init({ callbacks }): onSessionStart(id), onSessionComplete(event), onError(message), onStateChange(state). The browser onSessionComplete is optional — the webhook is the reliable trigger. Health signals fire on window:

window.addEventListener("telepatia-recorder-health", (e) => {
  // e.detail.type: "page-hidden" | "pagehide" | "microphone-denied"
});

Backend fetch errors use Telepatia’s standard format — switch on code: authentication_required (401, key invalid or expired), resource_not_found (404, wrong id or fetched too early), resource_conflict (409, id reused), rate_limit_exceeded (429). The full table is on the Scribe API errors page.