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

# Chats d'assistance

> Utilisez les chats d'assistance pour des conversations de support client individuelles avec votre compte

Les chats d'assistance sont des conversations individuelles entre un client et votre compte. Utilisez-les lorsque la conversation relève de l'assistance officielle, doit être visible par les membres de l'équipe ou nécessite un flux ouvert/résolu.

Contrairement aux messages privés, les chats d'assistance organisent les conversations autour d'une relation de support client avec votre compte. Ils sont adaptés au service client, et non à la messagerie entre pairs.

## Quand utiliser les chats d'assistance

Utilisez les chats d'assistance lorsque votre équipe doit répondre aux clients au nom du compte.

Exemples :

* Une boîte de réception d'aide pour les membres payants
* Une conversation d'assistance sur la facturation ou le compte
* Un fil d'assistance pour l'acheteur après le paiement
* Une ligne d'assistance entre le créateur et ses clients
* Un parcours d'escalade depuis votre application vers une interface de chat hébergée par Whop

### Ce qui distingue les chats d'assistance

Les chats d'assistance sont le type de chat destiné aux conversations officielles entre un client et un compte.

* Chaque chat d'assistance met en relation un client avec votre compte.
* Pour le client, la conversation se comporte comme un chat classique de type message privé et peut apparaître dans sa liste de messages privés.
* Les membres de l'équipe gèrent les chats d'assistance via une boîte de réception avec des états ouvert et résolu.
* Les membres de l'équipe peuvent lister, trier et filtrer les chats d'assistance par client, par statut et par vue administrateur/équipe.
* Les modérateurs peuvent aider à répondre aux chats d'assistance sans disposer d'un accès administrateur complet au compte.

### Contraintes

* Les chats d'assistance ne sont pas destinés aux conversations de groupe entre utilisateurs. Utilisez pour cela les [messages privés](https://docs.whop.com/fr/developer/guides/chat/direct-messages.md).
* Les chats d'assistance n'apparaissent pas dans le composant de liste des messages privés pour les administrateurs. Créez plutôt une boîte de réception d'assistance avec l'API des canaux d'assistance.
* Les chats d'assistance ne donnent pas accès aux salons liés à un produit ou à une adhésion. Utilisez les [canaux](https://docs.whop.com/fr/developer/guides/chat/channels.md) pour les salons réservés aux membres.
* Les chats d'assistance ne sont pas des messages privés entre pairs. Utilisez les [messages privés](https://docs.whop.com/fr/developer/guides/chat/direct-messages.md) lorsque les utilisateurs doivent s'écrire directement.

## Modèle d'accès

Un chat d'assistance appartient à un compte et à un client. Les membres de l'équipe disposant d'un accès à l'assistance peuvent lister les chats d'assistance du compte et y répondre. Le client peut afficher son propre chat d'assistance et y participer lorsqu'il est authentifié avec les scopes d'assistance requis.

Si un membre de votre équipe doit aider à gérer les chats d'assistance sans disposer d'un accès administrateur complet, ajoutez-le comme membre de l'équipe avec le rôle de modérateur. Les modérateurs peuvent ainsi gérer les conversations avec les clients tout en ayant un accès restreint aux paramètres plus larges du compte.

> [!NOTE]
>
> Les ID de chat d'assistance commencent par `feed_`.

## Configurer un chat d'assistance

**1. Synchroniser ou identifier le client**

Vous avez besoin de l'ID utilisateur Whop ou du nom d'utilisateur du client. Si votre application dispose de son propre système d'utilisateurs, associez d'abord les utilisateurs avec [Synchroniser vos utilisateurs](https://docs.whop.com/fr/developer/guides/chat/sync-users.md).

**2. Créer le canal d'assistance**

Utilisez [Create Channel](https://docs.whop.com/fr/api-reference/channels/create-channel.md) avec `kind` défini sur `support`, votre `account_id` et le `customer_user_id` du client. Whop renvoie le chat d'assistance existant s'il en existe déjà un pour ce client.

**3. Afficher la conversation**

Transmettez l'ID du canal d'assistance renvoyé à l'[élément Chat](https://docs.whop.com/fr/developer/guides/chat/chat-element.md).

**4. Lister les chats d'assistance pour votre équipe**

Utilisez [List Channels](https://docs.whop.com/fr/api-reference/channels/list-channels.md) avec `kind` défini sur `support` et `support_role` défini sur `staff` pour créer une boîte de réception pour votre équipe.

Affichez ensuite le chat d'assistance 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 chats d'assistance

Utilisez [Create Channel](https://docs.whop.com/fr/api-reference/channels/create-channel.md), [List Channels](https://docs.whop.com/fr/api-reference/channels/list-channels.md) et [Retrieve Channel](https://docs.whop.com/fr/api-reference/channels/retrieve-channel.md) pour gérer les chats d'assistance. Utilisez [Resolve Support Channel](https://docs.whop.com/fr/api-reference/channels/resolve-support-channel.md) et [Reopen Support Channel](https://docs.whop.com/fr/api-reference/channels/reopen-support-channel.md) pour indiquer si une conversation est terminée.

Les chats d'assistance prennent aussi en charge des flux de type boîte de réception. Vous pouvez créer des vues pour les conversations ouvertes, les conversations résolues, les conversations visibles par les clients et les vues équipe/administrateur. Consultez [List Channels](https://docs.whop.com/fr/api-reference/channels/list-channels.md) pour connaître les filtres disponibles, comme `status` et `awaiting_reply`.

## Étapes suivantes

> [card] [Élément Chat](https://docs.whop.com/fr/developer/guides/chat/chat-element.md)
>
> Affichez un chat d'assistance après l'avoir créé ou récupéré.

> [card] [Authentification](https://docs.whop.com/fr/developer/guides/chat/authentication.md)
>
> Ajoutez les scopes de chat d'assistance à votre endpoint de jeton.


## Related topics

- [Canaux du chat intégré](https://docs.whop.com/fr/developer/guides/chat/channels.md)
- [Messages privés du chat intégré](https://docs.whop.com/fr/developer/guides/chat/direct-messages.md)
- [Démarrage rapide du chat](https://docs.whop.com/fr/developer/guides/chat/quickstart.md)
