

- 1. 禅道介紹
- 1.1 关于禅道項目管理软件
- 1.2 如何獲得支持
- 1.3 各版本功能差異
- 1.4 關注我們
- 2. 安裝禅道
- 2.1. 環境搭建
- 2.1.1 搭建Ubuntu環境安裝禅道
- 2.1.2 搭建Centos環境安裝禅道
- 2.1.3 安裝PHP的ioncube擴展
- 2.2. 安裝禅道
- 2.2.1 選擇適合您的安裝方法
- 2.2.2 新版本禅道的安裝升級
- 2.2.3 Windows一鍵安裝包(新版)
- 2.2.4 Windows一鍵安裝包(舊版)
- 2.2.5 linux用一鍵安裝包(推薦)
- 2.2.6 使用源碼包安裝(各系統通用)
- 2.2.7 使用源碼包安裝(MAC系統)
- 2.2.8 基于禅道當前的一鍵安裝包(Windows和Linux)如何源碼安裝旗艦版禅道
- 2.2.9 渠成命令行安裝禅道
- 2.2.10 Docker和Kubernetes方式部署禅道
- 2.3 安裝PHP的LDAP擴展
- 2.4 在线安装雲禅道
- 2.5 安装 APCu扩展
- 2.6 安裝DuckDB引擎
- 2.7. 信創支持
- 2.7.1 OceanBase數據庫
- 2.8. 安装文檔协同服務
- 2.8.1 安装Windows协同服務
- 2.8.2 安装Linux协同服務
- 2.1. 環境搭建
- 3. 升級禅道
- 3.1. 升級禅道新版本
- 3.1.1 選擇和自己環境對應的升級方式
- 3.1.2 通過源代碼方式升級(通用)
- 3.1.3 windows一鍵安裝包的升級
- 3.1.4 linux一鍵安裝包升級
- 3.1.5 docker安裝禅道-升級禅道
- 3.1.6 舊版Docker鏡像升級說明
- 3.1.7 通過Roadrunner管理定時任務
- 3.2 如何安裝ioncube擴展
- 3.1. 升級禅道新版本
- 4. 維護配置
- 4.1. 維護禅道
- 4.1.1 初始化管理腳本
- 4.1.2 備份禅道
- 4.1.3 恢複刪除的資源
- 4.1.4 如何更新燃盡圖
- 4.1.5 一鍵安裝包如何實現mysql異機連接
- 4.1.6 linux一鍵安裝包配置https
- 4.1.7 禅道一鍵安裝包遷移/更新禅道一鍵安裝包
- 4.2. 配置禅道
- 4.2.1 設置是否允許匿名訪問
- 4.2.2 如何配置email發信
- 4.2.3 如何成爲超級管理員
- 4.2.4 配置禅道系統爲靜態訪問
- 4.2.5 去掉禅道訪問地址中的zentao
- 4.2.6 linux一键安装包去掉禅道訪問地址中的zentao
- 4.2.7 集成禅道和svn
- 4.2.8 集成禅道和git
- 4.2.9 在第三方應用中集成禅道
- 4.2.10 第三方應用配置免密登錄禅道
- 4.2.11 第三方應用集成禅道客戶端進行消息通知
- 4.2.12 集成webhook
- 4.2.13 集成ZDOO
- 4.2.14 客戶端集成
- 4.2.15 浏覽器通知的設置
- 4.2.16 集成釘釘工作消息通知
- 4.2.17 集成企業微信應用消息通知
- 4.2.18 集成企業微信群機器人
- 4.2.19 集成飛書群機器人
- 4.2.20 集成飛書消息通知
- 4.2.21 解決一鍵安裝包密碼口令弱的問題
- 4.3. 性能優化
- 4.3.1 nginx反向代理禅道502或504bad gateway错误
- 4.3.2 linux系統中配置session使用redis
- 4.3.3 緩存功能
- 4.1. 維護禅道
- 5. 快速入門
- 5.1. 新版本快速入門
- 5.1.1 20版本禅道的新增功能
- 5.1.2 新版本禅道的最簡使用
- 5.1.3 20版本禅道的界面變化
- 5.1. 新版本快速入門
- 6. 按照角色使用
- 6.1. 管理員
- 6.2. 項目集負責人
- 6.3. 産品经理
- 6.3.1 維護模塊
- 6.3.2 産品多分支/平台管理
- 6.3.3 維護計劃
- 6.3.4 維護需求
- 7.4.5 需求的狀態和研發階段
- 6.3.6 創建發布
- 6.3.7 跟蹤進度
- 6.3.8 反饋管理(企业版)
- 6.4. 項目經理
- 6.5. 研發人員
- 6.5.1 参加産品计划會議,分解任务
- 6.5.2 領取任務,並每天更新任務
- 6.5.3 創建構建,提交測試
- 6.5.4 確認Bug,解決Bug
- 6.5.5 執行的綜合、需求、Bug、任務看板
- 6.6. 測試人員
- 7. 功能介紹
- 7.1. 核心管理結構
- 7.1.1 項目集(Program)
- 7.1.2 項目(Project)
- 7.1.3 産品(Product)
- 7.1.4 執行(Execution)
- 7.1.5 管理模型
- 7.2. 地盤
- 7.3. 項目集
- 7.4. 産品
- 7.4.1 创建産品
- 7.4.2 維護模塊
- 7.4.3 産品多分支/平台管理
- 7.4.4 維護計劃
- 7.4.5 維護需求
- 7.4.6 需求的評審
- 7.4.7 需求的狀態和研發階段
- 7.4.8 創建發布
- 7.4.9 跟蹤進度
- 7.4.10 業務需求&需求多層級
- 7.5. 項目
- 7.6. 執行
- 7.6.1 参加産品计划會議,分解任务
- 7.6.2 領取任務,並每天更新任務
- 7.6.3 創建構建,提交測試
- 7.6.4 確認Bug,解決Bug
- 7.6.5 執行的綜合、需求、Bug、任務看板
- 7.7. 測試
- 7.8. 自動化測試
- 7.9 DevOps(解決方案)
- 7.10. 文檔
- 7.11. AI
- 7.11.1 AI小程序簡介
- 7.11.2 創建與設計AI小程序
- 7.11.3 發布與禁用小程序
- 7.11.4 調試AI小程序
- 7.11.5 前台小程序的應用
- 7.11.6 AI小程序的導入導出
- 7.11.7 管理AI小程序權限
- 7.12. BI
- 7.12.1 維度(企業版8.4+)
- 7.12.2 大屏(企業版8.4+)
- 7.12.3 透視表
- 7.12.4 透視表下钻
- 7.12.5. 大屏設計器
- 7.12.5.1 大屏設計器界面布局
- 7.12.5.2 大屏設計器引用圖表
- 7.12.5.3 大屏设计器引用透視表
- 7.12.6 圖表
- 7.12.7. 度量項
- 7.12.7.1 查看度量項
- 7.12.7.2 創建度量項
- 7.12.7.3 度量項編碼開發操作手冊
- 7.12.8 數據表(企業版8.4+)
- 7.13. 反饋
- 7.14. 看板
- 7.14.1 通用看板功能
- 7.15. 工作流
- 7.16. 學堂
- 7.17. 資産庫(旗艦版)
- 7.17.1 資産庫管理(旗舰版)
- 7.18. 組織
- 7.18.1 團隊成員和工作信息
- 7.18.2 人力資源日曆(需安裝插件)
- 7.18.3 组织動態
- 7.18.4 公司信息
- 7.19. 辦公
- 7.20. 後台設置
- 7.20.1 後台首頁
- 7.20.2. 系統設置
- 7.20.3 功能開關
- 7.20.4. 人員管理
- 7.20.5. 模型配置
- 7.20.6. 功能配置
- 7.20.7 文檔模板
- 7.20.8. 通知設置
- 7.20.9 插件管理
- 7.20.10 二次開發
- 7.20.11 Jira數據導入
- 7.20.12 Jira數據導入--数据迁移说明
- 7.20.13 Confluence數據導入
- 7.20.14. 權限維護和控制
- 7.20.14.1 項目集的權限維護和訪問控制
- 7.20.14.2 産品的权限维护和访问控制
- 7.20.14.3 項目的權限維護和訪問控制
- 7.20.14.4 執行的权限维护和访问控制
- 7.20.14.5 项目和執行的访问控制和数据关系
- 7.20.15. AI配置
- 7.20.16. DevOps設置
- 7.20.16.1. 資源
- 7.21. 客户端增强版會議SRS
- 7.21.1. 音視頻會議配置
- 7.21.1.1 安装音視頻服務端
- 7.21.1.2 安装SRS音視頻服務端
- 7.21.1.3 开启和配置音視頻功能
- 7.21.2. 发起會議
- 7.21.2.1 一对一会话中发起音視頻會議
- 7.21.2.2 群组会话中发起音視頻會議
- 7.21.2.3 独立发起音視頻會議入口
- 7.21.3. 加入會議
- 7.21.3.1 分享音視頻會議到会话
- 7.21.3.2 通过會議的ID加入會議
- 7.21.4. 预约會議
- 7.21.4.1 预约會議
- 7.21.5. 會議应用
- 7.21.5.1 音視頻會議应用
- 7.21.1. 音視頻會議配置
- 7.22. 客户端增强版會議Jitsi
- 7.1. 核心管理結構
- 8. AI插件
- 8.1 AI插件安裝
- 8.2 ZAI服務安装
- 8.3 AI插件功能使用
- 8.4 ZAI服務控制面板使用
- 9. 其他相關
- 9.1. 其他
- 9.1.1 禅道所使用到的第三方代碼
- 9.1.2 禅道FAQ
- 9.1.3 如何幫助禅道项目
- 9.1.4 禅道商业服務
- 9.1.5 禅道項目的貢獻者
- 9.1.6 曆史修改記錄
- 9.1.7 禅道對象名稱的重名規則
- 9.1. 其他
- 10. IPD版本功能介紹
- 10.1. 禅道IPD版介紹
- 10.1.1 關于禅道IPD版
- 10.1.2 禅道IPD版的核心流程
- 10.2. IPD版的安裝和升級
- 10.2.1 選擇適合您的安裝方法
- 10.2.2 選擇適合您的升級方法
- 10.3. 需求与市場管理界面
- 10.4. IPD研發管理界面
- 10.1. 禅道IPD版介紹
webhook 分享鏈接 /book/zentaopms/996.html?releaseID=21
本篇目錄
禅道集成了Webhook功能,可以通过发送 JSON 格式的数据到第三方hook地址,进行消息集成,包括钉钉、企业微信以及飞书。下面介绍如何配置该功能。
1. 配置Webhook
点击“后台”-“通知設置”-“Webhook”。
禅道內置了多種類型選項,根據不同的選項填寫不同的信息。
注:
- 名稱:必填項
- Hook地址:必填項,從第三方獲取。
- 发送方式:同步意味着在禅道内进行操作之后会立刻发送消息给 hook 地址。异步需要在“后台”-“系统”-“定時”下設置定時发送任务。
- 关联産品:空意味着对禅道内的所有操作都会发送给 hook 地址,否则只发送所选择的産品相关的操作。
- 关联執行:空意味着对禅道内的所有操作都会发送给 hook 地址,否则只发送所选择的執行相关的操作。
- 触发动作:指的是进行某种操作时,向设定的 hook 地址发送消息。可以在“后台”-“通知”-“設置”中設置。如果你了解基于禅道的二次開發,可以通过扩展 zentao/module/webhook/config.php 文件来修改此项内容。
- 參數類型:發送的數據的屬性,包括
{ "objectType": "", //对象类型,可以为空 "objectID": "", //对象ID,可以为空 "product": "", //关联産品ID,可以为空 "project": "", //关联執行ID,可以为空 "action": "", //动作,可以为空 "actor": "", //操作者,可以为空 "date": "", //操作时间,可以为空 "comment": "", //备注,可以为空 "text": "" //操作内容,包含操作对象的url,必选。 }
2. 配置钉钉群通知机器人
2.1 创建钉钉机器人
在钉钉中,点击“群設置”-“智能群助手”-“添加机器人”。
选择“自定义”,通过Webhook接入自定义服務。
點擊“添加”。
在安全設置下,勾选“加签”。
禅道目前僅支持加簽的方式。在禅道內添加釘釘群通知機器人類型的webhook時,把這裏的密鑰複制,粘貼到禅道“後台"-"通知"-"webhook"的釘釘群通知機器人類型的webhook的密鑰欄裏。
點擊“完成”,得到一個Webhook的地址。

2.2 配置机器人Webhook
机器人添加完成后,在禅道中添加一个类型为“钉钉群通知机器人”的webhook,填入从钉钉机器人获取的密钥和webhook 地址,即可发送消息到钉钉。
注:
- 釘釘的消息發送方式默認爲同步發送,不能修改。
- 目前釘釘對自定義機器人發送消息的頻率做了限制,每分鍾最多發送20條消息。
3. 配置钉钉工作消息通知
3.1 创建钉钉应用
在釘釘開放平台注冊,點擊“應用開發”-“企業內部開發”-“小程序”-“創建應用”。
填上應用名稱、描述等,點擊“確認創建”。自動返回應用的“基礎信息”頁面,獲得應用的ID、Key和Secret。
点击“开发管理”,输入服務器出口IP。填写禅道所在服務器的外网IP。这个IP在钉钉的开放平台中,没有被使用过。一个应用对应一个IP。
3.2 配置Webhook
選擇“釘釘工作消息通知類型”作爲所添加Webhook的類型,將上圖中的釘釘AgentId、釘釘AppKey和釘釘AppSecret填入相應的位置。
3.3 同步和绑定用戶
创建“钉钉工作消息通知”类型的应用后,还需要同步和绑定用戶。点击“权限管理”-“通知接口数据”,获取企业员工的通讯录数据的权限。

默认权限范围是“全部员工”。如果只需要部分员工的,可以点击“授權部门”右侧的添加按钮可进行选择。
點擊“通訊錄管理”,錄入公司部門及成員信息。
注:钉钉中添加应用的人员設置中的开发人员需要有通讯录管理权限。
然后,去禅道中点击“绑定用戶”按钮,进行用戶的同步和关联。
绑定用戶页面:
- 已绑定的用戶不会显示到钉钉Userid列表里;
- 可以解除绑定的用戶;
- 可以修改绑定的用戶。

用戶绑定成功后,根据禅道“后台”-“通知”-“設置”,绑定的用戶就可以在钉钉里接收到禅道里与该用戶相关的消息。
4. 配置企业微信群机器人
4.1 添加企业微信机器人
在手機端群聊中,點擊右上角團隊按鈕。
點擊“群機器人”。
填写机器人名称。點擊“添加”。
成功添加後會産生一個Webhook地址。將該地址發送給禅道系統管理員進行配置。
4.2 在禅道中配置机器人
在禅道中添加類型爲“企業微信群機器人”的Webhook。將機器人的Webhook地址填寫進去。
注:Webhook的触发条件需要在“后台”-“通知設置”-“設置”中勾选。
5. 配置企业微信应用消息
5.1 创建企业微信应用
創建企業微信賬戶,點擊“應用管理”-“創建應用”。
填寫應用名稱,選擇可見範圍。
"可见范围"是企业的部门和成员。在禅道中,可以将可见范围内的用戶設置为“绑定消息通知”(详情见 5.3 绑定用戶)。可以选定部门或指定用戶。选择部门后,会包含部门下所有用戶。上级部门会包含子部门中的所有用戶。也可指定某个用戶。
創建成功後,可以查看在禅道中添加Webhook時需要用到的該應用的Secret。
5.2 配置Webhook
在禅道的“添加Webhook"頁面,選擇“企業微信應用消息”爲類型,填上企業ID(企業微信管理員在“我的企業”頁面可以找到)以及上文截圖中企業密鑰(Secret)和應用ID(AgentId)。
點擊“保存”。可以在Webhook列表中看到剛添加的Webhook。
5.3 绑定用戶
添加Webhook后,需要绑定将禅道中的用戶与企业微信中的用戶进行绑定。绑定后,禅道相关操作的动作将会以应用消息方式发送给企业微信用戶。
点击操作按钮中的"绑定用戶",进入绑定用戶页面。选择要绑定的用戶,点击“操作”。出现一个弹窗,在下拉菜单中会出现企业微信中的用戶。选择相应的用戶,点击“保存”。
可以看到在列表中绑定了微信用戶。
绑定用戶在企业微信中就可以收到禅道内各种操作的提醒啦。
6. 配置飞书工作消息通知
6.1 创建应用
需要在飛書開放平台(https://open.feishu.cn/)上創建應用。
点击“确定创建”后,可以开始对其进行設置。
6.2 启用机器人
点击应用名称进入設置页面。点击“机器人”-“启用机器人”。
6.3 权限管理
在“权限管理”中,将“用戶”、“消息”和“通讯录”权限都加上。
6.4 版本管理与发布
在“版本管理与发布”中,创建应用的版本。将“可用性状态”設置为“全部成员”。
點擊“確認”,可以看到該應用處于“待申請”狀態。點擊“申請發布”。
6.5 审核版本
管理員會在飛書中收到審核提醒。
點擊“去審核”-“通過”。
6.6 添加禅道Webhook
在飞书内该应用的“凭证与基础信息”获得的APP ID和APP Secret。
填入禅道中的相應位置。
点击“保存”后,在进行“用戶绑定”。
設置完成后就可以在飞书里,接收禅道的消息提醒啦。
7. 配置飞书群通知机器人
在飞书中,也可以設置群通知机器人。选中一个群聊,点击右侧“設置”按钮。
點擊“群機器人”,然後添加“自定義機器人”。
填寫必要信息。
複制機器人”webhook地址"和“簽名校驗”。
點擊“完成”。在禅道中配置該機器人。將剛才複制的”webhook地址"和“簽名校驗”分別填入相應的位置。
飛書群通知機器人就添加完成啦。
-
禅道産品
禅道開源版 禅道企業版 禅道旗艦版 禅道IPD版 -
核心功能
産品管理 項目管理 質量管理 效能管理 -
使用文檔
基本版手冊 企業版手冊 旗艦版手冊 IPD版手冊 開發中心手冊 -
幫助中心
积分問答 常見問題 論壇交流 使用視頻 Gitee GitHub -
關于我們
關于我們 禅道軟件 最新動態 禅道活動 -
禅道社區
禅道博客 積分排行 積分商城 禅道書院 -
聯系方式
聯系人:魏中顯 電話:18561939726 微信:18561939726 Q Q:1746749398北京、上海、深圳分部