Question

禅道11.7版本开始，webhook支持集成钉钉工作消息通知。

这样在钉钉里，该用户就可以收到禅道里与自己相关的信息的工作通知，可以多一个渠道去通知用户禅道的信息动向。

在禅道后台--通知--webhook添加时，可以添加“钉钉工作消息通知”类型的webhook，之前“钉钉”类型的webhook改为“钉钉群通知机器人”。

下面我们来介绍“钉钉工作消息通知”类型的webhook的添加和使用。

一、“钉钉工作消息通知”类型的webhook的添加页面

添加页面，我们需要获取到钉钉AgentId，钉钉AppKey，钉钉AppSecret。

这些信息需要注册登录钉钉的开放平台，添加应用获取。

二、注册登录钉钉开放平台，创建应用

钉钉开发平台：https://open-dev.dingtalk.com。

2.1 创建应用

2.2 填写应用的基本信息

按照提示和要求填写应用的基本信息，带红色星号的都是必填项。

填写完成点击下一步即可。

2.3 获取钉钉AgentId，钉钉AppKey，钉钉AppSecret

应用确定创建完成后，下一步我们就可以直接进入到应用详情页，查看到应用凭证：AgentId、AppKey、AppSecret。

也可以从小程序页面，点击应用后再进入到应用详情页查看。

2.4 填写应用配置开发信息

在小程序详情页中，切换到第二个标签“开发管理”，即可看到服务器出口IP的信息，点击右侧的修改按钮，即可进入编辑页面。

输入服务器出口IP，请填写禅道所在服务器的外网IP。且这个IP在钉钉的开放平台中，没有被使用过，一个应用对应一个IP。

填写完成后点击保存即可。

三、在禅道中，输入钉钉的AgentId、AppKey和AppSecret

3.1 把钉钉AgentId，钉钉AppKey，钉钉AppSecret信息复制粘贴到禅道后台。

禅道后台--通知--webhook的“钉钉工作消息通知类型”的添加页面里。

3.2 同步和绑定用户

需要特别提醒的是：创建“钉钉工作消息通知”类型的应用后，因为还需要同步和绑定用户。

把禅道用户和钉钉用户做绑定，需要到“权限管理”里开通通讯录只读权限，获取企业员工的通讯录数据的权限。

权限管理页面中，默认勾选的范围是全部员工，如果只需要部分员工的，可以选择部分员工，点击授权部门右侧的添加按钮可进行选择。

四、钉钉工作消息通知的webhook的使用

应用添加成功后，我们就可以具体的使用了。

首先，我们需要点击“绑定用户”按钮，进行用户的同步和关联。

绑定用户之前，需要登录到钉钉（https://oa.dingtalk.com/contacts.htm），点击“通讯录管理”，录入公司部门及成员信息。

需要特别提醒的是：钉钉中添加应用的人员设置中的开发人员需要有通讯录管理权限。

绑定用户页面：

• 已绑定的用户不会显示到钉钉Userid列表里；
• 可以解除绑定的用户；
• 可以修改绑定的用户。

用户绑定成功后，根据禅道后台--通知--设置--webhook的设置，绑定的用户就可以在钉钉里接收到禅道里与该用户相关的消息。

例如以下的工作通知。如果需要@到具体用户，可以在组织--用户页面编辑用户信息，将注册钉钉的手机号，填写到手机信息中。