# 概述

本文介绍了什么是消息能力,如何接入消息能力,消息接口能力介绍等内容。

# 名词解释

消息

通过各种信息渠道传输信息或通知称为消息。

发送方式

各类消息推送渠道的统称,最终的消息下发通道与发送方式的配置有关。

消息类型

对消息场景的抽象,可以配置消息发送渠道、消息模板、发送策略等。

appid 应用身份唯一标识,在调用接口能力时使用。

# 什么是消息能力

平台提供了一套完整的消息发送能力,帮助客户统一管理不同系统向用户发送消息的业务,支持了短信、电子邮件、微信、钉钉、系统消息、APP消息推送等多种发送方式。

发送方式 描述 可接入的渠道
短信 通过短信服务商提供的短信通道进行推送。 阿里云短信、腾讯云短信等
电子邮件 通过电子邮箱提供的邮件投递服务进行推送。 网易云邮箱、阿里企业邮箱等
微信 通过微信开放的消息能力进行推送。 公众号模板消息、企业微信消息等
钉钉 通过钉钉开放的消息通知能力进行推送。 钉钉工作通知等
系统消息 通过平台内置的消息下发通道,在平台用户端接收。 平台站内信、其它应用的消息接收通道
APP消息推送 通过消息推送的服务商,向移动应用发送APP通知消息。
(移动应用需推送服务商对接)
个推等

# 如何接入消息能力

如果业务系统只需要实现消息的集中展示,或者基于对接难度的考虑,不使用平台开放的接口能力,可以考虑使用页面集成的方式。

接入方式 描述 接入教程
推模式(推荐) 中台提供接口,由业务方调用接口,将数据推送到中台,实现统一消息推送与管理。 从开放平台接入
从POA接入
拉模式(不推荐) 业务方适配中台数据结构,提供相应的接口,由中台调用接口,实现消息查阅等过程。 接入说明
页面集成 具备提醒意义的业务,且有完善的前端页面,提供页面地址、获取提醒信息的接口地址,可以将页面集成到平台。
注意:平台使用简约主题时,不支持页面集成方式
页面集成

# 消息接口能力介绍

API 描述 API使用规范
消息发送 发送渠道消息。 消息发送
发送方式查询(根据消息类型编码) 根据消息类型查询可用发送方式。 发送方式查询
安全手机号查询(手机号脱敏) 根据账号查询绑定的手机号。 安全手机号查询