自定义邮件通知插件

1. 简介

1.1 插件简介

该插件可以实现，当表单内新增或修改数据时，将业务相关信息通过自定义内容邮件的形式，发送给指定邮箱。

与其他邮件通知不同的是，该插件无需配合其他应用使用，只需配置收发邮箱的相关信息即可完成邮件发送。

1.2 应用场景

1.3 预期效果

在员工申领公司吉祥物的场景中，当员工提交申领表单后，自动向员工发送申领结果通知，如下所示：

2. 邮箱配置

使用邮件通知插件时，需要对发件人的邮箱进行配置。

该插件支持拥有 SMTP 协议的邮箱，支持的邮箱类型如下所示：

本节以 QQ 邮箱为例，说明邮箱配置的相关内容。

2.1 开启服务并获取授权码

发件人登录 QQ邮箱，在「邮箱首页 >> 设置 >> 账户」中，开启如下所示的任一 SMTP 服务，并获取授权码：

以开启 POP3/SMTP 服务，并获取授权码为例，如下所示：

开启 SMTP 服务并获取授权码后，复制并保存授权码，在配置智能助手时使用。

2.2 开启服务后获取授权码

开启SMTP服务后，若在配置插件的过程当中出现失败的情况，从而需要重新获取授权码进行调试时，可点击「生成授权码」进行获取。

2.3 获取服务器地址和端口

进入 QQ邮箱帮助中心，搜索 SMTP 服务器，即可查看对应的服务器地址及端口。

获取 SMTP 服务器地址及端口后，复制并保存，在配置智能助手时使用。

3. 插件安装及启用

3.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「自定义邮件通知」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 启用插件

在插件管理中，打开「邮件通知」插件右侧开关，启用插件。

4. 智能助手配置

4.1 创建表单

新建「帆软吉祥物申领」表单，用于员工填写吉祥物申请信息，字段设置如下所示：

4.2 添加智能助手

设计完表单后，在「扩展功能」处添加「智能助手」，并修改智能助手名称为「邮件通知」。

4.3 设置触发动作

由于当员工提交申领信息时，触发智能助手，故「触发动作」选择「新增数据」，「触发表单」选择「帆软吉祥物申领」，设置完成后点击「完成」。

4.4 设置执行动作

4.4.1 选择插件

由于申领信息提交后，触发「邮件通知」插件，故执行动作在「插件」中选择「邮件通知」。

4.4.2 设置邮件模板

设置收件人信息、邮件主题及内容等执行动作，可通过插入数据/表单直接插入申领者相关信息。

4.4.3 配置发件人邮箱

配置发件人邮箱相关信息如下：

4.4.4 服务器地址及端口

配置服务器地址及端口时，配置如下所示的任一端口即可：

1）系统默认端口

系统默认提供 465 和 587 两个端口。

不同邮箱类型的 SMTP 服务器地址，及支持的端口如下所示：

2）自定义服务器端口

若使用的邮箱不属于系统默认端口支持的邮箱类型，则需要前往对应邮箱的后台设置处，查询邮箱对应的服务器地址及端口号。

详细查找方法可参见本文【2.3 获取服务器地址和端口】。

4.4.5 自定义 SMTP 协议发送方式

1）发送方式设置

设置自定义 SMTP 协议发送方式为「自动选择」。

全部配置完成后，点击「完成」，并点击右上角「保存」。

2）发送方式说明

由于发送加密方式，是邮箱服务商提供的，故应当匹配邮件服务商支持的加密方式，如下所示：

4.5 效果演示

效果参见本文【1.3 预期效果】。

5. IP地址白名单

如果您的数据库允许外放访问但需要IP 地址加白名单，请设置白名单IP为：47.97.99.12.