DisbandDocs
disband.dev
自动翻译本页面为自动翻译，英文原文为最终版本。阅读此页的英文版

机器人模板

通用机器人即时可适应的起点。每个都是一个小型、独立的脚本，你可以粘贴到文件中，然后使用JavaScript或Python客户端运行。

欢迎者

每当有人加入一个空间时，都会发布欢迎信息。需要messages.write和members.read。

import { Client } from "@disband/bot";

const client = new Client({ token: process.env.DISBAND_BOT_TOKEN });
const WELCOME_CHANNEL = process.env.WELCOME_CHANNEL_ID;

client.on("memberJoin", async (member) => {
  await client.channels.send(WELCOME_CHANNEL, `Welcome to the space, ${member.display_name ?? member.username}!`);
});

await client.connect();

今天，网关发送了messageCreate、messageUpdate和messageDelete； 会员事件通过与你的机器人作用域允许的相同事件流到达。

票务经理

根据每个支持请求创建一个私人频道，并向员工角色发送ping。需要channels.manage（以及manage_channels角色）和messages.write。

import { Client } from "@disband/bot";

const client = new Client({ token: process.env.DISBAND_BOT_TOKEN });
const SUPPORT_CATEGORY = process.env.SUPPORT_CATEGORY_ID;
const STAFF_ROLE = process.env.STAFF_ROLE_ID;

client.on("messageCreate", async (message) => {
  if (message.author?.is_bot) return;
  if (!message.content.startsWith("!ticket")) return;

  const subject = message.content.slice("!ticket".length).trim() || "support";
  const channel = await client.channels.create({
    name: `ticket-${subject}`.slice(0, 32),
    parent_id: SUPPORT_CATEGORY,
  });
  await client.channels.send(channel.id, `<@&${STAFF_ROLE}> new ticket: ${subject}`);
  await message.reply(`Created ${channel.name}.`);
});

await client.connect();

自动响应器

回答一小组常见问题。需要messages.read和messages.write。

from disband_bot import Client

client = Client(token=DISBAND_BOT_TOKEN)
FAQS = {
    "hours": "We're open Monday to Friday, 9 to 5.",
    "invite": "Ask an admin for an invite link.",
}

@client.on("messageCreate")
def handle(message):
    if message.author_is_bot:
        return
    key = message.content.strip().lower().lstrip("!")
    if key in FAQS:
        message.reply(FAQS[key])

client.run()

审核助手

删除包含禁用单词的消息并记录它们。需要messages.read、messages.write和manage_messages角色。

const BANNED = ["spamword"];

client.on("messageCreate", async (message) => {
  if (message.author?.is_bot) return;
  if (BANNED.some((w) => message.content.toLowerCase().includes(w))) {
    await client.messages.delete(message.channel_id, message.id);
    await client.channels.send(message.channel_id, "A message was removed by the bot.");
  }
});

提示