Xsolla Bot en Discord

Descripción general

El bot opera directamente dentro de tu servidor de Discord y permite a los usuarios iniciar sesión, reclamar recompensas y realizar compras sin salir del entorno de Discord. Además, el bot admite el envío de mensajes salientes a los canales.

Flujo del usuario en Discord:

1. El usuario escribe /shop en cualquier canal donde el bot esté conectado. La tienda aparece solo para el usuario que usó el comando; otros usuarios en el canal no la verán.

2. El usuario inicia sesión con su ID de jugador.
3. El usuario navega por el catálogo.
4. El usuario hace clic en el botón de compra junto al artículo deseado.
5. El usuario es redirigido a la interfaz de pago.
6. Después de un pago exitoso, el usuario regresa al canal de Discord y el artículo se le otorga en el juego.

Si el usuario desea explorar otros artículos, puede hacer clic en el botón para abrir el Web Shop. El bot redirige al usuario a la URL del Web Shop, donde puede explorar todo el catálogo de artículos.

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

Requisitos previos

Para vender tus artículos del juego usando el bot, necesitas:

1. Usar Discord para comunicarte con los usuarios.
2. Tener un Web Shop completamente configurado. Esto también incluye la creación del catálogo de artículos que puedes hacer manualmente, a través de API o importando desde archivos JSON o plataformas externas.
3. Configurar los siguientes webhooks para validar usuarios y otorgar compras a los usuarios:
   • Validación del usuario en Web Shop
   • Pago exitoso del pedido
   • Cancelación del pedido
4. Firmar el acuerdo de licencia con Xsolla.

Cómo configurarlo

Crear bot

1. En tu proyecto en la Cuenta del editor, ve a la sección Storefront > Xsolla Bot en Discord.
2. Haz clic en Create.

3. Sube el logotipo y especifica el nombre del bot.
4. Haz clic en Create.
5. Ve a la pestaña Settings para completar la configuración del bot:
   1. En el bloque Player ID help configurator, haz clic en Set up y proporciona instrucciones concisas sobre cómo los usuarios pueden encontrar su ID de jugador. Se mostrará en la interfaz de Discord una vez que el usuario haga clic en How to find player ID.

2. La clave de API se genera automáticamente. Si deseas actualizarla, haz clic en Generate key.
3. El token del bot se genera automáticamente. Si ya tienes un bot en Discord, haz clic en Change y proporciona su token en el campo correspondiente.

Instrucciones para encontrar el token del bot en Discord

1. Ve a la página de tu aplicación en el portal de desarrolladores de Discord.
2. Ve a la sección Overview > Bot.
3. En la sección Token, haz clic en Reset token. Es posible que se te pida pasar una verificación.
4. Copia el nuevo valor del token.

Para verificar si has agregado el token correctamente, recarga la página en la Cuenta del editor. Si ves un enlace de invitación en la parte superior de la página, la configuración es exitosa. Sigue este enlace para agregar el bot a tu servidor de Discord.

4. En el bloque User authentication webhook, haz clic en Change y especifica la URL del webhook desde la sección Configuración del proyecto > Webhooks.
5. En la fila Web Shop URL, haz clic en Change. En la ventana modal que se abre, especifica tu URL del Web Shop y haz clic en Save.

Una vez que hayas configurado todos los ajustes requeridos, el estado del bot cambiará a Activo.

Configurar artículos

Para configurar artículos para vender:

1. Ve a la pestaña Shop y haz clic en Build your shop.
2. En la pestaña Shop items:
   1. Sube la imagen de portada de la tienda.
   2. Especifica el título de la tienda (requerido).
   3. Marca las casillas junto a los artículos que deseas vender a través de Discord (requerido).
   4. Haz clic en Confirm.

Después de eso, puedes ir a tu servidor de Discord para verificar si el bot funciona correctamente.

Configurar recompensas

Para motivar a los usuarios a visitar tu tienda con más frecuencia, puedes configurar las siguientes recompensas:

• Recompensa de inicio de sesión: recompensas que están disponibles para el usuario cuando inicia sesión en la tienda por primera vez.
• Recompensas diarias: artículos exclusivos que se pueden reclamar una vez al día.

Para configurarlo:

1. Ve a la pestaña Shop y haz clic en Build your shop.

2. Configura los artículos de recompensa:
   1. En la pestaña Login rewards, selecciona un artículo gratuito y haz clic en Confirm.
   2. En la pestaña Daily rewards, selecciona artículos gratuitos y haz clic en Confirm. Para reorganizar los artículos en el orden correcto, arrástralos y suéltalos en la página principal de configuración.

Después de eso, puedes ir a tu servidor de Discord para verificar si el bot funciona correctamente.