企业微信全套集成指南
本文介绍如何在专属集成平台完成企业微信的全套集成配置，实现通讯录同步、认证源配置、单点登录和消息推送。
概述
| 场景 | 说明 | 配置位置 |
|---|---|---|
| 通讯录集成 | 将企业微信用户同步到专属集成平台 | 用户中心 > 通讯录集成 |
| 认证源配置 | 使用企业微信账 号登录专属集成平台 | 用户中心 > 认证源管理 |
| 单点登录 | 通过企业微信实现应用 SSO | 应用中心 > 应用管理 |
| 消息推送 | 向企业微信发送通知消息 | 参数配置 > 企业消息配置 |
前提条件
第一部分：企业微信开放平台配置
步骤 1.1：创建企业微信应用
步骤 1.2：获取应用凭证
1.
2.
3.
AgentId：应用的唯一标识AgentSecret：应用的身份密钥4.
步骤 1.3：配置应用权限
1.
2.
步骤 1.4：配置可信域名
1.
2.
3.
第二部分：通讯录集成配置
步骤 2.1：创建通讯录集成任务
1.
2.
3.
4.
5.
步骤 2.2：配置字段映射
1.
2.
| 企业微信字段 | 平台字段 | 映射方式 |
|---|---|---|
| userid | username | 创建且更新 |
| name | display_name | 创建且更新 |
| mobile | phone_number | 创建且更新 |
| 创建且更新 | ||
| department | department | 创建且更新 |
3.
步骤 2.3：配置同步策略
1.
2.
3.
步骤 2.4：验证同步结果
1.
2.
3.
4.
第三部分：认证源配置
步骤 3.1：创建企业微信认证源
1.
2.
3.
4.
5.
步骤 3.2：配置账号关联
1.
2.
3.
4.
步骤 3.3：测试认证
1.
2.
3.
4.
5.
第四部分：单点登录配置
步骤 4.1：创建 SSO 应用
1.
2.
3.
4.
步骤 4.2：启用 SSO
1.
2.
3.
4.
步骤 4.3：配置应用权限
1.
2.
3.
步骤 4.4：测试 SSO
1.
2.
3.
4.
第五部分：消息推送配置
步骤 5.1：配置企业消息
1.
2.
3.
4.
5.
步骤 5.2：配置消息模板
1.
2.
3.
步骤 5.3：测试消息发送
1.
2.
3.
4.
验证清单
| 验证项 | 验证方法 | 预期结果 |
|---|---|---|
| 企业微信用户同步 | 查看用户列表 | 用户来自企业微信 |
| 企业微信账号登录 | 使用企业微信账号登录 | 登录成功 |
| 应用 SSO | 从应用发起企业微信登录 | 跳转并登录成功 |
| 消息推送 | 触发密码修改等事件 | 企业微信收到通知 |
常见问题
Q1：企业微信自建应用有什么限制？
Q2：OAuth2 和 OIDC 协议哪个好？
Q3：消息推送收不到怎么排查？
1.
2.
3.
4.
相关文档
| 文档 | 说明 |
|---|---|
| 通讯录集成-企业微信 | 通讯录集成详细配置 |
| 认证源-企业微信 | 认证源详细配置 |
| 单点登录配置 | SSO详细配置 |
| 企业消息配置 | 消息推送配置 |
修改于 2026-05-07 02:19:05