企业微信配置

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

1 准备工作

(1) 在企业微信后台查询"企业ID"。配置消息通道时会用到这个字段。

在企业微信后台查询"企业ID"

(2) 在企业微信后台创建"自建应用"。EasySQLMAIL将使用这个应用来推送信息。

开始配置企业微信消息通道前，需要在企业微信后台创建一个"自建应用"，以后EasySQLMAIL会使用这个应用来进行消息推送。您也可以使用已有的"自建应用"来推送消息。

第一步：登录企业微信后台，在"应用管理"中创建一个"自建应用"。

在企业微信后台创建"自建应用"

第二步：为应用设置名称和图标，并设置应用的可见范围。

设置应用的信息

提示：每个应用只能发送消息给“应用可见范围”内的员工。

第三步：为应用设置可信IP。企业微信应用创建成功后，还需要把您的外网IP地址添加到企业微信的可信IP中。请 点击这里 查看可信IP的配置方法。

2 添加企业微信消息通道

点击控制台界面左侧菜单“企业微信消息通道管理”，然后点击“企业微信消息通道管理”界面上的“添加企业微信”按钮，并在对话框中输入企业微信的名称和企业微信的CorpID（也称为“企业ID”）。点击这里 查看如何查询"企业ID"。

添加企业微信消息通道

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

3 添加企业微信应用

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

第一步：在企业微信消息通道的"应用列表"中点击"添加企业号应用"按钮，打开"添加企业微信应用"对话框。

添加企业微信应用对话框

第二步：输入企业微信应用的AgentID、Secret。AgentID和Secret可以按如下方法查询：

(1) 登录企业微信后台管理界面，点击“应用管理”，在应用列表中找到要添加的应用：

(2) 点击要添加到EasySQLMAIL的应用的图标，打开应用详情页面。在详情页面中可以看到应用的AgentID。点击Secret项目后的“查看”按钮，企业微信会将应用的Secret发送到管理员的企业微信中。管理员将AgentID和Secret复制到EasySQLMAIL的配置对话框中即可。

第三步：输入AgentID和Secret后，点击“获取应用名称”按钮。系统将自动从企业微信平台将应用的名称读取到“应用名称”文本框中。

这里可以在“接收测试消息的用户账号”中输入一个用于接收测试消息的企业微信账号，并点击“测试”按钮，系统会通过指定的应用向此企业微信账号发送一条测试消息。收到测试消息就表明应用的配置已经正确。

输入测试员工的账号并发送测试消息

系统发送的测试消息

收到测试消息确认配置信息无误后，点击配置界面中的“确定”按钮，保存应用配置。这时系统会自动从企业微信平台读取企业微信的通信录信息到EasySQLMAIL中，后续配置任务时会用到这些信息。

系统从企业微信平台读取通信录到本地

上述配置完成后，EasySQLMAIL就可以通过企业微信推送信息了。

提示：每个应用只能发送消息给“应用可见范围”内的员工。“应用可见范围”可以在企业微信后台管理界面的应用配置中设置：

设置应用可见范围

4 添加企业微信群机器人

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

第一步：在企业微信中群中创建群机器人。打开企业微信电脑版，在要添加群机器人的群聊上点击右键，选择“添加群机器人”按钮。然后按向导提示进行即可。

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

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

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

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

群机器人收到的测试消息

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

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

选择群机器人作为收件人

注意：

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

（2） 企业微信群消息只能在企业微信客户端中查看，普通微信客户端中无法查看企业微信群消息。

（3） 通过群机器人发送企业微信群消息时，只能发送文字消息、markdown消息、图片(2M以内)或文件(不大于20M)。每分钟群消息发送量不能大于20条。

（4） 通过群机器人发送钉钉群消息时，只能发送文字和markdown消息。每分钟群消息发送量不能大于20条。

5 常见问题

(1) 读取应用名称或是在推送消息时出现"not allow to access from your ip"错误。例如像下面这样：

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