# 邮箱集成套件：网易企业邮箱V1.9配置示例

来源快照：`result_data_new_260518.json`

- 来源 ID：`1201363276926181386`
- 模块：集成中心
- 目录：邮箱集成 - 配置示例
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、需求背景

E10邮箱集成对接网易企业邮箱，实现OA组织和人员初始化、实时同步至邮箱系统；门户元素展示未读邮件；门户导航栏入口展示未读邮件数据及单点登录。

**注意：此功能不涉及收发邮件功能**

# 二、操作步骤

## 1.网易企业邮箱配置

### 1.1登录管理后台，新建应用授权

[管理后台](https://qy.163.com/login/)-【应用中心】-【应用接入管理】-新建应用授权 （具体操作可参考截图）  
注：管理后台登录地址https://qy.163.com/login/

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413566735630342&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413566627405831&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413575350730756&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

新建应用授权填写说明：      

应用名称：可按需填写，无限制

IP白名单：访问接口时我司公网出口IP（注：如需开放全部IP，请设置为::/0如仅开通单点登录访问，请设置为127.0.0.1）

温馨提示：为了您的接口安全，建议您按需填写IP限制呢，请勿开放全部IP。

应用状态：默认启用       

### 1.2获取集成接口API参数

新建应用授权完成后，获取下表中调用网易企业邮箱集成接口API时所必需的参数：

**参数名称**| **参数说明**| **路径说明**  
---|---|---  
**appId**|  应用ID| 管理后台-【应用中心】-【应用接入管理】  
**authCode**|  应用授权码| 管理后台-【应用中心】-【应用接入管理】  
**orgOpenId**|  企业OpenId| 管理后台-【企业设置】-【企业信息】  
**邮箱域名**|  企业域名|    
**接口地址**|  https://api.qiye.163.com|    
  
参数详细位置可参考截图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413571089317888&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413566654111745&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

 

 

## 2.集成中心-邮箱集成-网易企业邮箱

点击网易企业邮箱（V1.9）新建

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413570873581576&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

也可以在ESB中心连接器中新建配置，ESB连接器中只是提供一个入口，功能都需要在【集成中心】-【邮箱集成】查看

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413570873581570&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

配置项| 说明  
---|---  
启用| 默认开启，控制整个功能是否可用的开关  
名称| 任意  
产品类型| 网易企业邮箱  
所属机构| 开启分权时显示  
绑定邮箱字段| 以此字段的值作为邮箱系统的账号  
启用同步| 默认开启，开启后可将OA组织和人员同步至邮箱系统  
关联单点登录标识| 关联后可邮箱门户元素查看未读邮件、门户导航栏可点击登录邮箱系统  
应用ID| 网易企业邮箱提供，参考步骤1.2获取  
应用授权码| 网易企业邮箱提供，参考步骤1.2获取  
企业Openid| 网易企业邮箱提供，参考步骤1.2获取  
邮箱域名| 网易企业邮箱提供，参考步骤1.2获取  
接口地址| https://api.qiye.163.com，如有特殊，根据实际修改  
  
 

## 3.维护个人信息卡片邮箱

配置示例“绑定邮箱字段”设置为“邮箱”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413579646525442&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

人力卡片邮箱字段维护正确的网易企业邮箱值

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413566627405830&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 4.手动同步

按照实际需要选择是否配置此步骤。

【集成中心】-【邮箱集成】打开新建的配置可点击同步，点击后将所选范围下的组织和人员同步至网易企业邮箱。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413570873581578&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 5.门户邮箱集成元素

涉及权限项：【门户】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413575350730764&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

按照实际需要选择是否配置此步骤

【后端管理中心】-【门户】-【设计】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413570902941705&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

搜索“邮箱”添加

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413575411818503&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

内容来源选择集成中心-邮箱集成新建的配置，此处也可按需配置邮件列表、提示信息等门户元素样式

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413571039813633&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

效果：若配置绑定了集成登录标识，点击右键则可登录网易企业邮箱

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413571039813633&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 6.门户导航栏

涉及权限项：【界面配置中心】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413579561811969&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

按照实际需要选择是否配置此步骤

【后台管理中心】-【界面配置中心】-【导航设置】-【PC网页版导航或PC客户端导航】，启用“网易企业邮箱”

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413575350730759&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

效果：点击可单点登录至邮箱，并可查看未读邮件的数量

![](https://weapp.eteams.cn/papi/file/preview?fileId=1201413575284449288&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 7.初始化密码查询

通过OA新增邮箱账号，初始化密码查询（前端-个人设置-集成设置-邮箱初始密码查询）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1183645317071052804&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意：

邮箱初始化密码查询须知：

OA同步人员到邮箱，同步类型为新增，才会生产初始化密码，可在当前页做查询

人员同步开启实时同步OA密码，且修改了OA密码，初始化密码变无效，请使用修改后的密码登录邮箱

用户在邮箱修改密码，请勿查询此页面密码做登录
