Xsolla Bot no Discord

Visão geral

O bot opera diretamente no seu servidor Discord e permite que os usuários façam login, resgatem recompensas e realizem compras sem sair do ambiente do Discord. Além disso, o bot suporta mensagens de saída para canais.

Fluxo do usuário no Discord:

1. O usuário digita /shop em qualquer canal em que o bot esteja conectado. A loja aparece apenas para o usuário que usou o comando — outros usuários no canal não a verão.

2. O usuário faz login com seu ID de jogador.
3. O usuário navega pelo catálogo.
4. O usuário clica no botão de compra ao lado do item desejado.
5. O usuário é redirecionado para a interface de pagamento.
6. Após um pagamento bem-sucedido, o usuário retorna ao canal do Discord, e o item é concedido ao usuário no jogo.

Se o usuário quiser explorar outros itens, ele pode pressionar o botão para abrir a Web Shop. O bot redireciona o usuário para o URL da Web Shop, onde ele pode explorar todo o catálogo de itens.

  %%{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

Pré-requisitos

Para vender seus itens de jogo usando o bot, você precisa:

1. Usar o Discord para se comunicar com os usuários.
2. Ter uma Web Shop totalmente configurada. Isso também inclui a criação do catálogo de itens, que você pode fazer manualmente, via API, ou importando de arquivos JSON ou plataformas externas.
3. Configure os seguintes webhooks para validar usuários e conceder compras aos usuários:
   • Validação do usuário na Web Shop
   • Pagamento bem-sucedido do pedido
   • Cancelamento de pedido
4. Assine o Acordo de Licenciamento com a Xsolla.

Como configurar

Criação do bot

1. No seu projeto na Conta de Distribuidor, acesse a seção Storefront > Xsolla Bot no Discord.
2. Selecione Create.

3. Faça o upload do logotipo e especifique o nome do bot.
4. Selecione Create.
5. Acesse a aba Settings para completar a configuração do bot:
   1. No bloco Player ID help configurator, selecione Set up e forneça instruções concisas sobre como os usuários podem encontrar o ID de jogador deles. Isso será exibido na interface do Discord quando o usuário pressionar How to find player ID.

2. A Chave de API é gerada automaticamente. Se você quiser atualizá-la, selecione Generate key.
3. O token do bot é gerado automaticamente. Se você já tem um bot no Discord, selecione Change e forneça o token dele no campo correspondente.

Instruções para encontrar o token do bot no Discord

1. Acesse a página da sua inscrição no portal de desenvolvedores do Discord.
2. Acesse a seção Overview > Bot.
3. Na seção Token, selecione Reset token. Você pode precisar passar por uma verificação.
4. Copie o novo valor do token.

Para verificar se você adicionou o token com sucesso, recarregue a página na Conta de Distribuidor. Se você vir um link de convite no topo da página, a configuração foi bem-sucedida. Siga este link para adicionar o bot ao seu servidor Discord.

4. No bloco User authentication webhook, selecione Change e especifique o URL do webhook na seção Project settings > Webhooks.
5. Na linha Web Shop URL, selecione Change. Na janela modal que abrir, especifique seu URL da Web Shop e selecione Save.

Depois de fazer todas as configurações necessárias, o status do bot mudará para Active.

Configuração de itens

Para configurar itens para venda:

1. Acesse a aba Shop e selecione Build your shop.
2. Na aba Shop items:
   1. Faça o upload da imagem de capa da loja.
   2. Especifique o título da loja (obrigatório).
   3. Marque as caixas ao lado dos itens que você deseja vender via Discord (obrigatório).
   4. Selecione Confirm.

Depois disso, você pode ir ao seu servidor Discord para verificar se o bot está funcionando corretamente.

Configuração de itens de recompensa

Para motivar os usuários a visitarem sua loja com mais frequência, você pode configurar as seguintes recompensas:

• Recompensa de login — recompensas que ficam disponíveis para o usuário quando ele faz login na loja pela primeira vez.
• Recompensas diárias — itens exclusivos que podem ser reivindicados uma vez por dia.

Para configurar:

1. Acesse a aba Shop e selecione Build your shop.

2. Configure os itens de recompensa:
   1. Na aba Login rewards, selecione um item gratuito e então pressione Confirm.
   2. Na aba Daily rewards, selecione itens gratuitos e selecione Confirm. Para reorganizar os itens na ordem correta, arraste e solte-os na página principal de configurações.

Depois disso, você pode ir ao seu servidor Discord para verificar se o bot está funcionando corretamente.