Discord 接入教程
这篇适用于 Discord。Sentinel 的 Discord 方案默认使用客户自己的 Discord Bot,不是把 Sentinel 官方 Bot 拉进你的服务器。
Step 1:创建 Discord Bot
- 打开 Discord Developer Portal
- 创建 Application
- 进入 Bot 页面
- 创建 Bot 并复制 Token
- 开启必要 intents
- 保存 Token,回到 Sentinel DC 面板导入
建议开启:
- Server Members Intent
- Message Content Intent
- Presence Intent 可按需开启
Step 2:导入 Bot Token
- 进入 Sentinel 控制台
- 打开 Discord 面板
- 进入 Bot 管理
- 粘贴 Bot Token
- 点击验证
- 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:配置服务器
进入目标服务器后,按这个顺序配置:
- 社区基础信息
- 欢迎 / 离开消息
- 验证与自动审核
- 工单系统
- AI 客服
- 增长系统
- 数据分析
不要一上来全开。先保证 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 对频繁变更有限制。