# 1.5.1 推送消息至员工的通知助手
通过该接口,可以给员工的通知助手推送消息,可以使用在一些MOT推送的场景
请求方式:POST
请求地址:{API_HOST}/api/v1/open/swan/push/message
请求头部:
key | value |
---|---|
Content-Type | application/json |
X-Consumer-Custom-ID | "@staff_super:im.finogeeks.com" |
请求参数说明:
参数名称 | 类型 | 是否必须 | 说明 | 默认值 |
---|---|---|---|---|
banner | string | 是 | app横幅提醒内容 | |
title | string | 是 | 标题 | |
content | string | 是 | 内容 | |
href | string | 是 | 查看详情的跳转链接 | |
userIds | string[] | 是 | 需要推送的员工 | |
window | string | 是 | 原生页面路径 | |
forward | string | 是 | 点击横幅消息跳转方式,mini: 小程序, native: 原生页面, 默认为空(打开app) | |
forwardURL | string | 是 | 点击横幅消息跳转路径 | |
noticeType | string | 是 | 通知类型,不传默认Customer |
请求报文示例:
{
"banner": "[营销海报更新提醒]",
"title": "营销海报更新提醒",
"content": "您有新的营销海报,欢迎查看",
"href": "fino://swan/native/poster",
"userIds": ["@staff_staff10:im.finogeeks.com"],
"window": "POSTER_MANAGER",
"forward": "",
"forwardURL": "",
"noticeType": ""
}
# 1.5.2 微信订阅消息推送
通过该接口,可以给微信的客户进行订阅消息的推送,需要知道用户的openId,并且该用户需要有订阅了该服务消息,该接口为微信订阅消息推送的一个封装;
请求方式:POST
请求地址:{API_HOST}/api/v1/open/wechat-service/wxa/message/subscribe/send
请求头部:
key | value |
---|---|
Content-Type | application/json |
X-Consumer-Custom-ID | "@staff_super:im.finogeeks.com" |
请求参数说明:
参数名称 | 类型 | 是否必须 | 说明 | 默认值 |
---|---|---|---|---|
touser | string | 是 | 微信用户openId | |
template_id | string | 是 | 所需下发的订阅模板id | |
page | string | 否 | 点击模板卡片后的跳转页面,仅限本小程序内的页面 | |
miniprogram_state | string | 否 | 跳转小程序类型:developer为开发版;trial为体验版;formal为正式版;默认为正式版 | |
lang | string | 否 | 进入小程序查看”的语言类型,支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文),默认为zh_CN | |
data | Object | 是 | 模板内容,格式形如 { "key1": { "value": any }, "key2": { "value": any } } |
请求示例:
{
"touser": "OPENID",
"template_id": "TEMPLATE_ID",
"page": "index",
"data": {
"number01": {
"value": "339208499"
},
"date01": {
"value": "2015年01月05日"
},
"site01": {
"value": "TIT创意园"
} ,
"site02": {
"value": "广州市新港中路397号"
}
}
}