Reference - Telepatia Integration Hub

window.TelepatiaEmbedConfig (read at load) and TelepatiaEmbed.init() take the same shape; init() wins when both set a field. Everything is optional except the publishable key.

Fast configuration

The minimal block to go live: the key, a locale, your brand, and the capabilities you want. Each capability renders only when your institution is also granted it.

<script>
  window.TelepatiaEmbedConfig = {
    apiKey: "pk_…",                       // publishable key — never the sk_
    settings: { locale: "en", branding: { name: "Your Brand" } },
    scribeContext: { show: true },        // Scribe: record + note
    intelligence:  { show: true },        // Telepatia Intelligence copilot
    cdss:          { show: true },        // CDSS review on the finished note
  };
</script>
<script src="https://cdn.telepatia.ai/telepatia-embed/v1/telepatia-embed.js"></script>

Full configuration

Every field, annotated. All are optional except apiKey; the defaults shown are what the embed uses when you omit a field.

window.TelepatiaEmbedConfig = {
  // — environment & auth —
  apiKey: "pk_…",                 // publishable key (never the sk_)
  mode: "prod",                   // "prod" (default) | "dev"
  exchangeUrl: undefined,         // override authcentral /apikey/exchange (white-label)

  // — presentation, shared by every capability —
  settings: {
    locale: "en",                 // "en" | "es" | "pt"
    theme: "light",               // "light" | "dark"
    layout: "floating",           // "floating" (default) | "sidebar" | "inline"
    branding: {
      name: "Your Brand",         // header label when no logoUrl
      logoUrl: undefined,         // partner logo (https/data: URL)
      brandColor: "#0a7d4f",      // any CSS color; drives every accent
    },
    doctor: { name: "Gómez", title: "Dr." }, // pre-Start welcome greeting
  },
  mountMode: "squeeze",           // "squeeze" (default, reflows page) | "overlay"
  hostId: undefined,              // shadow-DOM host element id
  styles: undefined,              // CSS injected into the shadow root

  // — shared clinical context —
  patient: {
    name: "Maria Gómez",          // required
    idCountry: "CO", idType: "CC", idValue: "55544433",
    scribePatientDocumentId: undefined, // link an existing patient
  },
  template: {
    medicalRecordConfigurationId: "mrc_…", // Smart Template
    configurationDocumentId: undefined,    // selected template (SSC)
  },
  consultation: {
    externalConsultationId: "CONSULT-12345", // your encounter id — always set it
    scribeSessionModality: "in-person",      // "in-person" | "telemedicine"
    patientConsentCollected: false,
  },

  // — capabilities: each renders on show AND the institution grant —
  scribeContext: { show: true },
  intelligence: {
    show: true,
    subtitle: "Clinical copilot",
    suggestions: [{ id: "dx", text: "Differential diagnoses?" }],
    chat: {
      suggestions: ["Differential diagnoses?"],
      greeting: "How can I help?",
      placeholder: "Ask about this consultation…",
      memoryHint: false,
      recentConsultations: [],    // [{ id: "<scribe session id>", … }]
    },
    documents: {                  // adds a Chat | Documents sub-tab
      institutionalDocumentId: undefined,
    },
  },
  cdss: {
    show: true,
    label: "CDSS",                // white-label tab label
    blockedCloseMessage: undefined, // banner copy on a refused close
    scribeSessionId: undefined,   // recorder-less: the session to review
    medicalRecordDocumentId: undefined, // …or the MRD (takes priority)
  },

  // — recorder session plumbing —
  open: false,                    // open the panel immediately on mount
  // callbacks: { onSessionStart, onSessionComplete, onError, onStateChange },
  // connection: { token, baseUrl, datalayerUrl, wsBaseUrl, authcentralUrl, webappUrl }, // white-label endpoint overrides
};

Config fields

Field	Value
`apiKey`	publishable key (`pk_…`), exchanged in the browser for a token
`mode`	`"prod"` (default) · `"dev"` — the Telepatia team sets `dev` locally
`settings.locale`	`"en"·"es"·"pt"`
`settings.branding`	`{ name, brandColor }` — accent for Scribe and the copilot
`settings.layout` · `settings.theme`	`"inline"` fills your container · `"light"·"dark"`
`mountMode`	`"squeeze"` (default) reflows the page · `"overlay"` covers it
`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.externalConsultationId`	your encounter id — always pass it
`consultation.scribeSessionModality`	`"in-person"` (default, when you omit it) · `"telemedicine"`
`open` · `callbacks`	open the panel now · lifecycle callbacks

Capabilities

Each capability is a { show } flag. What actually mounts is show AND the institution’s grant, so an ungranted flag renders nothing.

Capability	Config	Renders
Scribe	`scribeContext: { show: true }`	the recorder frame — recording, transcription, the note, patient cards
Telepatia Intelligence	`intelligence: { show: true, subtitle?, suggestions?, chat? }`	the copilot tab; `chat` turns on streaming chat, scales, attachments and memories
CDSS	`cdss: { show: true, label?, blockedCloseMessage? }`	corrective alerts on the finished note; `scribeSessionId` / `medicalRecordDocumentId` supply the session when Scribe is absent

Without scribeContext, the embed mounts a recorder-less surface (CDSS and/or Telepatia Intelligence) with no audio engine in its graph. intelligence.documents adds a Documents sub-tab inside the copilot.

TelepatiaEmbed methods

Method	Does
`init(config?)`	mounts and opens (overlay); collapsed unless `open: true`. Safe to call on every click.
`mountMemoryPanel(config)`	mounts the standalone memory panel into a partner container
`version`	loaded bundle version (e.g. `"1.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.

​Fast configuration

​Full configuration

​Config fields

​Capabilities

​TelepatiaEmbed methods

​Callbacks and errors