Créez votre salon

Intégration Discord

Notifications par webhook, chat dans les deux sens avec un bot et bonnes pratiques de sécurité.

Relier votre salon au Discord de votre communauté fait revenir les gens : annonces de match, résultats, lien du salon et même discuter avec ceux qui jouent. Le fichier discord.ts du projet d'exemple montre les deux façons.

FaçonFaitNécessite
WebhookEnvoie seulement des messages (résultats, « salon en ligne »)Une URL de webhook
BotEnvoie et reçoit : chat salon ↔ salon Discord, commandesUn bot dans le Discord Developer Portal

Façon 1 : webhook (5 minutes)

  1. Dans Discord : Paramètres du salon → Intégrations → Webhooks → Nouveau webhook.
  2. Copiez l'URL et mettez-la dans le .env : DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
  3. C'est tout. Le salon d'exemple annonce le résultat de chaque match.
ts
export async function avisarWebhook(url: string, texto: string): Promise<void> {
  await fetch(url, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ content: texto.slice(0, 2000), allowed_mentions: { parse: [] } }),
  });
}

Façon 2 : bot avec chat dans les deux sens

Créer le bot

  1. Allez sur discord.com/developers/applications → New Application.
  2. Onglet Bot → Reset Token et copiez le token dans DISCORD_TOKEN du .env.
  3. Toujours dans l'onglet Bot, activez Message Content Intent (sans elle le bot ne lit pas le texte des messages).
  4. Onglet OAuth2 → URL Generator : cochez bot et les permissions View Channels, Send Messages et Read Message History. Ouvrez l'URL générée et ajoutez le bot à votre serveur.
  5. Dans Discord, activez le Mode développeur (Paramètres → Avancés), clic droit sur le salon → Copier l'identifiant et mettez-le dans DISCORD_CANAL.

Ce que fait l'exemple

  • Chaque message du chat du salon de jeu va dans le salon Discord : **Ana**: gg
  • Chaque message du salon Discord va dans le salon de jeu : [discord] Bruno: bien joué
  • Le résultat de chaque match et le lien du salon (au démarrage) vont dans le salon Discord.

La pièce qui relie les deux bouts, dans sala.ts :

ts
this.discord = await PonteDiscord.conectar(token, canal);
this.discord.aoReceber = (autor, texto) => falar(this.room, `[discord] ${autor}: ${texto}`);
this.discord.enviar(`sala no ar: ${this.room.shareLink}`);

(PonteDiscord = pont vers Discord, aoReceber = à la réception, enviar = envoyer.)

Le code complet

ts
// discord.ts
import { Client, Events, GatewayIntentBits, type SendableChannels } from 'discord.js';

/** Le plus simple : juste NOTIFIER sur Discord (sans bot). Créez le webhook dans Salon > Modifier > Intégrations. */
export async function avisarWebhook(url: string, texto: string): Promise<void> {
  await fetch(url, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    // allowed_mentions vide : personne ne peut mentionner @everyone en l'utilisant comme pseudo
    body: JSON.stringify({ content: texto.slice(0, 2000), allowed_mentions: { parse: [] } }),
  }).catch((err) => console.error('[discord] webhook falhou', err));
}

/** Un vrai bot : chat dans les deux sens (salon <-> salon Discord) et commandes. */
export class PonteDiscord {
  private canal: SendableChannels | null = null;
  /** Messages venant du salon Discord (le bot ignore les siens et ceux des autres bots). */
  aoReceber: (autor: string, texto: string) => void = () => {};

  private constructor(private readonly client: Client) {}

  static async conectar(token: string, canalId: string): Promise<PonteDiscord> {
    const client = new Client({
      intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent],
    });
    const ponte = new PonteDiscord(client);
    client.on(Events.MessageCreate, (msg) => {
      if (msg.channelId !== canalId || msg.author.bot || !msg.content) return;
      ponte.aoReceber(msg.member?.displayName ?? msg.author.username, msg.content);
    });
    await client.login(token);
    const canal = await client.channels.fetch(canalId);
    if (!canal?.isSendable()) throw new Error('canal do Discord não encontrado ou sem permissão de enviar');
    ponte.canal = canal;
    return ponte;
  }

  enviar(texto: string): void {
    this.canal?.send({ content: texto.slice(0, 2000), allowedMentions: { parse: [] } }).catch((err) => console.error('[discord]', err));
  }

  destroy(): void {
    void this.client.destroy();
  }
}

/** Retire le formatage Discord du texte du jeu (un nom "**admin**" ne passe pas en gras, `@` ne devient pas une mention). */
export const limpar = (t: string) => t.replace(/[\*_~`|>@#]/g, (c) => `\${c}`);

Sécurité et bon sens

  • Échappez ce qui vient du jeu. Les noms et messages des joueurs peuvent contenir **, `, @... La fonction limpar() (« nettoyer ») met un \ devant ces caractères pour que rien ne devienne mise en forme ou mention.
  • Ignorez les bots dans le salon (y compris le vôtre), sinon les messages font un écho infini.
  • Limitez la taille. Discord accepte jusqu'à 2000 caractères par message ; le chat de bonk, environ 95 par ligne.
  • Pont à sens unique pour modérer. Si le salon Discord est public, envisagez d'envoyer seulement jeu → Discord et de réserver le sens Discord → jeu à un rôle de staff.

Aller plus loin

IdéeComment
Commande /sala qui répond avec le lien et qui joueSlash commands de discord.js (SlashCommandBuilder) lisant room.state.players
Rôle pour ceux qui jouent beaucoupLiez le compte bonk à Discord avec un code à 6 chiffres que le bot envoie en privé et que le joueur tape dans le salon (!vincular 123456)
Replays sur DiscordEnvoyez le .bkrp en pièce jointe (files: [{ attachment: chemin }]) à la fin de chaque match
Plusieurs processus (salon et bot séparés)Le salon ouvre une petite API HTTP locale (seulement 127.0.0.1, avec un token) avec /status et un flux d'événements ; le bot Discord la consomme. C'est ainsi que fonctionnaient les salons BonkTools : un bot pour plusieurs salons