Skip to content
Helix
PricingDocsChangelog
Log inStart free
Documentation
Overview
Getting Started with HelixYour First Mission WalkthroughFocus Mode vs Console ModeDesktop & Mobile Companion Apps
5-Minute API QuickstartIntegrations & Autonomous ChannelsProduction Examples & Recipes
Helix Agent Overview & Autonomy TiersHelix AdvisorHelix OperatorHelix PhasesHelix Sandbox
Synthetic AI & Simulation WorkflowsDrop-In White-Label Agent EmbedsDeveloper & Embed Guide
Helix ArchitectureArchitecture & Technical GuideHybrid Compute Bridge & Custom MCPHelix MCP
MCP Providers & Cloud Connectors
REST, Gateway & MCP API ReferenceAuthentication, Keys & ScopesSDKs & Programmatic ClientsWebhooks, HMAC Verification & ReplayTroubleshooting & Error Playbook
Helix Security ArchitectureEnterprise Security, Secrets & GovernanceBilling, Compute Windows & Quotas
Developer PlatformDeveloper Console
Docs/Synthetic AI & Embeds/Drop-In White-Label Agent Embeds

Drop-In White-Label Agent Embeds

Turn any web product into an agent-native platform without building sandboxes, streaming UIs, or approval workflows yourself. Helix Embeds let your customers interact with white-labeled AI specialists inside your own portal with strict single-tenant (principalId) cryptographic isolation.

Available Embed Surfaces

Surface ValuePurposeBest Placement
officeFull workspace hub: live agents, threads, approvals, filesPrimary "AI Assistant" tab in your SaaS nav
colleagueSingle scoped specialist chat & live tool execution feedSide drawer beside a specific record or ticket
hire-studioConversational workflow for creating a custom customer specialistOnboarding / Admin automations page
approvals-inboxFocused human review & sign-off queue (T2 gates)Notifications popover or Compliance Inbox
open-doorLive visual desktop/browser handoff viewerSupport / Live debugging modal
receiptsVerifiable Ed25519 audit ledger explorer for end customersEnterprise Security / Audit tab

Step 1 — Mint a Customer-Scoped Token on Your Backend

Never expose hx_live_* in browser HTML. Always mint a short-lived hx_embed_* token on your backend bound to the exact end-user (principalId):

TS
import { HelixClient } from "@launchverse/helix-sdk";

const helix = new HelixClient({
  baseUrl: "https://launchverse.app",
  apiKey: process.env.HELIX_API_KEY!, // hx_live_* kept strictly server-side
});

// Inside your authenticated API route (e.g. POST /api/acme/helix-token):
export async function issueCustomerEmbedToken(customerAccountId: string) {
  const token = await helix.embeds.createToken({
    principalId: customerAccountId,
    surfaces: ["office", "colleague", "approvals-inbox", "receipts"],
    ttlSeconds: 3600,
    whiteLabel: true,
  });
  return token;
}

Hard Isolation Guarantee: Even if an attacker extracts an hx_embed_* token from DevTools, every endpoint rejects requests outside its pinned principalId, and attempts against /api/webhooks/platform or key management immediately fail closed (403 principal_escalation_denied).

Step 2 — Mount the Web Component

Load /embed/helix-staff.js and pass the scoped token cleanly:

HTML
<script src="https://launchverse.app/embed/helix-staff.js" defer></script>

<helix-staff-embed
  id="acme-copilot"
  token="hx_embed_eyJ..."
  surface="office"
  principal-id="cust_acme_42"
  theme="dark"
  accent="gold"
  white-label="true"
  style="display: block; width: 100%; height: 720px;"
></helix-staff-embed>

React / Next.js Integration Pattern

TSX
"use client";
import { useEffect, useRef } from "react";

export function CustomerHelixEmbed({ embedToken, accountId }: { embedToken: string; accountId: string }) {
  const ref = useRef<HTMLElement | null>(null);

  useEffect(() => {
    const onMessage = (e: MessageEvent) => {
      if (e.origin !== "https://launchverse.app") return;
      if (e.data?.type === "helix:run.completed") {
        console.log("Completed task:", e.data.payload);
      }
      if (e.data?.type === "helix:approval.requested") {
        // Optionally show a badge in your host SaaS nav bar
      }
    };
    window.addEventListener("message", onMessage);
    return () => window.removeEventListener("message", onMessage);
  }, []);

  return (
    <helix-staff-embed
      ref={ref as never}
      token={embedToken}
      principal-id={accountId}
      surface="office"
      theme="dark"
      white-label="true"
      style={{ display: "block", width: "100%", height: "720px" }}
    />
  );
}

Step 3 — Host <-> Embed postMessage Event Protocol

Event typeDirectionPayload & Use Case
helix:readyEmbed -> HostFrame hydrated & session authenticated
helix:prefillHost -> EmbedPrefill the composer with context from the current CRM/ERP screen
helix:themeHost -> EmbedDynamically synchronize dark / light theme & custom CSS variables
helix:approval.requestedEmbed -> HostNotify your host UI when a T2 decision awaits the user
helix:run.completedEmbed -> HostTrigger toast / refresh tables in your SaaS when an agent finishes work

Step 4 — White-Label Styling & Content Security Policy (CSP)

When white-label="true", LaunchVerse consumer logos are omitted so the experience inherits your brand colors cleanly. Add these directives to your host app CSP:

HTTP
Content-Security-Policy:
  script-src 'self' https://launchverse.app;
  frame-src 'self' https://launchverse.app;
  connect-src 'self' https://launchverse.app wss://launchverse.app;

Preview and test custom accent themes visually in the Embed Studio or Desktop Embed Studio.

PreviousSynthetic AI & Simulation WorkflowsNext Developer & Embed Guide
Edit this page on GitHub&nearr;

Platform

How Helix worksSpecialist crewScreens & architectureSecurity & isolationSystem status

Products

Helix WorkspaceAI Staff & Role PacksEmbedded B2B2C StaffPricing & plans

Developers

Developer PlatformDeveloper ConsoleAPI ReferenceSDKs & CLIWebhooks & events

Resources

DocumentationQuickstart guideChangelogHelp Center

Solutions

Use casesCode migrationCVE remediationMulti-cloud ops

Company

About LaunchVerseCareersContact ussupport@launchverse.app

Legal

Privacy PolicyTerms of ServiceExternal status

Social

Sovereign agentic infrastructure engineered in Africa for global engineering teams.

Helix

AI Specialists & Assistants for Everyday Work.

© 2026 LaunchVerse (Helix). All rights reserved.Privacy·Terms·Security·Status