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

# 지원 채팅

> 내 계정과 고객 간의 1:1 고객 지원 대화에 지원 채팅을 사용하세요

지원 채팅은 고객과 내 계정 간의 1:1 대화입니다. 대화가 공식 지원이거나, 팀 멤버가 볼 수 있어야 하거나, 열림/해결됨 워크플로가 필요할 때 사용하세요.

다이렉트 메시지와 달리 지원 채팅은 내 계정과의 고객 지원 관계를 중심으로 대화를 구성합니다. 사용자 간 메시지가 아니라 고객 서비스에 가장 적합합니다.

## 지원 채팅을 사용해야 하는 경우

팀이 계정으로서 고객에게 응답해야 할 때 지원 채팅을 사용하세요.

예시:

* 유료 멤버를 위한 도움말 받은편지함
* 결제 또는 계정 지원 대화
* 체크아웃 후 구매자 지원 스레드
* 크리에이터와 고객 간 지원 창구
* 앱에서 Whop 호스팅 채팅 UI로 이어지는 에스컬레이션 경로

### 지원 채팅의 차별점

지원 채팅은 고객과 계정 간의 공식 대화를 위한 채팅 유형입니다.

* 각 지원 채팅은 한 명의 고객을 내 계정과 연결합니다.
* 고객에게는 대화가 일반 DM 형식의 채팅처럼 동작하며 DM 목록에 표시될 수 있습니다.
* 팀 멤버는 열림 및 해결됨 상태가 있는 받은편지함을 통해 지원 채팅을 관리합니다.
* 팀 멤버는 고객, 상태, 관리자/팀 보기별로 지원 채팅을 나열, 정렬, 필터링할 수 있습니다.
* 모더레이터는 전체 계정 관리자 권한 없이도 지원 채팅 응답을 도울 수 있습니다.

### 제약 사항

* 지원 채팅은 사용자 간 그룹 대화용이 아닙니다. 이러한 경우에는 [다이렉트 메시지](https://docs.whop.com/ko/developer/guides/chat/direct-messages.md)를 사용하세요.
* 지원 채팅은 관리자의 DM 목록 컴포넌트에 표시되지 않습니다. 대신 지원 채널 API로 지원 받은편지함을 구축하세요.
* 지원 채팅은 상품이나 멤버십 방 접근 권한을 부여하지 않습니다. 멤버 전용 방에는 [채널](https://docs.whop.com/ko/developer/guides/chat/channels.md)을 사용하세요.
* 지원 채팅은 사용자 간 DM이 아닙니다. 사용자끼리 직접 메시지를 주고받아야 한다면 [다이렉트 메시지](https://docs.whop.com/ko/developer/guides/chat/direct-messages.md)를 사용하세요.

## 접근 모델

지원 채팅은 계정과 고객에게 속합니다. 지원 접근 권한이 있는 팀 멤버는 계정의 지원 채팅을 나열하고 응답할 수 있습니다. 고객은 필요한 지원 범위로 인증되면 자신의 지원 채팅을 렌더링하고 참여할 수 있습니다.

팀원이 전체 관리자 권한 없이 지원 채팅 관리를 도와야 한다면 모더레이터 역할의 팀 멤버로 추가하세요. 모더레이터는 더 넓은 계정 설정에 대한 접근은 제한된 상태로 고객 대화 처리를 도울 수 있습니다.

> [!NOTE]
>
> 지원 채팅 ID는 `feed_`로 시작합니다.

## 지원 채팅 설정하기

**1. 고객 동기화 또는 식별하기**

고객의 Whop 사용자 ID 또는 사용자 이름이 필요합니다. 앱에 자체 사용자 시스템이 있다면 먼저 [사용자 동기화하기](https://docs.whop.com/ko/developer/guides/chat/sync-users.md)로 사용자를 매핑하세요.

**2. 지원 채널 생성하기**

`kind`를 `support`로 설정하고 `account_id`와 고객의 `customer_user_id`를 전달해 [Create Channel](https://docs.whop.com/ko/api-reference/channels/create-channel.md)을 사용하세요. 해당 고객의 지원 채팅이 이미 있으면 Whop은 기존 지원 채팅을 반환합니다.

**3. 대화 렌더링하기**

반환된 지원 채널 ID를 [Chat 요소](https://docs.whop.com/ko/developer/guides/chat/chat-element.md)에 전달하세요.

**4. 팀을 위한 지원 채팅 나열하기**

`kind`를 `support`로, `support_role`을 `staff`로 설정한 [List Channels](https://docs.whop.com/ko/api-reference/channels/list-channels.md)를 사용해 팀을 위한 받은편지함을 구축하세요.

그런 다음 반환된 채널 ID로 지원 채팅을 렌더링하세요:

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

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

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

## 지원 채팅 관리하기

지원 채팅을 관리하려면 [Create Channel](https://docs.whop.com/ko/api-reference/channels/create-channel.md), [List Channels](https://docs.whop.com/ko/api-reference/channels/list-channels.md), [Retrieve Channel](https://docs.whop.com/ko/api-reference/channels/retrieve-channel.md)을 사용하세요. 대화의 완료 여부를 추적하려면 [Resolve Support Channel](https://docs.whop.com/ko/api-reference/channels/resolve-support-channel.md)과 [Reopen Support Channel](https://docs.whop.com/ko/api-reference/channels/reopen-support-channel.md)을 사용하세요.

지원 채팅은 받은편지함 형식의 워크플로도 지원합니다. 열린 대화, 해결된 대화, 고객에게 보이는 대화, 팀/관리자 보기를 위한 뷰를 구축할 수 있습니다. `status`와 `awaiting_reply` 같은 사용 가능한 필터는 [List Channels](https://docs.whop.com/ko/api-reference/channels/list-channels.md)를 참고하세요.

## 다음 단계

> [card] [Chat 요소](https://docs.whop.com/ko/developer/guides/chat/chat-element.md)
>
> 지원 채팅을 생성하거나 조회한 후 렌더링합니다.

> [card] [인증](https://docs.whop.com/ko/developer/guides/chat/authentication.md)
>
> 토큰 엔드포인트에 지원 채팅 범위를 추가합니다.
