禅道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的设置,绑定的用户就可以在钉钉里接收到禅道里与该用户相关的消息。
例如以下的工作通知。如果需要@到具体用户,可以在组织--用户页面编辑用户信息,将注册钉钉的手机号,填写到手机信息中。