# 应用注册
第三方应用如果要接入消息发送能力,第1步是接入应用,接入应用后获得一个appid,appid用于接口对接。
接入流程如下:
打开云平台,进入消息服务-应用管理;
点击【接入应用】,创建1个新应用;
跳转方式选择“第三方页面”时,需要配置提醒接口,添加一个接口,然后将接口提供的参数与提供的功能进行绑定,包括提醒数、最新消息、最新时间、跳转链接等,绑定的功能从接口中获取数据,然后在消息应用列表中进行展示,实现消息提醒的目的。同时应用下的消息类型,选择发送方式时,无法选择系统消息,避免跳转方式冲突
编辑应用信息,点击【确定】后,会得到一个appid,保存appid,在后面对接接口时需要提供
# 消息类型
接入应用后,需要添加消息类型,消息类型是消息发送场景的概括,接口对接需要用到消息类型编号。
添加流程如下:
通过应用管理-消息类型管理,进入【消息类型管理】功能;
点击【添加消息类型】,创建1个消息类型;
消息类型编号,用于区分不同的消息类型,对接消息接口时使用;
消息类别,选择一个消息类别,简单理解为给消息类型分类即可,在消息类别管理中可以添加新的消息类别;
发送方式,如果1个消息类型,需要同时通过多个渠道给接收者发送消息,可以选择多个发送方式;
勾选发送方式后,需要选择当前发送方式发消息的网关,默认选中1个,就是我们在消息网关管理中设置的默认网关;
模板类型:添加消息类型后,需要编辑消息模板,消息模板的编辑方式分2种,叫做模板类型。一种是单类型,只要编辑1套模板,多个发送方式都使用这1套模板;另一种是多模板,每一个发送方式都分别定义一套模板;
# 消息模板
添加了消息类型后,需要编辑消息模板,发送消息时,从消息模板中获取内容作为消息正文发送。
模板配置流程如下:
在应用管理-消息类型管理中,点击【模板管理】,可以进入模板管理功能;
消息模板类型:
消息模板类型包括:单模板和多模板;
单模板:编辑1套模板,多个发送方式共用;
多模板:每个发送方式分别定义1套模板;
模板消息支持插入变量:
变量类型包括内置变量和自定义变量;
美元符号+双中括号的是内置变量,双花括号的是自定义变量;
内置变量由消息服务系统提供,自定义变量由开发者自行传值;
添加自定义变量需要按照格式添加,不然系统无法识别;
自定义变量添加后,鼠标光标移出编辑框后,自动识别自定义变量,并在下方出现变量设置,需要选择变量类型、填写变量标题;
短信模板,短信发送方式有2种,一种是选择模板,一种是自定义:
在设置-短信编辑方式中可以切换;
具体选择哪种发送方式,需要根据短信网关运营商的政策定,如阿里云短信要求必须要提前申请短信模板,通过短信模板发送短信,飞鸽传书短信支持自定义短信;
选择短信模板发送的短信编辑方式,消息类型中,短信发送方式的消息模板,必须从网关支持的短信模板中选择,带入到消息模板中,不可以自定义编辑;
示例:
如果希望消息内容保持一致,可以选择单模板类型;
如果希望每个发送方式各自定义1套模板,可以选择多模板类型;
如果希望消息内容自定义,可以选择单模板类型,在模板中插入自定义变量,即可实现消息内容自定义;
如果消息类型设置单模板,发送方式中存在短信发送方式(短信有严格模板设置),则需要沿用短信模板