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.

Configuración

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 e introduzca 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. Se mostrarán en la interfaz de usuario de Discord cuando el usuario haga clic en How to find player ID.

2. La clave API se genera automáticamente. Si quiere actualizarla, haga clic en Generate key.
3. El token del bot se genera automáticamente. Si ya tiene un bot en Discord, haga clic en Change y proporcione su token en el campo correspondiente.

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 tenga que pasar una verificación.
4. Copie el nuevo valor del token.

Para comprobar si ha añadido el token correctamente, actualice la página en Cuenta del editor. Si ve un enlace de invitación en la parte superior de la página, la configuración se ha realizado correctamente. Siga este enlace para añadir el bot a su servidor de Discord.

4. En el bloque User authentication webhook, haga clic en Change y especifique la URL del webhook de Project settings > Webhooks.
5. En la fila Web Shop URL, haga clic en Change. En la ventana modal que se abre, introduzca la URL de su Web Shop y haga clic en Save.

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

Configurar artículos

Para configurar artículos para vender:

1. Vaya a la pestaña Shop y haga clic en Build your shop.
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 crear las siguientes recompensas:

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

Configuración:

1. Vaya a la pestaña Shop y haga clic en Build your shop.

2. Configure artículos de recompensa:
   1. En la pestaña Login rewards, seleccione un artículo gratuito y haga clic en Confirm.
   2. En la pestaña Daily rewards, seleccione artículos gratuitos y haga clic en Confirm. Para ordenar los artículos en el orden correcto, 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.