ToShop文档Discord
把 Discord Bot 接到 Agent —— 按服务器 / 按频道授权、多服务器路由。
Discord 是 ToShop 另一个头等渠道。配一个 Bot，限定到特定服务器和频道，Agent 就出现在你团队已经在聊的地方。
配置
创建 Discord App
在 discord.com/developers → New Application → Bot → 复制 Bot Token。
开启 Message Content Intent
必开 —— 不然 Bot 看不到消息正文
同一页面：Bot → Privileged Gateway Intents → Message Content Intent。打开。
邀请 Bot
邀请进服务器，作用域：bot、applications.commands。权限整数 380104896（读 + 发 + 读历史）是合理最小集。
在 ToShop 添加渠道
设置 → Channels → Add Discord，粘贴 Token + guildId。
凭证与策略
botToken—— Discord 开发者门户的 Token。存系统钥匙串。guildId—— 这个 Bot 服务的 Discord 服务器 ID。channelId—— 可选 —— 限定到该服务器的某一个频道。allowedChannels—— 多个频道 ID 列表（代替单一 channelId）。groupPolicy—— allowlist（默认 —— 仅列表内频道）或 open（服务器内 Bot 可见的任意频道）。
在 Discord 里找 ID
消息路由
私信 Bot
与绑定 Agent 的 1:1 会话。
频道里 @ 它
Agent 回应 @-mention，同一线程内的后续回复保留上下文。
斜杠命令
按 Agent 配过的话，用户能用结构化命令快速触发。
一个 Agent 多个 Discord 服务器
一个 Agent 可绑定多个 Discord 服务器（例如团队主服务器 + 客户支持服务器）。各服务器自有频道上下文，但同一个 Agent 处理全部。
传输模式
Discord 常态走 socket（WebSocket 网关）。Webhook 用于斜杠命令交互。
服务器侧的坑
状态指示
和 Telegram 同套：ok、standby、degraded、fatal —— 在 设置 → Channels 的每张渠道卡上。
网络安全
Discord 触发的任务在网络白名单约束下运行 —— 私网 IP 默认拦截，除非显式放行。
常见模式
团队问答 Bot
在 #help 频道里回答 runbook、代码库、Shopify 商品的问题。
运维 Dashboard 频道
Autopilot 任务把每日摘要发到 #ops。
审批闸频道
长任务需要人工放行时往 #approvals 弹。
按频道分技能
#shop-ops 路由到店铺 Agent（仅 Shopify）；#dev-ops 路由到 Dev Agent（GitHub + 终端）。