使用EasySQLMAIL发送阿里钉钉文字消息
4 在SQL语句中调用EasySQLMAIL接口发送钉钉文字消息
EasySQLMAIL1.0.1207.3版本开始提供了阿里钉钉文字消息的发送功能。您可以通过EasySQLAMIL将文字消息发送到阿里钉钉的微应用中，例如象下面这样：
阿里钉钉文字消息推送效果
在本文中，将向您介绍如何利用EasySQLMAIL来推送阿里钉钉文字消息。
在开始配置钉钉消息通道前，需要先查到您的阿里钉钉的AppID和AppSecret。查询的方法如下：
（1）登录阿里钉钉后台管理平台（https://oa.dingtalk.com），并进入的“工作台”页面。
（2）点击工作台下方“第三方应用”下的“应用开发”，打开“钉钉开放平台”页面。
点击“工作台”标签
找到要添加的应用，并点击应用的“设置”菜单
点击应用信息右侧的“查看详情”
（3）在应用详情中即可看到应用的AppID和AppSecret。
查询阿里钉钉的AppID和AppSecret
安全提示：应用的AppID和AppSecret是阿里钉钉的关键信息，相当于阿里钉钉应用的用户名和密码。请务必妥善保管您的AppID和AppSecret，防止因AppID和AppSecret泄露而给企业造成损失。
（4）在添加阿里钉钉时需要注意要在应用的“权限管理”中将“通讯录只读权限”赋给要使用的应用。
将“通讯录只读权限”赋给要使用的应用
点击EasySQLMAIL主界面左侧菜单中的“消息通道管理”->“钉钉消息通道配置”，打开阿里钉钉消息通道管理界面，并点击“添加钉钉消息通道”按钮。
钉钉消息通道管理界面
添加钉钉消息通道
输入钉钉消息通道信息并点击“确定”后，EasySQLMAIL会读取钉钉平台的员工信息和微应用信息，并将这些信息保存到EasySQLMAIL系统中。
钉钉消息通道配置完成后，您可以在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接口表并处理待发消息。
收件人收到的钉钉消息
（1）给同一用户发相同内容消息一天仅允许一次，即同一天中相同的消息只能向同一员工发送一次，重复的消息将不会被发送给收件人，并且系统不会有错误提示。
（2）同一天中向同一用户发送消息不能超过500条。超出500条后的消息将不会被发送给收件人，并且系统不会有错误提示。
（3）如果通过自建的微应用发送消息，请在钉钉平台的微应用管理中明确设置应用的可见范围（不要选择“所有员工可见”选项）。如果要让微应用对所有员工都可见，可以将微应用的可见范围选择为阿里钉钉中的顶层部门。
