钉钉消息通道配置

在推送消息到钉钉前，需要在系统中配置钉钉消息通道。EasySQLMAIL支持配置多个钉钉消息通道，并可以为每个消息通道配置多个应用，用于推送不同类型的信息。

1 准备工作

在开始配置钉钉消息通道前，需要先在钉钉后台创建于推送消息的应用。您也可以使用已有的应用来推送消息。

1.1 创建钉钉应用

第一步: 登录钉钉客户端。然后点击"工作台"菜单，然后点击"应用搭建"按钮。

添加钉钉应用

第二步: 选择应用类型。这里选择“将现有系统搬到钉钉工作台”。您也可以根据您的需求选择其它类型的应用。

选择应用类型

第三步: 输入应用名称和点击应用后要打开的网页地址，并选择应用的"授权使用范围"。输入完成后点击"添加"按钮。

输入应用信息

提示：这里的移动端链接和PC端链接可以输入您的公司的主页或是其它系统的网址。员工在钉钉客户端的"工作台"中点击此应用的图标后，钉钉会打开这个网址。

第四步: 登录钉钉后台，点击"工作台"->"应用管理"菜单。选择"自建应用"，找到刚刚创建的应用，点击应用右侧的"设置"按钮。

进入应用设置页面

第五步: 在应用设置页面中点击"去开发"按钮，打开钉钉开放平台的应用信息页面。

在应用设置页面中点击"去开发"按钮

第六步: 点击"权限管理"菜单。选择"权限范围"。您可以根据您的实际情况选择应用的权限范围。应用将可以读取此范围内的员工的信息。

选择"权限范围"

在下方的权限列表中为应用选择以下权限：

通信录管理：通讯录部门信息读权限、成员信息读权限、通讯录部门成员读权限。

应用管理：企业已安装的应用列表查询权限。

权限选择好后，点击"批量申请"按钮。

批量申请应用权限

第七步: 在"开发管理"菜单中将您的公网IP地址添加到应用的"服务器出口IP"中。

点击"开发管理"，然后点击"修改"按钮

在"服务器出口IP"中输入您的公网IP地址，点击"保存"按钮

第八步: 在"版本管理与发布"菜单发布应用。发布时要选择发布的范围。所选范围内的员工将能够在钉钉客户端的"工作台"中看到此应用。(默认是在“未分组应用”目录下)

发布应用

员工可以在钉钉客户端中看到此应用

1.2 查询应用的AgentID、AppKey和AppSecret

第一步: 登录钉钉后台。点击"工作台"->"应用管理"菜单，在应用列表中找到要配置的应用，点击应用右侧的"配置"按钮。

第二步: 在钉钉应用配置中，点击"去开发"按钮。

第三步: 点击"应用信息"菜单，在"应用凭证"中查询应用的AgentID、AppKey和AppSecret。后续在EasySQLMAIL中配置钉钉应用时会用到这三个字段的内容。

查询应用信息

注意：AgentID、AppKey和AppSecret是应用的调用密码，请妥善保管以防止泄密。

2 添加钉钉消息通道

点击控制台界面左侧菜单“钉钉消息通道管理”，然后点击“钉钉消息通道管理”界面上的“添加钉钉”按钮，并在对话框中输入钉钉企业名称。

添加钉钉消息通道

消息通道配置好后，还需要为消息通道添加应用或群机器人，才能够进行消息推送。

3 添加钉钉应用

EasySQLMAIL进行信息推送时，需要通过钉钉应用发送信息。管理员可以在系统中为一个钉钉消息通道配置多个应用，使用每个应用来推送不同的信息。

第一步：在钉钉消息通道的"应用列表"中点击"添加企业号应用"按钮，打开"添加钉钉应用"对话框。然后输入钉钉应用的AgentID、AppKey和AppSecret。AgentID、AppKey和AppSecret可以在钉钉后台查询。点击这里了解查询方法

"添加钉钉应用"对话框

第二步：点击“获取应用名称”按钮。系统将自动从钉钉平台将应用的名称读取到“应用名称”文本框中。

获取钉钉应用名称

第三步(可选)：发布测试消息。在"接收测试消息的用户账号"输入一个员工的钉钉账号，点击"测试"按钮。系统会通过这个应用向指定的员工发送一条测试消息。如果收到测试消息，表明应用的配置是正确的。

发送测试消息

钉钉收到的测试消息内容

第四步：点击"确定"保存应用的配置。保存成功后，系统会从钉钉平台读取应用可见范围内的部门和员工列表，在配置任务时您可以从列表中选择消息的收件人。

系统从钉钉平台读取员工和部门列表

配置任务时选择钉钉员工作为收件人

4 添加钉钉群机器人

EasySQLMAIL支持通过钉钉群机器人推送消息到钉钉群。具体配置方法如下：

第一步：在钉钉客户端中创建群机器人。打开钉钉电脑版，在要添加群机器人的群聊中点击"群设置"按钮。然后点击"机器人"菜单。

点击群聊中的"群设置"按钮

点击"机器人"菜单

点击"添加机器人"

点击"自定义机器人"

输入机器人名称，并选择机器人的"安全设置"

如果安全设置里选择了"加签"，还需要把加签复制出来，后面配置的时候会用到这个字段的内容。

第二步：群机器人创建完成后，将群机器人的Webhook复制出来，保存备用。

注意：Webhook中包含了群机器人的调用信息，请妥善保管以防泄密。

第三步：在EasySQLMAIL中添加群机器人配置。在EasySQLMAIL配置界面上的“钉钉属性“对话框的“群机器人”Tab页中点击“添加群机器人”按钮，打开添加群机器人对话框。

在这个对话框中输入群机器人名称和上一步中获取到的群机器的人Webhook地址。然后点击“测试”按钮，系统会通过群机器人发送一条测试消息到对应的群中。

发送测试消息到钉钉群

收到测试消息后，表明群机器人的配置已经正确，在添加群机器人对话框中点击“确定”按钮保存配置即可。

以后配置任务时，选择群机器作为任务的收件人即可把消息推送到指定的群里。

选择群机器人作为收件人

注意：

（1） 输入群机器人名称时建议在名称前加上“群机器人-xxx”字样，以便在后续选用时区分群机器人收件人和普通收件人。

（2） 目前只支持向钉钉群机器人推送文字消息和markdown消息，不能推送文件、图片消息。

（3） 每个机器人每分钟最多发送20条消息到群里，如果超过20条，会限流10分钟。

（4） 查询钉钉群机器人的错误信息请访问 https://open.dingtalk.com/document/orgapp/custom-robots-send-group-messages#6a8e23113eggw

5 常见问题

(1) 读取应用名称或是在推送消息时出现错误 "访问ip不在白名单之中，请参考FAQ：https://open.dingtalk.com/document/org-faq/app-faq,request ip=123.123.123.123 appKey(dingh38kqybgfqktptyi)(错误代码:60020)."。例如像下面这样：

这是由于您的外网IP地址没有添加到应用的"服务器出口IP"中。请将您的外网IP添加到应用的服务器出口IP中即可。点击这里 查看设置方法。