钉钉自建应用
应用介绍
钉钉(Ding Talk)是阿里巴巴集团打造的企业级智能移动办公平台,是数字经济时代的企业组织协同办公和应用开发平台。当我们需要结合钉钉和业务系统的时候,我们需要建立一个钉钉自建应用,自建应用是企业内部开发场景下,企业开发者创建并提供给企业员工使用的应用,自建应用不收费。 官网:https://www.dingtalk.com/
应用场景介绍
通过HiFlow场景连接器,可以快速打通钉钉自建应用和其他应用之间消息&数据,实现比如定时/自动发送消息/接收消息/自动回复等。
应用支持的触发条件和执行操作
(一)企业微信自建应用应用支持的执行操作如下:
- 获取考勤数据:获取钉钉系统中总体考勤数据
- 发送文本消息:给指定的用户或部门全体人员发送文本消息
- 发送富文本消息:给指定的用户或部门全体人员发送富文本消息
- 发送文本通知:发送部门或全体的文本通知
- 发送富文本通知:发送部门或全体的富文本通知
应用账号和参数配置(或其他相关)
(一)钉钉自建应用使用应用的前置条件
- 需要是钉钉管理员
- 需要在钉钉开放平台创建应用:在【应用开发】-【企业内部开发-H5微应用】点击【创建应用】
(二)添加新的钉钉自建应用应用账户 添加新的钉钉自建应用应用账户需要:
- 必填字段:CorpID、AgentId、App Key、App Secret
- 加密 aes_key和签名 token在作为触发条件时,必填,是为了可以接收到钉钉接口返回的回调数据
- !!#ff9900 注意:!!成功添加账户后,需要在【权限管理】中根据自己的需求申请对应的应用管理权限,部分未开通的权限需要点击【申请权限】,例如个人权限、通讯录管理、消息通知、考勤等
(三)企业微信自建应用的配置参数 作为执行操作时,已上传临时素材为例,配置参数如下
发送文本/富文本消息
1.1 添加账号:可以选用在触发条件添加的账户,也可以添加一个新账户,当作为执行操作 时,加密 aes_key和签名 token可以不填写
1.2 配置内容:根据说明获取到用户ID和部门ID(支持批量填写),然后进行消息内容的配置
发送文本/富文本通知
2.1 配置内容:选择发送通知类型是全体通知还是指定部门通知,选择部门通知的话需要进行员工ID或者部门ID(支持批量填写),然后进行通知内容的配置
获取考勤数据
3.1 配置内容:配置前请先确定在钉钉开放平台【权限管理】-考勤相关权限已经开通,然后选择查询的具体时间即可