消息服务

1. 概况

消息途径分为邮件、短信、站内信3大类别。它包含了激发系统与用户交互的触发点类型，不同触发点在触发之后给用户反馈的消息模板，发送邮箱和短信的服务器配置信息。

消息服务用来选择某一个触发点对应选择的邮件模板、短信模板、站内信模板以及发送模式。用户可以根据需要，通过此功能，可以在忘记密码、添加/导入新用户、系统添加新功能、修改密码等过程中向不同成员发送邮件提醒。同时可以设置不同的邮件通知模式。

2. 消息服务列表

列表字段：

• 消息类型：由接收方的某些行为触发邮件发送的触发点类型。比如忘记密码、添加/导入新用户、项目停用、修改密码等。
• 说明：对触发类型的触发情景、适用场景的描述。
• 层级：发送设置生效的层级，包括平台层,组织层,项目层三个层级。
• 状态：消息类型的状态，分为启用,停用两种。启用状态下的消息类型会根据发送消息。
• 是否允许配置接收：设置是否允许用户自定义是否接收此类型的消息。

3. 设置邮件内容

• 进入平台管理，点击菜单“设置>通知>消息服务”，进入消息服务页面。
• 点击您要进行设置的消息类型所在列的按钮，选择设置邮件内容，进入该消息类型的设置邮件内容页。
• 在设置邮件内容页，您可以看到邮件的发送配置项和可使用邮件模板。

发送设置：

• 重发次数：自动重发的次数，默认重发次数为3次。
• 是否即时发送：选择触发该消息类型是否立刻发送。
• 是否允许手动重发：邮件发送失败后，是否允许用户在消息日志面点击重发。选择模板：
• 模板列表展示了当前消息类型下的全部模板。点击模板名称查看模板。您可以点击，选择设为默认模板，设置默认发送的邮件模板。
  • 点击操作栏的修改配置→按钮，打开修改设置页面：

可修改项：

• 重发次数：设置自动重发的次数，默认重发次数为3次。
• 是否即时发送：选择触发该消息类型是否立刻发送。
• 是否允许手动重发：设置邮件发送失败后，是否允许用户在消息日志面点击重发。
• 设置默认模板：选择触发该消息类型后使用的邮件模板。
  • 点击保存，保存您对该消息类型发送配置项的更改。

• 点击点击操作栏的创建模板→按钮，打开新建邮件模板页面。

必填字段：

• 模板名称：邮件模板的名称。
• 邮件主题：发送时邮件的主题。
• 邮件内容：邮件的内容。填写模板所需的文字和参数。模板中的参数变量通过${}进行替换，在发送时，将${}替换成对应的实际变量。例如：模板:${username}您好。发送参数：username=张三。发送信息：张三您好。更多的变量信息，请查看变量说明
  • 点击保存，完成新建模板。

3.1 修改模板

• 点击您要修改的邮件模板所在列的按钮，选择修改，进入修改模板页。
• 您可以在修改模板页，对邮件的主题、内容进行修改。
• (可选)你可以设置当前模板是否为默认使用模板。
• 点击保存，保存对模板的修改。

3.2 删除模板

点击您要删除的邮件模板所在列的按钮，选择删除，即可删除模板。

只能够删除自定义模板，不能删除预置模板。

4. 设置站内信内容

• 进入平台管理，点击菜单“设置>通知>消息服务”，进入消息服务页面。
• 点击您要进行设置的消息类型所在列的按钮，选择设置站内信内容，进入该消息类型的设置站内信内容页。
• 在设置站内信内容页，您可以看到站内信的发送配置项和可使用站内信模板。

发送设置：

• 站内信类型：分为消息和通知两种，如果是消息类型，则显示在消息通知的消息页。如果是通知类型，则显示在通知页。选择模板：
• 模板列表展示了当前消息类型下的全部模板。点击模板名称查看模板。您可以点击，选择设为默认模板，设置默认发送的站内信模板。
  • 点击操作栏的修改配置→按钮，打开修改设置页面：

可修改项：

• 站内信类型：可以选择消息和通知两种。
• 设置默认模板：选择触发该消息类型后使用的邮件模板。
  • 点击保存，保存您对该消息类型发送配置项的更改。

• 点击点击操作栏的创建模板→按钮，打开新建站内信模板页面。

必填字段：

• 模板名称：站内信模板的名称。
• 站内信主题：发送时站内信的标题。
• 站内信内容：站内信的内容。填写模板所需的文字和参数。模板中的参数变量通过${}进行替换，在发送时，将${}替换成对应的实际变量。

例如：
模板:`${username}`您好。
发送参数：`username=张三`。
发送信息：张三您好。  

• 更多的变量信息，请查看变量说明
  • 点击保存，完成新建模板。

4.1 修改模板

• 点击您要修改的站内信模板所在列的按钮，选择修改，进入修改模板页。
• 您可以在修改模板页，对站内信的主题、内容进行修改。
• (可选)你可以设置当前模板是否为默认使用模板。
• 点击保存，保存对模板的修改。

4.2 删除模板

点击您要删除的站内信模板所在列的按钮，选择删除，即可删除模板。

只能够删除自定义模板，不能删除预置模板。

5. 设置短信内容

• 进入平台管理，点击菜单“设置>通知>消息服务”，进入消息服务页面。
• 点击您要进行设置的消息类型所在列的按钮，选择设置短信内容，进入该消息类型的设置短信内容页。
• 在设置短信内容页，您可以看到可使用短信模板（短信没有发送设置）。

选择模板：

• 模板列表展示了当前消息类型下的全部模板。点击模板名称查看模板。您可以点击，选择设为默认模板，设置默认发送的短信模板。
  • 点击点击操作栏的创建模板→按钮，打开新建短信模板页面。

必填字段：

• 模板名称：短信模板的名称。
• 短信内容：短信的内容。
  • 点击保存，完成新建模板。

5.1 修改模板

• 点击您要修改的短信模板所在列的按钮，选择修改，进入修改模板页。
• 您可以在修改模板页，对短信的内容进行修改。
• (可选)你可以设置当前模板是否为默认使用模板。
• 点击保存，保存对模板的修改。

5.2 删除模板

点击您要删除的短信模板所在列的按钮，选择删除，即可删除模板。

只能够删除自定义模板，不能删除预置模板。

6. 变量声明

以下是邮件、短信、站内信模板中可以使用的变量参数。

模板中的参数变量通过${}进行替换，在发送时，将${}替换成对应的实际变量。

例如：

邮件标题：验证邮件
邮件内容：
${userName}，您好！您正在进行邮箱验证，您本次请求的验证码为：${verifyCode}。
此验证码用于重置密码，XXX内有效。

7. 更多操作

• 使用Choerodon进行通知配置
• 查看消息发送日志
• 如何发送系统公告