# 通知管理

通知管理用于统一管理,维护各种消息通知配置以及模版. 可通过统一的接口发送短信,邮件等消息通知

# 通知配置和模板

配置用于管理各种通知的配置. 如邮件的地址,端口,用户名密码等信息. 模版用于管理各种通知的消息模版. 如邮件模版,短信模版等.

# 服务商

同一个消息类型,但是可能由不同的服务商提供服务. 如发送短信, 阿里云和腾讯云所需要的配置以及模版内容可能都不一样. 在配置和模版中,会根据不同的服务商,填写不同的配置以及模版内容.

TIP

发送消息时,需要指定相同服务商的配置以及模版.

# 邮件通知

进入系统: 通知管理-通知配置 点击左侧菜单中的邮件 添加一个邮件通知配置.

# 添加163邮箱配置信息

add notify config

属性说明:

属性 说明 是否必填
配置名称 通知配置的名称,例如:测试网易邮配置。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 邮件服务商,支持多服务商,不同服务商配置信息不同,服务商选择默认时,支持javax.mail发送邮件的服务商
服务器地址 邮件服务商提供的服务器地址,163邮箱服务器地址为:smtp.163.com
端口 邮件服务商提供的服务端口,163邮箱端口为:25
发件人 发送邮件后显示的发件人信息
用户名 发件人账户
密码 发件人密码
其他配置 163邮箱需配置其他配置
说明 输入文字,对该配置进行说明或备注。长度限制为100字

163邮箱需操作设置如下图所示:

add notify config

# 添加139邮箱配置信息

add notify config

属性说明:

属性 说明 是否必填
配置名称 通知配置的名称,例如:测试网易邮配置。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 邮件服务商,支持多服务商,不同服务商配置信息不同,服务商选择默认时,支持javax.mail发送邮件的服务商
服务器地址 邮件服务商提供的服务器地址,139邮箱服务器地址为:SMTP.139.com
端口 邮件服务商提供的服务端口,139邮箱端口为:25
发件人 发送邮件后显示的发件人信息
用户名 发件人账户
密码 发件人密码
其他配置 139邮箱需配置其他配置
说明 输入文字,对该配置进行说明或备注。长度限制为100字

139邮箱需操作设置如下图所示:

add notify config

# 添加腾讯企业邮配置信息

add notify config

属性说明:

属性 说明 是否必填
配置名称 通知配置的名称,例如:测试网易邮配置。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 邮件服务商,支持多服务商,不同服务商配置信息不同,服务商选择默认时,支持javax.mail发送邮件的服务商
服务器地址 邮件服务商提供的服务器地址,腾讯企业邮服务器地址为:smtp.exmail.qq.com
端口 邮件服务商提供的服务端口,腾讯企业邮邮箱端口为:465
发件人 发送邮件后显示的发件人信息
用户名 发件人账户
密码 发件人密码
其他配置 腾讯企业邮需配置其他配置,配置信息查看其他配置
说明 输入文字,对该配置进行说明或备注。长度限制为100字

其他配置信息如下:

配置名称 配置值 说明
mail.smtp.auth true
mail.smtp.ssl.enable true

腾讯企业邮需操作设置如下图所示:

add notify config

# 添加阿里云企业邮配置信息

add notify config

属性说明:

属性 说明 是否必填
配置名称 通知配置的名称,例如:测试网易邮配置。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 邮件服务商,支持多服务商,不同服务商配置信息不同,服务商选择默认时,支持javax.mail发送邮件的服务商
服务器地址 邮件服务商提供的服务器地址,腾讯企业邮服务器地址为:smtp.mxhichina.com
端口 邮件服务商提供的服务端口,腾讯企业邮邮箱端口为:25
发件人 发送邮件后显示的发件人信息
用户名 发件人账户
密码 发件人密码
其他配置 阿里云企业邮需配置其他配置
说明 输入文字,对该配置进行说明或备注。长度限制为100字

阿里云企业邮是默认开启个人邮箱pop3、smtp协议的,所以无需在阿里云邮箱里设置

# 配置邮件模板

进入系统: 通知管理-通知模板 点击左侧菜单中的邮件 添加一个邮件通知模板.

add notify template

属性说明:

属性 说明 是否必填
模板名称 通知模板的名称,例如:测试邮件-图片+附件。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 邮件服务商,支持多服务商,不同服务商配置信息不同,服务商选择默认时,支持javax.mail发送邮件的服务商
标题 邮件发送成功后,收件人显示标题或主题。支持表达式替换
注:不同服务商显示不同
正文 邮件内容
收件人 接收邮件的用户,可同时添加多个。支持表达式替换
附件列表 发送邮件时携带的文件,可同时添加多个文件。支持表达式替换

表达式说明:表达式通用格式为$符号开头,两个大括号中填写需要被替换的内容。例:${test}

# 测试发送通知

  1. 点击通知模板表格中的操作列-调试.
  2. 弹出会话框后选择通知配置.
  3. 填写变量信息,用变量信息将通知模板中的表达式替换为相应的内容(通知模板中不存在表达式时,使用默认值{}即可)

例:通知模板内存在表达式${test}。则可以用对应的json格式数据{"test":"测试"},将通知模板中${test}替换为测试

mail send test

发送成功后会提示发送成功,请注意查收,打开邮箱查看是否收到邮件通知,收到邮件通知即测试通过.

mail send test

# 微信企业消息

# 配置信息

进入系统: 通知管理-通知配置 点击左侧菜单中的微信 添加一个企业微信通知配置.

add notify config

属性说明:

属性 说明 是否必填
模板名称 通知配置的名称,例如:微信企业消息通知。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 支持企业微信号微信公众号,不同服务商配置信息不同,目前只支持企业微信号
corpId 每个企业都拥有唯一的corpId,获取此信息可在管理后台“我的企业”-“企业信息”下查看“企业ID”(需要有管理员权限)
登录https://work.weixin.qq.com/-我的企业,正下方可见企业ID
corpSecret corpSecret是企业应用里面用于保障数据安全的“钥匙”,每一个应用都有一个独立的访问密钥,为了保证数据的安全,secret务必不能泄漏
登录https://work.weixin.qq.com/-在管理后台->“应用与小程序”->“应用”->“自建”,点进某个应用,即可看到
说明 输入文字,对该配置进行说明或备注。长度限制为100字

参考文档:https://work.weixin.qq.com/api/doc/90000/90135/91039 (opens new window)

# 模板信息

进入系统: 通知管理-通知模板 点击左侧菜单中的微信 添加一个企业微信通知模板.

add notify template

属性说明:

属性 说明 是否必填
模板名称 通知模板的名称,例如:微信企业消息通知。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 支持企业微信号微信公众号,不同服务商配置信息不同,现目前只支持微信企业消息通知
应用ID 每个应用都有唯一的agentId
登录https://work.weixin.qq.com/-在管理后台->“应用与小程序”->“应用”,点进某个应用,即可看到agentId
收信人ID 每个成员都有唯一的userId,即所谓“帐号”
登录https://work.weixin.qq.com/-在管理后台->“通讯录”->点进某个成员的详情页,可以看到
收信部门ID 每个部门都有唯一的id
登录https://work.weixin.qq.com/-在管理后台->“通讯录”->“组织架构”->点击某个部门右边的小圆点可以看到
按标签推送 本企业的标签ID列表,最多支持100个
内容 播放模板内容次数。支持表达式替换

参考文档:https://work.weixin.qq.com/api/doc/90000/90135/90250#文本消息 (opens new window)

表达式说明:表达式通用格式为$符号开头,两个大括号中填写需要被替换的内容。例:${test}

# 测试发送通知

  1. 点击通知模板表格中的操作列-调试.
  2. 弹出会话框后选择通知配置.
  3. 填写变量信息,用变量信息将通知模板中的表达式替换为相应的内容(通知模板中不存在表达式时,使用默认值{}即可)

例:通知模板内存在表达式${test}。则可以用对应的json格式数据{"test":"测试"},将通知模板中${test}替换为测试

corpWeChat send test

发送成功后会提示发送成功,请注意查收,打开企业微信客户端,查看是否收到消息,收到消息即通过测试.

# 钉钉通知

# 配置信息

进入系统: 通知管理-通知配置 点击左侧菜单中的钉钉 添加一个钉钉通知配置.

add notify config

属性说明:

属性 说明 是否必填
模板名称 通知配置的名称,例如:钉钉测试。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 钉钉
appKey 应用的唯一标识key
appSecret 应用的密钥
说明 输入文字,对该配置进行说明或备注。长度限制为100字

参考文档:https://developers.dingtalk.com/document/app/basic-concepts/title-kux-it4-9c7 (opens new window)

# 模板信息

进入系统: 通知管理-通知模板 点击左侧菜单中的钉钉 添加一个钉钉通知模板.

add notify template

属性说明:

属性 说明 是否必填
模板名称 通知模板的名称,例如:钉钉消息通知。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 钉钉
应用ID 每个应用都有唯一的agentId。
登录https://open-dev.dingtalk.com/fe/app-在管理后台->钉钉应用,点进某个应用,即可看到agentId
收信人ID 接收者的用户userid列表,最大列表长度:100。在https://oa.dingtalk.com/contacts.htm中点击查看的员工UserID 可选(收信人ID,部门ID, 全部用户,必须有一个不能为空)
收信部门ID 接收者的部门id列表,最大列表长度:20, 接收者是部门id下(包括子部门下)的所有用户,示例:123,456 可选(可不传,若传不能为空)
全部用户 是否发送给企业全部用户 可选
内容 消息内容,消息类型和样例参考“消息类型与数据格式”。支持表达式替换。最长不超过2048个字节

参考文档:https://developers.dingtalk.com/document/app/app-faq (opens new window) 注:钉钉推送消息需要到钉钉开发平台应用中心内添加IP白名单

表达式说明:表达式通用格式为$符号开头,两个大括号中填写需要被替换的内容。例:${test}

# 测试发送通知

  1. 点击通知模板表格中的操作列-调试.
  2. 弹出会话框后选择通知配置.
  3. 填写变量信息,用变量信息将通知模板中的表达式替换为相应的内容(通知模板中不存在表达式时,使用默认值{}即可)

例:通知模板内存在表达式${test}。则可以用对应的json格式数据{"test":"测试"},将通知模板中${test}替换为测试

dingding send test

发送成功后会提示发送成功,请注意查收,打开钉钉客户端,查看是否收到消息,收到消息即通过测试.

# 语音通知

# 配置信息

进入系统: 通知管理-通知配置 点击左侧菜单中的语音 添加一个语音通知配置.

add notify config

属性说明:

属性 说明 是否必填
模板名称 通知配置的名称,例如:测试邮件-图片+附件。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 语音服务商,支持多服务商,不同服务商配置信息不同,现目前只支持阿里云
regionId 电信区域代码
accessKeyId 访问密钥id
secret 密钥对
说明 输入文字,对该配置进行说明或备注。长度限制为100字

# 模板信息

进入系统: 通知管理-通知模板 点击左侧菜单中的语音 添加一个语音通知模板.

add notify template

属性说明:

属性 说明 是否必填
模板名称 通知模板的名称,例如:测试邮件-图片+附件。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
服务商 语音服务商,支持多服务商,不同服务商配置信息不同,现目前只支持阿里云
模版ID 阿里云内配置模板的ID。注:不同服务商显示不同
被叫显号 被叫显号,必须是已购买的号码。您可以在阿里云语音服务控制台上查看已购买的号码
被叫号码 被叫号码。仅支持中国大陆号码
播放次数 语音文件的播放次数,取值范围为1~3

参考文档:https://help.aliyun.com/document_detail/114036.html?spm=a2c4g.11186623.6.559.3ba33c2dejPA2P (opens new window)

# 测试发送通知

  1. 点击通知模板表格中的操作列-调试.
  2. 弹出会话框后选择通知配置.
  3. 填写变量信息,运营商模板内容里配置有变量时需填写相关变量信息,JSON格式.

voice send test

发送成功后会提示发送成功,请注意查收,收到电话语言通知即测试通过.