Configurare il Webhook di Top.gg su Square Cloud

​

Introduzione

• Questa guida presuppone che tu abbia un bot approvato su top.gg e che stia utilizzando Node.js o Python per il tuo progetto.
• Successivamente, dovrai creare un account su Square Cloud, cosa che puoi fare tramite la pagina di registrazione. Puoi usare la tua email per creare un account.
• Infine, devi avere un piano a pagamento attivo sul tuo account. Puoi visualizzare i nostri piani e acquistarne uno in base alle tue esigenze qui.

​

Configurare l’ambiente

npm init -y

npm install @top-gg/sdk express

pip install flask
pip install waitress

​

Configurare il progetto

• Vai al tuo profilo Top.gg qui.
• Clicca su “edit” sul bot per cui vuoi ricevere notifiche dei voti.
• Sotto “GENERAL”, scegli l’opzione “webhook”.
• Imposta l’autenticazione del webhook in “Authorization”. In questo esempio, abbiamo usato “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)

​

Creare il file di configurazione squarecloud

​

Caricare l’applicazione su Square Cloud

• Dashboard Upload
• CLI Upload

Accedi alla Dashboard di Square Cloud e carica i file del tuo progetto.

1

Primo passo

Per prima cosa, devi avere la CLI installata nel tuo ambiente. Se non l’hai ancora, esegui il seguente comando nel tuo terminale:

npm install -g @squarecloud/cli

Se la possiedi già, ti consigliamo di aggiornarla. Per farlo, esegui il seguente comando nel tuo terminale:

• Windows
• Linux, macOS e WSL

squarecloud update

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

2

Secondo passo

Ora, per autenticarti e usare gli altri comandi della CLI, troverai la tua chiave di autorizzazione qui cliccando su “Request API Key”. Dopo aver ottenuto la tua chiave di autorizzazione, esegui il seguente comando:

squarecloud auth login 

3

Terzo passo

Infine, per effettuare il deploy della tua applicazione su Square Cloud usando la CLI, devi eseguire il seguente comando, passando il percorso del tuo file zip:

squarecloud upload zip

​

Avviare i test

• Per il codice JavaScript che abbiamo creato con app.post("/topgg", webhook.listener((vote) => {...}), la route che riceverà i voti è “/topgg”. Quindi, se il tuo sito web è “mysite.squareweb.app”, dovresti inserire “mysite.squareweb.app/topgg” come Webhook URL.
• Per il codice Python che abbiamo creato con @app.route("/topgg", methods=["POST"]), la route che riceverà i voti è anch’essa “/topgg”. Quindi, il Webhook URL sarebbe lo stesso “mysite.squareweb.app/topgg”.

​

Risoluzione dei problemi

​

Contattaci