推送配置 - 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 推送的数据结构签名算法。