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

# 임베디드 채팅 채널

> 상품 및 멤버십에 연결된 공유 채팅방으로 채널을 사용하세요

채널은 많은 사용자를 위한 공유 채팅방을 제공합니다. 커뮤니티, 코호트, 이벤트 방, 멤버 전용 공지 등 상품 멤버십에 따라 접근 권한이 정해져야 하는 모든 대화에 사용하세요.

각 채널은 Chat 경험으로 구동됩니다. 고객은 해당 경험이 포함된 상품에 접근할 수 있을 때 채널에 접근할 수 있습니다.

## 채널을 사용해야 하는 경우

몇몇 사용자 간의 비공개 대화가 아니라 상품이나 커뮤니티에 속한 방이 필요할 때 채널을 사용하세요.

예시:

* 유료 커뮤니티의 메인 채팅방
* 강좌 코호트 토론방
* 관리자만 게시할 수 있는 공지 채널
* 상위 등급 상품에 연결된 프리미엄 방
* 접근 권한을 구매한 멤버를 위한 라이브 이벤트 채팅

### 채널의 차별점

채널은 상품 기반 방과 커뮤니티를 위한 채팅 유형입니다.

* Chat 경험으로 구동되며 상품에 연결할 수 있습니다.
* 접근 권한이 상품 멤버십을 따르므로 상품에 접근할 수 있는 모든 사람이 참여할 수 있습니다.
* DM에 적용되는 50명 제한 없이 대규모 방과 커뮤니티를 지원합니다.
* 미디어, 링크, 반응, 차단 단어, 게시 권한, 게시 쿨다운에 대한 모더레이션 제어 기능이 포함됩니다.
* 게시를 관리자로 제한하여 읽기 전용 또는 공지 형식으로 만들 수 있습니다.

### 제약 사항

* 사용자가 참여하려면 Chat 경험이 포함된 상품에 접근할 수 있어야 합니다.
* 채널은 DM 목록에 표시되지 않습니다. [Chat 요소](https://docs.whop.com/ko/developer/guides/chat/chat-element.md)로 직접 렌더링하세요.
* 채널은 사용자 간 비공개 대화나 소규모 그룹 대화용이 아닙니다. 이러한 경우에는 [다이렉트 메시지](https://docs.whop.com/ko/developer/guides/chat/direct-messages.md)를 사용하세요.
* 채널에는 지원 받은편지함이나 열림/해결됨 워크플로가 없습니다. 고객 지원에는 [지원 채팅](https://docs.whop.com/ko/developer/guides/chat/support-chats.md)을 사용하세요.

## 접근 모델

채널은 보통 멤버십으로 접근이 제한됩니다:

1. Chat 경험을 생성합니다.
2. 경험을 상품에 연결합니다.
3. 체크아웃이나 무료 멤버십을 통해 사용자에게 상품 접근 권한을 부여합니다.
4. 채널 ID를 사용해 `ChatElement`로 채널을 렌더링합니다.

> [!NOTE]
>
> 채널 ID는 `chat_feed_`로 시작합니다. `exp_`로 시작하는 Chat 경험 ID로도 채널을 조회할 수 있습니다.

## 채널 설정하기

**1. 상품 생성 또는 선택하기**

채널 접근 권한을 부여할 상품을 생성하세요. 사용자는 상품과 멤버십을 통해 채널 경험에 접근합니다.

**2. Chat 경험 생성하기**

Chat 앱의 경험을 생성하세요. 대시보드에서는 상품에 추가하는 Chat 앱이 이에 해당합니다. API에서는 [Create Experience](https://docs.whop.com/ko/api-reference/legacy/experiences/create-experience.md)를 사용하세요.

**3. 경험을 상품에 연결하기**

[Attach Experience](https://docs.whop.com/ko/api-reference/legacy/experiences/attach-experience.md)로 경험을 연결하세요. 이렇게 하면 해당 상품에 접근할 수 있는 고객이 채널을 사용할 수 있습니다.

**4. 사용자에게 접근 권한 부여하기**

사용자가 체크아웃을 통해 상품을 구매하게 하거나, 무료 변형으로 접근 권한을 제공하는 경우 [멤버십에 초대](https://docs.whop.com/ko/api-reference/memberships/invite-to-a-membership.md)하세요.

**5. 채널 렌더링하기**

채널 ID를 [Chat 요소](https://docs.whop.com/ko/developer/guides/chat/chat-element.md)에 전달하세요. 경험 ID만 있다면 [Retrieve Channel](https://docs.whop.com/ko/api-reference/channels/retrieve-channel.md)에 전달해 채널을 가져오세요.

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

## 채널 관리하기

채널은 누가 참여할 수 있고 멤버가 무엇을 게시할 수 있는지 제어하는 모더레이션 도구를 지원합니다. 예를 들어 관리자만 메시지를 보낼 수 있는 공지 채널을 만들거나, 미디어나 링크를 제한하거나, 단어를 차단하거나, 게시 쿨다운으로 시끄러운 대화의 속도를 늦출 수 있습니다.

모더레이션 옵션의 전체 목록은 [Update Channel](https://docs.whop.com/ko/api-reference/channels/update-channel.md)의 `moderation` 필드를 참고하세요.

## 다음 단계

> [card] [Chat 요소](https://docs.whop.com/ko/developer/guides/chat/chat-element.md)
>
> 앱에서 채널, DM 또는 지원 채팅을 렌더링합니다.

> [card] [인증](https://docs.whop.com/ko/developer/guides/chat/authentication.md)
>
> 채널 메시지를 읽고 보내는 데 필요한 범위로 토큰을 발급합니다.
