本产品及文档完善中,如果有什么问题请联系我们:18721583683(同微信)或chaho@qq.com
ITILDesk 支持与企业微信对接，实现企业微信扫码登录、通讯录同步与应用消息通知，让工单通知直达员工的企业微信。
对接能力
| 序号 | 能力 | 说明 |
|---|
| 1 | 扫码登录 | 员工使用企业微信扫码登录 ITILDesk |
| 2 | 通讯录同步 | 同步企业微信组织架构与成员到 ITILDesk |
| 3 | 消息通知 | 工单产生、分派、处理、超时等环节推送应用消息 |
| 4 | 身份关联 | 将企业微信成员与企业内账号自动匹配 |
前置准备
| 序号 | 准备项 | 说明 |
|---|
| 1 | 企业微信管理后台 | 具备应用创建与通讯录 Secret 查看权限 |
| 2 | 应用凭证 | 企业 ID（CorpID）、应用 ID（AgentId）、应用 Secret |
| 3 | 通讯录 Secret | 通讯录同步所需的 Secret |
| 4 | 可信域名 | 扫码登录需配置可信域名（域名需备案并可公网访问） |
配 置步骤
| 序号 | 步骤 | 操作 |
|---|
| 1 | 创建自建应用 | 企业微信管理后台 → 应用管理 → 自建 → 创建应用，获取 AgentId 与 Secret |
| 2 | 配置可信域名 | 在应用设置中配置网页授权及 JS-SDK 可信域名 |
| 3 | 进入配置页 | ITILDesk 系统设置 → 集成配置 → 企业微信 |
| 4 | 填写凭证 | 填入企业 ID（CorpID）、AgentId、应用 Secret |
| 5 | 配置回调 | 将平台生成的回调 URL 填回企业微信应用（接收消息服务器配置） |
| 6 | 测试连通 | 点击【测试连接】验证凭证有效性 |
| 7 | 启用同步与通知 | 开启通讯录同步与消息通知开关，按需设置通知模板 |
配置项说明
| 序号 | 配置项 | 说明 |
|---|
| 1 | 企业 ID（CorpID） | 企业微信管理后台"我的企业"中获取 |
| 2 | 应用 ID（AgentId） | 自建应用的 AgentId |
| 3 | 应用 Secret | 自建应用的 Secret |
| 4 | 通讯录 Secret | 通讯录同步专用 Secret（需申请通讯录权限） |
| 5 | 可信域名 | 扫码登录与消息回调的域名 |
| 6 | 回调 URL | 平台生成的消息接收 URL |
| 7 | 通知模板 | 工单各环节消息文案模板 |
验证方式
- 【测试连接】返回成功，凭证有效。
- 通讯录同步后成员与部门出现在平台用户管理中。
- 员工使用企业微信扫码可登录平台。
- 触发一次工单流转，员工企业微信收到应用消息。
注意事项
- 通讯录 Secret 与应用 Secret 是不同权限，需分别申请。
- 可信域名需配置 HTTPS 证书，否则扫码与回调失败。
- 消息通知依赖应用可见范围，请将应用可见范围设为全员或目标部门。
- 回调 URL 变更后需同步更新企业微信侧配置。