Les messages comme événements

Réagir à un mot

import { event } from 'chapterjs';

export default event({
  name: 'messageCreate',
  async run({ message }) {
    if (!/\bmerci\b/i.test(message.content)) return;
    await message.react('💜');
  },
});

⚠ Your files need an option that is not enabled for your bot:
  - Message Content Intent, needed by src/events/thanks.ts
  Enable it under "Privileged Gateway Intents", then save:
  https://discord.com/developers/applications/123456789012345678/bot
  Waiting for you to enable it...

Sûr par défaut

• Les messages des bots et des webhooks sont ignorés, y compris les vôtres. Un bot qui réagit aux messages et répond par un message verra sa propre réponse, y réagira, et ainsi de suite indéfiniment ; un serveur avec deux bots de ce genre les voit discuter toute la nuit. Alors par défaut, votre fichier ne tourne que pour les messages écrits par des personnes. Quand vous voulez vraiment les messages des bots, dites-le : bots: true, écrit à côté de name.
• Seulement les messages des serveurs. Les messages privés sont un autre endroit, sans serveur, sans membre et sans salon de serveur ; un fichier qui gère les deux doit les distinguer. Alors par défaut, votre fichier écoute sur les serveurs, où message.guild, message.channel et message.member sont toujours là.

Répondre à un message

import { event } from 'chapterjs';

export default event({
  name: 'messageCreate',
  async run({ message }) {
    if (!message.content.toLowerCase().includes('où est le règlement')) return;
    const rules = message.guild.rulesChannelId
      ? message.guild.channels.get(message.guild.rulesChannelId)
      : undefined;
    await message.reply({
      content: rules ? `Il est dans ${rules}.` : 'Ce serveur n’a pas encore de salon de règlement.',
      allowedMentions: { repliedUser: false },
    });
  },
});

Messages supprimés et modifiés

import { event } from 'chapterjs';

export default event({
  name: 'messageDelete',
  run({ message, guild }) {
    console.log(`Message ${message.id} supprimé dans #${message.channel.name} de ${guild.name}`);
  },
});

Points d’attention

• Ne répondez jamais à un message par un message sans penser aux boucles. Avec le comportement par défaut (pas de bots), vous êtes en sécurité. Avec bots: true, assurez-vous que votre fichier ne peut pas réagir à sa propre réponse.
• Une réaction à un mot tourne sur chaque message de chaque salon. Gardez la vérification légère et en premier, et faites return tôt.
• Les messages privés, c’est pour la production. Un bot de support qui écoute en messages privés s’essaie avec chapterjs start, sur l’application de dev si vous voulez.
• Un fil que le bot n’a jamais vu. Un message peut arriver dans un salon que le bot ne connaît pas encore (un fil créé avant sa connexion). Le framework le demande une fois à Discord, avant de lancer vos fichiers, donc message.channel est toujours là. Quand Discord refuse (le bot ne peut pas voir ce salon), l’événement n’est pas transmis et le terminal le dit avec ⚠.

Récapitulatif

• Un événement messageCreate tourne pour les messages écrits par des personnes, sur les serveurs, par défaut : aucune vérification author.bot à écrire.
• Le Message Content Intent est nécessaire pour lire message.content dans messageCreate et messageUpdate.
• bots: true et where: 'dm' ou where: 'both' élargissent ce qu’un fichier entend, et les types suivent.
• messageDelete donne ce qui reste du message (id, channel) et le serveur ; message.before est null.