Skip to main content

自定义通知配置

爱星物联开放平台推出自定义通知配置功能,支持配置App所有与短信、邮件相关平台配置和模板配置;开发者可以根据自己的需求在原有模板类型的基础上,自定义通知功能;

启用自定义通知配置

开发者进入到“App开发>通知配置”;

image-20250102102707560

默认情况下通知的配置方式为"直接使用平台短信邮件服务",开发者使用自己的配置需要切换到“配置自己公司的短信邮件服务”;

image-20250103083412019

提供了配置短信平台和配置邮件平台;

配置短信

为了应对各短信平台的配置需求,这里将配置定义为JSON格式,方便后期接入其它短信平台;下面已目前已完成接入的阿里云短信为例;

image-20250103145653519

配置JSON说明

{
//短信平台,目前仅支持Aliyuyn
"provider": "Aliyun",
//阿里云平台的accessId
"accessId": "xxxxxxxxxxxxxxxxxxx",
//阿里云平台的accessKey
"accessKey": "xxxxxxxxxxxxxxxxxxxxxxx",
//签名(中英文签名)
"sign": {
"zh": "签名中文",
"en": "签名英文"
},
//10DLC前往阿里云工单申请,用户国际短信推送,重要事情说三遍,提工单!提工单!提工单!
"other": [
"10DLC"
]
}

邮箱配置

邮箱的配置还是比较标准,目前这些配置正常应该能适应大部分的邮箱,

邮箱平台归总如下

国内邮箱:

腾讯邮箱(QQ邮箱和腾讯企业邮箱),网易邮箱(163邮箱和126邮箱)、搜狐邮箱、新浪邮箱、139邮箱、189邮箱

国外邮箱:

Outlook、Gmail,Zoho Mail;

image-20250103150031967

邮件服务名称:仅作为标识,方便开发者对配置进行标记;

账号:发送邮箱的的账号

密码:发送邮箱的密码或者客户端密码,这里建议专门配置一个客户端发送密码;

SMTP服务器地址:邮箱服务的地址,开发根据根据邮箱平台进行配置,下面会有常见的配置示例;

SMTP服务器端口:邮箱服务的端口

签名:邮箱标题的前缀,例如: 【爱星物联】xxxxxxxx

启用exchange服务器:如果你的邮箱启动exchange,则勾选;

认证类型:根据邮箱的认证方式进行选择

加密类型:根据邮箱的加密方式进行选择

各平台邮箱配置的示例

国内邮箱平台

邮箱平台smtp地址端口认证类型加密方式
QQ邮箱smtp.qq.com465或587用户名和密码认证SSLTLS
腾讯企业邮箱smtp.exmail.qq.com465用户名和密码认证SSLTLS
163邮箱smtp.163.com465或994用户名和密码认证SSLTLS
126邮箱smtp.126.com465或994用户名和密码认证SSLTLS
搜狐邮箱smtp.sohu.com465用户名和密码认证SSLTLS
新浪邮箱smtp.sina.com465用户名和密码认证SSLTLS
139邮箱smtp.139.com465或587用户名和密码认证SSLTLS
189邮箱smtp.189.cn465用户名和密码认证SSLTLS

国外邮箱平台

邮箱平台smtp地址端口认证类型加密方式
Outlook邮箱smtp.office365.com587用户名和密码认证STARTTLS
Gmail邮箱smtp.gmail.com587用户名和密码认证STARTTLS
Zoho Mail邮箱smtp.zoho.com587用户名和密码认证STARTTLS

通知模板配置

短信平台配置,每一个短信平台将对应一套短信模板; 邮件平台配置,所有邮件平台对应同一套通知模板;

短信通知模板

image-20250103155223375

进入到模板列表页面,点击新增添加模板,注意这里第三方模板编码必须是在阿里云平台申请的,通过内容只是作为预览,不与阿里云平台进行同步;这里需要注意的是一个短信平台的模板,通过模板类型+通知方式+模板语种唯一;

image-20250103162745497

邮件通知模板

image-20250103155417773

进入到模板列表页面,点击新增添加模板,邮件模板通过模板类型+通知方式+模板语种唯一,发送内容为通知内容;

image-20250103163026918