Xsolla Bot en Discord

Descripción general

El bot funciona directamente en su servidor de Discord y permite a los usuarios iniciar sesión, canjear recompensas y hacer compras sin salir de Discord. Además, el bot permite enviar mensajes a los canales.

Flujo de usuario en Discord:

1. El usuario escribe /shop en cualquier canal al que esté conectado el bot. La tienda se muestra únicamente al usuario que ha utilizado el comando; los demás usuarios del canal no la verán.

2. El usuario inicia sesión con su ID de jugador.
3. El usuario consulta el catálogo.
4. El usuario hace clic en el botón de compra junto al artículo deseado.
5. Se redirige al usuario a la interfaz de pago.
6. Tras completar el pago correctamente, el usuario vuelve al canal de Discord y se le concede el artículo en el juego.

Si el usuario quiere ver otros artículos, puede hacer clic en el botón para abrir Web Shop. El bot redirige al usuario a la URL de Web Shop, donde podrá consultar 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

Para vender artículos de su juego mediante el bot, debe:

1. Usar Discord para comunicarse con los usuarios.
2. Disponer de una Web Shop totalmente configurada. También incluye la creación del catálogo de artículos que puede hacer manualmente, mediante API o importando desde archivos JSON o plataformas externas.
3. Configurar los siguientes webhooks para validar a los usuarios y autorizar sus compras:
   • Validación del usuario en Web Shop
   • Pago del pedido realizado correctamente
   • Cancelación del pedido
4. Firma del acuerdo de licencia con Xsolla.

Cómo configurarlo

Crear bot

1. En su proyecto en Cuenta del editor, vaya a Storefront > Xsolla Bot in Discord.
2. Haga clic en Create.

3. Suba el logotipo y especifique el nombre del bot.
4. Haga clic en Create.
5. Vaya a la pestaña Settings para completar la configuración del bot:
   1. En el bloque Player ID help configurator, haga clic en Set up y facilite instrucciones precisas para que los usuarios puedan encontrar su ID de jugador. Haga clic en Set up. Se mostrarán las instrucciones en la interfaz de usuario de Discord cuando el usuario haga clic en How to find player ID.

2. En el bloque del selector de la interfaz de usuario, haga clic en Change. Seleccione cómo mostrar artículos en la tienda y haga clic en Save:
   • Dropdown selector (por defecto): la tienda muestra una lista desplegable con los artículos disponibles. Para comprar un artículo, el usuario lo selecciona de la lista, luego abre la tarjeta del artículo y hace clic en el botón de compra.
   • Buy buttons: la tienda muestra todos los artículos disponibles a la vez, con un botón de compra junto a cada uno.
3. La clave de API se genera automáticamente. Si quiere actualizarla, haga clic en Generate key.
4. El token del bot se genera automáticamente. Si ya tiene un bot en Discord, haga clic en Change, proporcione su token en el campo correspondiente y haga clic en Change. Tenga en cuenta que, una vez guardados los cambios, ya no podrá utilizar el token anterior.

Instrucciones para encontrar el token del bot en Discord

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

5. En el bloque User authentication webhook, haga clic en Change. En la lista desplegable, seleccione la URL del servidor donde quiere recibir webhooks de autenticación de usuario, o introduzca una nueva, y haga clic en Save.
6. En la fila Web Shop URL, haga clic en Change. En la ventana modal que se abre, indique su URL de Web Shop y haga clic en Save.

Para añadir el bot a su servidor de Discord, siga el enlace de invitación que aparece en la parte superior de la página.

Cuando haya configurado todos los ajustes necesarios, el estado del bot cambiará a Active.

Configurar artículos

Para configurar artículos para vender:

1. Vaya a la pestaña Shop y haga clic en Edit.
2. En la pestaña Shop items:
   1. Suba la imagen de portada de la tienda.
   2. Indique el nombre de la tienda (obligatorio).
   3. Marque las casillas situadas junto a los artículos que quiera vender a través de Discord (obligatorio).
   4. Haga clic en Confirm.

Después, puede ir a su servidor de Discord para comprobar si el bot funciona correctamente.

Configurar artículos de recompensa

Para animar a los usuarios a visitar su tienda con más frecuencia, puede ofrecer las siguientes recompensas:

• Recompensa por iniciar sesión: recompensas que los usuarios pueden obtener al iniciar sesión en la tienda por primera vez.
• Recompensas diarias: artículos exclusivos que se pueden obtener una vez al día.

Configuración:

1. Vaya a la pestaña Shop y haga clic en Edit.
2. Configure los artículos de recompensa:
   • En la pestaña Login rewards, seleccione un artículo y haga clic en Confirm.
   • En la pestaña Daily rewards, seleccione los artículos y haga clic en Confirm. Para cambiar el orden de los artículos, arrástrelos y suéltelos en la página principal de configuración.

Después, puede ir a su servidor de Discord para comprobar si el bot funciona correctamente.