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

# Créer une session de chat

> Référence de l'ancienne ChatSession. Pour les nouvelles intégrations, utilisez le groupe Chat de @whop/elements.

## Vue d'ensemble

Gère l'authentification et crée les éléments de chat.

## Exemples

### Utilisation de base

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

session.on("ready", () => {
  console.log("Session is ready");
});
```

### Créer des éléments

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

## Options

| Propriété | Type | Obligatoire | Par défaut | Description |
| - | - | - | - | - |
| `token` | `Token \| GetToken` | Oui | - | Le token à utiliser pour la session. Si une fonction est fournie, elle est appelée et attendue pour obtenir le token. Lorsqu'une fonction est fournie, le token est automatiquement actualisé avant son expiration. Si une chaîne est fournie, elle est utilisée comme token et n'est pas actualisée automatiquement. Vous pouvez toutefois mettre à jour le token à l'exécution en appelant 'updateOptions' avec un nouveau token. |

## Événements

Événements émis par la ChatSession.

Écoutez ces événements avec la méthode `on()`.

### `optionsUpdated`

Émis lorsque les options de la session sont mises à jour via `updateOptions()`.

**Signature du callback :** (options: `ExpandedChatSessionOptions`) => void

### `tokenRefreshed`

Émis lorsque le token d'authentification est actualisé.

**Signature du callback :** (token: `string`) => void

### `tokenRefreshError`

Émis lorsque l'actualisation du token échoue.

**Signature du callback :** (error: `unknown`) => void

### `error`

Émis lorsqu'une erreur se produit pendant le fonctionnement de la session.

**Signature du callback :** (error: `unknown`) => void

### `ready`

Émis lorsque la session est prête et authentifiée.

**Signature du callback :** (`void`) => void

## Méthodes

### `createElement(type, options)`

Crée une nouvelle instance d'élément.

| Paramètre | Type | Description |
| - | - | - |
| `type` | T \| \{ type: T; } | Le type d'élément (par ex. "chat-element") |
| `options` | ChatSessionElements\[T]\[0] | Options de configuration propres à l'élément |

**Renvoie :** `ChatSessionElements[T][1]`

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

### `updateOptions(options)`

Met à jour les options de la session après l'initialisation.

Les modifications sont propagées à tous les éléments actifs.

| Paramètre | Type | Description |
| - | - | - |
| `options` | Partial\<ChatSessionOptions> | Objet d'options partiel contenant les valeurs à mettre à jour |

### `destroy()`

Détruit la session et nettoie tous les éléments montés.

Appelez cette méthode lorsque vous n'avez plus besoin de la session afin de libérer des ressources.

### Méthodes de modale

#### `showSearchModal(options, force)`

Affiche l'élément de recherche dans une fenêtre modale superposée.

Par défaut, la modale se ferme automatiquement à la fin (`onResultClick`) ou lors de sa fermeture (`onClose`).
Appelez `ev.preventDefault()` dans un callback pour empêcher la fermeture automatique.

| Paramètre | Type | Description |
| - | - | - |
| `options` | [`SearchElementOptions`](https://docs.whop.com/fr/sdk/elements/search-element#searchelementoptions) \| ((modal: ModalContainer) => [`SearchElementOptions`](https://docs.whop.com/fr/sdk/elements/search-element#searchelementoptions)) | Options de l'élément ou callback qui reçoit le conteneur de la modale |
| `force` | Force \| undefined | - |

**Renvoie :** `Force extends true ? ModalContainer : ModalContainer | undefined`


## Related topics

- [Premiers pas avec Element Sessions](https://docs.whop.com/fr/sdk/elements/whop-elements.md)
- [Authentification du chat](https://docs.whop.com/fr/developer/guides/chat/authentication.md)
- [Élément Chat](https://docs.whop.com/fr/developer/guides/chat/chat-element.md)
