跳转至

系统通知

通过接口向指定的用户或部门发送通知,比如:全员通知、部门动态等信息。

获取应用参数

在发送系统消息之前,您需要通过有度管理后台->管理工具->系统消息获取以下信息:

  • 应用App ID
  • EncodingAESKey

b01_00003

初始化客户端

int buin = 14731009;// 请填写企业总机号码
String ydServerHost = "127.0.0.1:7080";// 请填写有度服务器地址
String appName="系统消息";
String appId = "sysMsgAssistant";// 请填写企业应用AppId
String appAesKey = "6PMlqU4Agyjn3aGTmAn7ELQJtz3x7H1uml5v5DRNkmM=";// 请填写企业应用的EncodingaesKey
YDApp app = new YDApp(buin, ydServerHost, appName, appId, "", appAesKey);
SysMsgClient msgClient = new SysMsgClient(app);

发送系统消息

发送系统消息给用户或部门

方法原型

public void sendSysMsg(String toUser, String toDept, SysMsgBody sysMsg) throws ParamParserException, HttpRequestException, AESCryptoException;

参数说明

参数名称 类型 描述
toUser String 用户名称,通过|分隔(示例:"youdu1|youdu2"。如果不是发给用户,可传输"")
toDept String 部门Id,通过|分割(示例:"100|101"。如果不是发送给部门,可传输"")
sysMsg SysMsgBody 发送的消息体

sysMsg成员说明

Request成员 设置方法 描述
title Set方法 标题
textBody Add方法 消息体
linkBody Add方法 超链接
popDuration Set方法 弹窗显示时间,0及负数弹窗不消失,正数为对应显示秒数

返回结果说明

成功:没有返回值。

失败:发生错误(如请求失败),抛出异常。

请求示例

SysMsgBody sysMsg = new SysMsgBody();
sysMsg.setTitle("有度即时通");
sysMsg.addTextBody("欢迎使用有度即时通:");
sysMsg.addLinkBody("https://www.youdu.im","有度官网",0);
sysMsg.setPopDuration(5);
String receiveUsers = "youdu0";
String receiveDepts = "1|2|3";
msgClient.sendSysMsg(receiveUsers,null,sysMsg);