Crie a sua sala

Integração com o Discord

Avisos por webhook, chat nos dois sentidos com um bot e boas práticas de segurança.

Ligar a sala ao Discord da sua comunidade traz as pessoas de volta: avisos de partida, resultado, o link da sala e até conversar com quem está jogando. O discord.ts do projeto de exemplo mostra os dois jeitos.

JeitoFazPrecisa de
WebhookSó manda mensagens (resultados, "sala no ar")Uma URL de webhook
BotManda e recebe: chat sala ↔ canal, comandosUm bot no Discord Developer Portal

Jeito 1: webhook (5 minutos)

  1. No Discord: Configurações do canal → Integrações → Webhooks → Novo webhook.
  2. Copie a URL e coloque no .env: DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
  3. Pronto. A sala de exemplo avisa o resultado de cada partida.
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: [] } }),
  });
}

Jeito 2: bot com chat nos dois sentidos

Criar o bot

  1. Entre em discord.com/developers/applications → New Application.
  2. Aba Bot → Reset Token e copie o token para DISCORD_TOKEN no .env.
  3. Ainda na aba Bot, ligue Message Content Intent (sem ela o bot não lê o texto das mensagens).
  4. Aba OAuth2 → URL Generator: marque bot e as permissões View Channels, Send Messages e Read Message History. Abra a URL gerada e adicione o bot ao seu servidor.
  5. No Discord, ative o Modo desenvolvedor (Configurações → Avançado), clique com o botão direito no canal → Copiar ID e coloque em DISCORD_CANAL.

O que o exemplo faz

  • Toda mensagem do chat da sala vai para o canal: **Ana**: gg
  • Toda mensagem do canal vai para a sala: [discord] Bruno: boa partida
  • O resultado de cada partida e o link da sala (quando ela sobe) vão para o canal.

O pedaço que liga as duas pontas, no 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}`);

O código completo

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

/** Forma mais simples: só AVISAR no Discord (sem bot). Crie o webhook em Canal > Editar > Integrações. */
export async function avisarWebhook(url: string, texto: string): Promise<void> {
  await fetch(url, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    // allowed_mentions vazio: ninguém consegue marcar @everyone escrevendo o nome no jogo
    body: JSON.stringify({ content: texto.slice(0, 2000), allowed_mentions: { parse: [] } }),
  }).catch((err) => console.error('[discord] webhook falhou', err));
}

/** Bot de verdade: chat nos dois sentidos (sala <-> canal) e comandos. */
export class PonteDiscord {
  private canal: SendableChannels | null = null;
  /** Mensagens que chegam do canal do Discord (o bot ignora as dele e as de outros 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();
  }
}

/** Tira formatação do Discord do que veio do jogo (nome "**admin**" não vira negrito, `@` não vira menção). */
export const limpar = (t: string) => t.replace(/[\*_~`|>@#]/g, (c) => `\${c}`);

Segurança e bom senso

  • Escape o que vem do jogo. Nomes e mensagens dos jogadores podem ter **, `, @... A função limpar() coloca \ antes desses caracteres para nada virar formatação ou menção.
  • Ignore bots no canal (inclusive o seu), senão as mensagens fazem eco infinito.
  • Limite o tamanho. O Discord aceita até 2000 caracteres por mensagem; o chat do bonk, cerca de 95 por linha.
  • Ponte em mão única para moderar. Se o canal for público, pense em só mandar sala → Discord e deixar o caminho Discord → sala para um cargo de staff.

Indo além

IdeiaComo
Comando /sala que responde o link e quem está jogandoSlash commands do discord.js (SlashCommandBuilder) lendo room.state.players
Cargo para quem joga muitoVincule a conta do bonk ao Discord com um código de 6 dígitos que o bot manda no privado e o jogador digita na sala (!vincular 123456)
Replays no DiscordEnvie o .bkrp como anexo (files: [{ attachment: caminho }]) ao fim de cada partida
Vários processos (sala e bot separados)A sala abre uma pequena API HTTP local (só 127.0.0.1, com token) com /status e um fluxo de eventos; o bot do Discord consome. Foi assim nas salas da BonkTools: um bot para várias salas