SendCloud邮件通知插件

1. 简介

1.1 功能简介

通过集成 SendCloud，向指定邮箱发送自定义内容的邮件。

1.2 应用场景

如：

合同管理场景中，合同变更后，可以通过邮件通知客户最新合作进展；
人事管理场景中，可以通过邮件给求职者发送 offer 通知；
海外业务对接时，可以通过邮件建立信息交流。

1.3 预期效果

2. SendCloud 注册

SendCloud 邮件通知插件需要配合 SendCloud 云平台使用，在使用之前，需要先注册 SendCloud 账号。

注册完成后，提交个人真实信息，否则会影响到您的信誉度而导致无法使用免费额度发送邮件。

3. 邮件发信设置

3.1 发信域名

3.1.1 基础概念

发信域名指的是一封邮件的出处，就好比邮件发送时候的“身份证”。如下图所示，jiandaoyun.com 就是这封邮件的发信域名

3.1.2 域名注册

SendCloud 的发信域名在初次注册时可以使用系统自带的发信域名，正式使用时，为了确保邮件成功送达率，建议自主注册域名并完成域名相关解析。

域名可以前往腾讯云、阿里云-万网、华为云以及其他你喜欢的云平台进行注册，相关费用在对应的平台进行支付。

注：如果已有域名，则忽略此步骤。

3.1.3 添加并验证

1）添加域名

注册域名后，在 SendCloud 域名设置处将注册的域名添加进来。如果有多个域名需要接入不同的邮件服务，可以一一添加进来。

2）域名配置

添加的域名需要验证后才能被邮件服务使用，验证就是前往购买域名的平台进行域名解析。

点击未验证域名右侧的设置按钮后可以看到需要配置的内容，即需要在注册域名的平台依次添加 4 条解析。

以阿里云为例，在域名解析处选择需要解析的域名，依次添加 4 条解析记录，配置内容如下：

记录类型	主机记录	解析线路	记录值	TTL
TXT	@	默认	从上图 ❶ 对应内容复制	10 分钟
TXT	mail._domainkey	默认	从上图 ❷ 对应内容复制	10 分钟
TXT	_dmarc	默认	从上图 ❸ 对应内容复制	10 分钟
MX	@	默认	从上图 ❹ 对应内容复制	10 分钟

10 分钟内域名解析生效，然后在 SendCloud 域名验证界面刷新页面，即可看到各项参数均已验证通过。

3.2 API_USER & API_KEY

1）平台赠送的 API_USER & API_KEY

在注册完账号后，会进入到邮件主页面，如果需要使用 SendCloud 平台的发信域名，可以点击「生成」 API_KEY，生成的 API_KEY 需要复制或者截图保存下来，否则后期将无法查看。

注：不复制也没关系，可以后续重新生成一个新的 API_KEY。

2）自己创建的 API_USER & API_KEY

在正式使用时，需要自己创建 API_USER & API_KEY。

API_USER：手动输入
类型：分为批量和触发

触发：在某种场景下, 由事件触发的邮件发送。比如: 注册激活, 密码找回, 站内通知, 信息确认, 账单寄送等；
批量：商家对会员发送的通知邮件. 比如: 新功能上线, 打折优惠等。

发信域名：步骤【3.1】验证通过的发信域名。

3.3 发信模板

为邮件设置发信模板，之后简道云中的邮件通知将按照此模板进行发送。

在 SendCloud 平台的邮件模板处进行设置，设置好以后点击确定。

模板名称：自定义命名，用于区分 SendCloud 中的邮件模板
调用名称：简道云需要根据此名称调用模板，不可重复命名
邮件主题：用户接收邮件时所看到的标题
邮件摘要：可不配置，简道云中暂不支持
邮件类型：跟需要使用的 API_USER 中的类型保持一致

4. 插件安装及配置

4.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：SendCloud 邮件通知插件安装。
安装成功后，可参考本文【4.2 配置插件】和【4.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。

2）插件市场处安装

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

4.2 配置插件

安装后需要配置插件方可使用。将步骤【3.2】中的 API_USER 和 API_KEY 依次下方对应位置位置中。

4.3 启用插件

配置完毕后将插件点击下图按钮启用插件。

5. 智能助手配置

5.1 添加智能助手

选择需要进行邮件发信的表单进行编辑，然后在「扩展功能」中添加智能助手。

5.2 设置触发动作

设置智能助手名称、触发表单、触发动作及触发条件。

由于是在表单处进行的智能助手，所以触发表单自动获取当前表单；
触发动作选择「修改数据」后触发；
触发条件选择表单中的 offer 发放确认字段，选择「是」的时候触发；
设置完成后点击「下一步」继续设置执行动作。

5.3 设置执行动作

执行动作中选择插件「SendCloud邮件通知」。注意，只有步骤【5.3】启用了，这里才会出现可供选择的插件。

执行动作中需要设置下列参数。

执行动作	具体设置	备注
收件人邮箱地址	选择表单中用来收集邮箱数据的字段	主表单中需要有一个填写邮箱的字段，之后的邮件将发送给表单中填写的邮箱
邮件类型	默认「使用模板」	也可以选择自定义内容，在设置智能助手的时候自主设置
模板调用名称	步骤【3.3】中模板的调用名称	选择需要使用的模板的调用名称
模板变量	设置模板时设置的变量	这里可将变量名一一赋值，赋值使用表单中的字段
邮件主题	可设置为自定义/字段值	邮件发送时显示的邮件主题，便于了解邮件的主题内容
邮件内容	可设置为组合值，自定义输入文字与表单内字段值组合，输入个性化邮件内容	也可以设置为自定义内容/字段值，可根据邮件需求自行设置
附件	发送邮件时可以发送附件	这里的附件选择表单中的附件字段
发件人邮箱地址	为了更高的送达率，建议发件人邮箱域名后缀与发信域名一致	也可以自主设置发件名称
发件人名称	发件人除了邮件名以外的别名	可以帮助接收人更好的识别邮件来源
回信接收地址	收件人收到邮件后，可能会“回复”邮件，需要一个邮箱接收地址	可以填写您能收到邮件的邮箱地址，支持个人邮箱。如果不填，将会回复到腾讯云

注：在收件人邮箱地址处，若需要设置多个邮箱地址，可使用逗号分隔后进行添加。

6. 效果演示

根据上述步骤完成设置后，即可在特定的条件下自动发送邮件，如下图所示：

7. 注意事项

1）同一发信域名，请勿在多个平台使用，否则域名验证（域名解析）时极可能会出现验证失败的情况。

2）插件执行过程中，可能会出现执行失败而导致邮件未发送成功，问题排查可参考文档：邮件插件执行失败问题汇总