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

# Synchroniser les utilisateurs avec le chat intégré

> Inscrivez les utilisateurs de votre plateforme en tant que sous-comptes avant de générer des jetons de chat, puis définissez un nom et une photo de profil propres au compte avec Update user.

Synchronisez les utilisateurs avant de générer des jetons utilisateur limités à un compte pour le chat intégré. L'utilisateur que vous transmettez comme `user_id` doit exister sur Whop, et vous pouvez fournir un nom et une photo de profil propres au compte qui s'affichent pour cet utilisateur dans le chat.

> [!NOTE]
>
> Cette étape **n'est pas nécessaire avec OAuth**. Si vous utilisez OAuth, l'utilisateur se connecte à Whop et le jeton OAuth identifie son compte Whop.

## Inscrire les utilisateurs en tant que sous-comptes

Créez un sous-compte pour chaque utilisateur de votre plateforme. Il s'agit du même flux que celui utilisé par le [SDK de versements](https://docs.whop.com/fr/developer/platforms/render-payout-portal.md) — consultez le guide [Inscrire des sous-comptes](https://docs.whop.com/fr/developer/platforms/enroll-subaccounts.md) pour la procédure complète.

```typescript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

const account = await client.accounts.create({
  email: "user@example.com",
  title: "Jane Doe",
  external_id: "user_12345", // your platform's user ID
});
```

Enregistrez de votre côté l'ID utilisateur obtenu. Vous le transmettrez lors de la génération des jetons de chat limités à un compte.

## Définir un nom et une photo de profil propres au compte

Appelez l'endpoint [Update user](https://docs.whop.com/fr/api-reference/users/update-user.md) avec l'ID de votre compte pour définir les valeurs affichées pour cet utilisateur dans le contexte de votre compte. Sans ID de compte, les champs mettent plutôt à jour le profil global de l'utilisateur.

Téléversez les avatars via l'endpoint [Create file](https://docs.whop.com/fr/api-reference/files/create-file.md), puis transmettez l'ID de fichier renvoyé comme photo de profil.

Appelez cet endpoint chaque fois que le profil d'un utilisateur change sur votre plateforme afin que Whop reste synchronisé.

> [!NOTE]
>
> L'endpoint Update user nécessite la permission `user:profile:update` sur la clé API qui effectue la requête. Utilisez une clé API de compte disposant d'un accès de niveau **propriétaire**, ou une clé qui inclut le scope `user:profile:update`.

## Étapes suivantes

> [card] [Authentification](https://docs.whop.com/fr/developer/guides/chat/authentication.md)
>
> Générez des jetons utilisateur limités à un compte pour le chat intégré.

> [card] [OAuth](https://docs.whop.com/fr/developer/guides/chat/oauth.md)
>
> Utilisez la connexion Whop au lieu de synchroniser vous-même les utilisateurs.

> [card] [Élément Chat](https://docs.whop.com/fr/developer/guides/chat/chat-element.md)
>
> Affichez une interface de chat en direct une fois vos utilisateurs authentifiés.

> [card] [Inscrire des sous-comptes](https://docs.whop.com/fr/developer/platforms/enroll-subaccounts.md)
>
> Découvrez le flux complet d'inscription des sous-comptes.


## Related topics

- [Messages privés du chat intégré](https://docs.whop.com/fr/developer/guides/chat/direct-messages.md)
- [Canaux du chat intégré](https://docs.whop.com/fr/developer/guides/chat/channels.md)
- [Chats d'assistance](https://docs.whop.com/fr/developer/guides/chat/support-chats.md)
