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

# Sincronizar usuarios con el chat incrustado

> Inscribe a los usuarios de tu plataforma como subcuentas antes de generar tokens de chat y luego establece un nombre y una foto de perfil específicos de la cuenta con Update user.

Sincroniza los usuarios antes de generar tokens de usuario con alcance de cuenta para el chat incrustado. El usuario que pasas como `user_id` debe existir en Whop, y puedes proporcionar un nombre y una foto de perfil específicos de la cuenta que se mostrarán para ese usuario en el chat.

> [!NOTE]
>
> Esto **no es necesario con OAuth**. Si usas OAuth, el usuario inicia sesión en Whop y el token de OAuth identifica su cuenta de Whop.

## Inscribe a los usuarios como subcuentas

Crea una subcuenta para cada usuario de tu plataforma. Es el mismo flujo que usa el [SDK de pagos salientes](https://docs.whop.com/es/developer/platforms/render-payout-portal.md); consulta la guía [Inscribir subcuentas](https://docs.whop.com/es/developer/platforms/enroll-subaccounts.md) para ver el proceso completo.

```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
});
```

Guarda el ID de usuario resultante en tu sistema. Lo pasarás al generar tokens de chat con alcance de cuenta.

## Establece un nombre y una foto de perfil específicos de la cuenta

Llama al endpoint [Update user](https://docs.whop.com/es/api-reference/users/update-user.md) con el ID de tu cuenta para definir valores que se muestran para ese usuario en el contexto de tu cuenta. Sin un ID de cuenta, los campos actualizan el perfil global del usuario.

Sube los avatares mediante el endpoint [Create file](https://docs.whop.com/es/api-reference/files/create-file.md) y luego pasa el ID de archivo devuelto como foto de perfil.

Llama a este endpoint cada vez que cambie el perfil de un usuario en tu plataforma para que Whop se mantenga sincronizado.

> [!NOTE]
>
> El endpoint Update user requiere el permiso `user:profile:update` en la clave de API que hace la solicitud. Usa una clave de API de cuenta con acceso **de nivel propietario** o una clave que incluya el alcance `user:profile:update`.

## Próximos pasos

> [card] [Autenticación](https://docs.whop.com/es/developer/guides/chat/authentication.md)
>
> Genera tokens de usuario con alcance de cuenta para el chat incrustado.

> [card] [OAuth](https://docs.whop.com/es/developer/guides/chat/oauth.md)
>
> Usa el inicio de sesión de Whop en lugar de sincronizar los usuarios tú mismo.

> [card] [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md)
>
> Muestra una interfaz de chat en vivo una vez que tus usuarios estén autenticados.

> [card] [Inscribir subcuentas](https://docs.whop.com/es/developer/platforms/enroll-subaccounts.md)
>
> Conoce el flujo completo de inscripción de subcuentas.


## Related topics

- [Canales del chat incrustado](https://docs.whop.com/es/developer/guides/chat/channels.md)
- [Mensajes directos del chat incrustado](https://docs.whop.com/es/developer/guides/chat/direct-messages.md)
- [OAuth del chat](https://docs.whop.com/es/developer/guides/chat/oauth.md)
