跳转至

邮件集成

有度支持配置腾讯企业邮箱的新邮件提醒、单点登录、同步组织架构,您可以在有度管理后台进行配置。

如企业需要自由定制企业邮箱的新邮件提醒及单点登录,可参考本案例集成。

初始化客户端

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地址。然后参加单点登录,有度单点登录到第三方系统进行单点登录集成。