华为云WELINK-普通卡片消息:请求消息

时间:2023-12-18 15:59:48

请求消息

请求头部见表1

表1 请求头部

参数

是否必选

参数类型

描述(值)

x-wlk-Authorization

String

access_token

Content-Type

String

application/json

请求参数见表2

表2 请求参数

参数

是否必选

参数类型

说明

msgOwner

String

消息发送方,如“考勤”,长度不超过18字节。

publicAccID

String

接收消息的公众号ID,不传则默认发送消息到通知中心;可以在管理后台-公众号-公众号设置找到公众号ID

msgRange

String

0:按用户推送;1:按部门发送;2:按角色发送;默认0:按用户推送

toUserList

Array[String]

接收消息的人员ID(多个接收者用','分隔,最多支持1000个);msgRange=0时必传

departmentList

Array[String]

接收消息的部门ID(多个接收者用','分隔,最多支持100个);msgRange=1时必传

roleList

Array[String]

接收消息的角色ID(多个接收者用','分隔,最多支持100个);msgRange=2时必传

msgTitle

String

消息标题,长度不超过128字节。

如仅展示中文消息,可直接传普通string,如 “出差电子流” 。

需要双语则参考请求包体示例,传入json类型的string。

msgContent

String

消息内容,长度不超过512字节。

如仅展示中文消息,可直接传普通string,如 “张三提交了一个去上海的出差申请” 。

需要双语则参考请求包体示例,传入json类型的string。

receiveDeviceType

String

接收消息终端,0 :PC;1 :Mobile;2 :PC+MOBILE(默认)

urlType

String

链接类型定义。当前只支持“html”,点击后跳转到相关链接

urlPath

String

点击消息,跳转的链接

desktopUrlPath

String

PC端消息跳转链接。

非必填,当receiveDeviceType配置为0和2时,需要配置该参数,如果不配置就默认使用urlPath

messageStatus

String

消息状态,具体显示见样例图片(PC端不支持,移动端从5.45.X版本开始支持)。

格式:"messageStatus":"{"EN":"processed","CN":"已处理"}",

其中CN长度: 2-5个字; EN长度: 2-10个字符。

statusColor

String

状态对应的颜色(PC端支持7.0以上,移动端5.45 以上支持)

支持三种颜色1 (蓝色), 2(灰色), 3(橙色);默认:1

isForceTips

Integer

是否强提醒。

强提醒时PC WeLink 收到消息,屏幕右下角会有弹窗提示。0:否;1:是。为空时默认为0,不强提醒

support.huaweicloud.com/devg-welink/start-141.html