邮件插件执行失败问题汇总

1. 简介

在使用插件时，部分情况下，插件会执行失败，在执行日志中也会看到插件执行失败的报错。

为了帮助大家更好的排查问题，现将邮件插件执行失败的场景进行汇总：

2. 腾讯云问题汇总

2.1 发信地址问题

1）问题描述

智能助手中填写的发件人邮箱地址不在腾讯云发信地址中。

2）解决方案

在腾讯云发信地址处新建一个地址用于发信。

2.2 模板ID

1）问题描述

使用模板时，模板 ID 填写错误。

2）解决方案

查看智能助手填写的模板 ID 是否与腾讯云邮件模板中的模板 ID 一致。

2.3 收件人邮件地址错误

1）问题描述

提交数据时，表单中的邮箱字段未填写或者邮箱填写错误。

2）解决方案

需要重新提交带有正确的邮箱数据方可触发插件。

2.4 邮件附件超限

1）问题描述

单条邮件附件总大小超过 10MB/单个附件大小超过 5MB。

2）解决方案

提交数据时，用于邮件发送的字段里的附件，需要确保单个附件不超过 5MB/附件总大小不超过 10MB。可以在该表单字段处进行备注，让成员提交数据时注意文件大小。

2.5 插件配置错误

1）问题描述

腾讯云邮件通知插件配置时，参数填写错误。

2）解决方案

校验参数 SECRET_ID 和 SECRET_KEY 是否和腾讯云 API密钥管理处的参数一致。

2.6 邮件模板未审核通过

1）问题描述

插件中配置的腾讯云邮件模板若未审核通过，则不能被插件所调用。

2）解决方案

前往腾讯云邮件模板设置处，查看配置的模板是否还在审核中，如果还在审核，需要等审核通过后方可正常发送邮件；如果是审核了但未通过，则需要重新创建模板，等待通过后再配置。

2.7 含特殊字符

1）问题描述

当邮件附件名称及变量的值含特殊符号时，邮件插件将执行失败。

2）解决方案

检查一下录入的数据，填入变量的值是否含有特殊字符；检查附件名是否包含特殊字符。特殊字符包括：

？\*"<>:/空格

3. SendCloud 问题汇总

3.1 邮件类型不一致

1）问题描述

配置的 API_USER 的类型和使用的邮件模板的类型不一致。

2）解决方案

检查选用的邮件模板和选用的 API_USER，他们的类型是否一致。是否都是「批量」或者是否都是「触发」类型

3.2 模板调用名称错误

1）问题描述

使用模板时，模板调用名称填写错误。

2）解决方案

检查模板调用名称是否和邮件模板中的一致，错误则修改成正确的模板。

3.3 收件人邮箱地址错误

1）问题描述

提交数据时，表单中的邮箱字段未填写或者邮箱填写错误。

2）解决方案

需要重新提交带有正确的邮箱数据方可触发插件。

3.4 邮件附件超限

1）问题描述

单条邮件附件总大小超过 10MB/单个附件大小超过 5MB。

2）解决方案

3.5 插件配置错误

1）问题描述

SendCloud 邮件通知插件配置时，参数填写错误。

2）解决方案

校验参数 API_USER 和 API_KEY 是否和 SendCloud 中的 API_USER 和 API_KEY 一致。