> ## 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.
# Hospedaje de bots
> Hospeda tus bots de Discord, WhatsApp y Telegram en la mayor plataforma de Latinoamérica. Rendimiento de nivel empresarial, seguridad avanzada y herramientas de desarrollo para tu proyecto.
## ¿Por qué elegir Square Cloud?
Somos la **mayor plataforma de hospedaje de bots de Latinoamérica**, en la que confían **80 de los 100 servidores de Discord brasileños más grandes**. Un bot vive o muere por su uptime y por su latencia hacia los gateways de Discord, WhatsApp y Telegram, por eso cada capa de nuestro stack, desde el hardware hasta el edge de la red, está optimizada para mantener tu proceso en línea y receptivo 24/7.
Cada bot se ejecuta sobre **SSD NVMe empresariales de Samsung** detrás de enlaces de **10Gbps**, en un contenedor aislado con **CPU y RAM impuestas por el kernel**, para que el pico de tráfico de un vecino nunca se convierta en tu problema de latencia.
**CLI**, **SDKs de JavaScript y Python**, una **extensión de VSCode** y **GitHub Actions/Webhooks** para CI/CD. Despliega desde tu terminal, tu editor o un `git push`.
Un edge **con Cloudflare por delante** más **Square Shield** mantiene tu bot dentro de los límites de rate de la API de la plataforma (Discord y otras), evitando los baneos y cooldowns que dejan un bot offline.
**Puntos de restauración con un clic** incluidos sin coste adicional. Revierte un deploy roto en segundos, sin pérdida de datos ni tiempo de inactividad.
**Probado a escala:** nuestra reputación se ganó ejecutando los bots detrás de algunas de las comunidades más activas de Latinoamérica, ese tipo de carga sostenida y de alta tasa de eventos que expone silenciosamente la infraestructura débil. El tuyo se ejecuta en los mismos clústeres.
***
## Entornos compatibles
Ofrecemos amplia compatibilidad para que puedas desarrollar con tu tecnología preferida.
### Plataformas
### Lenguajes
Además de estos, soportamos varios otros lenguajes y librerías. Nuestra infraestructura es flexible para adaptarse a las necesidades de tu proyecto.
***
## Características principales
### Infraestructura diseñada para cargas de trabajo siempre activas
Cada clúster se ejecuta sobre **SSD NVMe empresariales de Samsung** con enlaces de **10Gbps**, y tu bot corre en un contenedor aislado y sin privilegios con límites dedicados de CPU y RAM. El aislamiento es lo que convierte lo "rápido sobre el papel" en rápido en producción: tu proceso nunca compite con un vecino ruidoso por la E/S o la CPU, así que los tiempos de respuesta se mantienen bajos incluso bajo una carga sostenida de eventos.
### Square Shield: mantenerse dentro de los límites de rate
Discord, WhatsApp y Telegram banean a los bots que superan sus límites de rate de gateway y REST. **Square Shield** se sitúa entre tu bot y esas APIs, monitorizando los patrones de solicitud para mantenerte dentro del presupuesto permitido, la diferencia entre un bot que escala limpiamente y uno que queda en cooldown offline en el peor momento.
### Opera con total visibilidad
Los puntos de restauración te permiten revertir un mal deploy en segundos, sin pérdida de datos ni tiempo de inactividad. Los planes Pro y Enterprise añaden además snapshots diarios automáticos.
Transmite el stdout/stderr de tu aplicación en vivo para depurar en producción en el momento en que algo se comporta mal, sin necesidad de volver a desplegar.
Sigue el consumo de CPU, RAM y red en tiempo real desde un panel intuitivo, para que puedas ajustar los recursos y detectar regresiones antes de que lo hagan tus usuarios.
### Herramientas de desarrollo
Para optimizar tu flujo de trabajo, ofrecemos un ecosistema completo de herramientas:
Gestiona tus aplicaciones directamente desde la terminal. Despliega, consulta logs y mucho más, de forma rápida y práctica.
```bash theme={null}
npm install -g @squarecloud/cli
squarecloud auth login
```
Integra la gestión del hospedaje en tu editor de código favorito, simplificando el proceso de desarrollo y despliegue.
Automatiza el despliegue continuo (CI/CD) de tu bot. Con cada `push` a tu repositorio, tu aplicación se actualiza automáticamente en nuestra plataforma.
**Atención:** Para usar el despliegue mediante GitHub Actions, necesitas configurar un `token` de API en los secrets de tu repositorio. Consulta nuestra documentación específica para la guía paso a paso.
## ¿Cómo hospedar mi bot?
El primer paso para hospedar tu bot en **Square Cloud** es crear un archivo de configuración detallado. Este archivo no es solo un simple documento de texto, sino una guía completa que define los ajustes de la aplicación en **Square Cloud**. Funciona como un plano arquitectónico de tu proyecto en la plataforma.
Una vez que hayas adquirido el plan, necesitas crear este archivo, detallando cada configuración y rellenándolo correctamente. Los detalles sobre cómo crear este archivo están disponibles [aquí](https://docs.squarecloud.app/es/getting-started/config-file), con una guía paso a paso.
Con el archivo de configuración listo, el siguiente paso es preparar tu aplicación para la subida. Esto implica colocar los archivos de la aplicación y el archivo de configuración de **Square Cloud** dentro de un archivo .zip.
Sin embargo, no todos los archivos deben incluirse en este .zip. Archivos como `node_modules`, `package-lock.json`, `pyproject.toml` y `poetry.lock` no son necesarios, ya que pueden generarse automáticamente del lado del servidor.
Otro aspecto crucial es incluir el archivo de dependencias en el .zip. Este archivo le indica a la plataforma **Square Cloud** qué dependencias instalar para tu proyecto. Para un proyecto de Node.js, este archivo es `package.json`, y para un proyecto de Python, es `requirements.txt`.
Estos archivos listan las librerías y paquetes necesarios para que la aplicación funcione correctamente. Mantener estos archivos actualizados es crucial para evitar errores de instalación. Además, es importante señalar que las dependencias nativas, como `node-fetch` en Node.js y `random` en Python, no deben incluirse en estos archivos, ya que son librerías nativas.
Después de seguir todos los pasos y configurar tu proyecto para **Square Cloud**, es hora de subir tu bot. Accede a la página de subida en el sitio web de **Square Cloud** y envía tu archivo .zip [aquí](https://squarecloud.app/es/dashboard/new).
El proceso es simple: selecciona tu archivo .zip y haz clic en el botón de subida. La plataforma **Square Cloud** iniciará el proceso de despliegue, instalando las dependencias necesarias y configurando el entorno según el archivo de configuración.
