禅道从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、bearychat 

bearychat 是一个 团队内部沟通工具。在 www.bearychat.com 注册一个帐号，登录后进入【管理面板】页面。点击【机器人管理】菜单，进入机器人管理页面，点击【添加机器人】按钮，在【产品经理】标签页下选择【禅道】，按照提示操作即可创建一个禅道机器人。

在禅道中添加一个类型为【bearychat】的 webhook ，填入从 bearychat 禅道机器人配置中获取的 webhook 地址，即可从禅道发送消息到bearychat。

2、钉钉

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