钉钉自建应用插件

1. 简介

1.1 插件简介

钉钉自建应用支持简道云与钉钉的数据消息互通，如：应用内 DING 提醒、电话 DING 提醒、短信 DING 提醒等。从而实现便捷管理，提升企业内部协作效率。

1.2 应用场景

适用于需要通过钉钉集成模式内的提醒进行业务协作的各类场景中。如线索推送提醒、请假审批、报销审批、项目日报打卡提醒等。

1.3 预期效果

以销售管理场景中推送销售线索，成员在钉钉中收到 DING 提醒为例，效果如下所示：

1.4 使用说明

钉钉自建应用插件为免费插件，付费版用户可免费使用。

2. 钉钉平台配置

2.1 创建企业内部应用

1）登录 钉钉开放平台，在「应用开发 >> 企业内部应用 >> 钉钉应用」处，点击「创建应用」：

2）在创建应用的详情页中，设置应用名称、应用描述和应用图标。设置完成后，点击「保存」按钮。

2.2 创建机器人

1）应用创建完成后，进入应用开发页面中，在「应用能力 >> 添加应用能力」处，选择机器人，并点击「添加」按钮，如下所示：

2）在机器人配置页面，进行如下所示操作：

设置完成后，点击「发布」按钮。

2.3 配置应用权限

在「开发配置 >> 权限管理」处，为应用添加「企业机器人发送撤回 DING 消息」的权限。操作步骤如下所示：

2.4 发布应用

在「版本管理与发布」处，点击「查看版本详情」并点击「编辑」按钮，修改应用可见范围为「全部员工」。修改完成后，保存并发布当前应用。

2.5 获取机器人ID

应用发布完成后，在「机器人 >> 机器人配置」处，复制 RobotCode，即机器人 ID。

2.6 获取应用ID和应用Secret

进入「凭证与基础信息 >> 应用凭证」处，查看并复制应用ID（Client ID ）和应用 Secret（ Client Secret）。

2.7 添加群机器人

1）在钉钉群中选中需要添加机器人的内部群，点击内部群右上角的「设置」按钮，在群设置页面中选择「群机器人」。

2）进入机器人管理页面，选择刚刚创建并发布好的机器人「小简同学」。如下所示：

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「钉钉自建应用」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

安装完成后，在「插件管理」处，点击插件右侧的「设置」按钮，将【2.5 获取应用ID和应用Secret】中获取到的应用 Key 和应用 Secret 配置进去。

3.3 启用插件

在插件管理中，打开「钉钉自建应用」插件右侧开关，启用插件。

4. 表单搭建

以销售线索推送为例，新建「线索推送通知」表单，字段设置如下所示：

5. 智能助手配置

5.1 添加智能助手

表单设计完成后，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，进行如下设置：

5.2 设置触发动作

在「表单触发 >> 触发动作」处，勾选触发动作为「新增数据时」。

5.3 添加插件节点

触发节点设置完成后，点击节点连接线上的加号按钮，执行节点选择「插件节点」。

5.4 设置执行动作

执行动作设置如下：

5.5 效果演示

效果参见本文【1.3 预期效果】。

6. 注意事项

1）使用 DING 成员提醒时，需先前往钉钉平台 购买 DING 额度。

2）应用内 DING 成员个数上限为 200 个/次，短信 DING 和电话 DING 成员个数上限为 20 个/次。