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, confiada por 80 dos 100 maiores servidores do Discord brasileiro. Um bot vive ou morre pela sua disponibilidade e pela sua latência até os gateways do Discord, WhatsApp e Telegram — por isso cada camada da nossa stack, do hardware ao edge de rede, é ajustada para manter seu processo online e responsivo 24/7.

Performance sob medida

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

Um ecossistema completo

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

Square Shield + Cloudflare

Um edge protegido pela Cloudflare somado ao Square Shield mantém seu bot dentro dos limites de API da plataforma (Discord e outros), 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 por trás de algumas das comunidades mais movimentadas da América Latina — o tipo de carga sustentada e de alto volume de eventos que silenciosamente expõe infraestruturas frágeis. O seu roda nos mesmos clusters.

​
Ambientes suportados

Oferecemos ampla compatibilidade para que você possa desenvolver na tecnologia de sua preferência.

​
Plataformas

Discord

WhatsApp

Telegram

Twitter

Instagram

Facebook

Slack

YouTube

​
Linguagens

JavaScript

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

Além destas, suportamos diversas outras linguagens e bibliotecas. Nossa infraestrutura é flexível para se adaptar às necessidades do seu projeto.

​
Recursos Principais

​
Infraestrutura feita para cargas sempre ativas

Cada cluster roda em SSDs NVMe Samsung empresariais com uplinks de 10Gbps, e seu bot roda em um container isolado e sem privilégios, com limites dedicados de CPU e RAM. 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 permanecem baixos mesmo sob carga sustentada de eventos.

​
Square Shield: dentro dos limites de API

Discord, WhatsApp e Telegram banem bots que excedem os limites de requisição de 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 orçamento permitido — a diferença entre um bot que escala de forma limpa 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, sem downtime. Os planos Pro e Enterprise adicionam ainda snapshots automáticos diários.
Acompanhe o stdout/stderr da sua aplicação ao vivo para depurar em produção no exato momento em que algo se comporta mal, sem precisar de um novo deploy.
Acompanhe consumo de CPU, RAM e rede em tempo real por um painel intuitivo, para dimensionar recursos corretamente e pegar regressões antes dos seus usuários.

​
Ferramentas de Desenvolvimento

Para otimizar seu fluxo de trabalho, oferecemos um ecossistema completo de ferramentas:
1

Square Cloud CLI

Gerencie suas aplicações diretamente do terminal. Faça deploy, consulte logs e muito mais, de forma rápida e prática.
2

Extensão para VSCode

Integre a gestão da sua hospedagem ao seu editor de código favorito, simplificando o processo de desenvolvimento e deploy.
3

GitHub Actions

Automatize o deploy contínuo (CI/CD) do seu bot. A cada push no seu repositório, sua aplicação é atualizada automaticamente em nossa plataforma.
Atenção: Para utilizar o deploy via GitHub Actions, é necessário configurar um token de API em seus secrets no repositório. Consulte nossa documentação específica para o passo a passo.

​
Como hospedar meu bot?

Arquivo de Configuração

O primeiro passo para hospedar seu bot na Square Cloud é criar um arquivo de configuração detalhado. Este arquivo não é apenas um simples documento de texto, mas um guia abrangente que define as configurações para a aplicação na Square Cloud. Ele funciona como um plano arquitetônico para o seu projeto na plataforma.Uma vez adquirido o plano, você precisa criar este arquivo, detalhando cada configuração e preenchendo-o corretamente. Detalhes sobre como criar este arquivo estão disponíveis aqui, com um guia passo a passo.

Criação do Arquivo ZIP

Com o arquivo de configuração pronto, o próximo passo é preparar sua aplicação para upload. Isso envolve colocar os arquivos da aplicação e o arquivo de configuração da Square Cloud dentro de um arquivo .zip.No entanto, nem todos os arquivos precisam ser incluídos neste .zip. Arquivos como node_modules, package-lock.json, pyproject.toml e poetry.lock não são necessários, pois podem ser gerados automaticamente no lado do servidor.

Arquivo de Dependências

Outro aspecto crucial é incluir o arquivo de dependências no .zip. Este arquivo informa à plataforma Square Cloud quais dependências instalar para seu projeto. Para um projeto Node.js, este arquivo é o package.json, e para um projeto Python, é o requirements.txt.Esses arquivos listam as bibliotecas e pacotes necessários para o funcionamento correto da aplicação. Manter esses arquivos atualizados é crucial para evitar erros de instalação. Além disso, é importante observar que dependências nativas, como node-fetch no Node.js e random no Python, não devem ser incluídas nesses arquivos, pois são bibliotecas nativas.

Upload do Bot

Após seguir todas as etapas e configurar seu projeto para a Square Cloud, é hora de fazer o upload do seu bot. Acesse a página de upload no site da Square Cloud e envie seu arquivo .zip aqui.O processo é simples: selecione seu arquivo .zip e clique no botão de upload. A plataforma Square Cloud iniciará o processo de implantação, instalando as dependências necessárias e configurando o ambiente com base no arquivo de configuração.
Enviando aplicação para a Square Cloud

​
Perguntas frequentes

A maioria dos bots do Discord roda confortavelmente no plano Hobby por R$12,49/mês, que atende ao mínimo de 256 MB de RAM exigido para bots. Veja Planos e Preços para a comparação completa.
Sim — seu bot roda em um container isolado com CPU e RAM dedicadas, reinício automático em caso de queda, e a infraestrutura da Square Cloud tem uma média de 99.999% de uptime em toda a plataforma.