外部参与者

外部参与者是没有 GitLab 账户的用户，只能通过电子邮件与问题或服务台工单进行交互。 他们可以通过 服务台邮件 接收到问题或工单上公开评论的通知。

一个问题或工单上最多可以有 10 个外部参与者。

概览请参见 GitLab 服务台中的多个外部参与者。

服务台工单

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

从 Cc 头部添加外部参与者

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

您可以配置 GitLab，将 Cc 头部中的所有电子邮件地址也添加到服务台工单。 这适用于初始邮件和对 thank_you 邮件 的所有回复。

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

前提条件：

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

为项目启用设置：

1. 在左侧边栏，选择 Search or go to 并找到您的项目。
2. 选择 Settings > General。
3. 展开 Service Desk。
4. 选择 Add external participants from the Cc header。
5. 选择 Save changes。

作为外部参与者

外部参与者会收到每个公开评论的通知，使用 服务台邮件。

回复通知邮件

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

退订通知邮件

外部参与者可以使用默认服务台邮件模板中的退订链接来退订问题或工单的通知。

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

外部参与者要成功退订，您的 GitLab 实例必须可访问（例如，从公共互联网）。 如果不是这种情况，请考虑从模板中移除退订链接。

GitLab 的邮件还包含特殊的头部，允许支持的邮件客户端和其他软件 自动退订外部参与者。

作为 GitLab 用户

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

如果满足以下两个条件，外部参与者的电子邮件地址会被模糊处理：

• 您不是项目成员或只有 Guest（访客）角色。
• 问题或工单是公开的（非机密）。

外部参与者的电子邮件地址会在以下位置被模糊处理：

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

例如：

发送给外部参与者的通知

外部参与者会收到问题所有公开评论的通知。 对于私人沟通，请使用 内部备注。

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

查看所有外部参与者

概览所有接收新评论服务台邮件的外部参与者。

前提条件：

• 您必须拥有项目的至少 Reporter（报告者）角色。

要查看所有外部参与者的列表：

1. 转到问题或工单。
2. 向下滚动到评论编辑器。
3. 如果问题或工单有外部参与者，您可以在评论编辑器下方看到警告， 其中列出了所有外部参与者。

添加外部参与者

当您想在任何时候将他们包含在对话中时，使用 /add_email 快捷操作 添加外部参与者。

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

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

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

前提条件：

• 您必须拥有项目的至少 Reporter（报告者）角色。

将外部参与者添加到问题或工单：

1. 转到问题或工单。
2. 添加一个仅包含快捷操作 /add_email [email protected] 的评论。 您可以链接最多 6 个电子邮件地址。例如 /add_email [email protected] [email protected]

您应该看到成功消息和包含电子邮件地址的新系统备注。

移除外部参与者

当外部参与者应该停止接收通知时，使用 /remove_email 快捷操作 将他们从问题或服务台工单中移除。

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

前提条件：

• 您必须拥有项目的至少 Reporter（报告者）角色。
• 问题或工单上必须至少有一个外部参与者。

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

1. 转到问题或工单。
2. 添加一个仅包含快捷操作 /remove_email [email protected] 的评论。 您可以链接最多 6 个电子邮件地址。例如 /remove_email [email protected] [email protected]

您应该看到成功消息和包含电子邮件地址的新系统备注。