# 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号"
      }
  }
}