Quickstart

npm install @tortus-ai/embed-client

// server-side route, e.g. GET /api/tortus/client-secrets
const credentials = Buffer.from(`${CLIENT_ID}:${CLIENT_SECRET}`).toString("base64");

// The TORTUS user ID you saved for this person on their first launch, if any.
const savedUserId = await getTortusUserId(currentUser.id);

const response = await fetch("https://api.tortus.ai/v1/oauth/launch", {
  method: "POST",
  headers: {
    Authorization: `Basic ${credentials}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    ...(savedUserId ? { userId: savedUserId } : {}), // resume an existing user
    externalUserId: "your-internal-user-id",
    userPayload: { email: "clinician@example.com", firstName: "Ada", lastName: "Lovelace" },
  }),
});

const { launch_token, user_id } = await response.json();

// First launch only: persist the ID so future launches resume this user.
if (!savedUserId) {
  await saveTortusUserId(currentUser.id, user_id);
}
// return { launchToken: launch_token } to your frontend

<div id="tortus-container" style="width: 100%; height: 600px;"></div>

import { loadTortus } from "@tortus-ai/embed-client";

const client = await loadTortus({
  publishableKey: "pk_your_key_here",
  container: "#tortus-container",
  environment: "sandbox", // use "production" when you go live
  fetchClientSecrets: async () => {
    const res = await fetch("/api/tortus/client-secrets");
    const data = await res.json();
    return { launchToken: data.launchToken };
  },
});

client.on("consultation:completed", async ({ consultation, result, finish }) => {
  const { medicalNotes, letters, medicalCodes, transcriptions } = result.artifacts;

  // Filter by contentType, never rely on array order
  const note = medicalNotes.find((n) => n.contentType === "text/html");

  try {
    await saveToEhr({ reference: consultation.reference, note: note?.content, codes: medicalCodes });
    await finish({ status: "success" });
  } catch {
    await finish({ status: "failed" }); // lets the user retry in the TORTUS UI
  }
});

await client.consultations.start(
  {
    mode: "FACE_TO_FACE",
    patient: { name: "Jane Smith", dateOfBirth: "1985-03-15" },
    integration: { system: "EMIS" },
  },
  { returnTo: "home" },
);