Discord에서 엑솔라 봇 이용하기

개요

봇은 Discord 서버 내에서 직접 작동하며, 사용자가 Discord 환경을 떠나지 않고 로그인, 리워드 수령, 구매를 할 수 있게 합니다. 또한, 봇은 채널로의 아웃바운드 메시징을 지원합니다.

Discord에서의 사용자 플로:

1. 사용자가 봇이 연결된 채널에서 /shop을 입력합니다. 상점은 명령어를 사용한 사용자에게만 나타나며, 채널의 다른 사용자에게는 보이지 않습니다.

2. 사용자가 자신의 플레이어 ID로 로그인합니다.
3. 사용자가 카탈로그를 탐색합니다.
4. 사용자가 원하는 아이템 옆의 구매 버튼을 클릭합니다.
5. 사용자가 결제 UI로 리디렉션됩니다.
6. 결제가 성공적으로 완료되면, 사용자는 Discord 채널로 돌아가며, 게임 내에서 아이템이 사용자에게 지급됩니다.

사용자가 다른 아이템을 탐색하고 싶다면, 웹샵 솔루션을 열기 위한 버튼을 클릭할 수 있습니다. 봇은 사용자를 웹샵 솔루션 URL로 리디렉션하여 전체 아이템 카탈로그를 탐색할 수 있게 합니다.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as User
    participant D as Discord Bot
    participant X as Xsolla
    activate U
    U->>D: /shop command
    activate D
    D-->>U: Shop UI appears
    deactivate D
    U->>D: Log in with Player ID
    activate D
    D-->>U: Catalog displayed
    deactivate D
    U->>D: Click purchase on desired item
    activate D
    D->>X: Player ID + Item SKU
    activate X
    X-->>D: Return link to Payment UI
    D-->>U: Redirect to Payment UI
    deactivate D
    U->>X: Complete payment
    activate X
    note right of X: Grant item to player inventory
    deactivate X
    X->>D: Webhook: item granted notification
    deactivate X
    activate D
    D-->>U: Confirmation of successful purchase
    deactivate D
    deactivate U

사전 준비 사항

봇을 사용하여 게임 내 아이템을 판매하려면 다음이 필요합니다:

1. Discord를 사용하여 사용자와 소통합니다.
2. 완전히 구성된 웹샵 솔루션이 있어야 합니다. 여기에는 수동으로, API, JSON 파일 또는 외부 플랫폼에서 가져오기를 통해 아이템 카탈로그를 생성하는 것이 포함됩니다.
3. 사용자를 유효성 검사하고 구매를 사용자에게 지급하기 위해 다음 웹훅을 구성합니다:
   • 웹샵 솔루션에서의 사용자 유효성 검사
   • 주문에 대한 성공적인 결제
   • 주문 취소
4. 엑솔라와 라이선스 계약을 체결합니다.

설정 방법

봇 생성

1. 관리자 페이지의 프로젝트에서 Storefront > Xsolla Bot in Discord 섹션으로 이동합니다.
2. Create를 클릭합니다.

3. 로고를 업로드하고 봇 이름을 지정합니다.
4. Create를 클릭합니다.
5. Settings 탭으로 이동하여 봇 구성을 완료합니다:
   1. Player ID help configurator 블록에서 Set up을 클릭하고 사용자가 플레이어 ID를 찾는 방법에 대한 간단한 지침을 제공합니다. 사용자가 How to find player ID를 클릭하면 Discord UI에 표시됩니다.

2. API 키는 자동으로 생성됩니다. 업데이트하려면 Generate key를 클릭하세요.
3. 봇 토큰은 자동으로 생성됩니다. 이미 Discord에 봇이 있는 경우, Change를 클릭하고 해당 토큰을 입력란에 제공합니다.

Discord에서 봇 토큰 찾기 지침

1. Discord 개발자 포털에서 애플리케이션 페이지로 이동합니다.
2. Overview > Bot 섹션으로 이동합니다.
3. Token 섹션에서 Reset token을 클릭합니다. 인증을 통과해야 할 수도 있습니다.
4. 새 토큰 값을 복사합니다.

토큰을 성공적으로 추가했는지 확인하려면 관리자 페이지를 새로 고칩니다. 페이지 상단에 초대 링크가 표시되면 구성이 성공한 것입니다. 이 링크를 따라 봇을 Discord 서버에 추가하세요.

4. User authentication webhook 블록에서 Change를 클릭하고 프로젝트 설정 > 웹훅 섹션의 웹훅 URL을 지정합니다.
5. Web Shop URL 행에서 Change를 클릭합니다. 열리는 모달 창에서 웹샵 솔루션 URL을 지정하고 Save를 클릭합니다.

모든 필수 설정을 구성하면 봇의 상태가 Active로 변경됩니다.

아이템 구성

판매할 아이템을 구성하려면:

1. Shop 탭으로 이동하여 Build your shop을 클릭합니다.
2. Shop items 탭에서:
   1. 상점 커버 이미지를 업로드합니다.
   2. 상점 제목을 지정합니다 (필수).
   3. Discord를 통해 판매할 아이템 옆의 체크박스를 선택합니다 (필수).
   4. Confirm을 클릭합니다.

그 후 Discord 서버로 이동하여 봇이 제대로 작동하는지 확인할 수 있습니다.

리워드 아이템 구성

사용자가 스토어를 더 자주 방문하도록 유도하려면 다음 리워드를 설정할 수 있습니다:

• 로그인 리워드 - 사용자가 처음으로 스토어에 로그인할 때 제공되는 리워드.
• 일일 리워드 - 하루에 한 번 받을 수 있는 독점 아이템.

설정하려면:

1. Shop 탭으로 이동하여 Build your shop을 클릭합니다.

2. 리워드 아이템을 설정합니다:
   1. Login rewards 탭에서 무료 아이템을 선택하고 Confirm을 클릭합니다.
   2. Daily rewards 탭에서 무료 아이템을 선택하고 Confirm을 클릭합니다. 올바른 순서로 아이템을 재배치하려면 메인 설정 페이지에서 드래그 앤 드롭하세요.

그 후 Discord 서버로 이동하여 봇이 제대로 작동하는지 확인할 수 있습니다.