1. 安装禅道
1.1  选择适合您的安装方法
1.2  使用云禅道在线项目管理服务!
1.3  (推荐)windows用一键安装包安装
1.4  (推荐)linux用一键安装包
1.5  linux下用lampp集成包安装
1.6  使用源码包安装(MAC系统)
1.7  MAC下用XAMPP安装禅道
1.8  MAC下用XAMPP-VM安装禅道
1.9  禅道一键安装包里安装蝉知和ZDOO
1.10  禅道一键安装包里安装渠成软件
1.11  使用源码包安装(各系统通用)
1.12  宝塔面板安装禅道
1.13  华芸NAS在线安装
1.14  Centos7.4系统下安装httpd,mariadb,php7.2环境运行禅道
1.15  Centos8系统下安装httpd,mariadb,php7.2环境运行禅道
1.16  安装ioncube扩展
1.17  安装swoole扩展
1.18  Docker方式部署禅道
2. 禅道介绍
2.1  关于禅道项目管理软件
2.2  如何获得支持
2.3  关注我们
3. 升级禅道
3.1  选择和自己环境对应的升级方式
3.2  通过源代码方式升级(通用)
3.3  windows一键安装包的升级
3.4  linux一键安装包升级
4. 创建分组和用户
4.1  建立部门结构
4.2  添加一个用户帐号
4.3  批量维护帐号
4.4  设置分组,建立权限体系
5. 最简使用
5.1  使用禅道来进行项目任务管理
5.2  只使用禅道来做bug管理
5.3  只使用禅道来进行产品管理
5.4  个人使用禅道来做事务跟踪管理
6. 基本使用
6.1  禅道使用的基本流程和产品、研发、测试之间的三权分立
6.2  敏捷开发及scrum简介
6.3  禅道和scrum的对应关系
6.4  禅道的新手教程
6.5  创建第一个产品
6.6  添加第一个需求
6.7  开始第一个项目
6.8  确定项目要完成的需求列表
6.9  为需求分解任务
6.10  提交bug
6.11  视频教程:第一个演示项目
6.12  维护联系人
6.13  禅道的自定义功能
6.14  导入excel、csv参考文档
6.15  文档管理
6.16  工作方式的切换
6.17  操作获取积分功能
6.18  自定义必填项功能
6.19  如何排查产品、项目是否有访问权限
6.20  年度总结,工作内容统计一览表说明
7. 进阶使用
7.1. 使用流程
7.1.1  禅道使用流程图解
7.2. 个人管理
7.2.1  使用待办进行个人事务管理
7.2.2  关注需要自己处理的任务、需求、bug
7.2.3  通过我的档案查看或者修改个人信息
7.2.4  视频教程:禅道使用之个人篇
7.3. 产品经理篇
7.3.1  维护产品
7.3.2  维护产品线
7.3.3  创建和评审需求
7.3.4  变更和评审需求
7.3.5  需求的状态和研发阶段
7.3.6  需求的注意事项
7.3.7  维护产品模块
7.3.8  建立发布计划
7.3.9  建立发布
7.3.10  路线图
7.3.11  文档管理
7.3.12  主持产品会议
7.3.13  参与项目管理、演示和总结
7.3.14  需求的基本统计报表
7.3.15  视频教程:禅道使用之产品经理篇
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.5.1  参加项目计划会议,分解任务
7.5.2  领取任务,并每天更新任务
7.5.3  通过看板和树状图查看任务
7.5.4  创建版本
7.5.5  申请测试
7.5.6  解决bug
7.5.7  文档管理
7.5.8  确认bug
7.5.9  视频教程:禅道使用之开发团队篇
7.6. 测试团队篇
7.6.1  维护bug视图模块
7.6.2  提交bug
7.6.3  验证bug,关闭
7.6.4  激活bug
7.6.5  找到自己需要的bug
7.6.6  维护测试用例视图
7.6.7  创建测试用例
7.6.8  测试套件、报告和公共用例库的维护
7.6.9  管理测试版本
7.6.10  执行用例,提交Bug
7.6.11  查看报表统计
7.6.12  视频教程:禅道使用之测试团队篇
8. 维护配置
8.1. 维护禅道
8.1.1  初始化管理脚本
8.1.2  备份禅道
8.1.3  恢复删除的资源
8.1.4  如何更新燃尽图
8.1.5  一键安装包如何实现mysql异机连接
8.2. 配置禅道
8.2.1  设置是否允许匿名访问
8.2.2  如何配置email发信
8.2.3  禅道云发信
8.2.4  如何成为超级管理员
8.2.5  配置禅道系统为静态访问
8.2.6  去掉禅道访问地址中的zentao
8.2.7  linux一键安装包去掉禅道访问地址中的zentao
8.2.8  集成禅道和svn
8.2.9  集成禅道和git
8.2.10  在第三方应用中集成禅道
8.2.11  第三方应用配置免密登录禅道
8.2.12  第三方应用集成禅道客户端进行消息通知
8.2.13  集成webhook
8.2.14  集成ZDOO
8.2.15  客户端集成
8.2.16  禅道的翻译功能
8.2.17  浏览器通知的设置
8.2.18  集成钉钉工作消息通知
8.2.19  集成企业微信应用消息通知
8.2.20  集成飞书群机器人
8.2.21  集成飞书消息通知
8.2.22  集成版本库、集成Jenkins,并进行构建
8.2.23  解决一键安装包密码口令弱的问题
8.3. 性能优化
8.3.1  linux系统中配置session使用redis
9. 定制开发
9.1  二次开发机制
9.2  禅道的目录结构
9.3  找到要修改的文件
9.4  禅道的数据库结构
9.5  公用模块--common
9.6  如何登记菜单
9.7  如何登记权限
9.8  示例:如何修改禅道的语言提示?
9.9  示例:创建bug时可以设置优先级字段
9.10  使用在线扩展编辑器
9.11  二次开发编辑器和翻译功能限制使用说明
9.12  禅道项目管理软件打包规范1.1版本
10. 其他相关
10.1  禅道所使用到的第三方代码
10.2  禅道FAQ
10.3  如何帮助禅道项目
10.4  禅道商业服务
10.5  禅道项目的贡献者
10.6  历史修改记录
10.7  nginx反向代理禅道502 bad gateway错误

集成webhook

2017-10-27 10:46:56
刚哥
64860
最后编辑:王林 于 2021-11-02 13:51:30
分享链接
摘要:本文讲述如何在禅道中集成webhook。

禅道从9.6版本开始内置了集成webhook功能,可以在禅道内进行操作时发送 JSON 格式的数据到第三方hook地址,方便进行消息集成。下面介绍如何配置该功能。

一、配置

用超级管理员用户登录禅道,进入后台 => 通知 => webhook,点击【添加webhook】新增一个 webhook,如图:

名称hook 地址为必填项,其余为选填项,hook 地址从第三方获取。

发送方式为同步时,在禅道内进行操作之后立刻发送消息给 hook 地址。发送方式为异步时则需要打开 后台-计划任务 来定时发送。

关联产品关联项目为空时,对禅道内的所有操作都会发送给 hook 地址,否则只发送所选择的产品和项目相关的操作。

参数类型指发送的数据的属性,包括以下内容:


{
    "objectType": "",  //对象类型,可以为空
    "objectID": "",    //对象ID,可以为空
    "product": "",     //关联产品ID,可以为空
    "project": "",     //关联项目ID,可以为空
    "action": "",      //动作,可以为空
    "actor": "",       //操作者,可以为空
    "date": "",        //操作时间,可以为空
    "comment": "",     //备注,可以为空
    "text": ""         //操作内容,包含操作对象的url,必选。
}
触发动作指进行何种操作时,向设定的 hook 地址发送消息,如果全部为空则不会发送任何消息。对禅道二次开发有一定了解的同学可以通过扩展 zentao/module/webhook/config.php 文件来修改此项内容。

二、示例

1、钉钉

在钉钉中通过下图两种方式添加机器人,选择【自定义机器人】,按照提示操作。机器人添加完成后,在禅道中添加一个类型为【钉钉】的webhook,填入从钉钉机器人获取的 webhook 地址,即可发送消息到钉钉。钉钉的消息发送方式默认为同步发送,不能修改。目前钉钉对自定义机器人发送消息的频率做了限制,每分钟最多发送20条消息。




禅道11.7版本,把类型为 钉钉 改为 钉钉群通知机器人。为了适应钉钉群机器人的安全设置,在添加页面增加了密钥。

需要钉钉群主到钉钉里做设置。
下面我们具体介绍如何获取到钉钉群通知机器人的密钥。

1.1 钉钉群主登录钉钉桌面客户端,到群设置里,找到群机器人。




1.2  添加群机器人

点击添加群机器人,选择自定义类型。


目前钉钉群机器人支持自定义关键词、加签和IP地址(段)的安全设置。

禅道集成时,目前仅支持加签的方式,也就是把加签的安全设置的密钥复制,粘贴到禅道后台--通知--webhook的 钉钉群通知机器人类型的webhook的密钥栏里。


已添加的群机器人,在点击群机器人列表右侧的设置按钮,可以进如群机器人详情页面。

这样可以获取到webhook地址和加签安全设置的密钥。



2、企业微信

禅道11.7版本开始,webhook新增了企业微信类型。

可以和企业微信集成,禅道里的操作和消息可以发送到企业微信里。

2.1 添加“企业微信”类型的webhook

到禅道后台--通知--webhook里添加webhook,类型选择“企业微信”。

接下来,我们需要注册登录企业微信,获取webhook的地址。

获取“企业微信”的webhook地址,需要先登录 企业微信官网

注册企业微信,请按照要求填写企业基本信息和管理员信息。

注册登录成功后,可以到 我的企业 -- 权限管理 里根据使用需要设置其他的管理员信息。

因为webhook地址的获取,只能企业微信的管理员才能获取和查看到。

手机下载企业微信APP, 企业微信的管理员登录,到企业微信的基本信息里,通过点击“群机器人”,来查看到webhook地址。

把这个webhook地址复制,填写到禅道后台--通知--webhook,添加“企业微信”类型的webhook的地址栏,点击保存即可。

添加成功的“企业微信”类型的webhook。


2.2 “企业微信”类型webhook的使用

可以根据禅道后台--通知--设置里,webhook通知的设置,集成了企业微信后,可以在企业微信里查看到禅道里相关的操作信息。

登录企业微信时,会收到禅道里设置动作的消息通知。

可以查看到详细的操作信息。


评论列表
小李 2021-11-25 11:38:35
禅道所在服务器无法直接连接互联网, 但可通过代理服务器上网,禅道是否支持通过代理服务器推送消息到企业微信
于涛 2021-11-25 13:46:39 回复
集成企业微信的首要前提是需要保证禅道服务器和企业微信webhook服务器是相通的,这个是物理条件,如果可以通过代理的方式实现网络通信,那么就可以去做集成实现消息推送的:)
sing 2021-11-12 09:23:00
第三方wehook,错误CODE 120。怎么知道拼接URL
sing 2021-11-12 11:43:14 回复
补充下,是用群辉聊天软件chat。如何使用webhook。有经验可以分享下,多谢
禅道 - 闫敏 2021-11-12 17:12:51 回复
31 群有回复此问题
禅道返回的数据格式与 群辉chat 所需格式不同, 需要二次开发实现了
sing 2021-11-12 11:44:18 回复
{"error":{"code":120,"errors":{"name":"payload","reason":"required"}},"success":false}
禅道 - 闫敏 2021-11-12 17:12:31 回复
31 群有回复此问题
禅道返回的数据格式与 群辉chat 所需格式不同, 需要二次开发实现了
宋翠萍 2021-11-12 13:44:41 回复
可以添加下页面上方QQ,邀请进群后,截图看下钉钉配置页面咨询下。
黑肉 2021-11-10 15:48:04
请问webhook如何在飞书中@指派的人员呢?我们想在飞书机器人中同时显示缺陷所指派的人员。谢谢
禅道-Bee 2021-11-10 17:52:14 回复
后台-人员-编辑,给用户维护下手机号,然后再试试呢?
Dream、 2021-10-18 13:33:42
请问下@指派人员成功了,想加上@抄送人员能支持吗?
禅道 - 闫敏 2021-10-18 17:26:44 回复
目前这个功能禅道没有实现
如果有技术能力的话可以看下代码文档
http://www.zentao.net/book/zentaopmshelp/156.html
http://www.zentao.net/book/zentaopmshelp/225.html
https://www.zentao.net/publicclass/secondary-development-80237.html

或者联系群商务付费走定制开发流程呢
H。 2021-10-11 15:44:01
钉钉提醒的内容文字怎么修改呀
于涛 2021-10-11 16:52:51 回复
你好,目前集成钉钉通知后,消息推送的文字内容还不支持自定义呢:)
草坪 2021-08-30 09:47:55
你好,15版本的禅道,已经绑定了企微webhook,后台也已经绑定对应的联系人,bug提交也指定负责人了,怎么实现@该负责人呢?
禅道-Bee 2021-08-30 11:30:58 回复
企业微信这块目前还不支持@功能呢,可以先试试调整代码实现下。钉钉群通知目前可以@。
2021-08-18 15:39:20
配置钉钉后,提bug后未收到通知,错误信息:{"code":19002,"msg":"params error, msg_type need"},怎么解决?多谢~
王林 2021-08-18 17:10:36 回复
可以添加下页面上方QQ,邀请进群后,截图看下钉钉配置页面咨询下。
zz 2021-07-28 15:19:05
邮件和webhook配置好了,怎么进行使用禅道发邮件和钉钉
马超 2021-07-28 16:12:12 回复
禅道中邮件会给指派人和抄送人发送邮件,webhook 只能给指派人发送邮件,后台-通知-设置页面可以查看触发通知的动作。
如果还有其他疑问, 可以加一下左上角的商务联系方式,商务邀请进群后沟通。
zz 2021-07-27 18:35:32
hook 地址怎么获取
石洋洋 2021-07-28 11:18:56 回复
集成钉钉、企业微信、飞书的话hook地址都是从钉钉 企业微信 飞书的服务器上获取hook地址的,配置到禅道中后禅道会自动进行调用通知,可以多看一下当前文档的介绍,如果还有疑问可以加一下本网页最上方的QQ或者电话获取相应的协助。
陈兄 2021-06-22 11:27:18
飞书对接,怎么实现A提bug给B,@B目前,接收到的数据只有A,没有B,无法实现
{"action":"commented","actor":"chenxiong","comment":"2","date":"2021-06-22 11:20:04","objectID":"50","objectType":"bug","product":",1,","project":"1","text":"评论了Bug [#50"}
陈兄 2021-06-22 11:28:44 回复
飞书对接,怎么实现A提bug给B,A=chenxiong,接收到的数据只有A,没有B,无法实现,是否有参数可以识别B???
{"action":"commented","actor":"chenxiong","comment":"2","date":"2021-06-22 11:20:04","objectID":"50","objectType":"bug","product":",1,","project":"1","text":"评论了Bug [#50"}
禅道-Bee 2021-06-22 13:35:42 回复
现在禅道版本是什么版本,配置的飞书群机器人吗? 可以联系官网顶部商务QQ,邀请加入技术交流群沟通下,即时性会更好一些。
1/5
发表评论
评论通过审核后显示。