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

# Canales del chat incrustado

> Usa canales para salas de chat compartidas vinculadas a productos y membresías

Los canales ofrecen salas de chat compartidas para muchos usuarios. Úsalos para comunidades, grupos de alumnos, salas de eventos, anuncios exclusivos para miembros o cualquier conversación en la que el acceso deba depender de la membresía de un producto.

Cada canal funciona con una experiencia de Chat. Los clientes pueden acceder al canal cuando tienen acceso a un producto que contiene esa experiencia.

## Cuándo usar canales

Usa un canal cuando quieras una sala que pertenezca a un producto o a una comunidad, no una conversación privada entre unos pocos usuarios.

Ejemplos:

* La sala de chat principal de una comunidad de pago
* Una sala de debate para un grupo de un curso
* Un canal de anuncios en el que solo los administradores pueden publicar
* Una sala premium vinculada a un producto de nivel superior
* Un chat de un evento en directo para los miembros que compraron el acceso

### Qué diferencia a los canales

Los canales son el tipo de chat para salas y comunidades respaldadas por productos.

* Funcionan con experiencias de Chat y puedes vincularlos a productos.
* El acceso depende de la membresía del producto, así que todos los que tienen acceso al producto pueden participar.
* Admiten salas y comunidades grandes sin el límite de 50 miembros que se aplica a los MD.
* Incluyen controles de moderación para contenido multimedia, enlaces, reacciones, palabras bloqueadas, permisos de publicación y tiempos de espera entre publicaciones.
* Puedes hacerlos de solo lectura o de tipo anuncios limitando la publicación a los administradores.

### Limitaciones

* Los usuarios necesitan acceso al producto que contiene la experiencia de Chat antes de poder participar.
* Los canales no aparecen en la lista de MD. Muéstralos directamente con el [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md).
* Los canales no son para conversaciones privadas entre usuarios ni para grupos pequeños. Para eso, usa los [mensajes directos](https://docs.whop.com/es/developer/guides/chat/direct-messages.md).
* Los canales 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).

## Modelo de acceso

Los canales suelen estar restringidos por membresía:

1. Crea una experiencia de Chat.
2. Vincula la experiencia a un producto.
3. Da a los usuarios acceso al producto mediante el checkout o una membresía gratuita.
4. Muestra el canal con el `ChatElement` usando el ID del canal.

> [!NOTE]
>
> Los ID de canal empiezan por `chat_feed_`. También puedes obtener un canal por el ID de la experiencia de Chat, que empieza por `exp_`.

## Configurar un canal

**1. Crea o elige un producto**

Crea el producto que debe dar acceso al canal. Los usuarios obtienen acceso a las experiencias de canal mediante productos y membresías.

**2. Crea una experiencia de Chat**

Crea una experiencia para la app Chat. En el panel, es la app Chat que añades a un producto. A través de la API, usa [Create Experience](https://docs.whop.com/es/api-reference/legacy/experiences/create-experience.md).

**3. Vincula la experiencia al producto**

Vincula la experiencia con [Attach Experience](https://docs.whop.com/es/api-reference/legacy/experiences/attach-experience.md). Así el canal queda disponible para los clientes con acceso a ese producto.

**4. Da acceso a los usuarios**

Permite que los usuarios compren el producto mediante el checkout o [invítalos a una membresía](https://docs.whop.com/es/api-reference/memberships/invite-to-a-membership.md) si das acceso mediante una variante gratuita.

**5. Muestra el canal**

Pasa el ID del canal al [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md). Si solo tienes el ID de la experiencia, pásalo a [Retrieve Channel](https://docs.whop.com/es/api-reference/channels/retrieve-channel.md) para obtener el canal.

> [tab] React
>
> ```tsx theme={null}
> <ChatElement
>   options={{ channelId: "chat_feed_XXXXXXXXXXXXXX" }}
>   style={{ height: "100dvh", width: "100%" }}
> />
> ```

> [tab] Vanilla JS
>
> ```typescript theme={null}
> const chatElement = session.createElement("chat-element", {
>   channelId: "chat_feed_XXXXXXXXXXXXXX",
> });
>
> chatElement.mount("#chat-container");
> ```

> [tab] Swift
>
> ```swift theme={null}
> WhopChatView(
>     channelId: "chat_feed_XXXXXXXXXXXXXX",
>     style: .imessage
> )
> ```

## Gestionar canales

Los canales admiten herramientas de moderación para controlar quién puede participar y qué pueden publicar los miembros. Por ejemplo, puedes crear un canal de anuncios en el que solo los administradores puedan enviar mensajes, limitar el contenido multimedia o los enlaces, bloquear palabras o ralentizar conversaciones con mucho ruido mediante tiempos de espera entre publicaciones.

Consulta el campo `moderation` de [Update Channel](https://docs.whop.com/es/api-reference/channels/update-channel.md) para ver la lista completa de opciones de moderación.

## Próximos pasos

> [card] [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md)
>
> Muestra un canal, un MD o un chat de soporte en tu app.

> [card] [Autenticación](https://docs.whop.com/es/developer/guides/chat/authentication.md)
>
> Genera tokens con los alcances necesarios para leer y enviar mensajes del canal.
