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

# 웹사이트

> 계정의 웹사이트입니다. whop.site에 구축된 모든 사이트와 Whop Pixel이 보고하는 모든 도메인을 도메인별 트래픽 및 기여 매출과 함께 보여 줍니다. `websites`를 마운트하면 방문자, 페이지 조회수, 판매, 매출, 추세, 가장 많이 조회된 페이지와 함께 나열됩니다. 그 옆에 `pixel-setup`을 마운트하면, 마법사가 방금 픽셀 작동을 확인한 사이트에 대기 행이 자동으로 추가됩니다. 첫 이벤트가 통계 API에 도달하기까지 몇 분이 걸려 그렇지 않으면 사이트가 사라진 것처럼 보이기 때문입니다. 이를 위해 따로 연결할 것은 없으며, 행은 페이지에 유지되므로 판매자가 새로 고쳐도 그대로 남아 있습니다. 통계를 읽으려면 권한이 필요하므로 `accessToken`이 필요합니다. 단, 뷰어의 세션으로 읽을 수 있는 Whop 자체 앱 안에서는 예외입니다.

> [!NOTE]
>
> 이 페이지는 `@whop/elements@1.10.0` 및 `@whop/elements-react@1.10.0`을 다룹니다.

*Since `v1.0.0`.*

## Playground

예시 데이터로 엘리먼트를 조합해 보세요. 컨트롤을 조작하고, 엘리먼트를 추가 및 배치하고, 이벤트가 실시간으로 발생하는 것을 확인하세요.

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

## 옵션

`whop.websites.create({ … })`에 전달하거나, React에서는 `<Websites>`의 props로 전달하세요.

**windowDays** `number`

테이블이 다루는 트래픽 기간(일)으로, 1부터 90까지입니다. @default 30 기본값은 `30`입니다.

**includeApps** `boolean`

whop.site에 구축된 웹사이트를 생성된 순간부터 나열하며, 트래픽이 들어올 때까지는 0으로 표시합니다. 픽셀이 보고하는 도메인만 표시하려면 끄세요. @default true 기본값은 `true`입니다.

**pendingWebsites** `PendingWebsite[]`

방금 추가했지만 아직 활성화되지 않은 웹사이트로, `{ domain, kind }` 형식입니다. `kind`는 첫 배포를 기다리는 whop.site 사이트이면 `deploy`, 첫 픽셀 이벤트를 기다리는 사이트이면 `events`입니다. 설정 직후 사이트가 사라진 것처럼 보이지 않도록 대기 행으로 렌더링되며, 대기 중인 항목이 있는 동안 테이블이 폴링합니다. 마운트된 `pixel-setup` 마법사가 작동을 확인한 사이트는 자동으로 추가되고 새로 고침 후에도 유지되므로 직접 처리할 필요가 **없습니다**. 이 옵션은 핸들이 스스로 알 수 없는 대기, 특히 여기의 어떤 엘리먼트도 보고하지 않는 방금 만든 whop.site 사이트를 위한 것입니다. 직접 추가한 항목은 직접 제거해야 합니다. 도메인이 테이블에 나타나면 해당 행은 더 이상 그려지지 않지만, 목록 자체는 직접 변경할 때만 바뀝니다. 따라서 `websitesLoaded`에 해당 도메인이 포함되면 항목을 제거하고, 나머지에는 자체 타임아웃을 적용하세요. 기본값은 `[]`입니다.

**속성**

**domain** `string` *required*

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

**showVerify** `boolean`

각 행에 픽셀 확인 버튼을 추가합니다. 엘리먼트는 `onVerifyRequested`를 통해 버튼이 눌렸음을 보고할 뿐이며, 사이트를 열고 결과를 판단하는 것은 직접 해야 합니다. 브라우저는 자체 페이지가 연 팝업만 신뢰하기 때문입니다. 기본값은 `false`입니다.

**showSettings** `boolean`

whop.site 행에 설정 버튼을 추가합니다. 엘리먼트는 `onSettingsRequested`를 통해 버튼이 눌렸음을 보고할 뿐이며, 편집 화면은 직접 제공해야 합니다. 기본값은 `false`입니다.

**showEdit** `boolean`

whop.site 행에 행의 기본 작업 스타일로 편집 버튼을 추가합니다. 엘리먼트는 `onEditRequested`를 통해 버튼이 눌렸음을 보고할 뿐이며, 편집 화면은 직접 제공해야 합니다. 기본값은 `false`입니다.

**verifyTarget** `string`

진행 중인 확인이 속한 행으로, 처리 중인 `verifyRequested` 이벤트의 `target`입니다. 기본값은 `""`입니다.

**verifyStatus** `string`

진행 중인 확인의 상태로, 해당 행의 버튼에 표시됩니다: `waiting`, `connected`, `not-detected`, 또는 팝업이 차단된 경우 `blocked`. 기본값은 `"idle"`입니다.

`"idle"`, `"waiting"`, `"connected"`, `"not-detected"` 또는 `"blocked"` 중 하나입니다.

**accessToken** `string`

읽기에 사용되는 범위 지정 토큰입니다. 통계에는 `stats:read`가 필요하며, whop.site 웹사이트 목록은 앱을 읽습니다(토큰으로 읽을 수 없으면 행은 트래픽 정보만 표시합니다). 서버에서 `POST /api/v1/access_tokens`로 발급하고, 만료되기 전에 새 토큰을 설정하세요. `pixel-setup`은 이 토큰이 전달되지 않는 유일한 하위 엘리먼트입니다. 자체 `accessToken`으로 스캔을 인증하므로, 엘리먼트마다 토큰을 하나씩 발급하지 말고 두 스코프 세트를 모두 포함한 단일 토큰을 발급해 같은 문자열을 양쪽에 전달하세요. 생략하면 읽기에 뷰어 자신의 세션이 사용되며, 이는 동일 출처에서만 응답합니다.

**accountId** `string` *required*

이 화면들이 웹사이트를 읽을 계정 ID로, `biz_` 접두사가 붙습니다.

**appearance** `Appearance`

이 그룹 엘리먼트의 시각적 사용자 지정입니다. 전역 `WhopElements({ appearance })`를 재정의합니다. `update({ appearance })`로 실시간 변경할 수 있습니다.

**locale** `WhopElementsLocale`

이 그룹 엘리먼트 UI 텍스트의 로케일입니다. 앱에 빌드된 로케일 중 하나로 설정하면 전역 구성을 재정의합니다. 그 외의 값은 기본 로케일로 대체됩니다.

## 이벤트

생성 옵션 또는 React props로 콜백을 전달합니다.

### `onLoadingChange`

그룹 로딩 상태가 바뀔 때 실행됩니다. 마운트된 엘리먼트 중 하나라도 로딩 중이면 값은 `true`입니다.

**loading** `boolean`

## 메서드

`whop.websites.create({ … })` 또는 `useWebsites()`로 얻은 Websites 핸들에서 호출하세요.

### `update`

마운트된 모든 엘리먼트에 새 핸들 옵션을 병합합니다. React에서는 대신 네임스페이스 props를 변경하세요.

**매개변수**

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

### `destroy`

이 핸들이 만든 모든 엘리먼트와 하위 컨트롤러를 파괴하고, 컨트롤러 프레임을 제거하고, 구독을 해제합니다. 여러 번 호출할 수 있지만, 파괴된 핸들은 다른 모든 호출을 거부합니다. 다시 시작하려면 새 핸들을 만드세요. React는 프로바이더가 언마운트될 때 그룹을 자동으로 제거합니다.

## 엘리먼트

이 그룹이 마운트하는 엘리먼트입니다. 각 엘리먼트에는 자체 페이지가 있습니다.

> [card] [WebsitesElement](https://docs.whop.com/ko/elements/latest/websites/websites.md)
>
> 계정의 웹사이트를 하나의 테이블로 보여 줍니다. whop.site에 구축된 모든 사이트(생성된 순간부터 나열되며 트래픽이 들어올 때까지 0으로 표시)를 Whop Pixel이 보고하는 모든 도메인과 호스트 이름 기준으로 병합합니다. whop.site 사이트의 행에는 Whop 표시가 붙으므로 두 출처 모두에 트래픽이 있어도 구분됩니다. 각 행에는 페이지 조회수 추세, 순 방문자, 페이지 조회수, 기여 판매, USD 매출, 마지막으로 이벤트가 도착한 날짜가 표시됩니다. 도메인을 펼치면 가장 많이 조회된 페이지를 불러오고, 각 페이지 조회수 수치를 열면 어떤 이벤트로 구성되었는지 내역을 볼 수 있습니다. `showVerify`를 설정하면 이 엘리먼트를 호스팅하는 페이지에 사이트를 열어 픽셀 작동을 확인하도록 요청하는 행별 버튼이 추가됩니다. `showSettings`를 설정하면 whop.site 행에 `onSettingsRequested`로 클릭을 보고하는 설정 버튼이, `showEdit`를 설정하면 `onEditRequested`로 보고하는 기본 편집 버튼이 추가됩니다. 실제 편집은 자체 페이지에서 담당합니다.

> [card] [PixelSetupElement](https://docs.whop.com/ko/elements/latest/websites/pixel-setup.md)
>
> Whop Pixel을 설치하고 전환 이벤트를 연결합니다. 스니펫을 복사하고, 페이지에 설치되었는지 확인하고, 이벤트가 발생하는지 확인합니다. 인라인으로 마운트하거나 자체 오버레이 안에 마운트하세요.
