Skip to main content
1

API 키 생성하기

Whop 개발자 대시보드에서 API 키를 생성하고 서버에 WHOP_API_KEY로 저장하세요. 이 키를 사용하면 내 계정의 컨텍스트에서 작업을 수행할 수 있습니다. 서버에 보관하세요. 브라우저, 모바일 또는 클라이언트 측 코드에 절대 넣지 마세요.
2

패키지 설치하기

백엔드에 SDK를 설치하세요:
프런트엔드에 elements 패키지를 설치하세요:
웹 패키지가 내보내는 모든 클래스, 옵션, 타입은 패키지 레퍼런스에 나열되어 있습니다.
3

사용자의 사용자 ID 받기

채팅 토큰을 발급하기 전에 자체 사용자를 하위 계정으로 등록하세요. 이렇게 하면 플랫폼 사용자에 다시 매핑할 수 있는 Whop 계정이 생성됩니다.
결과로 받은 Whop 사용자 ID(응답의 owner_user.id)를 저장해 두고, 채팅 액세스 토큰을 생성할 때 user_id로 전달하세요. 사용자의 아바타와 표시 이름을 업데이트하는 방법에 대한 자세한 내용은 계정별 프로필을 참고하세요.
4

서버에 토큰 엔드포인트 만들기

API 키로 POST https://api.whop.com/api/v1/access_tokens를 호출하고 결과 토큰을 클라이언트에 반환하는 엔드포인트를 추가하세요.
app/api/chat/token/route.ts
5

채널, DM 또는 지원 채팅 생성하거나 가져오기

모든 채팅 유형은 실시간 메시지를 사용하며 Chat 요소에서 렌더링할 수 있습니다. 필요에 따라 유형을 선택하세요:

채널

공개 또는 대규모 그룹 대화를 위한 공유 채팅입니다. 모더레이션, 읽기 전용 옵션을 갖추고 고정된 멤버 수 제한이 없는 방입니다.

다이렉트 메시지

사용자 간 비공개 대화입니다. DM 목록에 표시되며 최대 50명의 멤버를 포함할 수 있습니다.

지원 채팅

사용자와 내 계정 간의 1:1 지원 대화입니다. 고객에게는 DM처럼 보입니다. 관리자는 DM 목록 대신 지원 받은편지함에서 관리합니다.
채팅을 렌더링하기 전에 열려는 채널 ID를 가져오세요.
6

앱에서 채팅 렌더링하기

생성한 토큰 엔드포인트를 사용해 토큰을 가져오고 채팅 요소를 렌더링합니다. SDK가 토큰을 관리하고 필요할 때 갱신합니다.

다음 단계

인증

임베디드 채팅에 계정 범위 토큰과 OAuth 중 하나를 선택합니다.

사용자 동기화하기

계정 범위 채팅 토큰을 발급하기 전에 Whop 사용자를 생성하거나 매핑하세요.

Chat 요소

채팅 UI의 props, 이벤트, 스타일, 딥 링크 옵션을 알아봅니다.

DM 목록 요소

사용자의 다이렉트 메시지 대화 목록을 표시합니다.