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

# Websites

> Los sitios web de una cuenta: cada sitio creado en whop.site más cada dominio del que informa el Whop Pixel, con el tráfico y los ingresos atribuidos por dominio. Monta `websites` y los lista con visitantes, páginas vistas, ventas, ingresos, tendencia y páginas más vistas. Monta `pixel-setup` a su lado y un sitio cuyo píxel el asistente acaba de comprobar como activo obtiene automáticamente una fila de espera, porque sus primeros eventos tardan unos minutos en llegar a la API de estadísticas y, de lo contrario, el sitio parecería perdido: no tienes que conectar nada para ello, y la fila se conserva en tu página para que siga ahí si el comerciante recarga. Leer estadísticas es privilegiado, así que necesita un `accessToken`, excepto dentro de la propia app de Whop, donde la sesión del visitante lleva la lectura.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

*Desde `v1.0.0`.*

## Playground

Combina los elementos con datos de ejemplo. Usa los controles, añade y organiza elementos, y observa cómo se disparan los eventos en vivo:

```tsx React theme={null}
import { WhopElements, Websites } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Websites /* options */>
        {/* mount elements here */}
      </Websites>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const websites = window.WhopElements().websites.create({ /* options */ });
</script>
```

## Opciones

Pásalas a `whop.websites.create({ … })`, o como props de `<Websites>` en React.

**windowDays** `number`

Cuántos días de tráfico cubre la tabla, de 1 a 90. @default 30 Por defecto es `30`.

**includeApps** `boolean`

Lista los sitios web creados en whop.site desde el momento en que existen, con ceros hasta que llega el tráfico. Desactívalo para mostrar solo los dominios de los que informa el píxel. @default true Por defecto es `true`.

**pendingWebsites** `PendingWebsite[]`

Sitios web que acabas de añadir y que aún no están activos: `{ domain, kind }`, donde `kind` es `deploy` para un sitio en whop.site que espera su primer despliegue o `events` para un sitio que espera sus primeros eventos del píxel. Se renderizan como filas de espera para que un sitio nunca parezca perdido justo después de configurarlo, y la tabla sondea mientras quede alguno pendiente. Los sitios que el asistente `pixel-setup` montado comprueba como activos se añaden por ti, se conservan tras una recarga y NO son tu responsabilidad: esto es para las esperas que el handle no puede ver por sí mismo, sobre todo un sitio en whop.site que acabas de crear, del que ningún elemento de aquí informa. Las entradas que añades te corresponde eliminarlas a ti: una fila deja de dibujarse cuando su dominio llega a la tabla, pero la propia lista solo cambia cuando tú la cambias, así que elimina una entrada cuando `websitesLoaded` nombre su dominio y aplica tu propio tiempo de espera al resto. Por defecto es `[]`.

**propiedades**

**domain** `string` *required*

**kind** `"events" | "deploy"` *required*

**showVerify** `boolean`

Añade un botón de comprobación del píxel a cada fila. El elemento solo informa de la pulsación a través de `onVerifyRequested`: abrir el sitio y decidir el resultado te corresponde a ti, porque una ventana emergente abierta por tu propia página es aquella en la que confían los navegadores. Por defecto es `false`.

**showSettings** `boolean`

Añade un botón de ajustes a las filas de whop.site. El elemento solo informa de la pulsación a través de `onSettingsRequested`: la superficie de edición es tuya. Por defecto es `false`.

**showEdit** `boolean`

Añade un botón de edición a las filas de whop.site, con el estilo de la acción principal de la fila. El elemento solo informa de la pulsación a través de `onEditRequested`: la superficie de edición es tuya. Por defecto es `false`.

**verifyTarget** `string`

A qué fila pertenece la comprobación en curso: el `target` del evento `verifyRequested` que estás gestionando. Por defecto es `""`.

**verifyStatus** `string`

Cómo va la comprobación en curso, mostrado en el botón de esa fila: `waiting`, `connected`, `not-detected` o `blocked` cuando se bloqueó la ventana emergente. Por defecto es `"idle"`.

Uno de `"idle"`, `"waiting"`, `"connected"`, `"not-detected"` o `"blocked"`.

**accessToken** `string`

Un token con alcance limitado para las lecturas: las estadísticas necesitan `stats:read`, y la lista de sitios web de whop.site lee apps (las filas se reducen a solo tráfico si el token no puede hacerlo). Genéralo en tu servidor con `POST /api/v1/access_tokens` y establece uno nuevo antes de que caduque. `pixel-setup` es el único hijo en el que no se proyecta: autentica sus propios escaneos con su propio `accessToken`, así que genera un único token que incluya ambos conjuntos de scopes y pasa esa misma cadena a ambos, en lugar de un token por elemento. Si se omite, las lecturas llevan la propia sesión del visitante, que solo responde en el mismo origen.

**accountId** `string` *required*

ID de la cuenta, con el prefijo `biz_`, cuyos sitios web leen estas superficies.

**appearance** `Appearance`

Personalización visual para los elementos de este grupo. Anula el `WhopElements({ appearance })` global. Cámbiala en vivo con `update({ appearance })`.

**locale** `WhopElementsLocale`

Configuración regional para el texto de la interfaz de los elementos de este grupo. Establécela en una de las configuraciones regionales incluidas en la app para anular la configuración global. Cualquier otro valor recurre a la configuración regional predeterminada.

## Eventos

Pasa los callbacks en las opciones de creación o como props de React.

### `onLoadingChange`

Se ejecuta cuando cambia el estado de carga agrupado. El valor es `true` mientras algún elemento montado siga cargando.

**loading** `boolean`

## Métodos

Llámalos en el handle de Websites obtenido de `whop.websites.create({ … })` o `useWebsites()`.

### `update`

Combina nuevas opciones del handle en todos los elementos montados. En React, cambia las props del namespace en su lugar.

**Parámetros**

**options** `Partial\<WebsitesOptions\>` *required*

### `destroy`

Destruye todos los elementos y subcontroladores que creó este handle, elimina el frame del controlador y libera sus suscripciones. Puedes llamarlo más de una vez, pero un handle destruido rechaza cualquier otra llamada: crea un nuevo handle para empezar de nuevo. React elimina el grupo automáticamente cuando el provider se desmonta.

## Elementos

Los elementos que monta este grupo. Cada uno tiene su propia página:

> [card] [WebsitesElement](https://docs.whop.com/es/elements/latest/websites/websites.md)
>
> Los sitios web de una cuenta en una sola tabla: cada sitio creado en whop.site (listado desde el momento en que existe, con ceros hasta que llega el tráfico) combinado por nombre de host con cada dominio del que informa el Whop Pixel. Las filas de los sitios de whop.site llevan una marca de Whop, para que las dos fuentes se distingan incluso cuando ambas tienen tráfico. Cada fila muestra una tendencia de páginas vistas, visitantes únicos, páginas vistas, ventas atribuidas, ingresos en USD y el último día en que llegó un evento. Al desplegar un dominio se cargan sus páginas más vistas, y cada cifra de páginas vistas abre el desglose de los eventos que la componen. Establece `showVerify` para añadir un botón por fila que pide a la página que aloja este elemento que abra el sitio y confirme que el píxel se está disparando; establece `showSettings` para añadir un botón de ajustes en las filas de whop.site que informa del clic a través de `onSettingsRequested`, y `showEdit` para añadir un botón principal de edición que informa a través de `onEditRequested`: tu página se encarga de la edición propiamente dicha.

> [card] [PixelSetupElement](https://docs.whop.com/es/elements/latest/websites/pixel-setup.md)
>
> Instala el Whop Pixel y conecta los eventos de conversión: copia el snippet, comprueba que está en una página y confirma que los eventos se disparan. Móntalo en línea o dentro de tu propio overlay.


## Related topics

- [WebsitesElement](https://docs.whop.com/es/elements/latest/websites/websites.md)
- [Implementa un negocio a partir de un blueprint](https://docs.whop.com/es/developer/websites/blueprints.md)
- [Aloja un sitio web en Whop](https://docs.whop.com/es/developer/websites/overview.md)
