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

# Alojamiento de sitios web en Whop

> Cómo ejecuta Whop tu sitio web a partir de la compilación que subes, sin ningún servidor que configurar.

Whop sirve tu sitio directamente desde la compilación que subes. No hay ningún servidor que configurar ni ningún destino de implementación al que apuntar.

## Compilaciones y versiones

Cada implementación produce una compilación, y exactamente una está en producción en cada momento.

```bash theme={null}
whop apps deploy                            # build, upload, promote
whop apps deploy --preview                  # upload only
whop apps builds promote abld_xxxxxxxx      # make a build live
```

Promover una compilación anterior es la forma de revertir; no hay un comando de reversión aparte. En el panel, usa la pestaña **Versions**.

El plugin de Vite empaqueta tu compilación en el archivo que se sube: los recursos de `dist/client` se sirven directamente y `dist/server` ejecuta tu código de servidor.

## Secretos

Los secretos de la app son vinculaciones cifradas que se convierten en variables de entorno en tiempo de ejecución.

```bash theme={null}
whop apps secrets list
whop apps secrets set --secret MAIL_API_KEY=mail-key-123
whop apps secrets unset --key MAIL_API_KEY
```

Ejecútalos dentro de un proyecto vinculado o pasa `--app app_xxxxxxxx`. `whop apps dev` inyecta los mismos secretos en local, excepto los nombres que controlan el runtime local. Una variable de entorno que exportes tú mismo siempre tiene prioridad.

El runtime también establece:

| Vinculación | Propósito |
| - | - |
| `APP_ID` | La app que se está sirviendo |
| `BUILD_ID` | La compilación promovida actualmente |
| `WHOP_API_ORIGIN` | El origen de la API de Whop contra el que construir las solicitudes |
| `WHOP_ACCOUNT_ID` | El id `biz_` de la cuenta propietaria de la app, para limitar las lecturas de la API a tu propio catálogo |
| `ASSETS` | Sirve tus recursos estáticos |
| `REALTIME` | Da soporte a las conexiones en tiempo real |

> [!NOTE]
>
> Estos nombres están reservados: un secreto con el mismo nombre se ignora.

## Llama a la API de Whop

Las llamadas `fetch` del lado del servidor pasan por un proxy de salida que adjunta la clave de API de la app a las solicitudes a la API de Whop:

```typescript src/routes/api.account.ts theme={null}
const response = await fetch(`${process.env.WHOP_API_ORIGIN}/api/v1/accounts/me`);
const account = await response.json();
```

La clave nunca llega a tu código, así que no se puede leer, registrar ni empaquetar. Las solicitudes a otros destinos pasan sin cambios.

* **Solo se firman las llamadas del lado del servidor.** Un `fetch` del navegador sale de la máquina del visitante, no de tu servidor; dirígelos a través de tu propio manejador.
* **Envía `x-whop-inject-key: none`** para dejar una solicitud del lado del servidor sin autenticar.

> [!WARNING]
>
> La clave inyectada pertenece al propio negocio de la app y no puede mover dinero. Se conceden las **lecturas** de pagos salientes y transferencias. Retirar fondos, enviar transferencias y gestionar destinos de pago no, así que esas operaciones devuelven un error de scope hasta que proporciones tu propia clave. Además, se autentica como tu negocio, nunca como el visitante; para la identidad del visitante, usa [OAuth](https://docs.whop.com/es/developer/guides/oauth.md).

## Ejecuciones programadas

Una app alojada también puede ejecutarse con un cron, sin que intervenga ninguna solicitud: establece `schedule` o `per_install_schedule` en la app y exporta `scheduled()` junto a `fetch()`. Consulta [Ejecuciones programadas](https://docs.whop.com/es/developer/guides/scheduled-runs.md).

## Registros

El runtime captura cada `console.log`, excepción no capturada y solicitud fallida durante 7 días.

```bash theme={null}
whop apps logs app_xxxxxxxx
whop apps logs app_xxxxxxxx --level error
whop apps logs app_xxxxxxxx --query "checkout"
```

Usa `--created_after` y `--created_before` con marcas de tiempo ISO 8601 para seleccionar un intervalo. Los errores de JavaScript del lado del cliente no aparecen aquí: están en la consola del navegador del visitante.

## Próximos pasos

> [card] [Haz seguimiento de los visitantes](https://docs.whop.com/es/developer/websites/tracking.md)
>
> El píxel ya está instalado: añade tus propios eventos.

> [card] [Blueprints](https://docs.whop.com/es/developer/websites/blueprints.md)
>
> Empieza a partir de un negocio que funciona en lugar de un proyecto vacío.

> [card] [Acepta pagos](https://docs.whop.com/es/developer/guides/accept-payments.md)
>
> Vende directamente desde el sitio que alojas.

> [card] [Referencia de la CLI](https://docs.whop.com/es/developer/cli.md)
>
> Todos los comandos `whop apps`.


## Related topics

- [Aloja un sitio web en Whop](https://docs.whop.com/es/developer/websites/overview.md)
- [Crea un sitio web con la CLI](https://docs.whop.com/es/developer/websites/quickstart.md)
- [Descripción general de la API de Whop](https://docs.whop.com/es/api-reference/overview.md)
