Crear el teu primer bot de Discord és més fàcil del que penses. No necessites una llicenciatura en informàtica ni anys d'experiència en programació. El 2026, construir i desplegar un bot funcional requereix un cap de setmana si estàs concentrat.
Aquesta guia et guia per tot el procés: registrar el teu bot, escriure la teva primera ordre, provar-lo localment i desplegar-lo en directe. Al final, tindràs un bot que s'executa al teu servidor.
Entendre què és un bot de Discord
Un bot de Discord és un programa que es connecta a Discord mitjançant l'API i respon a esdeveniments: quan algú escriu una ordre, reacciona a un missatge, s'uneix al servidor, etc.
Conceptes clau:
- Aplicació vs. Bot: La teva "aplicació" està registrada al Portal de desenvolupadors de Discord. El "bot" és el compte d'usuari associat a aquesta aplicació. Una aplicació té un bot.
- Tokens: Una clau secreta que autentica el teu bot. No la comparteixis mai. És com una contrasenya per al teu bot.
- Intencions: Permisos que permeten al teu bot veure determinats esdeveniments (missatges, reaccions, canvis d'estat dels membres, etc.). Només habilites el que necessites.
- Ordres: Els bots responen a ordres. Els bots moderns utilitzen ordres de barra inclinada (
/ordre) en lloc d'ordres de prefix (!ordre). Les ordres de barra inclinada són oficialment compatibles i recomanades. - Esdeveniments: El teu bot escolta els esdeveniments de Discord (missatge enviat, reacció afegida, membre unit) i hi reacciona.
Pas 1: Registra el teu bot al Portal de desenvolupadors de Discord
Aquí és on el teu bot existeix oficialment al sistema de Discord.
Procés:
- Ves al Portal de desenvolupadors de Discord
- Inicia sessió amb el teu compte de Discord
- Fes clic a "Nova aplicació"
- Posa-li un nom (per exemple, "El meu primer bot")
- Fes clic a "Crea"
- Ara ets a la configuració de la teva aplicació
Ara crea l'usuari del bot:
- Ves a la secció "Bot" (barra lateral esquerra)
- Fes clic a "Afegeix bot"
- Sota el nom d'usuari del bot, veuràs un botó "TOKEN"
- Copia el token — així és com s'autentica el teu bot. Mantén-ho en secret. No ho comparteixis mai públicament ni ho enviïs a GitHub sense xifratge.
Configura la configuració del bot:
- Habilita "Intenció de contingut del missatge" (permet al bot llegir el text del missatge)
- Habilita "Intenció de membres del servidor" (permet al bot veure qui hi ha al servidor)
- Desplaça't cap avall fins a la secció "OAuth2"
Pas 2: Genera l'enllaç de convidada del teu bot
Necessites un enllaç de convidada especial per afegir el bot a un servidor.
Al Portal de desenvolupadors:
- Ves a "OAuth2" → "Generador d'URL"
- A "ABASTOS", marca:
bot - A "PERMISOS", selecciona què pot fer el teu bot:
Enviar missatges(essencial per a qualsevol bot)Gestionar missatges(si estàs moderant)Afegir reaccions(si el bot reacciona a les coses)Connectar+Parlar(si és un bot de música/veu)- Per aprendre, només has de seleccionar
Enviar missatges+Llegir missatges(mínim viable)
- Copia l'URL generat a la part inferior
- Comparteix aquest URL amb els propietaris del servidor (o utilitza'l tu mateix per afegir-lo al teu propi servidor de prova)
No utilitzis el permís d'administrador tret que sigui absolutament necessari. L'excés de permisos és un risc de seguretat.
Pas 3: Tria el teu llenguatge i marc de treball
Dues opcions principals per a principiants:
JavaScript (discord.js)
Discord.js és el marc de treball de bot de Discord més popular. Comunitat enorme, tones de tutorials i documentació excel·lent.
Pros:
- La comunitat més gran i la majoria de tutorials en línia
- La documentació de discord.js és excel·lent
- Node.js és àmpliament utilitzat i fàcil d'aprendre
- Fàcil desplegament a la majoria de plataformes d'allotjament
Contres:
- JavaScript té peculiaritats (corba d'aprenentatge async/await)
- Node.js afegeix sobrecàrrega de memòria en comparació amb Python
Començar:
- Instal·la Node.js (v18+)
- Crea una carpeta de projecte
npm init -ynpm install discord.js
Python (discord.py)
Sintaxi més senzilla, ideal per a principiants, excel·lent per aprendre els fonaments.
Pros:
- La sintaxi més fàcil d'aprendre
- Intuïtiu per a principiants
- La documentació de discord.py és bona
- Python s'utilitza a tot arreu (ciència de dades, web, automatització)
Contres:
- Comunitat més petita que discord.js (però encara gran)
- Menys tutorials que JavaScript
- Ús de memòria lleugerament superior
Començar:
- Instal·la Python 3.10+
- Crea una carpeta de projecte
pip install discord.py
Recomanació per a principiants: Si coneixes Python, utilitza discord.py. Si coneixes JavaScript, utilitza discord.js. Si no coneixes cap dels dos, Python és més fàcil d'aprendre, però JavaScript té més recursos en línia. Tria'n un i compromet-te.
Pas 4: Escriu el teu primer bot (exemple de Python)
Aquí teniu un bot de Discord mínim que funciona en Python i que respon a una ordre:
import discord
from discord.ext import commands
# Crea un bot amb prefix d'ordre i intencions
intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix='!', intents=intents)
@bot.event
async def on_ready():
print(f'{bot.user} s'ha connectat a Discord!')
@bot.command(name='hello', help='Saluda')
async def hello(ctx):
await ctx.send(f'Hola {ctx.author.name}!')
@bot.command(name='ping', help='Respon amb pong')
async def ping(ctx):
await ctx.send('Pong!')
bot.run('YOUR_TOKEN_HERE')
Què fa això:
- Es connecta a Discord
- Escolta les ordres
!helloi!ping - Respon amb un missatge quan es desencadena
Per executar-lo:
- Substitueix
'YOUR_TOKEN_HERE'pel teu token real del pas 1 - Desa-ho com a
bot.py - Executa:
python bot.py - A Discord, escriu
!helloa qualsevol canal - El bot respon: "Hola [El teu nom]!"
Pas 5: Prova localment
Abans de desplegar, prova el teu bot localment (al teu ordinador).
Configura un servidor de prova:
- Crea un servidor de Discord privat per a les proves
- Afegeix-hi el teu bot utilitzant l'enllaç de convidada del pas 2
- Executa el teu codi de bot localment
- Escriu ordres al servidor de prova
- Busca errors al teu terminal; soluciona'ls
Errors comuns:
- "Token no vàlid" — Has copiat malament el token o ha caducat. Torna a generar-lo al Portal de desenvolupadors.
- "Falten permisos" — El bot no té permís per fer aquesta acció en aquest canal. Afegeix permisos o utilitza un canal on el bot tingui més drets.
- "Les intencions no estan habilitades" — Has d'habilitar les intencions al Portal de desenvolupadors (Intenció de contingut del missatge, Intenció de membres del servidor, etc.)
Prova a fons. Un bot amb errors en producció és vergonyós.
Pas 6: Afegeix més ordres
Ara que entens els conceptes bàsics, amplia amb més funcions.
Exemple de Python — una ordre d'economia senzilla:
@bot.command(name='balance', help='Comprova el teu saldo de monedes')
async def balance(ctx):
# En un bot real, això consultaria una base de dades
# Per ara, només torna un valor simulacre
await ctx.send(f'{ctx.author.name}, tens 100 monedes!')
@bot.command(name='roll', help='Tira un dau (1-6)')
async def roll(ctx):
import random
result = random.randint(1, 6)
await ctx.send(f'{ctx.author.name} ha tirat: **{result}**')
Cada ordre és una funció senzilla. Afegeix-ne tantes com vulguis.
Pas 7: Desplega el teu bot
L'allotjament local funciona per a les proves, però el teu bot s'atura quan tanques el teu portàtil. Desplega-ho a un servidor perquè s'executi les 24 hores del dia, els 7 dies de la setmana.
Opcions d'allotjament gratuïtes
Replit (el més fàcil per a principiants):
- Ves a Replit.com
- Crea un nou Repl → Python (o Node.js)
- Enganxa el teu codi de bot
- Fes clic a "Executa"
- Replit l'allotja gratuïtament (amb limitacions: pot adormir-se després de la inactivitat)
Railway.app (modern, fiable):
- Ves a Railway.app
- Connecta GitHub (o carrega fitxers directament)
- Crea un nou projecte → selecciona el teu bot
- Railway es desplega automàticament
- El nivell gratuït inclou un crèdit mensual de 5 dòlars
Glitch (similar a Replit):
- Ves a Glitch.com
- Crea un nou projecte
- Enganxa el codi
- Glitch el manté en funcionament (dins dels límits del nivell gratuït)
Important: No codifiquis el teu token al codi que envies a GitHub. Utilitza variables d'entorn:
import os
from dotenv import load_dotenv
load_dotenv()
TOKEN = os.getenv('DISCORD_TOKEN')
bot.run(TOKEN)
Crea un fitxer .env localment (afegeix-lo a .gitignore perquè no es confirmi):
DISCORD_TOKEN=el_teu_token_real_aquí
A Replit/Railway, estableix el token com a variable d'entorn secreta a la configuració de la plataforma (no al codi).
Errors comuns de principiants
Error 1: Codificar el token No posis mai el teu token al codi que envies a GitHub. Els bots amb tokens filtrats es veuen compromesos a l'instant. Utilitza variables d'entorn.
Error 2: No gestionar els errors El teu bot es bloqueja amb una entrada inesperada. Afegeix la gestió d'errors:
@bot.command()
async def divide(ctx, a: int, b: int):
try:
result = a / b
await ctx.send(result)
except ZeroDivisionError:
await ctx.send('No es pot dividir per zero!')
except ValueError:
await ctx.send('Si us plau, introduïu números vàlids!')
Error 3: No respectar els límits de velocitat Discord limita la velocitat amb què pots enviar missatges. No facis correu brossa a l'API. Afegeix retards entre les accions massives.
Error 4: Ignorar les intencions Molts bots de principiants fallen perquè no habiliten les intencions necessàries al Portal de desenvolupadors. Comprova les intencions que necessita el teu bot abans de desplegar-lo.
Error 5: Àmbit massa ambiciós No intentis construir un sistema econòmic, moderació, música i 50 ordres al teu primer bot. Comença amb 3-5 ordres senzilles. Amplia-ho un cop estiguis còmode.
Passos següents
Ara que tens un bot bàsic:
- Amplia la funcionalitat: Afegeix més ordres, utilitza bases de dades per persistir les dades, implementa una lògica complexa
- Utilitza ordres de barra inclinada: Sintaxi
/ordremoderna en lloc d'ordres de prefix - Afegeix reaccions: Permet als usuaris fer clic a botons o reaccionar amb emojis
- Connecta una base de dades: Emmagatzema dades d'usuari, monedes, preferències (SQLite per a principiants, PostgreSQL per a l'escala)
- Uneix-te a comunitats: Les comunitats de desenvolupadors de bots de Discord (reddit.com/r/discordbots, servidor de suport de Discord.js) tenen respostes a totes les preguntes
Recursos
- Documentació de discord.js: https://discord.js.org
- Documentació de discord.py: https://discordpy.readthedocs.io
- Documentació de l'API de Discord: https://discord.com/developers/docs/intro
- Tutorials de YouTube: Cerca "[discord.js/discord.py] tutorial" — gran quantitat de contingut
El teu primer bot de Discord és un projecte de cap de setmana. El teu primer bon bot de Discord és un mes de pràctica. El teu primer bot utilitzat per 1.000 servidors són mesos d'iteració, desenvolupament de funcions i construcció de comunitat. Comença ara, itera constantment i no hi pensis massa.