Bot de registros para Discord: mensajes borrados y editados, entradas y salidas

DISCORD_TOKEN=pega-aquí-tu-token
CANAL_REGISTRO=123456789012345678

discord.py
python-dotenv

import os

import discord
from dotenv import load_dotenv

load_dotenv()  # lee el token y el canal del fichero .env
CANAL_REGISTRO = int(os.environ["CANAL_REGISTRO"])  # el ID del canal de registros

intents = discord.Intents.default()
intents.message_content = True  # leer el texto de los mensajes
intents.members = True  # saber quién entra y quién sale
# los últimos mensajes que recuerda el bot; de los más viejos no sabrá el texto
client = discord.Client(intents=intents, max_messages=5000)


def recortar(texto: str | None) -> str:
    texto = texto or "(sin texto)"
    return texto if len(texto) <= 1000 else texto[:1000] + "…"


async def registrar(guild: discord.Guild | None, embed: discord.Embed):
    # solo en el canal de registros de ese mismo servidor
    canal = client.get_channel(CANAL_REGISTRO)
    if canal and guild and canal.guild == guild:
        await canal.send(embed=embed)


@client.event
async def on_raw_message_delete(payload: discord.RawMessageDeleteEvent):
    if payload.channel_id == CANAL_REGISTRO or payload.guild_id is None:
        return
    msg = payload.cached_message  # solo si el bot lo vio llegar
    if msg and msg.author.bot:
        return
    embed = discord.Embed(title="Mensaje borrado", color=0xE74C3C, timestamp=discord.utils.utcnow())
    embed.add_field(name="Canal", value=f"<#{payload.channel_id}>")
    if msg:
        embed.description = recortar(msg.content)
        embed.add_field(name="Autor", value=msg.author.mention)
        if msg.attachments:
            nombres = ", ".join(a.filename for a in msg.attachments)
            embed.add_field(name="Adjuntos", value=recortar(nombres), inline=False)
    else:
        embed.description = "Era de antes de que el bot lo viera: Discord no da su texto."
    await registrar(client.get_guild(payload.guild_id), embed)


@client.event
async def on_message_edit(before: discord.Message, after: discord.Message):
    # también salta cuando Discord añade la vista previa de un enlace: sin cambio de texto, nada
    if after.guild is None or after.author.bot or before.content == after.content:
        return
    embed = discord.Embed(title="Mensaje editado", url=after.jump_url, color=0xF1C40F, timestamp=discord.utils.utcnow())
    embed.add_field(name="Autor", value=after.author.mention)
    embed.add_field(name="Canal", value=after.channel.mention)
    embed.add_field(name="Antes", value=recortar(before.content), inline=False)
    embed.add_field(name="Después", value=recortar(after.content), inline=False)
    await registrar(after.guild, embed)


@client.event
async def on_member_join(member: discord.Member):
    embed = discord.Embed(title="Ha entrado", description=f"{member.mention} ({member})", color=0x2ECC71, timestamp=discord.utils.utcnow())
    embed.add_field(name="Cuenta creada", value=discord.utils.format_dt(member.created_at, "R"))
    await registrar(member.guild, embed)


@client.event
async def on_member_remove(member: discord.Member):
    embed = discord.Embed(title="Se ha ido", description=f"{member.mention} ({member})", color=0x95A5A6, timestamp=discord.utils.utcnow())
    await registrar(member.guild, embed)


@client.event
async def on_ready():
    print(f"Conectado como {client.user}")


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

DISCORD_TOKEN=pega-aquí-tu-token
CANAL_REGISTRO=123456789012345678

{
  "name": "bot-registros",
  "version": "1.0.0",
  "main": "index.js",
  "dependencies": {
    "discord.js": "^14.27.0",
    "dotenv": "^16.4.0"
  }
}

require("dotenv").config(); // lee el token y el canal del fichero .env
const { Client, EmbedBuilder, Events, GatewayIntentBits, Options, Partials } = require("discord.js");

const CANAL_REGISTRO = process.env.CANAL_REGISTRO; // el ID del canal de registros

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent, // leer el texto de los mensajes
    GatewayIntentBits.GuildMembers, // saber quién entra y quién sale
  ],
  // sin esto, de un mensaje que el bot no recuerda no llega ni el aviso
  partials: [Partials.Message, Partials.GuildMember],
  // los mensajes que recuerda por canal (de serie, 200)
  makeCache: Options.cacheWithLimits({ ...Options.DefaultMakeCacheSettings, MessageManager: 1000 }),
});

const recortar = (texto) => (!texto ? "(sin texto)" : texto.length <= 1000 ? texto : texto.slice(0, 1000) + "…");

async function registrar(guild, embed) {
  // solo en el canal de registros de ese mismo servidor
  const canal = await client.channels.fetch(CANAL_REGISTRO).catch(() => null);
  if (canal && guild && canal.guildId === guild.id) await canal.send({ embeds: [embed] });
}

client.on(Events.MessageDelete, async (msg) => {
  if (!msg.guild || msg.channelId === CANAL_REGISTRO || msg.author?.bot) return;
  const embed = new EmbedBuilder()
    .setTitle("Mensaje borrado")
    .setColor("#e74c3c")
    .setTimestamp()
    .addFields({ name: "Canal", value: `<#${msg.channelId}>`, inline: true });
  if (msg.partial) {
    embed.setDescription("Era de antes de que el bot lo viera: Discord no da su texto."); // el bot no lo vio llegar
  } else {
    embed.setDescription(recortar(msg.content)).addFields({ name: "Autor", value: `${msg.author}`, inline: true });
    if (msg.attachments.size) {
      embed.addFields({ name: "Adjuntos", value: recortar(msg.attachments.map((a) => a.name).join(", ")) });
    }
  }
  await registrar(msg.guild, embed);
});

client.on(Events.MessageUpdate, async (antes, despues) => {
  if (!despues.guild || !despues.author || despues.author.bot) return;
  // también salta cuando Discord añade la vista previa de un enlace: sin cambio de texto, nada
  if (!antes.partial && antes.content === despues.content) return;
  const embed = new EmbedBuilder()
    .setTitle("Mensaje editado")
    .setURL(despues.url)
    .setColor("#f1c40f")
    .setTimestamp()
    .addFields(
      { name: "Autor", value: `${despues.author}`, inline: true },
      { name: "Canal", value: `<#${despues.channelId}>`, inline: true },
      { name: "Antes", value: antes.partial ? "(el bot no lo recordaba)" : recortar(antes.content) },
      { name: "Después", value: recortar(despues.content) },
    );
  await registrar(despues.guild, embed);
});

client.on(Events.GuildMemberAdd, async (m) => {
  const embed = new EmbedBuilder()
    .setTitle("Ha entrado")
    .setDescription(`${m.user} (${m.user.tag})`)
    .setColor("#2ecc71")
    .setTimestamp()
    .addFields({ name: "Cuenta creada", value: `<t:${Math.floor(m.user.createdTimestamp / 1000)}:R>` });
  await registrar(m.guild, embed);
});

client.on(Events.GuildMemberRemove, async (m) => {
  const embed = new EmbedBuilder().setTitle("Se ha ido").setDescription(`${m.user} (${m.user.tag})`).setColor("#95a5a6").setTimestamp();
  await registrar(m.guild, embed);
});

client.once(Events.ClientReady, (c) => console.log(`Conectado como ${c.user.tag}`));

client.login(process.env.DISCORD_TOKEN);