# 应用注册

第三方应用如果要接入消息发送能力,第1步是接入应用,接入应用后获得一个appid,appid用于接口对接。

接入流程如下:

  • 打开云平台,进入消息服务-应用管理;

    图片

  • 点击【接入应用】,创建1个新应用;

    图片

  • 跳转方式选择“第三方页面”时,需要配置提醒接口,添加一个接口,然后将接口提供的参数与提供的功能进行绑定,包括提醒数、最新消息、最新时间、跳转链接等,绑定的功能从接口中获取数据,然后在消息应用列表中进行展示,实现消息提醒的目的。同时应用下的消息类型,选择发送方式时,无法选择系统消息,避免跳转方式冲突

    图片

  • 编辑应用信息,点击【确定】后,会得到一个appid,保存appid,在后面对接接口时需要提供

# 消息类型

接入应用后,需要添加消息类型,消息类型是消息发送场景的概括,接口对接需要用到消息类型编号。

添加流程如下:

  • 通过应用管理-消息类型管理,进入【消息类型管理】功能;

    图片

  • 点击【添加消息类型】,创建1个消息类型;

    图片

  • 消息类型编号,用于区分不同的消息类型,对接消息接口时使用;

    图片

  • 消息类别,选择一个消息类别,简单理解为给消息类型分类即可,在消息类别管理中可以添加新的消息类别;

    图片

  • 发送方式,如果1个消息类型,需要同时通过多个渠道给接收者发送消息,可以选择多个发送方式;

  • 勾选发送方式后,需要选择当前发送方式发消息的网关,默认选中1个,就是我们在消息网关管理中设置的默认网关;

    图片

  • 模板类型:添加消息类型后,需要编辑消息模板,消息模板的编辑方式分2种,叫做模板类型。一种是单类型,只要编辑1套模板,多个发送方式都使用这1套模板;另一种是多模板,每一个发送方式都分别定义一套模板;

    图片

# 消息模板

添加了消息类型后,需要编辑消息模板,发送消息时,从消息模板中获取内容作为消息正文发送。

模板配置流程如下:

  • 在应用管理-消息类型管理中,点击【模板管理】,可以进入模板管理功能;

    图片

  • 消息模板类型:

    • 消息模板类型包括:单模板和多模板;

    • 单模板:编辑1套模板,多个发送方式共用;

    • 多模板:每个发送方式分别定义1套模板;

      图片

      图片

  • 模板消息支持插入变量:

    • 变量类型包括内置变量和自定义变量;

    • 美元符号+双中括号的是内置变量,双花括号的是自定义变量;

    • 内置变量由消息服务系统提供,自定义变量由开发者自行传值;

    • 添加自定义变量需要按照格式添加,不然系统无法识别;

    • 自定义变量添加后,鼠标光标移出编辑框后,自动识别自定义变量,并在下方出现变量设置,需要选择变量类型、填写变量标题;

      图片

  • 短信模板,短信发送方式有2种,一种是选择模板,一种是自定义:

    • 在设置-短信编辑方式中可以切换;

    • 具体选择哪种发送方式,需要根据短信网关运营商的政策定,如阿里云短信要求必须要提前申请短信模板,通过短信模板发送短信,飞鸽传书短信支持自定义短信;

    • 选择短信模板发送的短信编辑方式,消息类型中,短信发送方式的消息模板,必须从网关支持的短信模板中选择,带入到消息模板中,不可以自定义编辑;

      图片

      图片

      图片

  • 示例:

    • 如果希望消息内容保持一致,可以选择单模板类型;

    • 如果希望每个发送方式各自定义1套模板,可以选择多模板类型;

    • 如果希望消息内容自定义,可以选择单模板类型,在模板中插入自定义变量,即可实现消息内容自定义;

      图片

如果消息类型设置单模板,发送方式中存在短信发送方式(短信有严格模板设置),则需要沿用短信模板