Configurar el Webhook de Top.gg en Square Cloud

​

Introducción

• Esta guía asume que tienes un bot aprobado en top.gg y que estás usando Node.js o Python para tu proyecto.
• A continuación, necesitarás crear una cuenta en Square Cloud, lo cual puede hacerse a través de la página de registro. Puedes usar tu correo electrónico para crear una cuenta.
• Finalmente, necesitas tener un plan de pago activo en tu cuenta. Puedes ver nuestros planes y comprar uno según tus necesidades aquí.

​

Configurando el entorno

npm init -y

npm install @top-gg/sdk express

pip install flask
pip install waitress

​

Configurando el proyecto

• Ve a tu perfil de Top.gg aquí.
• Haz clic en “edit” en el bot para el que quieres recibir notificaciones de votos.
• En “GENERAL”, elige la opción “webhook”.
• Establece la autenticación del webhook en “Authorization”. En este ejemplo, usamos “myappsquare”.

// Import libraries
const Topgg = require("@top-gg/sdk");
const express = require("express");

// Create Express app and Top.gg webhook instances
const app = express();
const webhook = new Topgg.Webhook("YOUR_AUTHORIZATION_TOKEN");

// Define route for '/topgg' endpoint (POST requests)
app.post("/topgg", webhook.listener((vote) => {
  // Log vote received message with user ID
  console.log(`Vote received successfully! User ID: ${vote.user}`);
}));

// Start server on port 80 (default HTTP)
app.listen(80);

# Import the necessary libraries
import logging
import json
from waitress import serve
from flask import Flask, request, abort

# Create an instance of the Flask app
app = Flask(__name__)

# Define your authorization token
AUTH_TOKEN = 'YOUR_AUTHORIZATION'

# Define a route for the '/topgg' endpoint that accepts POST requests
@app.route("/topgg", methods=["POST"])
def hook():
    # Check the authorization header
    auth = request.headers.get('Authorization')
    if auth != AUTH_TOKEN:
        logging.error('Access denied')
        abort(401)  # Unauthorized

    # Convert the request data from bytes to a JSON dictionary
    data = json.loads(request.data)
    # Print the ID of the user who voted
    print(f'Vote received successfully! User ID: {data["user"]}')
    # Return a response with the string "Data received" and status 200 to indicate that the request was processed successfully
    return "Data received"

# Check if this script is being run directly and not imported as a module
if __name__ == "__main__":
    # Set the log message format to exclude the log level
    logging.basicConfig(format='%(message)s', level=logging.INFO)
    # Serve our Flask app on port 80 and listen on all network interfaces
    serve(app, host="0.0.0.0", port=80)

​

Creando el archivo de configuración de squarecloud

​

Subiendo tu aplicación a Square Cloud

• Subida por el Dashboard
• Subida por la CLI

Accede al Dashboard de Square Cloud y sube los archivos de tu proyecto.

1

Primer paso

Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:

npm install -g @squarecloud/cli

Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:

• Windows
• Linux, macOS y WSL

squarecloud update

curl -fsSL https://cli.squarecloud.app/install | bash

2

Segundo paso

Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización aquí haciendo clic en “Request API Key”. Después de obtener tu clave de autorización, ejecuta el siguiente comando:

squarecloud auth login 

3

Tercer paso

Finalmente, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando, pasando la ruta de tu archivo zip:

squarecloud upload zip

​

Iniciando las pruebas

• Para el código JavaScript que creamos con app.post("/topgg", webhook.listener((vote) => {...}), la ruta que recibirá los votos es “/topgg”. Entonces, si tu sitio web es “mysite.squareweb.app”, debes poner “mysite.squareweb.app/topgg” como la Webhook URL.
• Para el código Python que creamos con @app.route("/topgg", methods=["POST"]), la ruta que recibirá los votos también es “/topgg”. Entonces, la Webhook URL sería la misma “mysite.squareweb.app/topgg”.

​

Solución de problemas

​

Contáctanos