账号打通，少一道门槛
企微身份与平台账号绑定后，员工不必再记一套新密码。开启自动建号后，新同事第一次登录就自动有账号，并且直接落在你指定的部门与角色里。
企业微信部署
把搭建客接进企业微信
这套集成在免费 SAAS 上就能开通，不需要私有部署。通讯录同步进来，账号打通，业务提醒推到工作群。员工不需要学习新入口，管理员也不用维护两份组织架构。
一、能力状态矩阵
和钉钉部署页一样，这一节的每一行都按当前实现如实标注。企业微信的应用类型比钉钉多一些，我们更要把边界写清楚。
| 能力 | 状态 | 说明 |
|---|---|---|
| 配置企业微信为认证提供商 | 已支持 | 在企业内新增认证提供商，类型选「企业微信」，填写 CorpID / Secret / 回调地址即可保存并启用 |
| 登录页展示企微入口 | 已支持 | 启用后登录页会列出该入口；企业内已启用该类型时，登录页可自动跳转到企微登录 |
| 第三方身份绑定 | 已支持 | 企微身份与平台账号做映射。一个身份只绑一个账号，一个账号可同时绑微信与企微 |
| 部门与成员同步 | 已支持 | 按 wecom 作为来源标识同步部门与成员，外部 ID 与本地部门自动建立映射关系 |
| 首次登录自动建号 | 已支持 | 可开启「自动创建用户」，并指定默认部门与默认角色 |
| 群机器人通知 | 已支持 | 通过 Webhook 通道把事件推到企微群机器人，当前最省事的触达方式 |
| 个人微信扫码登录 | 已支持 | 面向个人微信的扫码登录是平台完整实现的能力（含扫码、回调、绑定、自动注册），与企业微信是两套入口，见第六节 |
| 扫码免登完整链路 | 需联调交付 | 依赖自建应用类型、可信域名、网页授权配置，需在交付阶段联调确认 |
| 企微应用消息 | 规划中 | 当前建议用群机器人 Webhook 替代，把待办与提醒推到工作群 |
| 工作台免登入口 | 规划中 | 把搭建客挂到企微工作台并免登进入，需与企微侧一起配置，当前按项目评估 |
先说清边界：标注为「需联调交付」与「规划中」的能力不写进承诺清单。启动前先做可行性确认，能做就排期，不能做就直接给替代方案。
二、接入后是什么体验
通讯录同步，不用录两遍
部门与成员按企微通讯录同步进来，外部 ID 与本地部门建立映射。组织调整时同步一次即可，平台里的组织树不会和企微对不上。
提醒推到工作群
通过群机器人 Webhook，把派单、审核结果、到期提醒推到对应的工作群。对一线同事来说，在群里看到消息比登录系统查待办现实得多。
一个典型组合
企微负责「组织与触达」，搭建客负责「业务与数据」。例如门店巡检：督导在搭建客里发起巡检任务，任务提醒推到门店群；店长点链接进平台完成整改并上传照片；区域经理在平台上看到整改进度与排名。整个过程里，权限与数据口径都由搭建客统一管理。
三、需要准备什么
| 准备项 | 说明 |
|---|---|
| 企微管理员权限 | 需要能登录企业微信管理后台并创建自建应用，通常由企业 IT 或企微超级管理员操作 |
| 企业 ID（CorpID） | 在「我的企业」页面可以找到，是企微集成的必要参数 |
| 自建应用 | 在「应用管理」中创建自建应用，拿到 AgentId 与 Secret |
| 可信域名 / 可信 IP | 用于网页授权与接口调用；回调地址需与最终对外域名一致 |
| 通讯录权限 | 若要做组织同步，需要开启通讯录读取权限（或使用通讯录同步助手） |
| HTTPS 域名 | 企微对网页授权要求 HTTPS，建议一开始就配好证书 |
| 一个试点部门 | 建议先在一个部门跑通，确认账号与权限无误后再全量放开 |
关于 Secret 的保管：自建应用的 Secret 与通讯录同步的 Secret 是两套凭据，权限范围不同。建议分开保管，只授予实际需要的范围；在平台上配置后 Secret 不会回显明文。
四、接入步骤
企微侧：创建自建应用
在企微管理后台创建自建应用，记录 AgentId 与 Secret，配置可信域名，按需申请通讯录权限。
平台侧：新增认证提供商
进入「组织与成员 → 认证提供商」，新增配置，类型选择「企业微信」，填写 ClientID（企业 ID）、Secret 与回调地址，启用并设置默认部门与角色。
同步通讯录
把企微侧的部门与成员同步进来，平台按外部 ID 建立映射，已存在的部门不会重复创建，也不会覆盖平台已有的调整。
验证登录与权限
用真实员工账号走一遍登录，确认账号落到正确部门与角色，并只能看到该看的应用与数据。
配置群机器人触达
在企微群里添加群机器人并复制 Webhook 地址，在平台「消息中心」新增 Webhook 通道，绑定需要推送的事件，发一条测试消息确认。
试点 → 全量
先在一个部门或一个业务线跑一周，收集问题并调整，确认后再全面放开。
五、平台内怎么配
认证提供商的字段与钉钉一致，只是取值来源不同。
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| 标识 | 必填 | 企业内唯一，建议填 wecom；创建后不可修改 |
| 显示名称 | 必填 | 登录页上展示的名字，如「企业微信登录」 |
| 类型 | 必填 | 选择「企业微信」 |
| Client ID | 必填 | 企业微信的企业 ID（CorpID） |
| Client Secret | 必填 | 自建应用的 Secret，保存后不回显明文 |
| 回调地址 | 必填 | 需与企微后台配置的可信域名 / 授权回调保持一致 |
| 启用 | — | 关闭后登录页不再展示该入口 |
| 自动创建用户 | — | 开启后首次登录自动建号，建议开启 |
| 默认部门 | 开启自动建号时必填 | 新账号自动归入的部门，同时影响数据可见范围 |
| 默认角色 | 开启自动建号时必填 | 初始角色，建议先给最小权限再按需提权 |
| 扩展配置 | 选填 | JSON 格式的附加配置，用于特定场景的补充参数 |
消息通道配置
在「消息中心」新增通道时，类型选择 Webhook，填入企微群机器人地址即可。平台会把事件内容按模板发送到该群；需要发到多个群时，建多个通道分别绑定。
六、个人微信与企业微信的区别
这两个名字很像，但在技术上是两套完全不同的东西。放在一起讲清楚，避免买错东西。
| 对比项 | 个人微信 | 企业微信 |
|---|---|---|
| 面向对象 | 个人用户，任何人都有 | 企业内部员工，需要企业已开通企微 |
| 典型用途 | 外部客户、经销商、供应商扫码登录或自助填报 | 内部员工登录、组织管理、工作提醒 |
| 平台支持情况 | 已完整支持 扫码、回调、账号绑定、自动注册全链路 | 已支持 认证提供商、身份绑定、通讯录同步、自动建号 |
| 能否拿到组织架构 | 不能，个人微信没有企业组织概念 | 可以，通过通讯录权限同步部门与成员 |
| 适合的入口 | 对外门户、客户自助查询、外部人员上报 | 内部业务系统、员工待办、管理看板 |
一个常见组合：内部员工走企业微信登录，外部客户或经销商走个人微信扫码登录，两类人在平台里是不同的权限组，看到的是完全不同的数据。平台同时支持这两种身份绑定在同一个账号体系下。
七、状态与边界说明
现在就能用的
- 把企业微信配置为平台的认证提供商，并在登录页展示入口
- 企微身份与平台账号的绑定关系管理（支持一个账号绑多个第三方身份）
- 按
wecom来源同步部门与成员，外部 ID 自动映射 - 首次登录自动建号，落到指定默认部门与角色
- 个人微信扫码登录的完整链路（扫码、回调、绑定、自动注册）
- 通过 Webhook 通道把事件推送到企微群机器人
需要联调或尚未启用的
- 企微扫码免登完整链路：结合自建应用类型、可信域名与网页授权配置联调，先确认可行性再排期。
- 企微应用消息（原生）：尚未启用，当前用群机器人 Webhook 替代；对「提醒到人」这类需求，群机器人通常已够用。
- 工作台免登入口：把搭建客挂进企微工作台需要企微侧配合配置，按项目评估。
我们为什么把状态写在页面上
因为「能不能接」这个问题，答案往往取决于你的企微版本、应用类型和授权范围，而不是一句「支持」。把不确定的部分提前说清楚，项目推进才不会在交付阶段卡住。
八、常见问题
我们同时用钉钉和企业微信，能都接吗？
可以。平台支持配置多个认证提供商，一个账号也能同时绑定钉钉与微信身份。常见做法是按部门或业务线分别启用，避免员工在两个入口之间犹豫。
通讯录同步会把我平台上改过的部门覆盖掉吗？
不会整体覆盖。同步按外部 ID 逐条映射：能对上的更新，对不上的新建。但同步范围里的字段会以来源为准，所以建议先明确「哪些字段由企微说了算、哪些由平台维护」，并在测试部门验证一轮再全量同步。
客户也能用企微登录吗？
企业微信主要面向内部员工。如果要让外部客户或经销商登录，用个人微信扫码登录更合适，平台已完整支持这条链路。两者可以并存，权限分开控制。
提醒一定要建群机器人吗？能不能直接私聊推送？
企微原生应用消息（私聊推送）目前尚未启用，群机器人 Webhook 是当前可用的方式。它的特点是必须有一个群；如果希望提醒只对个人可见，可以先用平台的站内信 + 手机浏览器书签的方式，或者等应用消息能力上线。
私有化部署能接企微吗？
需要服务器能访问企业微信的开放接口。纯内网不出网的环境接不了企微的登录与同步，建议改用账号密码登录，触达走内网可访问的邮件或短信网关。
接入要多久？
企微侧应用与可信域名都就绪的情况下，平台侧的配置与验证通常当天可以完成。时间主要花在企微后台的权限申请与内部流程上。