应用介绍

钉钉（Ding Talk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。当我们需要结合钉钉和业务系统的时候，我们需要建立一个钉钉自建应用，自建应用是企业内部开发场景下，企业开发者创建并提供给企业员工使用的应用，自建应用不收费。
官网：www.dingtalk.com/

应用场景介绍

通过腾讯轻联，可以快速打通钉钉自建应用和其他应用之间消息&数据，实现比如定时/自动发送消息/接收消息/自动回复等。

应用支持的触发条件和执行操作

（一）企业微信自建应用应用支持的执行操作如下：

1. 获取考勤数据：获取钉钉系统中总体考勤数据

2. 发送文本消息：给指定的用户或部门全体人员发送文本消息

3. 发送富文本消息：给指定的用户或部门全体人员发送富文本消息

4. 发送文本通知：发送部门或全体的文本通知

5. 发送富文本通知：发送部门或全体的富文本通知

应用账号和参数配置（或其他相关）

（一）钉钉自建应用使用应用的前置条件

1. 需要是钉钉管理员

2. 需要在钉钉开放平台创建应用：在【应用开发】-【企业内部开发-H5微应用】点击【创建应用】

（二）添加新的钉钉自建应用应用账户
添加新的钉钉自建应用应用账户需要:

1. 必填字段：CorpID、AgentId、App Key、App Secret

2. 加密 aes_key和签名 token在作为触发条件时，必填，是为了可以接收到钉钉接口返回的回调数据

3. 注意：成功添加账户后，需要在【权限管理】中根据自己的需求申请对应的应用管理权限，部分未开通的权限需要点击【申请权限】，例如个人权限、通讯录管理、消息通知、考勤等
   

（三）企业微信自建应用的配置参数
作为执行操作时，已上传临时素材为例，配置参数如下

1. 发送文本/富文本消息
   
   1.1 添加账号：可以选用在触发条件添加的账户，也可以添加一个新账户，当作为执行操作 时，加密 aes_key和签名 token可以不填写
   
   1.2 配置内容：根据说明获取到用户ID和部门ID（支持批量填写），然后进行消息内容的配置

2. 发送文本/富文本通知
   
   2.1 配置内容：选择发送通知类型是全体通知还是指定部门通知，选择部门通知的话需要进行员工ID或者部门ID（支持批量填写），然后进行通知内容的配置

3. 获取考勤数据
   
   3.1 配置内容：配置前请先确定在钉钉开放平台【权限管理】-考勤相关权限已经开通，然后选择查询的具体时间即可