> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Aan de slag met Element Sessions

> Stel de legacy @whop/embedded-components-pakketten in. Gebruik voor nieuwe chatintegraties @whop/elements.

## Overzicht

Het belangrijkste toegangspunt voor de ingebedde componenten van Whop.

WhopElements is het rootobject dat de configuratie beheert en de chatsessie
aanmaakt. Initialiseer het één keer en gebruik het om de sessie aan te maken die chat-,
DM- en zoekelementen koppelt.

## Installatie

```bash React theme={null}
npm install @whop/embedded-components-vanilla-js @whop/embedded-components-react-js
```

```bash Vanilla JS theme={null}
npm install @whop/embedded-components-vanilla-js
```

## Voorbeelden

### Basisinitialisatie

```typescript theme={null}
import WhopElements from "@whop/embeddable-components";

const whopElements = new WhopElements({
  appearance: {
    theme: { appearance: "light" },
  },
  locale: "en",
});
```

### Een chatsessie aanmaken

```typescript theme={null}
const session = whopElements.createChatSession({
  token: async () => {
    // Fetch token from your backend
    const response = await fetch("/api/token");
    const data = await response.json();
    return data.token;
  },
});

const element = session.createElement("chat-element", {
  channelId: "feed_XXXXXXXXXXXXXX",
});
element.mount("#chat-container");
```

### Opties bijwerken na initialisatie

```typescript theme={null}
// Switch to dark mode
whopElements.updateOptions({
  appearance: {
    theme: { appearance: "dark" },
  },
});
```

### Luisteren naar optiewijzigingen

```typescript theme={null}
whopElements.on("optionsUpdated", (options) => {
  console.log("Options changed:", options);
});
```

## Opties

| Eigenschap | Type | Verplicht | Standaard | Beschrijving |
| - | - | - | - | - |
| `appearance` | [`Appearance`](https://docs.whop.com/nl/sdk/elements/types#appearance) \| undefined | Nee | - | Pas het uiterlijk van de ingebedde Whop-Elements aan. Bevat thema-instellingen zoals lichte/donkere modus en accentkleuren. |
| `locale` | `"en" \| "es" \| "zh" \| "nl" \| "pt" \| "de" \| "hu" \| "it" \| "fr" \| "ja" \| "pl" \| "tr" \| undefined` | Nee | "en" | De locale voor alle Elements. Bepaalt de taal en de opmaak van tekst, datums en getallen. |
| `environment` | [`WhopElementsEnvironment`](https://docs.whop.com/nl/sdk/elements/types#whopelementsenvironment) \| undefined | Nee | "production" | De omgeving voor API-aanroepen. Gebruik '"sandbox"' om te testen zonder productiegegevens te beïnvloeden. |

## Events

Events die door WhopElements worden uitgezonden.

Luister naar deze events met de methode `on()`.

### `optionsUpdated`

Wordt uitgezonden wanneer de opties van WhopElements worden bijgewerkt via `updateOptions()`.

**Callback-signatuur:** (options: [`WhopElementsOptions`](https://docs.whop.com/nl/sdk/elements/types#whopelementsoptions)) => void

## Methoden

### `createChatSession(options)`

Maak een nieuwe chatsessie aan voor het beheren van chatelementen.

| Parameter | Type | Beschrijving |
| - | - | - |
| `options` | `ChatSessionOptions` | Configuratieopties voor de chatsessie |

**Retourneert:** [`ChatSession`](https://docs.whop.com/nl/sdk/elements/chat-session)

### `updateOptions(options)`

Werk de configuratie van WhopElements bij na initialisatie.

Wijzigingen worden doorgevoerd in alle actieve sessies en elementen.
Alleen de opgegeven opties worden bijgewerkt; andere blijven ongewijzigd.

| Parameter | Type | Beschrijving |
| - | - | - |
| `options` | Partial\<[`WhopElementsOptions`](https://docs.whop.com/nl/sdk/elements/types#whopelementsoptions)> | Gedeeltelijk optie-object met de waarden die moeten worden bijgewerkt |

## Gerelateerde types

* [WhopElementsOptions](https://docs.whop.com/nl/sdk/elements/types.md#whopelementsoptions)
* [WhopElementsEnvironment](https://docs.whop.com/nl/sdk/elements/types.md#whopelementsenvironment)
* [Appearance](https://docs.whop.com/nl/sdk/elements/types.md#appearance)
* [Theme](https://docs.whop.com/nl/sdk/elements/types.md#theme)
* [AccentColor](https://docs.whop.com/nl/sdk/elements/types.md#accentcolor)
