Vai al contenuto principale
Panoramica del servizio Square Cloud Bots

​
Perché scegliere Square Cloud?

Siamo la più grande piattaforma di hosting di bot dell’America Latina, con la fiducia di 80 dei 100 più grandi server Discord brasiliani. Un bot vive o muore in base al suo uptime e alla sua latenza verso i gateway di Discord, WhatsApp e Telegram, quindi ogni livello del nostro stack, dall’hardware all’edge di rete, è ottimizzato per mantenere il tuo processo online e reattivo 24/7.

Prestazioni progettate su misura

Ogni bot gira su SSD NVMe enterprise dietro uplink da 10Gbps, in un container isolato con CPU e RAM applicate a livello di kernel, così il picco di traffico di un vicino non diventa mai il tuo problema di latenza.

Un ecosistema completo per sviluppatori

CLI, SDK JavaScript, Python e Go, un’estensione VS Code e GitHub Actions/Webhooks per il CI/CD. Effettua il deploy dal tuo terminale, dal tuo editor o con un git push.

Square Shield + Cloudflare

Un edge protetto da Cloudflare più Square Shield mantiene il tuo bot entro i rate limit delle API delle piattaforme (Discord e altre), prevenendo i ban e i cooldown che mettono offline un bot.

Snapshot istantanei

Punti di ripristino con un clic inclusi senza costi aggiuntivi. Annulla un deploy difettoso in pochi secondi, senza perdita di dati e senza downtime.
Provato su larga scala: la nostra reputazione è nata gestendo i bot dietro alcune delle community più attive dell’America Latina: quel tipo di carico sostenuto, con un alto volume di eventi, che mette silenziosamente in luce le infrastrutture deboli. Il tuo gira sugli stessi cluster.

​
Ambienti supportati

Sviluppa con la piattaforma e il linguaggio che usi già.

​
Piattaforme

Discord, WhatsApp, Telegram, Slack e X hanno una guida passo passo con codice: scegli una scheda per aprirla.

Discord

WhatsApp

Telegram

Slack

X (Twitter)

Instagram

Facebook

YouTube

​
Linguaggi

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

Anche la maggior parte degli altri linguaggi e librerie funziona senza configurazioni aggiuntive. Vedi linguaggi e runtime supportati.

​
Caratteristiche principali

​
Infrastruttura costruita per carichi di lavoro always-on

Ogni cluster gira su SSD NVMe enterprise con uplink da 10Gbps, e il tuo bot gira in un container isolato e senza privilegi con limiti dedicati di CPU e RAM. L’isolamento è ciò che trasforma il “veloce sulla carta” in veloce in produzione: il tuo processo non si contende mai I/O o CPU con un vicino rumoroso, così i tempi di risposta restano bassi anche sotto un carico di eventi sostenuto.

​
Square Shield: restare entro i rate limit

Discord, WhatsApp e Telegram bannano i bot che superano i rate limit dei loro gateway e delle loro API REST. Square Shield si posiziona tra il tuo bot e quelle API, monitorando i pattern delle richieste per mantenerti entro il budget consentito. È la differenza tra un bot che scala senza problemi e uno che finisce offline in cooldown nel momento peggiore.

​
Opera con piena visibilità

I punti di ripristino ti permettono di annullare un deploy sbagliato in pochi secondi, senza perdita di dati né downtime. I piani Pro ed Enterprise aggiungono anche snapshot giornalieri automatici.
Segui in diretta lo stdout/stderr della tua applicazione per eseguire il debug in produzione non appena qualcosa non va, senza rifare il deploy.
Monitora il consumo di CPU, RAM e rete in tempo reale dalla dashboard, così puoi dimensionare correttamente le risorse e individuare le regressioni prima dei tuoi utenti.

​
Strumenti di sviluppo

Effettua il deploy e gestisci il tuo bot da dove lavori:
1

Square Cloud CLI

Effettua il deploy, riavvia, segui i log e gestisci le tue applicazioni direttamente dal terminale. Inizia dalla guida rapida della CLI.
2

Estensione VS Code

Gestisci ed effettua il deploy delle tue applicazioni senza lasciare il tuo editor di codice. Scopri come installare l’estensione VS Code.
3

GitHub

Deploy continuo per il tuo bot: collega il tuo repository GitHub e ogni push aggiorna automaticamente l’applicazione, oppure effettua il deploy da un workflow con GitHub Actions.
Il deploy con GitHub Actions richiede una chiave API salvata nei secret del tuo repository, mai nel codice.

​
Come ospitare il mio bot?

Aggiungi un file di configurazione

Crea un file squarecloud.app nella root del tuo progetto. Indica a Square Cloud quale file eseguire, quanta memoria riservare e quale runtime usare. La guida al file di configurazione spiega ogni campo. Aggiungi AUTORESTART=true perché il bot si riavvii da solo dopo un crash.

Includi il file delle dipendenze

Mantieni il file delle dipendenze nel progetto: package.json per Node.js, requirements.txt o pyproject.toml per Python. Square Cloud installa sul server tutto ciò che vi è elencato. Escludi i moduli integrati, come fs in Node.js o random in Python, perché sono già inclusi nel linguaggio.

Comprimi il progetto

Comprimi il tuo codice, il file di configurazione e il file delle dipendenze in un .zip. Escludi node_modules, i lockfile come package-lock.json e gli altri file generati: le dipendenze vengono installate sul server, e un upload più leggero si pubblica più in fretta. La CLI e l’estensione per VS Code escludono i lockfile per te. Ti servono versioni bloccate? Aggiungi !package-lock.json al tuo file squarecloud.ignore.

Carica il tuo bot

Invia lo .zip dalla pagina di upload. Square Cloud installa le dipendenze, prepara l’ambiente in base al tuo file di configurazione e avvia il tuo bot.
Caricamento dell'applicazione su Square Cloud

​
Qualcosa è andato storto?

L'app non si avvia

Risolvi un deploy che fallisce o va in crash all’avvio: moduli mancanti, INVALID_DEPENDENCY, una porta già in uso o RAM insufficiente.

Errori dei bot Discord

Token non validi, intent non consentiti, disconnessioni di Lavalink e un bot che va offline dopo aver funzionato in locale.

​
Domande frequenti

Consigliamo il piano Standard, da R$44,99/mese** con 4 GB di RAM e 4 vCPU, che lascia spazio a server molto attivi e picchi di traffico. Un bot più leggero funziona anche sul piano **Hobby**, da **R$12,49/mese: un bot richiede almeno 256 MB di RAM. Consulta Piani e prezzi per il confronto completo.
Sì. Il tuo bot gira in un container isolato con CPU e RAM dedicate, e l’infrastruttura di Square Cloud ha una media del 99,99% di uptime su tutta la piattaforma. Imposta AUTORESTART=true nel tuo file di configurazione perché il bot si riavvii anche da solo dopo un crash: è disattivato per impostazione predefinita.