禅道11.7版本开始,webhook支持集成钉钉工作消息通知。
在禅道后台--通知--webhook添加时,可以添加“钉钉工作消息通知”类型的webhook,之前“钉钉”类型的webhook改为“钉钉群通知机器人”。
下面我们来介绍“钉钉工作消息通知”类型的webhook的添加和使用。
添加页面,我们需要获取到钉钉AgentId,钉钉AppKey,钉钉AppSecret。
按照提示和要求填写应用的基本信息,带红色星号的都是必填项。
填写完成点击下一步即可。
应用确定创建完成后,下一步我们就可以直接进入到应用详情页,查看到应用凭证:AgentId、AppKey、AppSecret。
也可以从小程序页面,点击应用后再进入到应用详情页查看。
在小程序详情页中,切换到第二个标签“开发管理”,即可看到服务器出口IP的信息,点击右侧的修改按钮,即可进入编辑页面。
输入服务器出口IP,请填写禅道所在服务器的外网IP。且这个IP在钉钉的开放平台中,没有被使用过,一个应用对应一个IP。
填写完成后点击保存即可。
禅道后台--通知--webhook的“钉钉工作消息通知类型”的添加页面里。
需要特别提醒的是:创建“钉钉工作消息通知”类型的应用后,因为还需要同步和绑定用户。
把禅道用户和钉钉用户做绑定,需要到“权限管理”里开通通讯录只读权限,获取企业员工的通讯录数据的权限。
应用添加成功后,我们就可以具体的使用了。
首先,我们需要点击“绑定用户”按钮,进行用户的同步和关联。
需要特别提醒的是:钉钉中添加应用的人员设置中的开发人员需要有通讯录管理权限。
绑定用户页面:
例如以下的工作通知。如果需要@到具体用户,可以在组织--用户页面编辑用户信息,将注册钉钉的手机号,填写到手机信息中。
THE END