Cómo alojar un bot de Discord 24/7

​

Introducción

​

Requisitos previos

• Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
• Plan activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.

​

Crear el proyecto

​

Aplicación de bot en Discord

Crear la aplicación

Accede al Developer Portal y haz clic en “New Application”. Define un nombre para tu bot y haz clic en “Create” para crear la aplicación.

Generar el token

Después de crear la aplicación, navega a la pestaña “Bot” y haz clic en “Reset Token” para generar el token de autenticación. Cópialo: lo definirás como variable de entorno en Square Cloud, nunca en tu código.

Activar los intents privilegiados

El bot de ejemplo lee el texto de los mensajes, así que necesita el Message Content Intent. Permanece en la pestaña “Bot”, desplázate hasta “Privileged Gateway Intents” y activa Message Content Intent. Este ejemplo no necesita los otros dos intents privilegiados (Presence y Server Members).

​

Desarrollar el bot

npm init -y

npm install discord.js

const { Client, Events, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    // Privileged: turn on "Message Content Intent" in the Developer Portal
    GatewayIntentBits.MessageContent,
  ],
});

client.once(Events.ClientReady, (readyClient) => {
  console.log(`Logged in as ${readyClient.user.tag}`);
});

client.on(Events.MessageCreate, (message) => {
  if (message.author.bot) return;
  if (message.content === "!hello") {
    message.reply("Hello!");
  }
});

// The token comes from the DISCORD_TOKEN environment variable
client.login(process.env.DISCORD_TOKEN);

pip install discord.py

import os

import discord
from discord.ext import commands

intents = discord.Intents.default()
# Privileged: turn on "Message Content Intent" in the Developer Portal
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.command()
async def hello(ctx):
    await ctx.reply("Hello!")


# The token comes from the DISCORD_TOKEN environment variable
bot.run(os.environ["DISCORD_TOKEN"])

discord.py

​

Configurar Square Cloud

DISPLAY_NAME=My Discord Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Discord Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN es el archivo que ejecuta Square Cloud, y MEMORY es la RAM del bot en MB. Los bots necesitan al menos 256 MB; 512 MB deja margen para crecer.
• AUTORESTART=true vuelve a iniciar el bot si falla. Consulta cómo funciona el auto restart.
• No hay SUBDOMAIN: un bot no sirve páginas web.

​

Definir el token del bot

• Dashboard: en la página de subida, abre Configuración avanzada y añade una variable llamada DISCORD_TOKEN con tu token como valor. Para un bot que ya está en línea, añádela en la página Variables de entorno de la aplicación y reinicia el bot.
• CLI: justo después de subir el bot (consulta Hacer deploy y verificar), defínela con squarecloud app env set y reinicia el bot:

squarecloud app env set DISCORD_TOKEN=your_token_here
squarecloud app restart

​

Qué va en el ZIP

• Tu archivo principal (index.js o main.py) y tus demás archivos de código.
• package.json o requirements.txt.
• squarecloud.app.

​

Hacer deploy y verificar

​

A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​

A través de la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Invitar al bot a tu servidor

1. Accede al Developer Portal y selecciona tu bot.
2. Navega a la pestaña “OAuth2” y ve a “OAuth2 URL Generator”.
3. En “Scopes”, marca la opción “bot”.
4. En “Bot Permissions”, marca solo lo que necesita el ejemplo: View Channels, Send Messages y Read Message History. Evita Administrator: los bots rara vez lo necesitan, y un token filtrado controlaría entonces todo tu servidor.
5. Copia la URL generada, ábrela en tu navegador y añade el bot a tu servidor. La URL se ve así:

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=68608&scope=bot

​

Errores comunes

​

An invalid token was provided

​

Used disallowed intents

​

El bot está en línea pero no responde a !hello

​

Próximos pasos

​

Contáctanos