C# Discord.Net机器人如何在按钮触发时创建Discord私有线程

前置要求 #

• 目标服务器需达到Nitro Boost 2级及以上，否则私有线程接口无权限调用
• 机器人需在触发按钮所在频道拥有创建私有线程、在线程内发送消息权限
• 已完成按钮交互事件的基础绑定，可正常捕获按钮点击回调参数

核心说明 #

你提到的RestThreadChannel、SocketThreadChannel是线程实体的两种返回类型（分别对应REST接口直返、Socket本地缓存实体），不需要手动实例化，调用频道提供的创建方法后会自动返回对应实例。 #

实现代码 #

在你已有的按钮点击回调逻辑中插入以下代码即可，回调参数默认是SocketMessageComponent类型：

// 第一步：先返回延迟响应，避免Discord3秒交互超时报错
await component.DeferAsync(ephemeral: true);

// 第二步：配置私有线程参数
var threadConfig = new ThreadCreationProperties
{
    Name = $"专属会话-{component.User.Username}", // 自定义线程名
    Type = ThreadType.PrivateThread, // 核心参数：指定为Nitro私有线程类型
    AutoArchiveDuration = AutoArchiveDuration.OneDay, // 自动归档时长，按需选1小时/1天/3天/1周
    IsInvitable = false // 私有线程专属：禁止普通成员邀请其他人加入
};

// 第三步：创建线程，二选一即可
// 方案1：关联当前点击的按钮所属消息创建线程（推荐，原消息下方会显示线程入口）
IThreadChannel createdThread = await component.Channel.CreateThreadAsync(component.Message.Id, threadConfig);

// 方案2：不关联消息，直接在当前频道创建独立私有线程
// IThreadChannel createdThread = await component.Channel.CreateThreadAsync(threadConfig);

// 第四步：将点击按钮的用户加入线程成员（私有线程默认仅创建者可见，必须手动加用户否则用户看不到）
await createdThread.AddUserAsync(component.User as IGuildUser);

// 第五步（可选）：在线程内发送初始提示消息
await createdThread.SendMessageAsync($"<@{component.User.Id}> 你的私有线程已创建，非线程成员无法查看内容。");

// 给点击用户返回私有提示
await component.FollowupAsync("私有线程创建成功，可在线程列表查看。", ephemeral: true);

常见问题排查 #

• 抛出权限缺失错误：检查频道权限覆写配置，确认机器人在当前频道的私有线程创建权限已开启，不要只给全局角色权限
• 抛出参数非法错误：先确认服务器Boost等级是否达标，2级以下服务器仅支持创建公开线程，无法创建私有线程
• 创建完成后用户看不到线程：确认是否执行了AddUserAsync方法将触发用户加入线程成员列表

内容的提问来源于stack exchange，提问作者Manuel