> ## 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
> Hospede seus bots Discord, WhatsApp e Telegram na maior plataforma da América Latina. Performance empresarial, segurança avançada e ferramentas de desenvolvimento para seu projeto.
## 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**. Nossa plataforma foi construída pensando nas necessidades dos desenvolvedores, oferecendo um ambiente otimizado e ferramentas que simplificam o gerenciamento do seu projeto.
Hardware de ponta com **SSDs NVMe Samsung empresariais** e redes de **10Gbps** garantindo **performance máxima** e **latência ultra-baixa** para seus bots.
Oferecemos **CLI**, **SDKs**, **extensão para VSCode** e **GitHub Actions** para **otimizar seu fluxo de trabalho** e **acelerar o desenvolvimento**.
Proteção integrada com o **Square Shield** para manter seu bot **seguro** e **dentro dos limites de API**, evitando **banimentos** e **instabilidades**.
Tecnologia **exclusiva** de pontos de restauração em **1 clique**, inclusos **sem nenhum custo adicional**, garantindo **total segurança** dos seus dados.
**Confiança comprovada:** Nossa reputação foi construída através de anos servindo desenvolvedores do Brasil e de toda a América Latina, proporcionando estabilidade e qualidade que você pode confiar para seus projetos mais importantes.
***
## Ambientes suportados
Oferecemos ampla compatibilidade para que você possa desenvolver na tecnologia de sua preferência.
### Plataformas
### Linguagens
Além destas, suportamos diversas outras linguagens e bibliotecas. Nossa infraestrutura é flexível para se adaptar às necessidades do seu projeto.
***
## Recursos Principais
### Infraestrutura de Ponta
Nossa rede é construída com **SSDs NVMe Samsung** de nível empresarial e **uplinks de 10Gbps** por cluster, garantindo conexões ultrarrápidas e estáveis. Isso se traduz em um bot com tempo de resposta mínimo e alta disponibilidade.
### Segurança com Square Shield
O **Square Shield** é nossa camada de proteção inteligente. Ele monitora e protege seu bot para garantir que ele não exceda os limites de solicitação da API da plataforma (como o Discord), evitando banimentos e instabilidades.
### Gerenciamento Simplificado
Realizamos backups automáticos da sua aplicação diariamente, permitindo que você restaure uma versão anterior com apenas um clique em caso de problemas.
Acesse logs completos e em tempo real da sua aplicação para depurar erros e monitorar o comportamento do seu bot de forma eficiente.
Monitore o consumo de recursos (CPU, RAM, Rede) e o desempenho geral do seu bot através de um painel de analytics intuitivo.
### Ferramentas de Desenvolvimento
Para otimizar seu fluxo de trabalho, oferecemos um ecossistema completo de ferramentas:
Gerencie suas aplicações diretamente do terminal. Faça deploy, consulte logs e muito mais, de forma rápida e prática.
```bash theme={null}
npm install -g @squarecloud/cli
squarecloud auth login
```
Integre a gestão da sua hospedagem ao seu editor de código favorito, simplificando o processo de desenvolvimento e deploy.
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?
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](https://docs.squarecloud.app/pt-br/getting-started/config-file), com um guia passo a passo.
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.
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.
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](https://squarecloud.app/pt-br/dashboard/new).
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.
