Skip to main content
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 R44,99/me^s∗∗com4GBdeRAMe4vCPUs,quedaˊfolgaparaservidoresmovimentadosepicosdetraˊfego.Umbotmaislevetambeˊmrodanoplano∗∗Hobby∗∗,apartirde∗∗R44,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 **R12,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.