> ## 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.

# ChatElement (Legacy)

> Referentie voor de legacy ChatElement. Gebruik voor nieuwe integraties ChatElement uit @whop/elements.

## Overzicht

Een UI-element dat een chatinterface weergeeft.

## Gebruik

### Basisgebruik

```typescript theme={null}
// Create the element
const element = session.createElement("chat-element", {
  channelId: "feed_XXXXXXXXXXXXXX",
  onReady: () => {
    console.log("Chat element is ready");
  },
});

// Mount it to a container
element.mount("#chat-container");
```

### Luisteren naar events

```typescript theme={null}
const element = session.createElement("chat-element", {
  channelId: "feed_XXXXXXXXXXXXXX",
});

element.on("ready", () => {
  console.log("Chat element is ready");
});

element.on("profileClick", (ev) => {
  console.log("Profile clicked:", ev.detail.id);
});

element.on("linkClick", (ev) => {
  console.log("Link clicked:", ev.detail.url);
});

element.on("messageSent", (ev) => {
  console.log("Message sent:", ev.detail.id, ev.detail.content, ev.detail.channelId);
});

element.on("messageDeleted", (ev) => {
  console.log("Message deleted:", ev.detail.id);
});

element.on("experienceClick", (ev) => {
  console.log("Experience clicked:", ev.detail.id);
});

element.mount("#chat-container");
```

```typescript theme={null}
const element = session.createElement("chat-element", {
  channelId: "feed_XXXXXXXXXXXXXX",
  onReady: (element) => {
    console.log("Chat element is ready");
  },
});
```

## Events

Events die door de ChatElement worden uitgezonden.

Luister naar deze events met de methode `on()` of door callbackfuncties mee te geven in de opties.

### `error`

Wordt uitgezonden wanneer er een fout optreedt tijdens de initialisatie of werking van het element.

**Callbacksignatuur:** (error: `unknown`) => void

### `ready`

Wordt uitgezonden wanneer het element klaar is met laden en gereed is voor interactie met de gebruiker.

**Callbacksignatuur:** (element: `ChatElement`) => void

### `optionsUpdated`

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

**Callbacksignatuur:** (options: [`ChatElementOptions`](#chatelementoptions)) => void

### `snapshot`

Wordt uitgezonden wanneer de interne status van het element verandert.

**Callbacksignatuur:** (snapshot: [`ChatElementSnapshot`](#chatelementsnapshot)) => void

### `profileClick`

Wordt uitgezonden wanneer de gebruiker op een profiel klikt.

**Callbacksignatuur:** (ev: `CustomEvent`\<\{ id: `string`; }>) => void

### `linkClick`

Wordt uitgezonden wanneer de gebruiker op een link klikt.

**Callbacksignatuur:** (ev: `CustomEvent`\<\{ url: `string`; }>) => void

### `messageSent`

Wordt uitgezonden wanneer de gebruiker een bericht verstuurt.

**Callbacksignatuur:** (ev: `CustomEvent`\<\{ id: `string`; content: `string`; channelId: `string`; }>) => void

### `messageDeleted`

Wordt uitgezonden wanneer de gebruiker een bericht verwijdert.

**Callbacksignatuur:** (ev: `CustomEvent`\<\{ id: `string`; }>) => void

### `experienceClick`

Wordt uitgezonden wanneer de gebruiker op een vermelding van een experience klikt.

**Callbacksignatuur:** (ev: `CustomEvent`\<\{ id: `string`; }>) => void

### `attachmentClick`

Wordt uitgezonden wanneer de gebruiker op een bijlage klikt.

**Callbacksignatuur:** (ev: `CustomEvent`\<\{ messageId: `string`; attachments: `AttachmentClickEventAttachment`\[]; }>) => void

## Methoden

### `mount(container)`

Koppel het element aan een DOM-container.

De container moet een leeg element zijn. Het element wordt als child toegevoegd.
Als het element al gekoppeld is, logt deze methode een waarschuwing en keert terug.

| Parameter | Type | Beschrijving |
| - | - | - |
| `container` | `HTMLElement` \| `#$\{`string`\}` | Het containerelement of een CSS-selector die begint met '#' |

```typescript theme={null}
// Using a selector
element.mount("#my-container");

// Using an element reference
const container = document.getElementById("my-container");
element.mount(container);
```

### `unmount()`

Verwijder het element uit de DOM en ruim alle event listeners op.

Na het ontkoppelen mag de elementinstantie niet opnieuw worden gebruikt.
Maak een nieuwe elementinstantie aan als je opnieuw wilt koppelen.

```typescript theme={null}
// Unmount when done
element.unmount();

// Commonly used in event handlers
element.on("complete", () => {
  element.unmount();
});
```

### `updateOptions(options)`

Werk de configuratieopties van het element bij na het aanmaken.

Alleen de opgegeven opties worden bijgewerkt; andere opties blijven ongewijzigd.
Het element wordt opnieuw gerenderd met de nieuwe opties.

| Parameter | Type | Beschrijving |
| - | - | - |
| `options` | `Partial`\<[`ChatElementOptions`](#chatelementoptions)> | Gedeeltelijk optie-object met de waarden die moeten worden bijgewerkt |

```typescript theme={null}
// Update a single option
element.updateOptions({
  onComplete: (ev) => {
    console.log("New handler!");
  },
});
```

### `getSnapshot()`

Haal de huidige status-snapshot van het element op.

De snapshot bevat de huidige interne status van het element, zoals
de laadstatus, formulierwaarden of andere elementspecifieke gegevens.

**Retourneert:** [`ChatElementSnapshot`](#chatelementsnapshot)

```typescript theme={null}
const snapshot = element.getSnapshot();
console.log("Current state:", snapshot.state);

// Or listen for changes
element.on("snapshot", (snapshot) => {
  console.log("State changed:", snapshot);
});
```

## Styling

Pas dit element aan met `appearance.classes`. Zie de [stylingreferentie](https://docs.whop.com/nl/sdk/elements/styling-reference.md) voor de volledige lijst met stabiele klassenamen en voorbeeldsnippets.

## Types

### ChatElementOptions

Configuratieopties voor de ChatElement.

| Eigenschap | Type | Verplicht | Standaard | Beschrijving |
| - | - | - | - | - |
| `channelId` | `string` | Ja | - | De ID van het kanaal, de DM of de supportchat waarmee verbinding wordt gemaakt. |
| `deeplinkToPostId` | `string \| undefined` | Nee | - | De ID van het bericht waarnaar een deeplink wordt gemaakt. |
| `disableNavigation` | `boolean \| undefined` | Nee | false | Schakelt linknavigatie uit. Luister naar het event 'linkClick' om de navigatie zelf af te handelen. |
| `emptyState` | `EmptyStateOptions \| undefined` | Nee | - | Aangepaste lege status die wordt weergegeven wanneer er geen berichten zijn. |
| `style` | `"imessage" \| "discord" \| undefined` | Nee | 'imessage' | De stijl van de chat. |
| `features` | `{ banUser?: boolean; muteUser?: boolean; previewAttachments?: boolean; mentionExperiences?: boolean; } \| undefined` | Nee | - | Configureer welke functies beschikbaar zijn in de chat. |
| `onReady` | `((element: ChatElement) => void) \| undefined` | Nee | - | Callback die wordt aangeroepen wanneer het element klaar is met laden en gereed is voor interactie. Dit is gelijk aan luisteren naar het event 'ready'. |
| `onEvent` | `((event: ChatElementEvent) => void) \| undefined` | Nee | - | Callback die wordt aangeroepen wanneer een event van het chatelement wordt uitgezonden. |

### ChatElementSnapshot

Vertegenwoordigt de huidige status van de ChatElement.

Gebruik `element.getSnapshot()` om de huidige status op te halen, of luister naar het event `snapshot` voor wijzigingen.

| Eigenschap | Type | Verplicht | Standaard | Beschrijving |
| - | - | - | - | - |
| `state` | `"ready" \| "loading"` | Ja | - | De huidige laadstatus van het element. - '"loading"' - Het element wordt geïnitialiseerd - '"ready"' - Het element is volledig geladen en interactief |
