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

# Messages privés du chat intégré

> Configurez des messages privés individuels ou de groupe pour les utilisateurs de votre application, séparés de leurs autres conversations Whop.

Les messages privés sont des conversations privées entre deux utilisateurs ou plus. Utilisez-les lorsque votre application a déjà des utilisateurs et que vous souhaitez une messagerie privée au sein de votre produit.

Pour le chat intégré, les messages privés appartiennent par défaut au contexte de votre compte. Les utilisateurs ne voient donc que les conversations créées pour votre application, et non des messages Whop sans rapport.

## Quand utiliser les messages privés

Utilisez les messages privés lorsque seuls certains membres doivent rejoindre la conversation.

Exemples :

* Messagerie entre acheteur et vendeur dans votre application
* Un fil privé de coaching entre un coach et son client
* Une conversation en petit groupe pour un projet, une promotion ou une équipe
* Une conversation de marketplace entre deux utilisateurs mis en relation
* Messagerie entre utilisateurs dans votre application

### Ce qui distingue les messages privés

Les messages privés sont le type de chat destiné aux conversations privées entre des utilisateurs précis.

* Il peut s'agir de conversations individuelles ou de groupe comptant jusqu'à 50 membres.
* Seuls les utilisateurs ajoutés comme membres peuvent voir la conversation et y participer.
* Ils apparaissent dans l'[élément de liste des messages privés](https://docs.whop.com/fr/developer/guides/chat/dms-list-element.md), afin que les utilisateurs puissent parcourir et ouvrir leurs conversations récentes.
* Vous pouvez les limiter à votre compte, ce qui donne à votre application intégrée sa propre boîte de réception, séparée des messages Whop sans rapport.
* Ils prennent en charge les noms de conversation personnalisés et la gestion des membres.

### Contraintes

* Les messages privés n'accordent pas d'accès en fonction de l'adhésion à un produit. Ajoutez ou retirez directement des membres lorsque l'accès change.
* Les messages privés ne disposent pas de contrôles réservés aux administrateurs, de lecture seule ni de modération au niveau du salon. Utilisez les [canaux](https://docs.whop.com/fr/developer/guides/chat/channels.md) pour les salons modérés.
* Les messages privés n'incluent ni boîte de réception d'assistance ni flux ouvert/résolu. Utilisez les [chats d'assistance](https://docs.whop.com/fr/developer/guides/chat/support-chats.md) pour le support client.
* Les messages privés ne sont pas conçus pour les grandes communautés, les annonces ou les salons ouverts à tous les membres. Utilisez pour cela les [canaux](https://docs.whop.com/fr/developer/guides/chat/channels.md).

## Modèle d'accès

Chaque conversation privée a des membres. Ces membres sont les seuls utilisateurs qui peuvent voir la conversation et y participer.

Lorsque vous créez des messages privés pour le chat intégré, rattachez-les à votre compte. Votre application dispose ainsi de sa propre boîte de réception et les conversations restent séparées du reste de Whop.

> [!NOTE]
>
> Les ID de canal de messages privés commencent par `feed_`.

## Configurer un message privé

**1. Synchroniser ou créer les utilisateurs**

Assurez-vous que chaque participant dispose d'un ID utilisateur Whop. Si votre application a ses propres utilisateurs, associez-les d'abord à des utilisateurs Whop. Consultez [Synchroniser vos utilisateurs](https://docs.whop.com/fr/developer/guides/chat/sync-users.md).

**2. Créer le canal de message privé**

Utilisez [Create Channel](https://docs.whop.com/fr/api-reference/channels/create-channel.md) avec `kind` défini sur `private` pour créer la conversation. Listez les autres membres dans `participant_user_ids`. Avec une clé API de compte, transmettez également `sender_user_id`.

**3. Ajouter des membres si nécessaire**

Utilisez [Add Channel Member](https://docs.whop.com/fr/api-reference/channel-members/add-channel-member.md) pour ajouter un utilisateur à une conversation privée existante. Utilisez [Remove Channel Member](https://docs.whop.com/fr/api-reference/channel-members/remove-channel-member.md) pour en retirer un.

**4. Afficher la conversation ou la liste**

Utilisez l'[élément Chat](https://docs.whop.com/fr/developer/guides/chat/chat-element.md) pour une conversation privée unique, ou l'[élément de liste des messages privés](https://docs.whop.com/fr/developer/guides/chat/dms-list-element.md) pour permettre aux utilisateurs de choisir parmi leurs conversations.

Affichez ensuite la conversation privée avec l'ID de canal renvoyé :

> [tab] React
>
> ```tsx theme={null}
> <ChatElement
>   options={{ channelId: "feed_XXXXXXXXXXXXXX" }}
>   style={{ height: "100dvh", width: "100%" }}
> />
> ```

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

> [tab] Swift
>
> ```swift theme={null}
> WhopChatView(
>     channelId: "feed_XXXXXXXXXXXXXX",
>     style: .imessage
> )
> ```

## Gérer les messages privés

Utilisez [List Channels](https://docs.whop.com/fr/api-reference/channels/list-channels.md) avec `kind` défini sur `private`, [Update Channel](https://docs.whop.com/fr/api-reference/channels/update-channel.md) et [Delete Channel](https://docs.whop.com/fr/api-reference/channels/delete-channel.md) pour gérer les conversations.

Utilisez [List Channel Members](https://docs.whop.com/fr/api-reference/channel-members/list-channel-members.md), [Add Channel Member](https://docs.whop.com/fr/api-reference/channel-members/add-channel-member.md) et [Remove Channel Member](https://docs.whop.com/fr/api-reference/channel-members/remove-channel-member.md) pour gérer les participants.

> [!TIP]
>
> Si vous utilisez l'élément de liste des messages privés, rattachez-le à votre compte afin que les utilisateurs ne voient que les conversations de votre expérience de chat intégré.

## Étapes suivantes

> [card] [Élément de liste des messages privés](https://docs.whop.com/fr/developer/guides/chat/dms-list-element.md)
>
> Affichez les conversations privées et gérez la sélection des canaux.

> [card] [Synchroniser vos utilisateurs](https://docs.whop.com/fr/developer/guides/chat/sync-users.md)
>
> Créez ou associez des utilisateurs Whop avant de créer des canaux de messages privés.
