跳转至

触发类消息

什么是触发类消息

根据预先设置的业务触发事件由系统自动发送的消息。

实现流程

本文档以通知升级消息为例,描述触发类消息的实现流程。

场景描述:

当用户 A 满足“连续 7 天登录“条件后,系统将用户 A 的等级信息从“初级”改为“高级”,并自动向此用户发送一条“通知升级消息”。

通知升级消息相关参数:

RC:ML:Official:Upgrade
{
    "imageUrl": "https://rongcloud-res.cn.ronghub.com/fc269b9ba6dfc08b2853966c14227fa6",
    "content": "恭喜你成功完成(新手登录任务)获得奖励,快去领取吧!",
    "contentUrl": "http://www.rongcloud.cn",
    "buttonTitle": "",
    "extra": ""
}

pushContent: 恭喜你成功完成(新手登录任务)获得奖励,快去领取吧!

消息在客户端的展示效果如下:

image

前期准备

服务端:

需要提供一个升级接口,使得客户端登录的用户在满足升级条件后,可以调用这个接口向服务端发出请求,修改客户等级。

  • 接口配置:

HTTP方法: POST

HTTP URL: /user/upgrade

Query参数: 无

Header参数: 登录成功时返回的cookie

HTTP响应: 正常响应,返回 "code": 1000

客户端:

需要将消息中心库导入工程,注册消息:

#import "RCMLOfficialUpgrade.h"

[[RCIM sharedRCIM] registerMessageType:[RCMLOfficialUpgrade class]];
客户端实现流程

触发条件: 当用户 A 连续 7 天登录。

调用接口: 当用户 A 连续 7 天登录,客户端通过 HTTP 请求的方式,调用升级接口(/user/upgrade),如果返回 1000,表示请求成功。如果返回非 1000,可以使用 HTTP 抓包工具进行调试。

服务端实现流程

接口响应: 当客户端调用升级接口(/user/upgrade)时,服务端修改数据库中用户 A 的等级信息,即:从“初级”改为“高级”。 成功后,HTTP 响应客户端的请求,返回 1000,并构造“通知升级消息(RC:ML:Official:Upgrade)”,发送给用户 A。

支持的触发类消息

提示

发送渠道:由业务逻辑触发的客户端发起的 HTTP 请求,App Server 接收到请求后发送的消息。客户端只接收消息,不可发送。

交易信息:

名称 标识 描述 样式
OrderProcessing RC:ML:Trading:OrderProcessing 预定处理中通知 纯文本
OrderFailed RC:ML:Trading:OrderFailed 预定失败通知 纯文本
OrderSuccess RC:ML:Trading: OrderSuccess 预定成功通知 纯文本
NotPaid RC:ML:Trading:NotPaid 预定未付款通知 纯文本
Paid RC:ML:Trading:Paid 预定已付款通知 纯文本
OrderDistribution RC:ML:Trading:OrderDistribution 订单开始配送通知 纯文本
OrderComment RC:ML:Trading:Comment 订单完成待评论通知 纯文本

系统通知:

名称 标识 描述 样式
Upgrade RC:ML:Official:Upgrade 通知升级 纯文本
DiscountsExpire RC:ML:Official:DiscountsExpire 优惠到期提醒 纯文本
WelcomeTxt RC:ML:Official:Welcome:Txt 欢迎消息 纯文本
WelcomeImgTxt RC:ML:Official:Welcome:ImgTxt 欢迎消息 图文

互动消息:

名称 标识 描述 样式
Comment RC:ML:Interaction:Comment 评论消息 方形图标卡片
Liked RC:ML:Interaction: Liked 点赞消息 方形图标卡片
Followed RC:ML:Interaction:Followed 关注消息 方形图标卡片
Awaken RC:ML:Interaction:Awaken 唤醒消息 方形图标卡片

社区消息:

名称 标识 描述 样式
HelpInfo RC:ML:Community:HelpInfo 求助信息通知 方形图标卡片

OrderProcessing

买家提交订单完成后,卖家确认订单时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Trading:OrderProcessing  

content:{  
    "content": "预定处理中:代理小哥正在确认你的订单【佳洁士牙膏,新年红包套装...】,请耐心等候....",  
    "contentUrl": "http://www.rongcloud.cn",  
    "extra": ""  
}  

pushContent:  
预定处理中:代理小哥正在确认你的订单【佳洁士牙膏,新年红包套装...】,请耐心等候....

OrderFailed

买家提交订单完成后,订单生成失败时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Trading:OrderFailed  

content:{  
    "content": "由于【SHOP】太火爆了,预定未成功,更多选择等你查看。",  
    "contentUrl": "http://www.rongcloud.cn",  
    "extra": ""  
}  

pushContent:  
预定失败:由于【SHOP】太火爆了,预定未成功,更多选择等你查看。

OrderSuccess

买家提交订单完成后,订单生成成功时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Trading:OrderSuccess  

content:{  
    "content": "预定成功:你预定【SHOP】已进行订单确认,欢迎光临下榻。",  
    "contentUrl": "http://www.rongcloud.cn",  
    "extra": ""  
}  

pushContent:  
预定成功:你预定【SHOP】已进行订单确认,欢迎光临下榻。

NotPaid

订单生成成功后,买家未付款时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Trading:NotPaid  

content:{  
    "content": "你的订单【佳洁士牙膏...】,还未付款,就差一步,就能拥有它......",  
    "contentUrl": "http://www.rongcloud.cn",  
    "extra": ""  
}  

pushContent:  
你的订单【佳洁士牙膏...】,还未付款,就差一步,就能拥有它......

订单生成成功后,买家已付款时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Trading:Paid  

content:{  
    "content": "你的订单【佳洁士牙膏...】,已付款,商家开始备货,准备出库.......",  
    "contentUrl": "http://www.rongcloud.cn",  
    "extra": ""  
}  

pushContent:  
你的订单【佳洁士牙膏...】,已付款,商家开始备货,准备出库.......

OrderDistribution

订单付款成功后,卖家发货并开始配送时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Trading:OrderDistribution  

content:{  
    "content": "你的订单【佳洁士牙膏...】,已经开始配送,请不要走开。配送员:小马 电话:1371759800",  
    "contentUrl": "http://www.rongcloud.cn",  
    "extra": ""  
}  

pushContent:  
你的订单【佳洁士牙膏...】,已经开始配送,请不要走开。配送员:小马 电话:1371759800

OrderComment

订单商品送达买家后,提示买家给出评价时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Trading:Comment  

content:{  
    "content": "订单【SHOP】已完成,期待反馈和评论。",  
    "contentUrl": "http://www.rongcloud.cn",  
    "extra": ""  
}  

pushContent:  
订单【SHOP】已完成,期待反馈和评论。

Upgrade

当用户完成新手登录任务后,发送的消息,用户可以通过点击消息中的按钮,领取奖励。

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
imageUrl string 消息中图片的 Url 地址
buttonTitle string 按钮的标题
extra string 附加信息

示例

objectName:  
RC:ML:Official:Upgrade

content:{  
    "content": "恭喜你成功完成(新手登录任务)获得奖励,快去领取吧!",  
    "contentUrl": "http://www.rongcloud.cn",   
    "imageUrl":"https://rongcloud-res.cn.ronghub.com/fc269b9ba6dfc08b2853966c14227fa6",  
    "buttonTitle": "立即领取",  
    "extra": ""  
}  

pushContent:  
恭喜你成功完成(新手登录任务)获得奖励,快去领取吧!

DiscountsExpire

优惠券即将到期时,提示用户领取时发送的消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
imageUrl string 消息中图片的 Url 地址
contentTitle string 内容的标题
extra string 附加信息

示例

objectName:  
RC:ML:Official: DiscountsExpire

content:{  
    "content": "你有一张 50.00 优惠券明日到期,再不领取就要过期啦!",  
    "contentUrl": "http://www.rongcloud.cn",   
    "imageUrl": "",  
    "contentTitle": "优惠到期提醒",  
    "extra": ""  
}  

pushContent:  
优惠到期提醒

WelcomeTxt

用户安装应用后,发送的纯文本类型的欢迎消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Official:Welcome:Txt

content:{  
    "content": "你好, Alice:\n\n很高兴认识你。蜜糖直播帮你结交新朋友,也时刻保护你的隐私安全。\n了解《蜜糖直播平台行为规范》,和我们一期健康成长,发现更多奇幻世界。",  
    "contentUrl": "http://www.rongcloud.cn",   
    "extra": ""  
}  

pushContent:  
你好,Alice:很高兴认识你。

WelcomeImgTxt

用户安装应用后,发送的图文类型的欢迎消息

属性 类型 描述
content string 消息内容
contentUrl string 点击消息内容跳转的 Url 地址
imageUrl string 消息中图片的 Url 地址
welcomeTitle string 欢迎的标题
extra string 附加信息

示例

objectName:  
RC:ML:Official:Welcome:ImgTxt

content:{  
    "content": "你好, Alice:\n\n很高兴认识你。蜜糖直播帮你结交新朋友,也时刻保护你的隐私安全。\n了解《蜜糖直播平台行为规范》,和我们一期健康成长,发现更多奇幻世界。",  
    "contentUrl": "http://www.rongcloud.cn",  
    "imageUrl": "https://rongcloud-res.cn.ronghub.com/8793820294a993d57365a7f9d9b91d2e",  
    "welcomeTitle": "终于等到你",   
    "extra": ""  
}  

pushContent:  
你好,Alice:很高兴认识你。

Comment

发布的内容被其他用户评论后,发送的消息

属性 类型 描述
opreatorId string 操作者的 userId
opreatorName string 操作者的昵称
opreatorPortraitUrl string 操作者头像的 Url 地址
countUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Interaction:Comment

content:{  
    "opreatorId": "opreator1",  
    "opreatorName": "莫莫酱",  
    "opreatorPortraitUrl": "https://rongcloud-res.cn.ronghub.com/1d7c39378bb561d8783798e19e0ee373",  
    "countUrl": "http://www.rongcloud.cn",   
    "extra": ""  
}  

pushContent:  
莫莫酱刚刚发表了评论@了你

Liked

发布的内容被其他用户点赞后,发送的消息

属性 类型 描述
opreatorId string 操作者的 userId
opreatorName string 操作者的昵称
opreatorPortraitUrl string 操作者头像的 Url 地址
countUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Interaction:Liked

content:{  
    "opreatorId": "opreator2",  
    "opreatorName": "小胖",  
    "opreatorPortraitUrl": "https://rongcloud-res.cn.ronghub.com/70cb59b054e5e7587ea1750adf074849",  
    "countUrl": "http://www.rongcloud.cn",   
    "extra": ""  
}  

pushContent:  
小胖刚刚为你点赞

Followed

被其他用户关注后,发送的消息

属性 类型 描述
opreatorId string 操作者的 userId
opreatorName string 操作者的昵称
opreatorPortraitUrl string 操作者头像的 Url 地址
countUrl string 点击消息内容跳转的 Url 地址
extra string 附加信息

示例

objectName:  
RC:ML:Interaction:Followed

content:{  
    "opreatorId": "opreator2",  
    "opreatorName": "小胖",  
    "opreatorPortraitUrl": "https://rongcloud-res.cn.ronghub.com/70cb59b054e5e7587ea1750adf074849",  
    "countUrl": "http://www.rongcloud.cn",   
    "extra": ""  
}  

pushContent:  
小胖刚刚关注了你

Awaken

被其他用户唤醒后,发送的消息

属性 类型 描述
opreatorId string 操作者的 userId
opreatorName string 操作者的昵称
opreatorPortraitUrl string 操作者头像的 Url 地址
countUrl string 点击消息内容跳转的 Url 地址
count string 消息内容
extra string 附加信息

示例

objectName:  
RC:ML:Interaction:Awaken

content:{  
    "opreatorId": "opreator1",  
    "opreatorName": "莫莫酱",  
    "opreatorPortraitUrl": "https://rongcloud-res.cn.ronghub.com/1d7c39378bb561d8783798e19e0ee373",  
    "countUrl": "http://www.rongcloud.cn",  
    "count": "你再不出现 ,莫莫酱就要生气了哦 ~ 呜呜",   
    "extra": ""  
}  

pushContent:  
你再不出现 ,莫莫酱就要生气了哦 ~ 呜呜

HelpInfo

被其他用户求助时,发送的消息

属性 类型 描述
opreatorId string 操作者的 userId
opreatorName string 操作者的昵称
opreatorPortraitUrl string 操作者头像的 Url 地址
countUrl string 点击消息内容跳转的 Url 地址
count string 消息内容
extra string 附加信息

示例

objectName:  
RC:ML:Community:HelpInfo

content:{  
    "opreatorId": "opreator2",  
    "opreatorName": "小胖",  
    "opreatorPortraitUrl": "https://rongcloud-res.cn.ronghub.com/70cb59b054e5e7587ea1750adf074849",  
    "countUrl": "http://www.rongcloud.cn",  
    "count": "有个问题向你求助:小唐山 有停车位吗?",   
    "extra": ""  
}  

pushContent:  
有个问题向你求助:小唐山 有停车位吗?