Programar tu propio bot de Discord con discord.py

Q: ¿Por qué no aparecen mis comandos slash?

Después de tree.sync(), los comandos registrados globalmente pueden tardar hasta una hora en aparecer en todas partes en Discord. Para probarlos, puedes sincronizarlos directamente con un solo servidor y estarán disponibles de inmediato.

Escribe paso a paso tu propio bot de Discord con Python y discord.py y despliégalo en ZapX.

10 de noviembre de 20263 min de lectura0 Visitas0 útil

Introducción

En esta guía crearás tu propio bot de Discord desde cero con Python y la biblioteca discord.py. Registrarás la aplicación del bot en el Discord Developer Portal, escribirás una estructura básica funcional con un comando slash propio y, después, desplegarás el bot en ZapX Discord Bot Hosting. Tener conocimientos básicos de Python es útil, pero no es imprescindible.

Preparación

Antes de empezar a escribir el código, necesitas crear una aplicación de bot en Discord:

Abre el Discord Developer Portal y haz clic en New Application. Asigna un nombre a tu bot.
En el menú de la izquierda, ve a la pestaña Bot. Allí encontrarás el Token de tu bot mediante Reset Token. Copia el token y guárdalo en un lugar seguro: permite acceder por completo a tu bot y nunca debes incluirlo en el código ni compartirlo públicamente.
En esa misma página, en Privileged Gateway Intents, activa Message Content Intent si quieres que tu bot reaccione al contenido de los mensajes (por ejemplo, a comandos de texto).
Ve a la pestaña OAuth2 → URL Generator. Selecciona el ámbito bot y también applications.commands (para los comandos slash), marca los permisos que necesite tu bot y abre el enlace generado para invitarlo a tu propio servidor de Discord.

Escribir el bot en Python

Primero, instala discord.py en tu entorno de desarrollo:

bash

pip install -U discord.py

Crea un archivo main.py y prepara la estructura básica de tu bot:

python

import os
import discord
from discord import app_commands

intents = discord.Intents.default()
intents.message_content = True

client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)


@client.event
async def on_ready():
    await tree.sync()
    print(f"Bot ist online als {client.user}")


@tree.command(name="hallo", description="Begrüßt dich mit einer kurzen Nachricht")
async def hallo(interaction: discord.Interaction):
    await interaction.response.send_message(f"Hallo {interaction.user.mention}!")


client.run(os.environ["DISCORD_TOKEN"])

El token no se incluye directamente en el código, sino que se lee desde la variable de entorno DISCORD_TOKEN (os.environ["DISCORD_TOKEN"]). Así mantienes el token fuera del código y preparas todo para el paso de despliegue que se describe más abajo.

Si también quieres que el bot reaccione cuando se unan nuevos miembros al servidor, por ejemplo, enviándoles un mensaje de bienvenida, añade otro controlador de eventos:

python

@client.event
async def on_member_join(member: discord.Member):
    channel = discord.utils.get(member.guild.text_channels, name="willkommen")
    if channel:
        await channel.send(f"Willkommen auf dem Server, {member.mention}!")

Desplegar el bot en ZapX Discord Bot Hosting

Crea un nuevo servicio de bot de Discord en el panel de cliente de ZapX, si aún no lo has hecho.
Durante la configuración, selecciona Python 3.12 como entorno de ejecución.
Sube main.py (y, si tienes uno, un archivo requirements.txt con paquetes adicionales) al directorio del servicio mediante el administrador de archivos integrado o la carga de archivos.

Administrador de archivos de ZapX Discord Bot

Introduce el token del bot que generaste antes en la pestaña Einstellungen, en Bot-Konfiguration → Discord Bot Token, y guarda la configuración. Así el token queda separado del código y no tendrás que modificarlo cuando vuelvas a subir archivos. En tu código, este valor seguirá estando disponible como la variable de entorno DISCORD_TOKEN.

Configuración de ZapX Discord Bot con el campo del token

5. Inicia el servicio. Si todo funciona correctamente, en el registro aparecerá Bot ist online als ... y tu bot se mostrará como "Online" en tu servidor de Discord.

Solución de problemas

El bot sigue desconectado: Comprueba que el token esté configurado correctamente en la variable de entorno DISCORD_TOKEN y que no haya ningún mensaje de error en el registro del servicio.

No aparecen los comandos slash: Después de tree.sync(), los comandos registrados globalmente pueden tardar hasta una hora en aparecer en todas partes en Discord. Para probarlos, sincronízalos directamente con un solo servidor y estarán disponibles de inmediato.

Aparece "Missing Access" u otro error de permisos: El bot no tiene los permisos necesarios en el servidor. Comprueba los permisos de los roles del bot y asegúrate de haber seleccionado los permisos adecuados en OAuth2 URL Generator al invitarlo.

Conclusión

Ya has creado un bot de Discord funcional con discord.py, lo has equipado con un comando slash propio y lo has desplegado en ZapX Discord Bot Hosting. A partir de aquí, puedes ampliarlo con más comandos, funciones de moderación o integraciones.

FAQ

Preguntas frecuentes

Necesitas crear una aplicación de bot en el Discord Developer Portal. Allí crea una New Application, obtén el token en la pestaña Bot mediante 'Reset Token' y genera el enlace de invitación en OAuth2 URL Generator con los ámbitos 'bot' y 'applications.commands'.

El token no se incluye directamente en el código, sino que se lee desde la variable de entorno DISCORD_TOKEN ('os.environ["DISCORD_TOKEN"]'). En ZapX Discord Bot Hosting, introdúcelo en la pestaña Einstellungen, en Bot-Konfiguration -> Discord Bot Token.

Python 3.12.

Comentarios

¿Te resultó útil este artículo?

Tus comentarios nos ayudan a priorizar y mejorar los contenidos.

0 de 0 Las valoraciones consideraron útil este artículo.

Ayuda personalizada

¿No te basta con la guía?

Nuestro equipo de soporte de ZAP conoce tu producto. Describe brevemente tu consulta y te ayudaremos personalmente.

¿Qué 🍪 cookies deseas permitir?

Programar tu propio bot de Discord con discord.py

Introducción

Preparación

Escribir el bot en Python

Desplegar el bot en ZapX Discord Bot Hosting

Solución de problemas

Conclusión

Preguntas frecuentes

Bot de Discord

Preparación

Escribir el bot en Python

Desplegar el bot en ZapX Discord Bot Hosting

Solución de problemas

Conclusión

Servidor de juego

Servidores y hosting

ZAPX

Recursos

ZAP-Hosting