Crie bots para o Codec.

01 Começar em 5 minutos

Um bot do Codec é um programa em Node.js que roda no seu computador (ou num servidor) e conversa com o Codec pelo SDK oficial, o arquivo codec-bot.js.

02 Criar o bot no Codec

Tudo que é do perfil do bot fica no app, na aba Bots › Desenvolvedor:

• Nome, frase curta, descrição, tags e cor — o que aparece no cartão do bot.
• Foto — PNG, JPG ou WEBP (vira uma imagem pequena, que vai em cada mensagem).
• Token — a senha do bot. Aparece uma vez só; se perder, gere outro (o antigo para de funcionar).
• Comandos — são registrados pelo seu código e aparecem aqui quando o bot liga.
• Online/offline — o bot fica online enquanto o programa está rodando.

03 Instalar o SDK

Usando só o SDK num projeto seu, instale a única dependência:

npm install firebase

E coloque o codec-bot.js na pasta do projeto. O token vem da variável de ambiente CODEC_TOKEN (o projeto inicial lê do arquivo .env).

04 Primeiro bot

const { Client } = require("./codec-bot");

const client = new Client({ token: process.env.CODEC_TOKEN });

// Comando com / (aparece nas sugestões do chat)
client.command({ name: "ping", description: "Mostra se o bot está vivo" }, async (ctx) => {
  const ms = await client.ping();
  await ctx.reply(`🏓 Pong! ${ms} ms`);
});

// Mensagens comuns
client.on("message", async (message) => {
  if (message.content === "oi bot") await message.reply(`Oi, ${message.author.name}! 👋`);
});

client.on("ready", () => console.log(`✅ ${client.bot.name} online!`));

client.login();

node --env-file=.env index.js

05 Comandos com /

Registre com client.command(definição, função). Quando alguém usa o comando, a resposta aparece com “Fulano usou /comando” em cima — igual aos bots do Codec.

client.command(
  { name: "dado", description: "Rola um dado", args: "[lados]" },
  async (ctx) => {
    const lados = Number(ctx.options[0]) || 6;
    const n = 1 + Math.floor(Math.random() * lados);
    await ctx.reply(`🎲 ${ctx.user.name} tirou **${n}**`);
  },
);

Definição

O que a função recebe (ctx)

06 Ler mensagens

O evento message dispara para cada mensagem nova nos canais de texto dos servidores onde o bot está. Mensagens de outros bots são ignoradas (mude com new Client({ ignoreBots: false })).

client.on("message", async (message) => {
  if (message.content.includes("bom dia")) {
    await message.react("☀️");
  }
  if (message.content === "!quem") {
    const m = message.member;
    await message.reply(`${m.mention} · dono: ${m.isOwner ? "sim" : "não"} · cargos: ${m.roles.length}`);
  }
});

07 Mandar mensagens

reply e send aceitam um texto ou um objeto de opções, e devolvem a mensagem enviada (dá para edit e delete depois).

const canal = server.channel("avisos");          // por nome ou id
const enviada = await canal.send("Reunião às 20h! 📅");

await enviada.edit("Reunião adiada para 21h ⏰");
setTimeout(() => enviada.delete(), 60_000);        // apaga depois de 1 min

Para marcar alguém, use member.mention no texto (vira @nome em destaque).

08 Cartões

Cartões (embeds) organizam a resposta com título, texto, campos e imagens.

const { Embed } = require("./codec-bot");

const card = new Embed()
  .setTitle("🏆 Ranking da semana")
  .setDescription("Quem mais conversou no servidor")
  .setColor("#f59e0b")
  .addField("1º", "Ana — 320 mensagens", true)
  .addField("2º", "Leo — 290 mensagens", true)
  .setThumbnail("https://exemplo.com/trofeu.png")
  .setFooter("Atualizado agora");

await ctx.reply({ embed: card });

Também dá para passar um objeto direto: { embed: { title: "Oi", description: "…" } }.

09 Botões

Até 5 botões por mensagem, sozinhos ou embaixo de um cartão. Quando alguém clica, chega o evento button com o id do botão.

await canal.send({
  content: "Aceita as regras do servidor?",
  buttons: [
    { id: "regras:sim", label: "Aceito", style: "success", emoji: "✅" },
    { id: "regras:nao", label: "Não aceito", style: "danger" },
    { label: "Ler as regras", style: "link", url: "https://meusite.com/regras" },
  ],
});

client.on("button", async (click) => {
  if (click.customId === "regras:sim") {
    await click.update({ content: `✅ ${click.user.name} aceitou as regras.` });
  }
});

10 Eventos

client.on("memberJoin", async (member) => {
  const canal = member.server.channel("geral") ?? member.server.textChannels[0];
  await canal?.send(`🎉 Bem-vindo(a), ${member.mention}!`);
});

client.on("serverJoin", (server) => console.log(`Entrei em ${server.name}`));
client.on("error", (err) => console.error(err));

11 Client

12 Servidor, canal e membro

13 Deixar online 24 horas

O bot só responde enquanto o programa estiver rodando. Para não depender do seu PC ligado:

• Hospedagens de bots (Discloud, Square Cloud e parecidas): envie a pasta do projeto sem node_modules e coloque o token nas variáveis de ambiente do painel (CODEC_TOKEN).
• VPS (Linux): use o pm2 para religar sozinho se cair.

npm install -g pm2
CODEC_TOKEN=seu-token pm2 start index.js --name meu-bot
pm2 save

14 Bots da Comunidade

Por padrão, só você consegue adicionar o seu bot (nos servidores que você gerencia). Para ele aparecer para todo mundo em Bots da Comunidade:

15 Limites e regras

• Não faça o bot mandar mensagens sem ninguém pedir em vários canais (spam).
• Não guarde nem peça senhas, tokens ou dados pessoais das pessoas.
• Bots que quebram as regras são tirados da comunidade.

16 Perguntas frequentes