• 服务台工单
  • 从 cc 头部添加外部参与者
• 作为外部参与者
  • 回复通知邮件
  • 取消订阅通知邮件
• 作为极狐GitLab用户
  • 查看所有外部参与者
  • 添加外部参与者
  • 移除外部参与者

外部参与者 **(FREE ALL)**

• 在极狐GitLab 17.0中引入。

外部参与者是没有极狐GitLab帐户的用户，他们只能通过电子邮件与议题或服务台工单进行互动。
他们会收到关于议题或工单的公共评论通知，通知通过服务台邮件发送。

每个议题或工单的外部参与者最多为10个。

服务台工单

极狐GitLab会将服务台工单的外部作者添加为外部参与者。
通常，外部作者是创建工单的初始电子邮件中的From头部的电子邮件地址。

从 cc 头部添加外部参与者

默认情况下，极狐GitLab只会将创建服务台工单的电子邮件的发件人添加为外部参与者。

您可以配置极狐GitLab以便也将所有来自cc头部的电子邮件地址添加到服务台工单中。
这适用于初始邮件以及所有对感谢 邮件的回复。

从cc头部添加的外部参与者会收到new_participant邮件，而不是thank_you邮件，以通知他们已被添加到工单中。

先决条件：

• 您必须拥有项目的至少 Maintainer（维护者） 角色。

要为项目启用此设置：

1. 在左侧边栏中，选择 搜索或转到 并查找您的项目。
2. 选择 设置 > 常规。
3. 展开 Service Desk。
4. 选择 从 cc 头部添加外部参与者。
5. 选择 保存更改。

作为外部参与者

外部参与者会收到每次在议题或工单上发布的公共评论的通知，
通知通过服务台邮件 发送。

回复通知邮件

外部参与者可以回复收到的通知邮件。
这会在议题或工单上创建一个新评论，并显示外部参与者的电子邮件地址，而不是极狐GitLab用户名。电子邮件地址后会加上(external participant)。

取消订阅通知邮件

外部参与者可以使用默认服务台邮件模板中的取消订阅链接，取消订阅该议题或工单的通知。

如果您自定义 thank_you、new_participant 和 new_note 邮件模板，可以使用%{UNSUBSCRIBE_URL}占位符将取消订阅链接添加到模板中。

为了确保外部参与者能够成功取消订阅，您的 极狐GitLab实例必须是可访问的（例如，来自公共互联网）。
如果无法访问，建议从您的模板中移除取消订阅链接。

极狐GitLab发送的电子邮件还包含特殊的邮件头，允许支持的电子邮件客户端和其他软件 自动取消外部参与者的订阅。

作为极狐GitLab用户

要查看外部参与者的电子邮件地址，您必须至少具有该项目的Reporter角色。

如果同时满足以下两个条件，外部参与者的电子邮件地址将被隐藏：

• 您不是该项目的成员，或者仅具有Guest角色。
• 该 issue 或工单是公开的（非保密）。

在以下情况下，外部参与者的电子邮件地址将被隐藏：

• 服务台工单的作者字段。
• 所有提到外部参与者的系统注释。
• REST 和GraphQL APIs。
• 评论编辑器下方的警告消息。

例如：

### 发送给外部参与者的通知

外部参与者会收到关于issue上所有公共评论的通知。
对于私人交流，请使用内部注释。

外部参与者不会收到任何其他议题或工单事件的通知。

查看所有外部参与者

查看所有收到服务台邮件的新评论的外部参与者。

先决条件：

• 您必须至少拥有该项目的Reporter角色。

查看所有外部参与者的步骤：

1. 转到议题或工单。
2. 向下滚动到评论编辑器。
3. 如果议题或工单有外部参与者，您将在评论编辑器下方看到一条警告，列出所有外部参与者。

添加外部参与者

• 在极狐GitLab 13.8中引入，并启用了名为issue_email_participants的标志，默认启用。

使用 /add_email快速操作 添加外部参与者，当您希望随时将其添加到对话时。

添加后，外部参与者将开始使用服务台邮件接收通知。

新添加的外部参与者会收到新参与者邮件，通知他们已被添加到工单中。极狐GitLab不会为手动添加的外部参与者发送感谢邮件。

您应该在专门的评论中添加外部参与者，因为他们不会收到包含 /add_email 快速操作的评论通知邮件。

先决条件：

• 您必须至少拥有该项目的 Reporter 角色。

将外部参与者添加到议题或工单的步骤：

1. 转到议题或工单。
2. 添加仅包含快速操作 /add_email user@example.com 的评论。
   您最多可以添加 6 个电子邮件地址。例如 /add_email user@example.com user2@example.com。

您应该会看到一个成功消息，并且会有一条包含电子邮件地址的新系统注释。

移除外部参与者

• 在极狐GitLab 13.8 中引入，并启用了名为issue_email_participants的标志，默认启用。

使用/remove_email快速操作从议题或服务台工单中移除外部参与者，当他们不再希望接收通知时。

将他们从议题或工单中移除后，他们不会再收到新通知。
但他们仍然可以回复他们之前收到的邮件，并在议题或工单中创建新评论。

先决条件：

• 您必须至少拥有该项目的 Reporter 角色。
• 该议题或工单必须至少有一个外部参与者。

从议题或工单中移除现有外部参与者的步骤：

1. 转到议题或工单。
2. 添加仅包含快速操作/remove_email user@example.com的评论。
   您最多可以移除6个电子邮件地址。例如/remove_email user@example.com user2@example.com。

您应该会看到一个成功消息，并且会有一条包含电子邮件地址的新系统注释。