> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Hospedagem de bots Discord, WhatsApp e Telegram 24/7

> Hospede seu bot de Discord, WhatsApp ou Telegram online 24/7, com CPU e RAM dedicadas, reinício automático e snapshots. Planos a partir de R$12,49/mês.

<Frame>
  <img src="https://squarecloud.app/banners/pt-br/bots.png" alt="Visão geral do serviço Bots da Square Cloud" style={{ borderRadius: "0.2rem" }} />
</Frame>

## 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.

<CardGroup cols={2}>
  <Card title="Performance sob medida" icon="bolt">
    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.
  </Card>

  <Card title="Um ecossistema completo para desenvolvedores" icon="code">
    **CLI**, **SDKs para JavaScript, Python e Go**, uma **[extensão para VS Code](/pt-br/vscode-extension/installation)** e **GitHub Actions/Webhooks** para CI/CD. Faça deploy pelo terminal, pelo editor ou com um `git push`.
  </Card>

  <Card title="Square Shield + Cloudflare" icon="shield-halved">
    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.
  </Card>

  <Card title="Snapshots instantâneos" icon="server">
    **Pontos de restauração em um clique**, inclusos sem custo adicional. Reverta um deploy quebrado em segundos, sem perda de dados e sem downtime.
  </Card>
</CardGroup>

<Info>
  **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.
</Info>

***

## 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.

<CardGroup cols={4}>
  <Card title="Discord" icon="discord" href="/pt-br/tutorials/bots/discord" />

  <Card title="WhatsApp" icon="whatsapp" href="/pt-br/tutorials/bots/whatsapp" />

  <Card title="Telegram" icon="telegram" href="/pt-br/tutorials/bots/telegram" />

  <Card title="Slack" icon="slack" href="/pt-br/tutorials/bots/slack" />

  <Card title="X (Twitter)" icon="x-twitter" href="/pt-br/tutorials/bots/x" />

  <Card title="Instagram" icon="instagram" />

  <Card title="Facebook" icon="facebook" />

  <Card title="YouTube" icon="youtube" />
</CardGroup>

### Linguagens

<CardGroup cols={3}>
  <Card title="JavaScript" icon="node-js" href="../articles/getting-started-with-nodejs" />

  <Card title="Bun" icon="bread-slice" href="../articles/getting-started-with-bun" />

  <Card title="Deno" icon="t-rex" href="../articles/getting-started-with-deno" />

  <Card title="Python" icon="python" href="../articles/getting-started-with-python" />

  <Card title="Java" icon="java" href="../articles/getting-started-with-java" />

  <Card title="Rust" icon="rust" href="../articles/getting-started-with-rust" />

  <Card title="Elixir" icon="droplet" href="../articles/getting-started-with-elixir" />

  <Card title="PHP" icon="php" href="../articles/getting-started-with-php" />

  <Card title="Go" icon="golang" href="../articles/getting-started-with-go" />

  <Card title="C#" icon="c" href="../articles/getting-started-with-csharp" />

  <Card title="Ruby" icon="gem" href="../articles/getting-started-with-ruby" />

  <Card title="HTML/CSS" icon="html5" href="../articles/getting-started-with-html" />
</CardGroup>

<Info>
  A maioria das outras linguagens e bibliotecas também funciona direto. Veja as [linguagens e runtimes suportados](/pt-br/runtimes/introduction).
</Info>

***

## 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

<AccordionGroup>
  <Accordion title="Snapshots em um clique">
    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.
  </Accordion>

  <Accordion title="Logs em tempo real">
    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.
  </Accordion>

  <Accordion title="Analytics ao vivo">
    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.
  </Accordion>
</AccordionGroup>

### Ferramentas de desenvolvimento

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

<Steps>
  <Step title="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](/pt-br/cli-reference/quickstart).

    ```bash theme={"system"}
    npm install -g @squarecloud/cli
    squarecloud auth login
    ```
  </Step>

  <Step title="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](/pt-br/vscode-extension/installation).
  </Step>

  <Step title="GitHub">
    Deploy contínuo para o seu bot: [integre seu repositório do GitHub](https://help.squarecloud.app/pt-br/article/como-integrar-seu-repositorio-do-github-e-fazer-deploy-automatico-1nk6gr9/) e cada `push` atualiza a aplicação automaticamente, ou faça deploy por um workflow com [GitHub Actions](https://help.squarecloud.app/pt-br/article/workflow-github-actions-deploy-automatico-o6c7e2/).
  </Step>
</Steps>

<Warning>
  O deploy com GitHub Actions precisa de uma [chave de API](/pt-br/api-reference/authentication) guardada nos secrets do repositório, nunca no código.
</Warning>

## Como hospedar meu bot?

<Steps>
  <Step title="Adicione um arquivo de configuração" icon="file">
    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](/pt-br/getting-started/config-file) explica cada campo. Adicione `AUTORESTART=true` para que o seu bot reinicie sozinho depois de uma falha.
  </Step>

  <Step title="Inclua seu arquivo de dependências" icon="box">
    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.
  </Step>

  <Step title="Compacte o projeto" icon="file-zip">
    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](/pt-br/getting-started/squarecloud-ignore).
  </Step>

  <Step title="Envie seu bot" icon="arrow-up">
    Envie o `.zip` na [página de upload](https://squarecloud.app/pt-br/dashboard/new). A Square Cloud instala as dependências, prepara o ambiente a partir do seu arquivo de configuração e inicia o seu bot.

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/dashboard/uploading-pt-br.gif" alt="Enviando aplicação para a Square Cloud" style={{ borderRadius: "0.2rem" }} />
    </Frame>
  </Step>
</Steps>

## Algo deu errado?

<CardGroup cols={2}>
  <Card title="O app não inicia" icon="triangle-exclamation" href="/pt-br/platform/troubleshooting/app-wont-start">
    Corrija um deploy que falha ou cai ao iniciar: módulos ausentes, `INVALID_DEPENDENCY`, uma porta já em uso ou RAM insuficiente.
  </Card>

  <Card title="Erros do bot do Discord" icon="discord" href="/pt-br/platform/troubleshooting/discord-bot-errors">
    Tokens inválidos, intents não permitidas, desconexões do Lavalink e um bot que cai depois de funcionar localmente.
  </Card>
</CardGroup>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quanto custa hospedar um bot do Discord?">
    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](/pt-br/platform/plans) para a comparação completa.
  </Accordion>

  <Accordion title="Meu bot fica online 24/7?">
    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](/pt-br/getting-started/config-file) para que o bot também reinicie sozinho depois de uma falha: essa opção vem desligada por padrão.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.