Pular para o conteúdo principal
Visão geral do serviço Bots da Square Cloud

​
Por que escolher a Square Cloud?

Somos a maior plataforma de hospedagem de bots da América Latina, com a confiança de 80 dos 100 maiores servidores brasileiros do Discord. Um bot vive ou morre pela sua disponibilidade e pela latência até os gateways do Discord, WhatsApp e Telegram, por isso cada camada da nossa stack, do hardware ao edge da rede, é ajustada para manter seu processo online e responsivo 24/7.

Performance sob medida

Cada bot roda em SSDs NVMe empresariais atrás de uplinks de 10Gbps, em um container isolado com CPU e RAM garantidas pelo kernel, então o pico de tráfego de um vizinho nunca vira o seu problema de latência.

Um ecossistema completo para desenvolvedores

CLI, SDKs para JavaScript, Python e Go, uma extensão para VS Code e GitHub Actions/Webhooks para CI/CD. Faça deploy pelo terminal, pelo editor ou com um git push.

Square Shield + Cloudflare

Um edge protegido pela Cloudflare somado ao Square Shield mantém seu bot dentro dos rate limits das APIs das plataformas (Discord e outras), evitando os banimentos e cooldowns que tiram um bot do ar.

Snapshots instantâneos

Pontos de restauração em um clique, inclusos sem custo adicional. Reverta um deploy quebrado em segundos, sem perda de dados e sem downtime.
Comprovado em escala: nossa reputação foi conquistada rodando os bots de algumas das comunidades mais movimentadas da América Latina: o tipo de carga contínua, com alto volume de eventos, que expõe sem alarde uma infraestrutura fraca. O seu roda nos mesmos clusters.

​
Ambientes suportados

Desenvolva com a plataforma e a linguagem que você já usa.

​
Plataformas

Discord, WhatsApp, Telegram, Slack e X têm um guia passo a passo com código: escolha um cartão para abri-lo.

Discord

WhatsApp

Telegram

Slack

X (Twitter)

Instagram

Facebook

YouTube

​
Linguagens

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

A maioria das outras linguagens e bibliotecas também funciona direto. Veja as linguagens e runtimes suportados.

​
Recursos principais

​
Infraestrutura feita para cargas sempre ativas

Cada cluster roda em SSDs NVMe empresariais com uplinks de 10Gbps, e seu bot roda em um container isolado e sem privilégios, com limites dedicados de CPU e RAM. O isolamento é o que transforma “rápido no papel” em rápido em produção: seu processo nunca disputa I/O ou CPU com um vizinho barulhento, então os tempos de resposta continuam baixos mesmo sob carga contínua de eventos.

​
Square Shield: dentro dos rate limits

Discord, WhatsApp e Telegram banem bots que ultrapassam os rate limits dos seus gateways e APIs REST. O Square Shield fica entre o seu bot e essas APIs, monitorando os padrões de requisição para manter você dentro do limite permitido. Essa é a diferença entre um bot que escala sem problemas e um que entra em cooldown e sai do ar na pior hora.

​
Opere com visibilidade total

Pontos de restauração permitem reverter um deploy ruim em segundos, sem perda de dados e sem downtime. Os planos Pro e Enterprise ainda adicionam snapshots automáticos diários.
Acompanhe o stdout/stderr da sua aplicação ao vivo para depurar em produção assim que algo sair do esperado, sem precisar de um novo deploy.
Acompanhe o consumo de CPU, RAM e rede em tempo real pelo dashboard, para dimensionar os recursos certos e pegar regressões antes dos seus usuários.

​
Ferramentas de desenvolvimento

Faça deploy e gerencie seu bot de onde você trabalha:
1

Square Cloud CLI

Faça deploy, reinicie, acompanhe logs e gerencie suas aplicações direto do terminal. Comece pelo início rápido da CLI.
2

Extensão para VS Code

Gerencie e faça deploy das suas aplicações sem sair do editor de código. Veja como instalar a extensão para VS Code.
3

GitHub

Deploy contínuo para o seu bot: integre seu repositório do GitHub e cada push atualiza a aplicação automaticamente, ou faça deploy por um workflow com GitHub Actions.
O deploy com GitHub Actions precisa de uma chave de API guardada nos secrets do repositório, nunca no código.

​
Como hospedar meu bot?

Adicione um arquivo de configuração

Crie um arquivo squarecloud.app na raiz do seu projeto. Ele diz à Square Cloud qual arquivo executar, quanta memória reservar e qual runtime usar. O guia do arquivo de configuração explica cada campo. Adicione AUTORESTART=true para que o seu bot reinicie sozinho depois de uma falha.

Inclua seu arquivo de dependências

Mantenha o arquivo de dependências no projeto: package.json para Node.js, requirements.txt ou pyproject.toml para Python. A Square Cloud instala tudo o que ele lista no servidor. Deixe de fora os módulos nativos, como fs no Node.js ou random no Python, já que eles vêm com a linguagem.

Compacte o projeto

Compacte seu código, o arquivo de configuração e o arquivo de dependências em um .zip. Deixe de fora node_modules, lockfiles como o package-lock.json e outros arquivos gerados: as dependências são instaladas no servidor, e um upload menor faz o deploy mais rápido. A CLI e a extensão para VS Code já deixam os lockfiles de fora para você. Precisa de versões fixas? Adicione !package-lock.json ao seu arquivo squarecloud.ignore.

Envie seu bot

Envie o .zip na página de upload. A Square Cloud instala as dependências, prepara o ambiente a partir do seu arquivo de configuração e inicia o seu bot.
Enviando aplicação para a Square Cloud

​
Algo deu errado?

O app não inicia

Corrija um deploy que falha ou cai ao iniciar: módulos ausentes, INVALID_DEPENDENCY, uma porta já em uso ou RAM insuficiente.

Erros do bot do Discord

Tokens inválidos, intents não permitidas, desconexões do Lavalink e um bot que cai depois de funcionar localmente.

​
Perguntas frequentes

Recomendamos o plano Standard, a partir de R$44,99/mês** com 4 GB de RAM e 4 vCPUs, que dá folga para servidores movimentados e picos de tráfego. Um bot mais leve também roda no plano **Hobby**, a partir de **R$12,49/mês: um bot precisa de pelo menos 256 MB de RAM. Veja Planos e Preços para a comparação completa.
Sim. Seu bot roda em um container isolado com CPU e RAM dedicadas, e a infraestrutura da Square Cloud tem uma média de 99,99% de uptime em toda a plataforma. Defina AUTORESTART=true no seu arquivo de configuração para que o bot também reinicie sozinho depois de uma falha: essa opção vem desligada por padrão.