本产品及文档完善中,如果有什么问题请联系我们:18721583683(同微信)或chaho@qq.com
ITILDesk 支持与飞书对接，实现飞书扫码登录、通讯录同步与消息卡片通知，工单动态以卡片形式直达员工飞书。
对接能力
| 序 号 | 能力 | 说明 |
|---|
| 1 | 扫码登录 | 员工使用飞书扫码登录 ITILDesk |
| 2 | 通讯录同步 | 同步飞书组织架构与成员到 ITILDesk |
| 3 | 消息卡片 | 工单各环节推送飞书消息卡片 |
| 4 | 身份关联 | 将飞书用户与企业内账号自动匹配 |
前置准备
| 序号 | 准备项 | 说明 |
|---|
| 1 | 飞书开放平台 | 具备应用创建与权限申请能力 |
| 2 | 应用凭证 | App ID、App Secret |
| 3 | 事件订阅参数 | Encrypt Key、Verification Token |
| 4 | 回调地址 | 事件订阅请求地址 |
配置步骤
| 序号 | 步骤 | 操作 |
|---|
| 1 | 创建应用 | 飞书开放平台 → 开发者后台 → 创建企业自建应用 |
| 2 | 获取凭证 | 应用凭证中获取 App ID 与 App Secret |
| 3 | 申请权限 | 申请通讯录读取、消息推送、登录等权限并发布版本 |
| 4 | 配置事件订阅 | 填写请求地址，配置 Encrypt Key 与 Verification Token |
| 5 | 进入配置页 | ITILDesk 系统设置 → 集成配置 → 飞书 |
| 6 | 填写凭证 | 填入 App ID、App Secret、Encrypt Key、Verification Token |
| 7 | 测试与启用 | 【测试连接】通过后，开启同步与消息卡片 |
配置项说明
| 序号 | 配置项 | 说明 |
|---|
| 1 | App ID | 飞书应用的唯一标识 |
| 2 | App Secret | 飞书应用密钥 |
| 3 | Encrypt Key | 事件订阅消息加密密钥 |
| 4 | Verification Token | 事件订阅校验令牌 |
| 5 | 事件订阅地址 | 平台生成的回调地址 |
| 6 | 消息卡片模板 | 工单通知卡片模板 |
验证方式
- 【测试连接】返回成功。
- 通讯录同步后成员出现在平台用户管理中。
- 员工使用飞书扫码可登录平台。
- 触发工单流转，员工飞书收到消息卡片。
注意事项
- 飞书应用需发布版本并通过权限审核后接口方可生效。
- 事件订阅的 Encrypt Key 与 Verification Token 需与飞书后台完全一致。
- 扫码登录需配置应用的安全设置（可信域名/IP 等）。
- 消息卡片支持模板定制，请按通知场景配置对应卡片。