> ## 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 de soporte

> Usa los chats de soporte para conversaciones individuales de atención al cliente con tu cuenta

Los chats de soporte son conversaciones individuales entre un cliente y tu cuenta. Úsalos cuando la conversación sea de soporte oficial, deba ser visible para los miembros del equipo o deba tener un flujo de abierto/resuelto.

A diferencia de los mensajes directos, los chats de soporte organizan las conversaciones en torno a una relación de atención al cliente con tu cuenta. Son ideales para el servicio al cliente, no para la mensajería entre usuarios.

## Cuándo usar chats de soporte

Usa los chats de soporte cuando tu equipo necesite responder a los clientes en nombre de la cuenta.

Ejemplos:

* Una bandeja de ayuda para miembros de pago
* Una conversación de soporte sobre facturación o la cuenta
* Un hilo de soporte al comprador después del checkout
* Una línea de soporte del creador al cliente
* Una vía de escalado desde tu app hacia la interfaz de chat alojada por Whop

### Qué diferencia a los chats de soporte

Los chats de soporte son el tipo de chat para las conversaciones oficiales entre un cliente y una cuenta.

* Cada chat de soporte conecta a un cliente con tu cuenta.
* Para el cliente, la conversación se comporta como un chat normal de tipo MD y puede aparecer en su lista de MD.
* Los miembros del equipo gestionan los chats de soporte desde una bandeja con estados abierto y resuelto.
* Los miembros del equipo pueden listar, ordenar y filtrar los chats de soporte por cliente, estado y vista de administrador/equipo.
* Los moderadores pueden ayudar a responder a los chats de soporte sin obtener acceso completo de administrador a la cuenta.

### Limitaciones

* Los chats de soporte no son para conversaciones de grupo entre usuarios. Para eso, usa los [mensajes directos](https://docs.whop.com/es/developer/guides/chat/direct-messages.md).
* Los chats de soporte no aparecen en el componente de lista de MD para los administradores. En su lugar, crea una bandeja de soporte con la API de canales de soporte.
* Los chats de soporte no dan acceso a salas de productos o membresías. Para salas exclusivas para miembros, usa [canales](https://docs.whop.com/es/developer/guides/chat/channels.md).
* Los chats de soporte no son MD entre usuarios. Usa los [mensajes directos](https://docs.whop.com/es/developer/guides/chat/direct-messages.md) cuando los usuarios deban escribirse directamente.

## Modelo de acceso

Un chat de soporte pertenece a una cuenta y a un cliente. Los miembros del equipo con acceso de soporte pueden listar y responder a los chats de soporte de la cuenta. El cliente puede mostrar su propio chat de soporte y participar en él cuando se autentica con los alcances de soporte necesarios.

Si alguien de tu equipo debe ayudar a gestionar los chats de soporte sin obtener acceso completo de administrador, añádelo como miembro del equipo con el rol de moderador. Los moderadores pueden ayudar a gestionar las conversaciones con los clientes con un acceso restringido a los ajustes generales de la cuenta.

> [!NOTE]
>
> Los ID de chat de soporte empiezan por `feed_`.

## Configurar un chat de soporte

**1. Sincroniza o identifica al cliente**

Necesitas el ID de usuario o el nombre de usuario de Whop del cliente. Si tu app tiene su propio sistema de usuarios, asigna primero los usuarios con [Sincroniza tus usuarios](https://docs.whop.com/es/developer/guides/chat/sync-users.md).

**2. Crea el canal de soporte**

Usa [Create Channel](https://docs.whop.com/es/api-reference/channels/create-channel.md) con `kind` establecido en `support`, tu `account_id` y el `customer_user_id` del cliente. Whop devuelve el chat de soporte existente si ya hay uno para ese cliente.

**3. Muestra la conversación**

Pasa el ID del canal de soporte devuelto al [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md).

**4. Lista los chats de soporte para tu equipo**

Usa [List Channels](https://docs.whop.com/es/api-reference/channels/list-channels.md) con `kind` establecido en `support` y `support_role` establecido en `staff` para crear una bandeja de entrada para tu equipo.

Después, muestra el chat de soporte 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 chats de soporte

Usa [Create Channel](https://docs.whop.com/es/api-reference/channels/create-channel.md), [List Channels](https://docs.whop.com/es/api-reference/channels/list-channels.md) y [Retrieve Channel](https://docs.whop.com/es/api-reference/channels/retrieve-channel.md) para gestionar los chats de soporte. Usa [Resolve Support Channel](https://docs.whop.com/es/api-reference/channels/resolve-support-channel.md) y [Reopen Support Channel](https://docs.whop.com/es/api-reference/channels/reopen-support-channel.md) para controlar si una conversación ha terminado.

Los chats de soporte también admiten flujos de trabajo de tipo bandeja de entrada. Puedes crear vistas para conversaciones abiertas, conversaciones resueltas, conversaciones visibles para el cliente y vistas de equipo/administrador. Consulta [List Channels](https://docs.whop.com/es/api-reference/channels/list-channels.md) para ver los filtros disponibles, como `status` y `awaiting_reply`.

## Próximos pasos

> [card] [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md)
>
> Muestra un chat de soporte después de crearlo u obtenerlo.

> [card] [Autenticación](https://docs.whop.com/es/developer/guides/chat/authentication.md)
>
> Añade los alcances de chat de soporte a tu endpoint de token.


## Related topics

- [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md)
- [Canales del chat incrustado](https://docs.whop.com/es/developer/guides/chat/channels.md)
- [Inicio rápido del chat](https://docs.whop.com/es/developer/guides/chat/quickstart.md)
