如何使用禅道集成钉钉

摘要：禅道的Webhook功能支持集成钉钉，可以通过发送JSON格式的数据到第三方Hook地址，与钉钉进行集成，让团队间的沟通与协作更加顺畅，消息接收更及时。

对于研发企业来说，坚持精细、特色、专业的项目管理方案，是其在行业竞争中成功突围的关键。在企业引入项目管理软件对项目实施全面、科学管理的过程中，项目管理工具能否帮助企业统筹管理整个项目团队的人、事、物，最终为用户带去更超值的服务体验，帮助提升企业竞争力。

禅道是一款功能强大的项目管理软件，它能够完整覆盖项目的全生命周期，为企业提供端到端的数字化项目管理解决方案。同时禅道作为一款开源软件，拥有强大扩展机制，能够为用户提供丰富插件并且可以集成多种工具，禅道可以很好地实现与企业IM间的互联互通，破解长期困扰用户的企业IM与项目管理软件间的数据孤岛问题，大大提高团队沟通的效率。

那么，禅道是否可以集成钉钉，并配置钉钉群通知机器人呢？是否可以实现通过钉钉扫码登录禅道？是否可以通过钉钉接收禅道的工作消息呢？

答案是肯定的，禅道的Webhook功能支持集成钉钉，可以通过发送JSON格式的数据到第三方Hook地址，与钉钉进行集成。禅道与钉钉成功集成后，禅道的消息通知、任务进展、项目进度、任务指派等通知都会同步推送到钉钉，通过禅道集成钉钉，还可实现钉钉扫码登录禅道，并可配置钉钉群通知机器人等多种功能，让团队间的沟通与协作更加顺畅，消息接收更及时。

下面我们就来具体介绍如何在禅道内集成钉钉，并通过配置钉钉接收来自禅道的消息、通知，实现从钉钉扫码免密登录禅道。

一、禅道集成钉钉——配置钉钉群通知机器人

配置禅道钉钉机器人，首先我们先要在禅道中添加Webhook，禅道中通过“后台——通知——Webhook——添加Webhook”，选择添加“钉钉群通知机器人”类型的Webhook。

接下来，登录钉钉，在钉钉中点击群设置——智能群助手——添加机器人。

选择自定义选项

点击“添加”选项。

输入需要添加的机器人的名称，选择需要添加的群组，并在安全设置一栏，勾选“加签”。

点击“完成”，会得到一个钉钉的Webhook地址。

我们需要将这个地址在禅道中进行Webhook配置。复制粘贴到禅道中“Webhook的钉钉群通知机器人”选项中的Hook地址和密钥栏里，成功保存后，即可在钉钉中接收禅道通知。

这里需要注意的是，禅道集成Webhook中钉钉的消息发送方式默认为同步发送，不能修改。并且钉钉对自定义机器人发送消息的频率做了限制，每分钟最多发送20条消息。

二、禅道钉钉集成——配置钉钉工作消息通知

接下来我们来介绍如何在钉钉上接收禅道的工作消息通知。

想要实现钉钉工作消息通知功能，需要登录钉钉开放平台注册，创建钉钉应用，点击“应用开发”——“企业内部开发”——“小程序”——“创建应用”点击“添加”。

填写应用名称、描述等，点击“确认创建”。自动返回应用的“基础信息”页面，获得应用的ID、Key和Secret。获取钉钉AgentId，钉钉AppKey，钉钉AppSecret。

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

点击“开发管理”，输入服务器出口IP，填写禅道所在服务器的外网IP，需要特别提醒的是，这个IP在钉钉的开放平台中，没有被使用过，一个应用对应一个IP。

接着登录禅道，通过“后台——通知——Webhook——添加Webhook”路径，选择“钉钉工作消息通知”作为所添加Webhook的类型，将之前得到的钉钉AgentId、钉钉AppKey和钉钉AppSecret按页面要求填入相应的位置，钉钉工作消息通知配置完成。

三、禅道钉钉集成——钉钉接收禅道消息提醒

成功创建“钉钉工作消息通知”的应用后，还需要同步和绑定用户才能实现在钉钉中接收禅道信息提醒。需要在禅道创建“钉钉工作消息通知”类型的应用后，点击“权限管理”——“通知接口数据”，获取企业员工的通讯录数据的权限。

禅道的钉钉工作消息通知，默认权限范围是“全部员工”。如果只需要部分员工的，可以点击“授权部门”右侧的添加按钮可进行选择。

点击“通讯录管理”，录入公司部门及成员信息。然后，在禅道中点击“绑定用户”按钮，进行用户的同步和关联。

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

四、禅道钉钉集成——禅道钉钉扫码登陆

完成配置“钉钉工作消息通知”后就可以通过登录钉钉实现禅道免密登录，成功登录后用户可在钉钉上轻松查看禅道动态，不遗漏禅道的任何工作通知和任务指派。

五、禅道集成钉钉发送消息插件

除了禅道软件自带的Webhook钉钉集成外，禅道团队还推出了禅道集成钉钉发送消息插件。

通过安装该插件，用户可以发送钉钉消息给审核人员及抄送的成员。此插件是针对拥有钉钉微应用用户，需要有钉钉微应用ID，与禅道官方Webhook不冲突且互补。成功配置钉钉消息通知后并安装此插件，可以实现，创建需求、任务、Bug的时候将正文标题发送给审核人员以及抄送的成员，在钉钉中点击链接就可以跳转到禅道的待办页面。