配置网易邮箱同步与订阅

本文面向维护网易企业邮箱通讯录同步的连接器管理员。你可以核对存量账号映射，并按业务需要配置邮件订阅，区分用户同步结果与订阅结果。

适用于已具备存量账号识别和邮件订阅配置能力的部署。先检查网易连接器配置页是否提供 启用网易邮件订阅配置 开关；本文不包含连接器基础接入，也不提供邮件推送接收服务。

准备工作

使用具有当前租户网易连接器配置和同步操作权限的账号。

已按基础接入说明配置网易连接器，核对企业标识、域名和账号映射。

需要开启订阅时，准备由业务系统维护、可被网易访问的 HTTP 或 HTTPS 绝对回调地址；地址不能包含空格。

同一企业的多个连接器需先协调。企业级动态订阅在网易侧共享，修改回调地址可能覆盖该企业原有订阅，不能仅按当前连接器评估影响。

企业级订阅负责登记企业的新邮件到达推送目标；账号级订阅负责让指定邮箱账号接收通知，依赖企业级订阅已登记。保存回调地址不代表平台已提供真实接收端点，也不代表推送已经送达。

核对存量账号映射

核对目标账号和域名

在现有网易邮箱通讯录同步配置中，核对映射生成的网易账号前缀和连接器域名。两者共同确定目标邮箱账号，不能仅按姓名或手机号判断是否同一账号。

如果多个本地用户映射到相同的目标账号，先修正映射。目标账号已关联其他本地用户时，不强制覆盖原关联。

按既有流程发起同步

在已授权的用户范围内按既有方式执行同步。对于原本需要新增的用户，系统先查询目标账号：不存在时创建；已存在且为正常普通账号、未关联其他本地用户时，关联该账号并同步允许更新的属性。

冻结、删除、离职、交接等异常状态或关联冲突需要先由相应管理员处理，不会通过存量识别强制接管或恢复。查询失败不等于账号不存在，不应继续当作新增处理。

查看单个用户的处理结果

检查同步明细，区分新建、存量关联更新和被阻断的用户。历史失败用户需要重新发起同步，不会因升级而在后台批量迁移。

存量关联不重置密码、别名、历史邮件、客户端授权信息或归档设置。结果存在冲突时，先核对账号映射及原关联，再决定后续处理。

选择是否开启邮件订阅

打开连接器配置并选择订阅方式

打开网易邮箱通讯录同步连接器的新建或编辑配置页，找到 启用网易邮件订阅配置。

不需要新邮件推送时保持关闭。关闭状态不填写回调地址，用户同步可继续进行，但不发起账号级订阅。

开启时填写回调地址并保存

需要新邮件推送时开启开关，在 网易推送回调地址 填写有效地址，核对企业标识后保存。

保存时会核对网易侧企业级订阅。地址相同时保持原订阅；地址不同时，需要取消原订阅再登记新地址。出现覆盖提示时，先确认该企业其他连接器及接收服务是否会受影响。

如果提示原订阅已取消、新订阅登记失败，先检查网易侧当前状态和回调配置，再重试，不把这次操作视为配置成功。

同步后分别检查用户与订阅结果

配置保存并确认企业级订阅已登记后，再按既有流程执行用户同步。开启状态下若企业级订阅缺失或无法确认，应先修复配置，不继续用户变更。

创建或恢复正常用户后，检查账号级订阅结果。用户已创建但订阅失败时，应处理订阅警告或重试，不要将用户重新当作未创建而重复新增。

验证结果

确认连接器保存结果与网易侧企业级订阅状态一致，用户同步明细中可区分用户变更结果与订阅结果。需要验证邮件通知时，还应由接收服务负责人检查真实请求是否到达及被处理；配置登记或用户创建成功都不能代替这项检查。

常见问题

提示网易邮箱账号已关联其他用户怎么办？

核对账号前缀、域名和本地用户映射，确认现有归属。不要直接覆盖；涉及解除原关联时，由有权限的管理员确认对象与影响后处理。

用户创建成功，为什么还有订阅警告？

用户创建与账号级订阅分开处理。检查开关、企业级订阅、回调地址及失败原因，按同步明细提供的方式重试订阅或重新同步。

升级后开关显示关闭，原有企业级订阅会立即取消吗？

首次打开存量连接器不会仅因默认关闭而取消网易侧订阅。历史未配置状态与管理员主动关闭不同，首次编辑前先确认网易侧已有状态。

停用或回滚

已启用的连接器需要停止订阅时，关闭开关并确认影响，再保存。确认网易侧企业级订阅已取消；取消失败时不能视为保存成功。此操作不会批量遍历并清理历史账号级订阅，其实际状态需在网易侧核对。

需要恢复订阅时，重新开启、核对回调地址、保存并检查企业级订阅状态。更换回调地址前记录原值；发生部分失败时先核对网易侧当前状态，再决定恢复原地址或重试新地址。

配置网易邮箱同步与订阅

准备工作#

核对存量账号映射#

选择是否开启邮件订阅#

验证结果#

常见问题#

提示网易邮箱账号已关联其他用户怎么办？#

用户创建成功，为什么还有订阅警告？#

升级后开关显示关闭，原有企业级订阅会立即取消吗？#

停用或回滚#