企业微信集成手册¶
场景¶
-
实现企业微信与平台租户日程信息的双向同步（会议室日程）；
-
实现企业微信与平台租户通讯录同步；
前置条件¶
-
企业微信管理员进行相关操作配置
-
需要创建自建应用并提供 CorpId(企业ID)，AgentID，Secret，EncodingAESKey，Token
-
需要提供会议室应用 RoomSecret
操作步骤¶
获取企业ID¶
- 管理员扫码登录企业微信后台
https://work.weixin.qq.com/wework_admin/loginpage_wx?from=myhome
- 登录后点击切换到【我的企业】页面
- 在最下方找到【企业ID】并复制保存
获取【会议室】密钥¶
- 登录企业微信后台后点击切换到【应用管理】界面，找到【会议室】应用并点击进入
- 在会议室应用详情界面，点击【API】下拉箭头-->【查看】获取会议室RoomSecret
创建自建应用¶
- 登录企业微信后台后点击切换到【应用管理】页面
- 在应用标签下，点击自建区域的【创建应用】，进入创建自建应用的界面
- 上传应用logo并填写应用名称等信息，点击【选择部门/成员】选择应用可见范围
注意：一般选择一级架构组织即可，选择后点击确认
- 应用信息填写完成后点击【创建应用】，进入应用的详情配置页面获取AgentID和Secret
注意：这里的AgentId和Secret即为自建应用的 ID和密钥，需要保存后续配置到智会办公平台。
- 在应用详情配置页面给自建应用配置企业可信IP
在应用详情配置页面最下方【开发者接口】中找到【企业可信IP】选项卡，点击【配置】按钮，进入配置页面
注意：新创建的自建应用需要先配置【设置接收消息服务器URL】然后才可以配置企业可信IP
- 点击【设置接收消息服务器URL】进入API接收消息设置页面
- 填写对应的服务器URL、Token和EncodingAESKey信息，其他保持默认状态即可
注意：
- 办公平台URL回调地址规则为，其中企业ID即为【我的企业】界面获取的企业ID
https://console.uniaio.com/v1.0/calendars/qywx/{企业ID}/callback
示例：如 企业ID如果为 CropXXXXX,则完整的回调URL为
https://console.uniaio.com/v1.0/calendars/qywx/CropXXXXX/callback
-
Token和EncodingAESKey可以通过随机获取生成
-
需要先将以上信息在智会办公平台对应组织--系统配置--通讯录配置中填写保存，企业微信URL通过校验后才能保存
-
此处回调地址、Token和EncodingAESKey和会议室回调配置中一致，只需要生成一次，其他地方复用就可以了
-
跳转管理后台填写相关配置等到后台完成企业微信通讯录配置后，点击【保存】按钮进行保存
- 填写服务器可信IP地址，点击【确定】按钮保存企业可信IP
智会办公平台默认服务器IP配置信息为 124.222.73.128;43.142.186.206，填入这两个IP后点击【确定】按钮完成配置。
配置企业微信通讯录¶
- 登录管理后台进入租户组织管理界面
- 点击【账户管理】-->【系统配置】-->【通讯录】进入通讯录配置页面
- 将获取到的企业微信配置信息填写到对应的表单中，然后点击【确定】按钮保存
相关固定值输入参数如下
企业微信URL前缀：https://qyapi.weixin.qq.com/
平台地址：https://console.uniaio.com/portal/index.html
小程序APPID：wxff8b23a8dd8cc735
- 跳转到企业微信自建应用继续配置企业可信IP
配置【会议室】回调地址¶
- 登录企业微信后台后点击切换到【应用管理】界面，找到【会议室】应用并点击进入
- 点击接收事件服务器【设置】按钮进入配置会议室回调配置接口页面
- 填写对应的服务器URL、Token和EncodingAESKey（复用自建应用配置）
注意：
-
此处的三个信息直接采用企业自建应用中【设置接收消息服务器URL】的三个信息
-
需要保证智会办公管理后台已经完成了企业微信相关配置
-
点击【保存】按钮完成回调配置
配置用户通讯录同步¶
- 登录管理后台进入租户组织管理界面
- 点击【账户管理】-->【系统配置】-->【通讯录】进入通讯录配置页面
- 点击【数据同步】按钮，同步企业通讯录数据
- 点击查看【用户管理】模块如果有企业微信数据说明通讯录同步成功
