本指南介绍如何在 Discourse 社区中邀请用户加入群组，涵盖管理员、群组所有者以及拥有特定权限的 moderators 的操作方法。
所需用户等级：管理员或群组所有者（Moderators 需要启用
moderators_manage_groups站点设置，才能邀请用户加入他们不拥有的群组）
管理员和群组所有者可以创建邀请，将新用户和现有用户添加到自定义群组中。Moderators 通常无法邀请用户加入群组，除非他们是该特定群组的所有者，或者站点管理员已启用 moderators_manage_groups 设置。
本指南将说明：
- 管理员和群组所有者如何向用户发送邀请。
- Moderators 如何邀请用户加入他们拥有的群组。
moderators_manage_groups站点设置如何更改权限。- 如何使用 Discourse API 进行用户邀请。
- 如何通过 CSV 上传批量发送邀请。
邀请用户加入群组
管理员可以将新用户和现有用户邀请到一个或多个自定义群组。操作步骤如下：
- 导航至您的个人资料页面。
- 点击 邀请。
- 选择 添加到群组 下拉菜单，以选择您希望邀请用户加入的群组。
- 点击 创建链接，即可将邀请保存为链接，直接与用户分享。
无法将用户邀请到预定义的群组，例如信任等级群组、管理员（admin）、版主（mod）或工作人员（staff）群组。作为替代方案，您可以在群组配置页面的 管理 > 成员资格 > 效果 部分配置自定义群组，以自动设置用户的信任等级。这样，您就可以将受邀用户的信任等级设置为不同于站点
default invitee trust level设置所规定的等级。
有关发送邀请的更多详细信息，请参阅 配置用户如何创建并发送邀请以加入您的社区。
Moderators 权限
默认情况下，Moderators 无法 邀请用户加入他们不拥有的群组。如果 Moderator 尝试在未拥有该群组的情况下将群组添加到邀请中，他们将收到“您无权查看请求的资源”错误。
有两种方法可以授予 Moderators 此权限：
- 将 Moderator 设为群组所有者：将 Moderator 指定为他们希望邀请用户加入的特定群组的所有者。
- 启用
moderators_manage_groups站点设置：这将允许所有 Moderators 在整个站点中创建和管理群组（包括发送邀请）。该设置位于 管理 → 设置 → 群组 下。
故障排除：如果您是 Moderator，在邀请表单中看到了“添加到群组”下拉菜单，但在提交时收到错误，请确保您是所选群组的所有者。如果不是，请管理员将您设为该群组的所有者，或启用
moderators_manage_groups站点设置。
作为群组所有者邀请用户
如果您是群组所有者，可以邀请新用户加入您拥有的群组。操作步骤如下：
- 进入群组页面。
- 点击 邀请 按钮。
添加现有用户
群组所有者还可以使用 添加用户 按钮邀请 现有用户（即已在该站点拥有账户的用户）加入群组。
使用 API
还可以使用 Discourse API 发送群组邀请，API 端点为 /invites.json。或者，您可以使用 The Discourse API gem 通过 Ruby 发送邀请。
以下是使用 Discourse API Gem 的 API 示例：
require 'discourse_api'
client = DiscourseApi::Client.new("https://discourse.example.com")
client.api_key = "your_key"
client.api_username = "an_admin"
# 通过电子邮件邀请用户加入特定群组
client.invite_user(
email: "bob@bob.com",
group_ids: "1,2,3"
)
批量邀请
批量邀请用户可以通过上传 CSV 文件完成。有关此过程的详细信息，请参阅详细指南：发送批量用户邀请。
最佳实践
- 创建自定义群组：根据角色或权限组织用户，而不是使用系统群组进行邀请。
- 在邀请信息中提供清晰的说明：避免用户对其被邀请的原因产生困惑。
- 定期审查并管理群组成员资格：以维持有序的社区并移除不活跃用户。
- 谨慎使用
moderators_manage_groups设置：启用此设置将赋予 Moderators 重大权限；在启用之前，请确保您的 Moderators 团队已接受过群组管理最佳实践的培训。
常见问题与解决方案
- 邀请无法使用：检查邀请的过期日期和兑换限制。
- 用户未收到邀请：验证 已发送邮件日志，并确保电子邮件地址有效。
- “您无权”错误：如果您是 Moderator，请确保您是您试图邀请加入的群组的所有者，或者已启用
moderators_manage_groups站点设置。 - 无法邀请加入系统群组：您无法将用户邀请到预定义群组（如
admins或trust_level_2）。请创建一个具有所需效果的自定义群组。
常见问题解答（FAQs）
Moderators 可以邀请用户加入任何群组吗？
不可以。默认情况下，Moderators 只能邀请用户加入他们个人拥有的群组。若要允许 Moderators 邀请用户加入任何群组，管理员必须启用 moderators_manage_groups 站点设置。
我可以邀请用户加入“工作人员”（Staff）群组吗？
不可以。您无法将用户邀请到预定义的系统群组。相反，请创建一个自定义群组，并配置它以授予所需的信任等级或权限。
我如何邀请已有账户的用户？
群组所有者可以使用群组页面上的 添加用户 按钮，或者管理员在创建邀请时使用 添加到群组 下拉菜单。