有度是企业即时通信工具，在本文场景中作为ONES消息通知的接收渠道：ONES产生通知，经有度自建应用推送到已绑定成员。按ONES国内版手册，接入需同时满足版本许可、四项有度应用参数加消息推送开关、有度用户名绑定三类条件；手册标注企业版ONES 3.6及以上，当前许可与部署范围仍需核对。本文结论仅依据该手册，未做目标环境实测，有度厂商开发文档本轮访问超时，兼容条件待复核。
要点总览（TL;DR）
- 有度接收ONES消息通知需要三类条件同时具备：手册标注企业版ONES 3.6及以上（当前许可与部署范围仍需核对）、四项有度自建应用参数加消息推送开关、有度用户名与ONES成员绑定。
- 四项应用参数为有度服务器地址、企业总机号、AppID、EncodingAESKey，均取用实际企业有度应用信息，并确认消息推送已启用。
- 成员绑定以有度用户名为匹配依据，用户名须与有度中的实际成员对应，绑定后验证账号有效性；未绑定或用户名不一致的成员收不到通知。
- 验收以绑定成员在有度中实际收到ONES消息通知为准，建议同时准备一个未绑定成员做对照，并记录参数来源与核验日期。
- 本文依据ONES国内版手册整理，未做目标环境实测；有度厂商开发文档本轮访问超时，兼容条件待复核。
这条通知链路的方向与成立前提
先明确数据方向：ONES是消息来源，有度是接收渠道，链路为单向通知。ONES侧完成有度应用参数配置和成员绑定后，绑定成员在有度中接收ONES发出的消息通知。手册描述的能力边界到“接收通知”为止，不包含反向写入或双向同步。
成立前提有两层。第一层是版本与许可：所读手册标注企业版ONES 3.6及以上，这一标注是手册的适用条件，实际许可类型、版本号和部署形态仍需在目标环境核对，不能直接套用到其他版本组合。第二层是配置完整性：应用参数、消息推送开关、成员绑定三项缺一不可，任何一项缺失都会导致通知无法送达对应成员。
本文范围限定在通知接收的接入准备与验收，不涉及单点登录配置，也不涉及组织目录或通讯录同步。手册未提供这两方面的证据，因此本文不对其配置方式作任何说明。同时需要说明，本文依据的是ONES国内版手册的结构化摘记，未在目标环境执行配置与收发测试，文中步骤属于按手册整理的接入方案，落地时以实际界面和目标环境结果为准。
配置前要准备的有度应用信息
接入前需要从有度侧取得企业自建应用的四项信息，并在ONES侧对应位置填写，同时确认消息推送处于启用状态。这四项参数共同构成ONES调用有度应用的身份与加密依据，缺少任何一项都无法完成应用侧对接。
| 参数 | 作用 | 取用来源 | 填写注意 |
|---|---|---|---|
| 有度服务器地址 | 指向企业有度服务的访问入口 | 企业有度部署信息 | 使用本企业实际地址，区分测试与生产环境 |
| 企业总机号 | 标识所属有度企业 | 有度企业信息 | 与有度后台显示的企业标识保持一致 |
| AppID | 标识本次使用的自建应用 | 有度自建应用详情 | 对应专门用于ONES通知的应用，避免与其他应用混用 |
| EncodingAESKey | 消息加解密凭据 | 有度自建应用详情 | 按有度生成值原样填写，注意字符完整 |
| 消息推送开关 | 决定应用是否推送消息 | 有度自建应用设置 | 确认已启用，未启用时参数正确也不会产生通知 |
准备阶段建议做两件事：一是把四项参数的取用位置、填写人和填写日期记录在同一份接入记录中，便于后续排查时判断参数是否被改动；二是确认使用的是实际企业有度应用信息，示例值或他人环境的参数只能用于理解字段含义，不能用于上线。参数在ONES侧填写完成后，先不要急于批量绑定成员，留出一个账号做单点验证更稳妥。
成员绑定：用户名对齐与有效性验证
成员绑定的匹配依据是有度用户名。ONES成员与有度成员建立绑定关系时，填写的是该成员在有度中的用户名，因此用户名必须与有度里的实际成员一一对应。用户名拼写、大小写或前后空格出现差异，都会造成绑定指向错误或绑定失败。
绑定操作可以按以下顺序推进：
- 从有度侧导出或核对需要接收通知的成员用户名清单，作为比对基准。
- 在ONES侧找到成员绑定入口，为每个成员填写对应的有度用户名。
- 逐条核对填写值与清单是否完全一致，重点检查易混字符和多余空格。
- 绑定完成后执行账号有效性验证，确认该绑定关系可用。
需要提前建立的预期是：未绑定成员收不到通知，用户名与有度实际成员不一致的成员同样收不到。这类问题在批量绑定中容易被忽略，因为配置界面通常不会提示“该用户名在有度中不存在”。因此绑定环节的核对工作量应放在上线之前，而不是等成员反馈收不到通知后再逐个回溯。
绑定范围建议按通知实际需要确定。ONES消息通知面向的是需要在有度中及时获知事项的成员，把全部成员一次性绑定会放大用户名核对的工作量，也会让后续排查难以定位。可以先覆盖一个团队或一个项目相关成员，验证链路后再扩展。
异常与重复：配置不生效时先查什么
通知没有到达时，按“先全局后个人、先参数后绑定”的顺序排查，可以把问题范围快速收窄。全局现象指所有绑定成员都收不到，个人现象指部分成员收不到，两类现象指向的原因不同。
| 现象 | 优先检查 | 判断依据 |
|---|---|---|
| 所有成员都收不到通知 | 四项应用参数是否填写正确、消息推送是否启用 | 参数错误或推送关闭时，链路在应用层就中断 |
| 部分成员收不到通知 | 该成员是否已绑定、用户名是否与有度实际成员一致 | 绑定缺失或用户名不匹配只影响对应成员 |
| 同一成员收到重复通知 | 该成员是否存在多条绑定关系 | 重复绑定会让同一通知多次投递 |
| 参数与绑定均已核对仍无通知 | 有度侧应用状态与双方版本兼容性 | 属于本轮资料未覆盖的范围，需向双方确认 |
排查时保留变更记录会显著降低难度：每次修改参数或绑定关系后记录修改内容和时间，出现异常时可以先判断是否与最近一次变更相关。对于参数与绑定都已核对、通知仍未到达的情况，本轮资料没有给出进一步结论。有度厂商开发文档访问超时，有度与ONES的兼容条件尚待复核，这类问题应向有度与ONES双方确认，不能据此判断某一方不支持该能力。
可验证结果：怎样确认通知真的送达
验收标准只有一条：绑定成员在有度中实际收到ONES发出的消息通知。配置界面显示保存成功、参数校验通过，都不能替代实际送达。验收应在目标环境执行，并把结果记录下来。
可执行的验收清单如下：
- 准备对照样本：至少一个已完成绑定的成员，以及一个未绑定成员，两者处于同一通知触发场景。
- 触发一条ONES消息通知，确认已绑定成员在有度中收到，未绑定成员未收到；两项结果同时成立，说明应用配置与绑定逻辑均按预期工作。
- 对已绑定成员再做一次账号有效性验证，确认绑定关系持续可用。
- 记录四项应用参数的取用来源、填写人、填写日期，以及本次验收的执行日期和参与成员。
- 在接入记录中标注未实测部分，包括有度厂商文档未取得、兼容条件待复核，作为后续复核项。
验收通过后，成员绑定范围可以逐步扩展。每次扩展后重复一次对照验证，确认新增成员能收到通知，避免批量操作引入用户名不一致的问题。若后续ONES或有度发生版本变更，建议重新执行一次上述验收，因为本轮结论基于手册标注的版本条件，版本变化后的表现需要在目标环境重新确认。
常见问题
手册标注企业版ONES 3.6及以上，我们用的是其他版本，还能按本文配置吗？
本文的版本条件来自所读ONES国内版手册，手册标注企业版ONES 3.6及以上。其他版本组合不在该标注范围内，不能直接套用本文结论。建议先在目标环境核对实际许可类型、版本号和部署形态，再决定是否按本文流程推进；版本条件不满足时，配置界面与参数项也可能与文中描述不同。
四项应用参数都填对了，为什么成员还是收不到通知？
先区分范围：所有成员都收不到，优先检查四项应用参数是否填写正确、消息推送是否启用，参数错误或推送关闭会让链路在应用层中断；只有部分成员收不到，则检查这些成员是否已绑定、用户名是否与有度中的实际成员一致。绑定以有度用户名为匹配依据，拼写、大小写或多余空格都会造成指向错误。参数与绑定都已核对仍无通知时，属于本轮资料未覆盖的范围，需向有度与ONES双方确认。
成员绑定用邮箱、手机号还是用户名？
按ONES国内版手册，绑定依据是有度用户名，填写的是该成员在有度中的用户名，需要与有度里的实际成员一一对应。建议先从有度侧导出或核对需要接收通知的成员用户名清单作为比对基准，再在ONES侧逐条填写并核对，绑定完成后验证账号有效性。
配置完成后，怎样算验收通过？
通过标准是绑定成员在有度中实际收到ONES发出的消息通知，配置界面显示保存成功不能替代实际送达。可准备一个已绑定成员和一个未绑定成员，在同一通知触发场景下对照：已绑定成员收到、未绑定成员未收到，两项同时成立说明应用配置与绑定逻辑按预期工作。验收后记录参数取用来源、填写人、填写日期和执行日期，并把兼容条件待复核列为后续复核项。
有度与ONES的兼容性有没有官方结论？
本轮有度厂商开发文档访问超时，未取得正文，因此有度与ONES的兼容条件尚待复核。本文结论仅依据ONES国内版手册的结构化摘记，未在目标环境执行配置与收发测试。遇到参数与绑定均已核对、通知仍未到达的情况，应向有度与ONES双方确认，不能据此判断某一方不支持该能力。
官方参考资料
- 集成有度（ONES）
