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

# Mensajes directos del chat incrustado

> Configura mensajes directos privados individuales o de grupo para los usuarios de tu app, separados de sus demás conversaciones de Whop.

Los mensajes directos son conversaciones privadas entre dos o más usuarios. Úsalos cuando tu app ya tenga usuarios y quieras mensajería privada dentro de tu producto.

En el chat incrustado, los MD pertenecen por defecto al contexto de tu cuenta. Eso significa que los usuarios solo ven las conversaciones creadas para tu app, no mensajes de Whop no relacionados.

## Cuándo usar mensajes directos

Usa mensajes directos cuando solo determinados miembros deban unirse a la conversación.

Ejemplos:

* Mensajería entre comprador y vendedor dentro de tu app
* Un hilo privado de coaching entre un coach y su cliente
* Una conversación de grupo pequeño para un proyecto, un grupo de alumnos o un equipo
* Una conversación de marketplace entre dos usuarios emparejados
* Mensajería entre usuarios dentro de tu app

### Qué diferencia a los mensajes directos

Los MD son el tipo de chat para conversaciones privadas entre usuarios concretos.

* Pueden ser conversaciones individuales o de grupo con hasta 50 miembros.
* Solo los usuarios añadidos como miembros pueden ver la conversación y participar en ella.
* Aparecen en el [DMs list element](https://docs.whop.com/es/developer/guides/chat/dms-list-element.md), para que los usuarios puedan explorar y abrir sus conversaciones recientes.
* Puedes limitarlos a tu cuenta, de modo que tu app incrustada tenga su propia bandeja de entrada, separada de mensajes de Whop no relacionados.
* Admiten nombres de conversación personalizados y gestión de miembros.

### Limitaciones

* Los MD no dan acceso según la membresía de un producto. Añade o elimina miembros directamente cuando cambie el acceso.
* Los MD no tienen controles de solo administradores, solo lectura ni moderación a nivel de sala. Para salas moderadas, usa [canales](https://docs.whop.com/es/developer/guides/chat/channels.md).
* Los MD no incluyen una bandeja de soporte ni un flujo de abierto/resuelto. Para la atención al cliente, usa los [chats de soporte](https://docs.whop.com/es/developer/guides/chat/support-chats.md).
* Los MD no están diseñados para comunidades grandes, anuncios ni salas para todos los miembros. Para eso, usa [canales](https://docs.whop.com/es/developer/guides/chat/channels.md).

## Modelo de acceso

Cada MD tiene miembros. Esos miembros son los únicos usuarios que pueden ver la conversación y participar en ella.

Cuando crees MD para el chat incrustado, mantenlos vinculados a tu cuenta. Así tu app tiene su propia bandeja de entrada y las conversaciones quedan separadas del resto de Whop.

> [!NOTE]
>
> Los ID de canal de MD empiezan por `feed_`.

## Configurar un mensaje directo

**1. Sincroniza o crea usuarios**

Asegúrate de que cada participante tenga un ID de usuario de Whop. Si tu app tiene sus propios usuarios, asígnalos primero a usuarios de Whop. Consulta [Sincroniza tus usuarios](https://docs.whop.com/es/developer/guides/chat/sync-users.md).

**2. Crea el canal de MD**

Usa [Create Channel](https://docs.whop.com/es/api-reference/channels/create-channel.md) con `kind` establecido en `private` para crear la conversación. Enumera los demás miembros en `participant_user_ids`. Con una clave de API de cuenta, pasa también `sender_user_id`.

**3. Añade más miembros cuando sea necesario**

Usa [Add Channel Member](https://docs.whop.com/es/api-reference/channel-members/add-channel-member.md) para añadir un usuario a un MD existente. Usa [Remove Channel Member](https://docs.whop.com/es/api-reference/channel-members/remove-channel-member.md) para eliminar uno.

**4. Muestra la conversación o la lista**

Usa el [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md) para un solo MD o el [DMs list element](https://docs.whop.com/es/developer/guides/chat/dms-list-element.md) para que los usuarios elijan entre sus conversaciones.

Después, muestra el MD con el ID de canal devuelto:

> [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
> )
> ```

## Gestionar mensajes directos

Usa [List Channels](https://docs.whop.com/es/api-reference/channels/list-channels.md) con `kind` establecido en `private`, [Update Channel](https://docs.whop.com/es/api-reference/channels/update-channel.md) y [Delete Channel](https://docs.whop.com/es/api-reference/channels/delete-channel.md) para gestionar las conversaciones.

Usa [List Channel Members](https://docs.whop.com/es/api-reference/channel-members/list-channel-members.md), [Add Channel Member](https://docs.whop.com/es/api-reference/channel-members/add-channel-member.md) y [Remove Channel Member](https://docs.whop.com/es/api-reference/channel-members/remove-channel-member.md) para gestionar los participantes.

> [!TIP]
>
> Si usas el DMs list element, mantenlo vinculado a tu cuenta para que los usuarios solo vean las conversaciones de tu experiencia de chat incrustado.

## Próximos pasos

> [card] [DMs list element](https://docs.whop.com/es/developer/guides/chat/dms-list-element.md)
>
> Muestra las conversaciones de MD y gestiona la selección de canales.

> [card] [Sincroniza tus usuarios](https://docs.whop.com/es/developer/guides/chat/sync-users.md)
>
> Crea o asigna usuarios de Whop antes de crear canales de MD.


## Related topics

- [Canales del chat incrustado](https://docs.whop.com/es/developer/guides/chat/channels.md)
- [Playground del chat incrustado](https://docs.whop.com/es/developer/guides/chat/playground.md)
- [Temas y estilos del chat incrustado](https://docs.whop.com/es/developer/guides/chat/theming-and-styles.md)
