邮件集成
有度支持配置腾讯企业邮箱的新邮件提醒、单点登录、同步组织架构,您可以在有度管理后台进行配置。
如企业需要自由定制企业邮箱的新邮件提醒及单点登录,可参考本案例集成。
初始化客户端
int buin = 14731009; // 请填写企业总机号码
String ydServerHost = "127.0.0.1:7080"; // 请填写有度服务器地址
String exMailAppAesKey = "U7RpMNo9dtLB8QsmwooQRjf8znXIwNdULQqelLfHB54="; //请填写企业邮应用的EncodingaesKey
MailMsgClient mailMsgClient = new MailMsgClient(buin, ydServerHost, exMailAppAesKey);
exMailAppAesKey值通过企业应用->企业邮箱->其他邮箱 获取。
发送新邮件消息
功能说明
在用户邮箱收到新邮件时,通过此方法向有度客户端推送新邮件提醒。可通过用户名或用户绑定的邮件地址进行发送。
方法原型
public void sendMailMsg(String toUser, String toEmail, EmailBody emailMsg) throws ParamParserException, HttpRequestException, AESCryptoException;
参数说明
参数名称 | 类型 | 描述 |
---|---|---|
toUser | String | 用户名称,通过|分隔(示例:"youdu1|youdu2") |
toEmail | String | 邮件地址,通过|分割(示例:"test1@xinda.im|test2@xinda.im") |
emailMsg | EmailBody | 发送的邮件体 |
emailMsg成员说明
emailMsg成员 | 必须 | 说明 |
---|---|---|
action | 否 | 邮件消息类型。new: 新邮件,unread: 未读邮件数 |
subject | 否 | 邮件主题。action为new时有效,可为空 |
fromUser | 否 | 发送者帐号,action为new时有效 |
fromEmail | 否 | 发送者邮件帐号,action为new时有效。fromUser不为空,fromEmail值无效 |
time | 否 | 邮件发送时间。为空默认取服务器接收到消息的时间 |
link | 否 | 邮件链接。action为new时有效,点此链接即可打开邮件,为空时点击邮件消息默认执行企业邮箱单点登录 |
unreadCount | 否 | 未读邮件数。action为unread时有效 |
返回结果说明
成功:没有返回。
失败:发生错误(如请求失败),抛出异常。
请求示例1
EmailBody mailMsg = new EmailBody();
mailMsg.setAction(Const.Mail_Msg_New);
mailMsg.setSubject("测试邮件");
mailMsg.setFromUser("youdu3");
String toUser = "youdu0|youdu1";
mailMsgClient.sendMailMsg(toUser, "", mailMsg);
请求示例2
EmailBody mailMsg = new EmailBody();
mailMsg.setAction(Const.Mail_Msg_New);
mailMsg.setSubject("测试邮件");
mailMsg.setFromUser("test1");
String toEmail = "test1@xinda.im|test2@xinda.im";
mailMsgClient.sendMailMsg("", toEmail, mailMsg);
发送未读邮件数消息
功能说明
向客户端发送未读邮件数,通过|分割(示例:"test1@xinda.im|test2@xinda.im")
方法原型
public void sendUnreadCountMailMsg(String toUser, String toEmail, int unreadCount, long timex) throws ParamParserException, HttpRequestException, AESCryptoException;
参数说明
参数名称 | 类型 | 描述 |
---|---|---|
toUser | String | 用户名称,通过|分隔(示例:"youdu1|youdu2") |
toEmail | String | 邮件地址,通过|分割(示例:"test1@xinda.im|test2@xinda.im") |
unreadCount | int | 未读邮件数 |
timex | long | 时间戳 |
返回结果说明
成功:没有返回。
失败:发生错误(如请求失败),抛出异常。
请求示例1
long timex = Calendar.getInstance().getTimeInMillis();
int unreadCount = 10;
String toUser = "youdu1|youdu2";
mailMsgClient.sendUnreadCountMailMsg(toUser, "", unreadCount, timex);
请求示例2
long timex = Calendar.getInstance().getTimeInMillis();
int unreadCount = 9;
String toEmail = "test1@xinda.im|test2@xinda.im";
mailMsgClient.sendUnreadCountMailMsg("", toEmail, unreadCount, timex);
单点登录
需要在企业应用->企业邮箱->其他邮箱 配置单点登录Url地址。然后参加单点登录,有度单点登录到第三方系统进行单点登录集成。