一、钉钉应用开发平台是什么？

钉钉应用开发平台是开发在钉钉容器内运营的应用。钉钉应用是业务数字化的高价值载体，云钉一体能力底座全面普惠，释放数字化生产力量，加速组织业务数字化转型，打造企业数字化统一办公门户。

钉钉应用开发平台全貌

在下图中可以看到，钉钉应用开发平台包含钉钉开放底座以及在钉钉上使用的四类应用、两大部分内容：

• 钉钉底座：提供丰富的开放能力

  • 2000+钉钉API
    • 如：IM/日程/OA审批/订盘等；
  • 45+场景化能力包
    • 如：行政/财务/人事/IT管理等；
  • 10+钉钉开放场域
    • 如：工作台/会话/日历/文档等；
  • 80+硬件产品开放
    • 如：考勤/门禁/会议等；

• 在钉钉上使用的四类应用

  • 原生应用
    • 如：考勤打卡、签到、审批、邮箱、公告，等等，实现一些标准化的流程。
  • 钉钉市场应用
    • 专注于一些领域开发的专业应用，如财务、OA、客户管理等。
  • 低代码应用
    • 钉钉搭，低代码或者零代码的方式开发应用，让企业的业务人员也可以低门槛的开发应用，集成了宜搭，氚云，简道云等主流厂商。
  • 全代码应用
    • 基于钉钉开放底座2000+API，集成企业业务流程，实现企业数字化流程，开发运行于钉钉容器内运行的应用。

钉钉应用开发平台现状

钉钉应用开发平台是一个成熟的开发平台，拥有2000+API、50+场景能力包、10+开放场域，企业自建应用数达到百万级。

二、5分钟开发应用演示

钉钉开发平台提供应用开发源代码，供开发者在开发者后台迅速跑通并创建应用或关联应用。

开发步骤

1. 登录开发者后台：https://open-dev.dingtalk.com

   

2. “从示例代码创建应用”中点击“更多示例代码”。

   

3. 进入代码广场选择并开发应用。

   

4. 选择“向个人或群发送消息”。

   

5. 进入详情页，包括应用使用的语言、支持应用类型、关联接口、推荐能力包等。

   

    
   1. 创建应用。

      

   2. 调试运行，首先下载示例代码。

      

   3. 使用IntelliJ IDEA打开下载好示例代码（能力包）。

      

      

   4. 生成启动命令并复制，在本地启动。

      

      

   5. 发布应用。

      

      系统会自动化完成一系列工作，包括：接口权限设置、应用访问地址配置、应用可用范围配置，同时会生成一个二维码，使用钉钉手机端扫描即可访问使用，PC端可用点击“直接访问应用”进入。
6. 应用使用演示，创建群并向群内发送消息。
   打开钉钉应用，填写表格中的相关内容，群名称、消息标题、消息内容，消息链接、选择发送人等，提交后即会收到消息，点击消息可以跳转到配置中的消息链接。

   

   

至此完成了一个应用在钉钉上的开发和本地部署，以及在钉钉上的访问。

应用的代码结构

应用的代码结构包括两个目录：

• backend：服务端代码
  backend的核心是发送消息的controller，包括发送群消息、发送工作通知、查询已读列表，等功能。

  

• frontend：前端代码
  frontend的核心是App.js，在这里实现了免登功能、发送群消息按钮，等基础功能；

  

三、钉钉应用开发过程

钉钉应用开发过程可以分为开发前和开发中。

开发前：

• 需求匹配：了解自己的需求，查看钉钉提供了哪些能力。
• 可行性分析：体验感受钉钉提供的能力，分析是否满足诉求。

开发中：

• 创建应用，管理权限，编写代码，调试测试，发布上线。

开发前

能力中心门户

能力中心是钉钉开放主阵地，一键体验，让开放能力接入更便捷。
点击前往能力中心
点击前往开发者文档

应用开发五部曲

只需简单几步实现把企业系统快速搬上钉钉，方便员工管理与使用，更能集成钉钉开放能力，融合钉钉产品形态，加速组织业务数字化。

• 把企业应用添加到工作台
• 应用一键免登
• 内网应用上钉钉
• 集成钉钉能力
• 与钉钉产品融合

场景化集成方案

• 基于钉钉丰富的开放能力，支持复杂的业务场景需求，提供多场景、多行业、多角色的能力融合解决方案，大大提升数字化生产力。

  

• “场景化能力融合方案包” 

  钉钉应用开放平台根据企业常见场景，对钉钉能力进行最优编排，并提供应用开发示例源码，全面助力开发者开发高价值应用，加速企业数字化转型。

  

  • 业务场景
    • 钉钉开放能力和企业常见的业务结合，场景化包装使用说明。
  • 标杆案例
    • 最佳实践标杆案例，展示应用开发前后使用变化。
  • 开发流程
    • 针对钉钉能力进行了能力使用编排，并提供完整的开放文档、SDK。
  • 示例源码
    • 提供开发源代码，可开发者后台跑通源码，并直接复用代码。

云IDE在线体验

场景化能力融合方案包也提供了云IDE体验功能，可以帮助开发者在没有开发环境的时候，预先体验钉钉应用的开发流程，同时可以在云IDE中进行断点调试、修改代码测试、可行性调研时代码的功能实现效果等。

下面是以第三方的一个“公司/园区数字食堂”应用为例的在线体验步骤。

• 体验示例代码

  

• 按照右侧任务栏中的步骤执行，完成后用手机端扫描二维码。
  

• 体验应用功能

  

钉钉文档中心

  点击前往开发者文档

• 学习路径
  钉钉文档中心新上线了学习路径，以企业内部应用开发为例，学习路径会详细介绍应用开发的具体流程，用简洁易读的方式让开发者一目了然，有的放矢的学习。

  

• API文档
  包括服务端、客户端，以及各产品模块API的完整介绍。

  

应用开发实战案例

DingTalk“开发者说”展示各行业在钉钉开发的实战案例，帮助你开阔思维，快速开始在钉钉开发。

 开发中

开发流程

• 应用创建
  • 应用类型：小程序、H5微应用、机器人
  • 应用名称
  • 应用描述
  • 开发方式：企业自主开发或委托服务商开发
• 应用配置
  • 如服务器出口IP：用于调用服务端接口
  • H5微应用：应用首页地址和PC端首页地址
  • 小程序：开发人员和小程序域名
  • 机器人：消息接收地址
• 应用开发与部署
  • 获取API调用凭证
  • 接入钉钉免登
  • 其它接口接入例如通讯录、审批等
  • 前端开发
• 应用测试
  • 小程序：上传开发版本并设置体验组织
  • H5微应用：添加测试用户名单
• 应用发布
  • 直接发布，发布后可调整应用的使用范围，如财务应用只限财务人员可见

创建应用

钉钉上的应用，本质代表着钉钉平台上的一个真实可靠的身份，所以创建应用之后，代表可以使用这个身份，安全可信的调用API，接收事件，处理业务逻辑。

所以创建应用之后，可以得到应用的ID，AppKey和AppSecret，这是做接下来开发最重要的东西。

钉钉全代码应用，基于应用的开发者身份、应用使用方、运行模式分为不同的类型：

• 基于开发者和使用方分类
  • 分为企业自建应用、第三方企业应用和第三方个人应用
  • token鉴权方式不同，企业自建应用企业可使用自己的信息鉴权，而第三方企业应用则需要第三方开发者身份和使用方（企业）身份鉴权
  • 可用API范围不同，企业自建应用可调用API范围比较广，而第三方企业/个人应用有专有API及权限范围
• 基于开发形式分类
  • 分为小程序、H5微应用
  • 小程序的优势在于用户体验度比较高，H5微应用的优势在于灵活、可实现功能更丰富
  • 前端API和研发代码不同
• 基于运行场域分类
  • 分为工作台、群应用、消息菜单等
  • 需要适配开发对应场域的代码，比如群应用需要开发机器人，卡片功能等

应用配置

• 调用钉钉服务端接口前，需要先添加所需接口的调用权限。

• 接口权限是以应用为维度授予的，每个应用的接口权限都是独立存在的，如果多个应用都需要调用同一个接口，那么每个应用都要添加相对应的接口调用权限。

• 不是所有接口都可以直接开通使用，具体参照接口的使用范围和适用类型，部分接口需要付费或满足特定条件后才可使用。

开发代码

• H5应用本质是开发一个站点，把站点首页配置的应用中，就可以访问了。
• 免登是基本上必须接入的能力，可以获取到当前访问用户的身份。
• 调用任何服务端API需要生成token，token管理也是必备的能力。
• 所有的示例代码都已经实现了这两部分功能，开发者可以基于Demo进行二次开发，节省开发时间。

测试发布

• 内网穿透（前文的应用开发演示）只是用来本地测试，不可以用于生产环境。
• 测试阶段可以配置仅自己可见。
• 发布完成之后，在工作台找到对应应用，可以点击查看。

贡献Demo，繁荣社区

• 贡献完整demo
  https://github.com/open-dingtalk/h5app-demo.git

• 参与demo仓库的代码贡献

• Demo示例，重点关注以下部分：

  

   
  • backend：后端SpringBoot项目
  • dingboot-common：Demo模板包，基础逻辑封装
  • taobao-sdk-java-auto：钉钉SDK，用来调用API
  • UrlConstant：接口URL，自行添加
  • BizController：Controller，实现自己的业务代码
  • BizManager：Service，具体实现业务逻辑代码
  • Application：填写应用配置信息
  • frontend：前端React项目
  • App.js：页面逻辑代码

四、钉钉应用平台发展规划

钉钉应用开发平台的使命，是让应用开发更简单。

• 加大开放：让钉钉内部更开放
  • API开放
    建立开放评估体系，实现更高质量的开放。
  • 钉钉酷应用
    支持更多开放场域，目前群应用在灰度中，未来会有更新形式的应用形态。
  • 应用融合度
    融合度越高的应用，用户使用的频率也越高，因此这一指标可以指引应用开发的方向。

• 目前正在进行的工作

  

  • 提升开放能力平台的易用性，包括能力中心、场景化能力包、云IDE体验、代码广场等。

  • 指引更清晰，包括应用配置指引、文档学习路径、开发者小助手等。

  • 工具更丰富，包括API统计/诊断/调试/管理、内网传统、微应用调试工具、D-Design组件库等。

五、Q&A

Q：目前没有直接获取企业全部员工的接口，如何获取企业全部员工的信息？后续是否有计划开放类似接口？

A：是可以获取到的，目前在通讯录下有部门、人员获取接口，根据获取组织的部门及部门下属人员来获取组织人员信息。

Q：开发中的报错信息“参数不合法”，但没有提示哪个参数，针对这类报错如何解决？

A：可以运用新的API诊断工具，其中会有更详细的报错信息，如果还是不能显示具体问题，可以求助技术支持人员进行排查。

Q：员工的档案接口字段是否没有全量开发？例如userID和手机号？

A：因为手机号属于敏感信息，需要申请手机号接口权限，然后唤起个人信息授权，授权后才可以拿到相应信息。可在文档中搜索个人手机号和个人授权组件，将两个功能结合即可。

Q：API接口调用有时候失败，提示系统繁忙是什么原因？

A：导致系统繁忙有多种原因，可能是网关不稳定，或者是一些内部错误，错误码包装的不是很清晰，可以提交工单或找在线的答疑机器人询问，并提供相关接口的requestID。

回看地址

回看地址

回看地址

一、钉钉是什么？

钉钉是企业应用数字化的操作系统

简单来说，钉钉是企业应用数字化的操作系统，就如同PC上的windows操作系统一样，我们可以在上面安装各种应用比如office、WPS，用于企业的各种实际应用。

钉钉自带原生应用，如考勤、审批、钉钉课等，底层是基于阿里云的各种能力，可以实现快速扩容，同时支持学校或企业的在线化应用，企业可以将自己的应用安装到钉钉上，也可以安装第三方的应用像宜搭、氚云等。

案例一：一汽集团

中国第一汽车集团自2019年，将钉钉工作台作为集团协同办公等统一门户，将人事、行政、企业文化、销售业务等业务数字化场景，将集团的100余移动应用集成到钉钉，提高组织运营效率。

案例二：东方希望集团

东方希望集团，集成了包括智慧行政和后勤、生产管理、系统集成（企业资源计划ERP、人事系统eHR和制造执行系统MES）等三类52个微应用，覆盖了公司办公的几乎所有场景。

钉钉应用是业务数字化的高价值载体

钉钉作为整个操作系统的底座，其云原生的能力为企业接入提供了各种各样的接口，包括场景化的能力，各种开放域等，目前钉钉全部开放接口2428个，其中服务端API 2092个，H5 JSAPI 220个，小程序API 116个，覆盖50+个钉钉产品和业务，以及API的开放状态和开放责任人。

对于企业现有的业务系统，如何通过三部曲的方式，和钉钉的底座能力平台有机融合在一起呢？

企业系统和钉钉能力集成，打造组织数字化平台

只需要简单的几步操作，就能把企业系统快速搬上钉钉工作台，方便管理和使用，通过钉钉能力融合，加速业务数字化。

第一步：应用上钉钉

• 快捷上钉钉
  • 将内部系统快捷方式添加到工作台，让企业办公入口更统一。
• 免登进入应用
  • 企业在内部系统集成钉钉免登，无需账密即可一键登入，高效便捷。
• 内网应用上钉钉
  • 用企业网关穿透内网应用，没有VPN也能保障数据安全

第二步：集成钉钉能力

• 开发高效
  • 连接器快速实现应用与钉钉能力打通，简单高效。
• 使用高效
  • 代码开发集成OA审批、待办、机器人、日程等能力，满足个性化需求

第三步：融合产品形态

• 扩展应用交互形态，融合在群、工作台、文档中沉浸式体验。
• 如群会话开放、工作台开放。

二、开发钉钉应用三部曲之一：应用上钉钉

场景描述

• 背景示例
  作为信息化专员小张发现：
  • 员工在浏览器中收藏各个系统的登录入口。
  • 各个系统的密码时常遗忘。
  • 常常需要找你进行密码的重置。
• 目标
  把常用的系统聚合到钉钉工作台上，实现统一门户，将现有系统入口通过创建应用的方式集成到工作台中。

效果演示

• 使用快捷方式在钉钉访问企业系统
  参考文档：使用快捷方式在钉钉访问企业系统
  • 登录钉钉开发者后台
  • 选择应用开发 > 企业内部开发 > 钉钉应用 > 创建应用
  • 填写应用的基本信息，然后单击确定创建。
    • 应用类型：选择H5微应用。
    • 开发方式：选择企业自助开发。
  • 单击已创建的应用。在应用页面，单击开发管理，然后单击修改；
  • 在开发管理页面，完成以下配置，然后单击保存。
    （填写应用首页地址、PC端首页地址和管理后台地址时，都必须以http或https开头。）
    • 开发模式：选择快捷链接。
    • 应用首页地址：要接入的H5微应用的首页URL。
    • PC端首页地址（可选）：用户在PC端打开该应用时使用的地址。
    • 管理后台地址（可选）：管理员在应用后台管理该应用时使用的地址。
  • 配置权限管理：为使用员工分配操作权限。
  • 发布：在版本管理与发布中，点击确认发布。
  • 登录企业钉钉工作台，点击添加，搜索刚刚发布的应用，添加到工作台。
    
    当企业有多个应用程序时，为方便企业管理和员工的使用，企业系统可以快速的接入到钉钉，通过URL上翻的方式，将系统链接配置为钉钉工作台应用，不需要代码能力就能很快实现。
• 钉钉账号与企业权限账号互通，端内端外实现免登
  通过上述操作，员工点击该应用，即可实现登录；同样，在添加了该应用后，通过企业自己的应用管理平台，也可以通过钉钉扫码的方式授权登录，实现内网应用上钉钉。但要实现无密码登录或扫码登录，还要实现钉钉账号与企业权限账号互通，端内端外实现免登。
  具体操作可以参考以下三个文档实现：

  • 参考文档1：使用钉钉免登进入企业系统

  • 参考文档2：使用钉钉扫码免登进入企业系统

  • 参考文档3：通过账号映射关系免登进入企业系统

• 内网应用上钉钉，没有VPN也能保障数据安全
  钉钉企业应用网关，为企业提供了内网应用在外网安全访问的能力，可以替代传统的 VPN 方案，并且基于阿里云的网络加速能力提升应用访问速度。该产品以零信任为理念，提供持续动态的访问准入校验，最大程度上保障企业数字信息安全。
  参考文档：内网应用安全上钉钉

三、开发钉钉应用三部曲之二：集成钉钉能力

通过以上步骤，提高了员工使用应用的便捷程度，那如何让现有的应用更加高效，这就涉及到企业如何去集成钉钉的能力。

企业业务系统和钉钉能力融合

企业人事、财务、销售等业务系统集成2000+的钉钉开放能力，最大化发挥业务数字化的生产力。

场景描述

• 背景示例
  如果你是智能制造工厂的信息化专员小张，你发现现有信息通路太长：

  

  时常出现：

  • 生产异常、预警等信息无法第一时间传达至指定人。

  • 负责人无法及时知晓当天生产情况。

• 目标
  可以在线监测生产情况，定期汇总生产数据推送至负责人，发现生产异常情况，第一时间推送至相关人员进行处理，确保生产流程顺利进行。
   
• 效果
  • Before
    • 每日生产汇总数据没有通知，需要负责人登录生产业务系统中查看，较为繁琐。
    • 生产情况层层沟通上报，时效性较差，且容易遗漏细节。
  • After
    • 接入钉钉消息通知功能后，每日可自动发送消息提醒，负责人可在第一时间了解生产情况，方便快捷。
    • 生产情况定时发送给生产节点中所有负责人，无需层层汇报，提高信息传达效率。

      

  • Before
    • 生产流程异常情况通过邮件形式通知，时效性较差，且邮件消息关注度不强，经常会被漏掉。
    • 生产情况层层沟通上报，时效性较差，且容易遗漏细节。
  • After
    • 接入钉钉消息通知功能后，生产出现异常，立即通知到指定人员，消息传达更及时。
    • 异常情况直接发送给生产节点中所有负责人，无需层层上报，提高信息传达效率，问题解决处理更加高效及时。

      

场景集成

• 接口1:钉消息接口
  • 重要信息，通过DING消息快速触达和提醒
• 接口2：业务消息透传IM窗口
  • 重要预警，快速找对人，沟通解决
• 接口3：创建“库存补充”日程
  • 确保任务落实到个人，明确到时间和目标
• 接口4：业务流程穿透IM聊天窗
  • 快速推进业务流程，提升业务协同效率
• 接口5：实人认证
  • 重要审批单，二次认证，保障信息安全

集成场景

• 组织架构集成

  

   
  • HR
    • 定时任务扫组织架构和人员信息，形成组织架构及人员的Q、E、A操作增量数据，形成队列调用集成服务接口。
  • 集成服务
    • 接受数据，对特殊业务场景进行逻辑处理。如一人多岗。并调用钉钉相应接口同步组织架构、人员信息至钉钉中，并将返回的数据进行存储及关联映射。
  • 钉钉组织架构人员信息
    • 接受数据，并进行相应处理。
• 考勤数据集成

  

   
  • 传统缺点
    • 用户不能及时获知自己的打卡情况。
    • 无法及时查询自己的班次情况。
    • 考勤统计不及时。
  • 钉钉优点
    • 内勤外勤打卡统一管理。
    • 员工随时查看打卡情况、排班情况。
    • 钉钉不断优化迭代功能。
    • 满足多业态打卡方式不同。
• 统一待办集成

  

• 机器人自助服务集成

  

更多能力详见钉钉开发能力库，目前有50多个场景。

四、开发钉钉应用三部曲之三：融合产品形态

企业应用和钉钉产品形态融合，沉浸式融合体验，应用在钉钉端内无处不在。

应用在群扩展

点击此处，前往文档中心查看群开放文档。

• 会话应用（栏）
  • 会话应用可作为业务节点入口，且能够展示红点和未读能力。
• 机器人
  • 以机器人为载体，使消息通过接口，定时定向定任务和群内用户进行互动。
• 互动/置顶/数据卡片
  • 充分使用互动卡片和会话容器的交互能力，实现群内业务闭环。

应用在工作台扩展

蚂蚁分工工作台组件，支持团队项目管理场景，通过对团队项目可视化概览，实时掌握团队项目进展情况，实现快速跟进高效协作。
点击此处，前往文档中心查看工作台开放文档。

• 组件权限
  • 根据用户不同的角色身份，来适配不同的团队协同的组件。
• 交互体验前置
  • 通过可视化数据组件可以一目了然任务数据情况，数据实时同步。
• 跳转至应用
  • 快速跳转应用，实现高效、明确的工作协作，让协同办公更简单。

综上，企业只需要简单的几步操作，就能把企业系统快速搬上钉钉工作台，通过三部曲的方式，和钉钉的底座能力平台有机融合在一起，方便管理和使用，通过钉钉能力融合，加速业务数字化。

五、钉钉应用开发服务与支持

能力方案

•  能力中心门户：立即前往

• 能力上新：立即前往

应用开发

• ​​应用开发后台：点击前往

• 应用开发工具：点击前往

• 开发者文档：点击前往

• 技术工单服务：点击前往

生态合作​​​

• 钉钉合作伙伴：钉钉合作伙伴平台

​​​​

六、QA

Q:企业数据上工作台，钉钉有现成的组件么？
A：没有，需要开发自定义组件并注册可使用的数据源。自定义组件的开发需要使用指定版本的小程序IDE，并遵守钉钉小程序组件开发规范。钉钉数据源上注册的服务端接口，没有特殊的要求，也不强制是否在别的应用中用到。只要在数据源上注册即可调用到。

Q:企业应用免登，如果有多个业务系统，是否要开发集成多次？
A：如果企业自身已经有统一的身份认证服务，且业务系统都已经接入，那只需和钉钉集成后可以对钉钉用户的身份进行识别，与已有统一身份认证平台交换信息，就不需要集成多次。否则，是需要自己开发服务可以识别每个业务系统和钉钉用户的身份关系及验证逻辑。

Q:开发业务扩展应用通常需要注意的问题和建议？
A:

• 确保创建企业应用是注册后端服务的白名单
• 针对钉钉能力集成，申请开通相应的权限

最近公司需要把自己做的sass系统嵌入到钉钉微应用，方便客户在pc端使用，本次任务需求其实很简单，就是把已经开发好的vue sass系统嵌入钉钉微应用，使用钉钉的免登。

1. 登录 钉钉开发平台创建应用如下图
   

2.填写好信息后进入项目，填写其他信息 如下图

服务器出口ip–是你的应用调取后端接口的地址，
应用首页地址，和pc端首页地址我这边是填写vue前段项目的地址，为了方便开发调试，可以先使用本地服务如http//192.168.1.112:8080/#/login，注意开头必须要是http或者https
这样配置好以后就可以在钉钉客户端–工作台–全部应用里面找到刚才创建的应用，并且可以点击访问。实际上访问的项目就是刚才提到的应用首页地址，

3. 但是在pc端打开后我们发现无法打开f12调试器，然后翻看文档，发现
   
   按照上图步骤进行操作，注意以下几点，第一复制代码到vue项目的public里面的index.html的head标签里面
   第二，本地启动的vue项目不要在浏览器打开，否则会被占用
   
4. 链接成功后是这样的

最后调试完成以后务必要删掉刚才放在head标签里面的代码，否则打包上线会疯狂报错websocket链接不上，调试工具的脚本是通过websocket链接钉钉项目的。
码字不易有帮助的麻烦留个赞