关键词:邮件收发,O2OA,企业邮箱,电子邮箱,邮件系统集成,企业邮件,邮箱

O2OA平台并不包含企业邮箱解决方案，我们建议将专业的商业邮箱集成到O2OA中，作为更优的企业邮箱解决方案。本篇主要介绍如何在O2OA中如何集成腾讯企业邮。

.

功能:

1.实现和腾讯企业邮的单点认证.
2.读取未读邮件数量.
3.新邮件到达同步:有新邮件到达时将新邮件到达信息从腾讯企业邮推送到O2OA平台.

前提:

1.已经申请腾讯企业邮.
2.已经启用企业微信和O2OA的通讯录同步或者已经将个人的邮件地址设置为腾讯企业邮地址.
3.如果启用"新邮件到达同步",需要开通外网地址,并在80或443或8080上开通center server的访问.

配置步骤:

1.从configSample目录下复制exmail.json到config目录.

2.配置exmail.json文件:

{
    "enable":true,
    "corpId":"(change this value)",
    "token":"(change this value)",
    "encodingAesKey":"(change this value)",
    "newRemindSecret":"(change this value)",
    "ssoSecret":"(change this value)",
  "personAttributeNewCountName": "exmailNewCount",
  "personAttributeTitleName": "exmailTitle",
  "newCountAddress": "https://api.exmail.qq.com/cgi-bin/mail/newcount",
  "ssoAddress": "https://api.exmail.qq.com/cgi-bin/service/get_login_url",
}

enable:是否启用.
corpId:腾讯企业邮的cropId,可以在腾讯企业邮查询得到.
newRemindSecret:读取新邮件时使用的密钥.
ssoSecret:单点登录使用的密钥.
token:新邮件到达同步的回调认证token(可选).
encodingAesKey:新邮件到达同步的回调Key,(可选).
personAttributeNewCountName:新邮件数量在个人属性中存储的字段名,默认为:exmailNewCount.
personAttributeTitleName:新邮件标题在个人属性中存储的字段名,默认为:exmailTitle.
newCountAddress:腾讯企业邮新邮件数量读取地址,一般不需要修改,默认为:https://api.exmail.qq.com/cgi-bin/mail/newcount
ssoAddress:腾讯企业邮sso登录地址,一般不需要修改,默认为:https://api.exmail.qq.com/cgi-bin/service/get_login_url

3.重启服务器生效.

读取接口:

读取新邮件标题(被动方式),读取的是腾讯企业邮通过回调接口推动到系统并记录在个人属性中的标题.

get http://127.0.0.1:20020/x_organization_assemble_personal/jaxrs/exmail/list/title/passive

读取新邮件数量(被动方式),读取的是腾讯企业邮通过回调接口推动到系统并记录在个人属性中的数量.

get http://127.0.0.1:20020/x_organization_assemble_personal/jaxrs/exmail/jaxrs/exmail/new/count/passive

读取新邮件数量(主动方式),服务器发起连接读取腾讯企业邮新邮件数量并返回数量值.

get http://127.0.0.1:20020/x_organization_assemble_personal/jaxrs/exmail/jaxrs/jaxrs/exmail/new/count