Xsolla Bot no Discord

Visão Geral

O bot opera diretamente dentro do seu servidor Discord e permite que os usuários façam login, reivindiquem recompensas e realizem compras sem sair do ambiente 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 no qual 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 o 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 clicar no botão para abrir a Web Shop. O bot redireciona o usuário para a 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 do 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. Configurar os seguintes webhooks para validar usuários e conceder compras aos usuários:
   • Validação do usuário na Web Shop
   • Pagamento bem-sucedido para pedido
   • Cancelamento de Pedido
4. Assinar o Acordo de Licenciamento com a Xsolla.

Como configurar

Criar bot

1. No seu projeto na Conta de Distribuidor, vá para a seção Storefront > Xsolla Bot in Discord.
2. Clique em Create.

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

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

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

1. Vá para a página da sua aplicação no portal de desenvolvedores do Discord.
2. Vá para a seção Overview > Bot.
3. Na seção Token, clique em Reset token. Você pode ser solicitado a 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, clique em Change e especifique a URL do webhook na seção Project settings > Webhooks.
5. Na linha Web Shop URL, clique em Change. Na janela modal que se abre, especifique sua URL da Web Shop e clique em Save.

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

Configurar itens

Para configurar itens para venda:

1. Vá para a aba Shop e clique em 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. Clique em Confirm.

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

Configurar 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. Vá para a aba Shop e clique em Build your shop.

2. Configure itens de recompensa:
   1. Na aba Login rewards, selecione um item gratuito e clique em Confirm.
   2. Na aba Daily rewards, selecione itens gratuitos e clique em 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.