神鲸办公与企业微信集成需依次完成五步：一、获取CorpID、AgentId和Secret；二、设置并校验可信域名；三、配置可信IP；四、启用通讯录同步并设置事件接收URL、Token及EncodingAESKey；五、在神鲸后台填入全部参数并触发组织同步。
如果您正在配置神鲸办公系统与企业微信的集成，但无法完成绑定，则可能是由于关键参数未正确填写或企微后台设置缺失。以下是完成神鲸办公与企业微信集成配置的具体步骤：
一、获取企业微信基础凭证
该步骤用于获取神鲸办公集成所必需的身份识别参数，包括企业唯一标识及应用密钥，是后续所有配置的前提。
1、使用企业微信管理员账号登录企业微信管理后台，在左侧菜单栏点击「我的企业」，复制页面底部显示的CorpID（企业ID）。
2、进入「应用管理」→「自建」，点击「创建应用」，填写应用名称（如“神鲸办公集成”）、应用图标及可见范围（建议设为全部部门），点击「创建应用」。
3、创建成功后，在该应用详情页中，复制AgentId（应用ID）和Secret（应用密钥），这两项需完整、准确填入神鲸办公后台对应字段。
二、配置企微可信域名与域名校验
该步骤确保神鲸办公的回调地址被企业微信识别为合法来源，避免免登、消息推送等核心功能因域名未校验而失败。
1、在企微应用详情页，下滑至「开发者接口」→「网页授权及JS-SDK」→「设置可信域名」，点击「申请校验域名」。
2、下载生成的校验文件（格式为WW_verify_xxxxxxxx.txt），将该文件上传至神鲸办公所用服务器的根目录下，确保可通过http://{您的神鲸办公域名}/WW_verify_xxxxxxxx.txt直接访问且返回纯文本内容（仅文件名）。
3、校验文件可访问后，返回企微后台点击「确认」完成校验。
三、设置企业微信可信IP地址
该步骤用于授权神鲸办公服务器调用企微服务端接口，若IP未配置或配置错误，组织同步、消息发送等API请求将被拒绝。
1、在企微应用详情页，进入「开发者接口」→「企业可信IP」。
2、将神鲸办公部署服务器的公网出口IP地址逐个添加（最多支持120个），注意不可填写内网IP或负载均衡私有地址。
一站式排查小程序隐私授权报错（errno 104 / buttonId is wrong 等）+ 标准修改模式。适用：隐私协议配置、隐私弹窗不弹、授权报错、隐私接口调用失败。已抽离具体项目，适用于任何微信小程序。
3、若使用云服务商（如阿里云、腾讯云），需确认实际发起请求的IP是否为弹性公网IP或NAT网关出口IP，并据此填写。
四、启用通讯录同步并配置事件接收
该步骤建立企微组织数据变更与神鲸办公的实时联动机制，确保成员增删改操作自动同步至神鲸办公系统。
1、在企微管理后台，进入「安全与管理」→「管理工具」→「通讯录同步」，点击「开启API接口同步」。
2、在同步配置页中，点击「随机获取」生成Token和EncodingAESKey，请勿关闭当前页面，后续需回填至神鲸办公。
3、将页面中显示的事件接收URL（即神鲸办公提供的回调地址）完整复制，粘贴至企微「通讯录同步」设置页的「URL」字段中。
4、将刚生成的Token和EncodingAESKey一并填入神鲸办公后台对应配置项。
五、在神鲸办公后台完成参数回填与组织同步
该步骤将企微侧获取的所有凭证与策略映射至神鲸办公系统，触发首次组织架构拉取与用户身份绑定。
1、登录神鲸办公平台管理后台，进入「系统集成」→「企业微信」模块。
2、依次填入以下字段：CorpID、AgentId、Secret、Token、EncodingAESKey，并确保「可信域名」字段与企微校验时使用的域名完全一致（不含协议头，支持端口）。
3、保存配置后，进入「组织架构」→「组织同步」，选择「企业微信」作为数据源，点击「确认同步」。
4、系统将启动异步同步任务，同步过程中请勿中断网络连接或修改企微侧配置。
