集成钉钉工作消息通知 分享链接

最后编辑:王林 于 2021-11-02 13:51:30

禅道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的设置,绑定的用户就可以在钉钉里接收到禅道里与该用户相关的消息。

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

先知 50319