使用EasySQLMAIL发送阿里钉钉文字消息

无标题 1

1 概述

2 配置阿里钉钉消息通道

2.1 获取阿里钉钉的AppID和AppSecret

2.2 配置阿里钉钉消息通道

3 在数据发布任务中通过阿里钉钉发送消息给员工

4 在SQL语句中调用EasySQLMAIL接口发送钉钉文字消息

5 发送钉钉消息时需要注意的问题

 

1 概述

EasySQLMAIL1.0.1207.3版本开始提供了阿里钉钉文字消息的发送功能。您可以通过EasySQLAMIL将文字消息发送到阿里钉钉的微应用中,例如象下面这样:

阿里钉钉文字消息推送效果

在本文中,将向您介绍如何利用EasySQLMAIL来推送阿里钉钉文字消息。

2 配置阿里钉钉消息通道

2.1 获取阿里钉钉的AppID和AppSecret

在开始配置钉钉消息通道前,需要先查到您的阿里钉钉的AppID和AppSecret。查询的方法如下:

(1)登录阿里钉钉后台管理平台(https://oa.dingtalk.com),并进入的“工作台”页面。

(2)点击工作台下方“第三方应用”下的“应用开发”,打开“钉钉开放平台”页面。

点击“工作台”标签

找到要添加的应用,并点击应用的“设置”菜单

点击应用信息右侧的“查看详情”

(3)在应用详情中即可看到应用的AppID和AppSecret。

查询阿里钉钉的AppID和AppSecret

安全提示:应用的AppID和AppSecret是阿里钉钉的关键信息,相当于阿里钉钉应用的用户名和密码。请务必妥善保管您的AppID和AppSecret,防止因AppID和AppSecret泄露而给企业造成损失。

(4)在添加阿里钉钉时需要注意要在应用的“权限管理”中将“通讯录只读权限”赋给要使用的应用。

将“通讯录只读权限”赋给要使用的应用

2.2 配置阿里钉钉消息通道

点击EasySQLMAIL主界面左侧菜单中的“消息通道管理”->“钉钉消息通道配置”,打开阿里钉钉消息通道管理界面,并点击“添加钉钉消息通道”按钮。

钉钉消息通道管理界面

添加钉钉消息通道

输入钉钉消息通道信息并点击“确定”后,EasySQLMAIL会读取钉钉平台的员工信息和微应用信息,并将这些信息保存到EasySQLMAIL系统中。

3 在数据发布任务中通过阿里钉钉发送消息给员工

钉钉消息通道配置完成后,您可以在EasySQLMAIL的数据发布任务中推送文字消息给指定的员工。

(1)创建数据发布任务,并选择任务类型为“文字消息”。

创建高级任务

(2)选择消息的收件人。

任务类型选择为“文字消息”,并选择钉钉收件人

收件人选择好后,按照文字消息的设计方法设计任务即可。有任务配置的更多信息,请参见:EasySQLMAIL系统操作手册->任务管理

4 在SQL语句中调用EasySQLMAIL接口发送钉钉文字消息

在启用了EasySQLAMIL的“外部接口功能”后,您可以在您的SQL语句中调用EasySQLMAIL发送文字消息到阿里钉钉。具体方法如下:

(1)在EasySQLMAIL对应数据源的“外部接口功能”中启用“允许从该数据源上的接口表中发送企业微信或钉钉消息”选项,并选择允许从该数据源上调用的阿里钉钉微应用:

启用外部接口并选择发信应用

(2)在此数据源需要发送钉钉消息时执行SQL语句将要发送的消息插入到EasySQLMAIL的外部接口表,例如:

INSERT INTO easysqlmail_wx_intf(wx_app_id,content,to_user) VALUES(

14/*用于发信的应用ID,可在数据源外部接口设置界面中查到*/,

'您好,SQL语句已执行完毕。',/*要发送的消息内容*/

'manager304'/*收件人的阿里钉钉账号,可在“钉钉消息通道配置”的“成员查询”中看到*/);

EasySQLMAIL外部接口启用后,EasySQLMAIL会定期读取easysqlmail_wx_intf接口表并处理待发消息。

收件人收到的钉钉消息

5 发送钉钉消息时需要注意的问题

(1)给同一用户发相同内容消息一天仅允许一次,即同一天中相同的消息只能向同一员工发送一次,重复的消息将不会被发送给收件人,并且系统不会有错误提示。

(2)同一天中向同一用户发送消息不能超过500条。超出500条后的消息将不会被发送给收件人,并且系统不会有错误提示。

(3)如果通过自建的微应用发送消息,请在钉钉平台的微应用管理中明确设置应用的可见范围(不要选择“所有员工可见”选项)。如果要让微应用对所有员工都可见,可以将微应用的可见范围选择为阿里钉钉中的顶层部门。

文档最后更新时间:2019-07-01