推送配置 - Meiqia/MeiqiaSDK-Android GitHub Wiki

消息推送配置

当前仅支持一种推送方案,即美洽服务端发送消息至开发者的服务端,开发者再推送消息到 App。

设置接收推送的服务器地址

推送消息将会发送至开发者的服务器。

设置服务器地址,请使用美洽管理员帐号登录 美洽,在「设置」 -> 「SDK」中设置。

设置推送地址

通知美洽服务端发送消息至开发者的服务端

目前,美洽的推送是通过推送消息给开发者提供的 URL 上来实现的。

在 App 进入后台时,应该通知美洽服务端,让其将以后的消息推送给开发者提供的服务器地址。

开发者需要在 App 后台的时候,调用关闭美洽服务接口,如下代码:

MQManager.getInstance(context).closeMeiqiaService();

关闭美洽推送

在 App 进入前台时,应该通知美洽服务端,让其将以后的消息发送给SDK,而不再推送给开发者提供的服务端,如下代码:

MQManager.getInstance(context).openMeiqiaService();

推送消息数据结构

当有消息需要推送时,美洽服务器会向开发者设置的服务器地址发送推送消息,方法类型为 POST,数据格式为 JSON

发送的请求格式介绍:

request.header.authorization 为数据签名。

request.body 为消息数据,数据结构为:

Key 说明
messageId 消息 id
content 消息内容
messageTime 发送时间
fromName 发送人姓名
deviceToken 发送对象设备的 deviceToken,格式为字符串
clientId 发送对象的顾客 id
customizedId 开发者传的自定义 id
contentType 消息内容类型 - text/photo/audio
deviceOS 设备系统
customizedData 开发者上传的自定义的属性
type 消息类型 - mesage 普通消息 / welcome 欢迎消息 / ending 结束消息 / remark 评价消息 / 留言消息

开发者可以根据请求中的签名,对推送消息进行数据验证,美洽提供了 Java、Python、Ruby、JavaScript、PHP 5种语言的计算签名的代码,具体请移步 美洽 SDK 3.0 推送的数据结构签名算法