Skip to content

Discord 接入教程

这篇适用于 Discord。Sentinel 的 Discord 方案默认使用客户自己的 Discord Bot,不是把 Sentinel 官方 Bot 拉进你的服务器。


Step 1:创建 Discord Bot

  1. 打开 Discord Developer Portal
  2. 创建 Application
  3. 进入 Bot 页面
  4. 创建 Bot 并复制 Token
  5. 开启必要 intents
  6. 保存 Token,回到 Sentinel DC 面板导入

建议开启:

  • Server Members Intent
  • Message Content Intent
  • Presence Intent 可按需开启

Step 2:导入 Bot Token

  1. 进入 Sentinel 控制台
  2. 打开 Discord 面板
  3. 进入 Bot 管理
  4. 粘贴 Bot Token
  5. 点击验证
  6. Sentinel 会读取 Bot 名称、状态和可管理服务器

如果验证失败,优先检查:

  • Token 是否复制完整
  • Bot 是否被重置过 Token
  • Developer Portal intents 是否开启
  • 当前账号是否有权限管理目标服务器

Step 3:邀请 Bot 进入服务器

在 Developer Portal 生成 OAuth2 邀请链接,建议包含:

  • bot
  • applications.commands

常用权限:

  • Manage Roles
  • Manage Channels
  • Kick Members / Ban Members 按需开启
  • Moderate Members
  • Manage Messages
  • Send Messages
  • Read Message History
  • Use Slash Commands
  • Create Public Threads / Send Messages in Threads 按需开启

Bot 进入服务器后,Sentinel DC 面板会自动识别服务器。


Step 4:配置服务器

进入目标服务器后,按这个顺序配置:

  1. 社区基础信息
  2. 欢迎 / 离开消息
  3. 验证与自动审核
  4. 工单系统
  5. AI 客服
  6. 增长系统
  7. 数据分析

不要一上来全开。先保证 Bot 权限和频道 ID 配置正确,再逐步开放用户互动。


常用指令

Discord 指令是 Slash Command,输入 / 后选择对应命令。实际是否可用取决于面板配置和频道 ID 限制。

/setup-verify
管理员发送验证按钮,用于引导用户完成入服验证
/setup-tickets
管理员发送工单入口按钮,用户点击后创建私密工单频道
/points
查看自己的 Sentinel 积分
/leaderboard
查看当前服务器积分排行
/tasks
查看进行中的任务,并按按钮提交凭证
/raffles
查看当前抽奖列表,并通过按钮参与
/joinraffle <raffle_id>
用抽奖 ID 直接参与指定抽奖
/shop
查看积分商城商品
/redeem <item_id>
用商品 ID 兑换积分商城商品

频道 ID 限制开启后,积分、任务、抽奖、商城相关指令只能在对应频道使用。


常见权限问题

Bot 看不到服务器

通常是 Bot 没有进服务器,或当前账号没有管理权限。

Bot 无法发消息

检查频道权限:

  • View Channel
  • Send Messages
  • Read Message History
  • Use External Emojis 按需开启

Bot 无法分配身份组

Discord 的角色层级很关键。Bot 的最高角色必须高于它要分配的身份组。

Slash Command 不显示

检查:

  • 邀请时是否勾选 applications.commands
  • Bot 是否已重新同步命令
  • 当前频道是否允许使用应用命令

Bot 名称和头像

Sentinel 支持在服务器内设置 Bot 昵称。

全局 Bot 名称和头像需要在 Discord Developer Portal 修改。不要频繁改全局头像和名称,Discord 对频繁变更有限制。

下一步

Bot 接进服务器后,先配置社区管理,再配置增长系统。

社区管理 →增长系统 →

Community Growth & Management System