DingTalk「开发者说」- 开发钉钉酷应用集成入门

简介: 本篇主要分享钉钉酷应用的群应用开发流程和实践。

DingTalk「开发者说」

开发钉钉酷应用集成入门

 

摘要:本篇主要分享钉钉酷应用的群应用开发流程和实践。

 

分享人:石周,钉钉酷应用开发技术专家

 

视频地址:

 

正文:

 

一、什么是酷应用?

 

钉钉酷应用是以场景为中心,解构巨型应用并重组,便捷完成协同,高效实现目标的全新应用形态。


从应用开发的视角来看,凡是具备在不同场景(如群应用、工作台组件、日程应用、消息应用等)扩展使用能力的应用,统称为酷应用,亦即:酷应用兼具业务功能和跨场域联动的特点。


image.png

 

二、群应用

 

群应用是钉钉酷应用中目前较为成熟的一种,是在会话中使用的应用扩展形态,其基于主应用扩展了快捷入口、会话机器人和互动卡片的能力,使应用不仅可以在群会话中实现多人多角色的任务协同、目标共创、商机共享、战报通告等沉浸体验,从技术能力上还可以实现在单聊会话中集成酷应用。

 

image.png

示例:某企业通过群应用对焦OKR

 

群应用的特性

 

  • 沉浸式体验:无需脱离聊天上下文,不打断当前工作;
  • 场景化协同:信息围绕场景和具体事项做实时高效协同;
  • 即时数据分析:利用高效协同产生的结构化数据进行即时分析,形成有效洞察;
  • 指标化运营:人人参与,实干真用,和组织激励机制相结合,让数字化真正落地。

 

群会话扩展的开发流程

 

  • 创建应用
  • 配置机器人
  • 设置群会话扩展
  • 开发卡片
  • 开发完成验证

 

企业自建酷应用开发文档:https://open.dingtalk.com/document/org/cool-application-introduction

第三方企业酷应用开发文档:https://open.dingtalk.com/document/isv/cool-application-introduction-isv

 

三、酷应用开发流程

 

image.png

开发企业内部应用流程图

 

1、开发企业应用

 

  • 创建企业应用,或者复用之前存在的应用;
  • 第三方酷应用,最终依赖第三方应用的上架,新应用要走上架流程。

 

image.png

 

企业自建应用学习路径:https://open.dingtalk.com/document/org-roadmap

第三方企业应用学习路径:https://open.dingtalk.com/document/isv-roadmap

 

2、配置应用机器人

 

image.png

 

  • 应用机器人为群扩展中必需;
  • 三方机器人默认创建,机器人名称图标和应用保持一致,不允许修改;
  • 配置机器人消息接收地址,用来处理机器人的被at消息,非必选;

 image.pngimage.png


3、配置群拓展

 

            image.png     image.pngimage.png

配置群扩展信息

           image.png     image.png

配置快捷入口

 

  • 企业自建酷应用信息可以修改,点击添加到群之后,就可以到当前企业下的群内验证;
  • 第三方酷应用发布之后信息不可以修改,可以先在测试应用中测试验证,后续如果有修改诉求,可以找运营修改。自动化运营审核的流程也会在不久的将来上线;
  • 链接encode不要将$符号encode掉,否则该参数无法传入;
  • 链接打开配置请使用半屏打开方式,以保证应用的沉浸式体验。

 

4、互动卡片

 

  • 互动卡片是酷应用的核心功能;
  • 互动卡片可以理解为传统应用的H5页面,承载交互的核心业务流程;
  • 卡片中的链接配置为半屏打开,更沉浸式的体验。

 

image.png     image.png

 

5、开发完成验证

 

  • 企业自建应用,选择添加到群直接测试;
  • 三方企业应用,需要安装到测试组织,才能在测试组织的群内开通使用,所以需要参考体验安装流程(配置好事件订阅,接收三方必接事件即可)。

 

image.png   image.png

 

四、酷应用开发实践

 

Demo地址:https://github.com/open-dingtalk/h5app-cool-app-demo

 

项目需求:搭建一个在群内可以以卡片形式运行的应用

 

开发步骤:

 

1、创建应用

 

a.  登录钉钉开放平台后台创建一个H5应用: https://open-dev.dingtalk.com/#/index

 

b.  配置应用

 

参考文档:https://developers.dingtalk.com/document/app/configure-orgapp

 

c.  此处配置应用首页地址需公网地址,若无公网ip,可使用钉钉内网穿透工具;

 

钉钉内网穿透工具,可用于开发调试,请勿用于生产:https://developers.dingtalk.com/document/resourcedownload/http-intranet-penetration

 

image.png

 

d.  配置相关权限

 

demo使用接口相关权限有:

ž   成员信息读权限

ž   chat相关接口的管理权限

ž   chat相关接口的读取权限

 

参考文档:https://developers.dingtalk.com/document/app/address-book-permissions

 

2、配置机器人

 

参考文档:https://open.dingtalk.com/document/org/configure-push-settings

 

image.png

 

 

3、配置群应用和群入口

 

参考文档:https://open.dingtalk.com/document/org/configure-the-basic-information-of-the-group-application

 

a.  扩展到群会话;

 

image.png

 

b.  配置群应用入口;

 

image.png

 

此应用需配置两个群入口:小酷公告、小酷日程。头像和名称可自行定义,链接配置参考下方。

 

小酷公告:

- 移动端地址:

dingtalk://dingtalkclient/action/im_open_hybrid_panel?panelHeight=percent60&hybridType=online&pageUrl={URL编码后的首页地址}%2F%23%2FAnnouncement%2F$DOUBLE_ENCCID$

- 示例:

dingtalk://dingtalkclient/action/im_open_hybrid_panel?panelHeight=percent60&hybridType=online&pageUrl=http%3A%2F%2Fdingtalkcool.vaiwan.cn%2F%23%2FAnnouncement%2F$DOUBLE_ENCCID$

- 桌面端地址:

dingtalk://dingtalkclient/page/link?url={URL编码后的首页地址}%2F%23%2FAnnouncement%2F$DOUBLE_ENCCID$&pc_slide=true

- 示例:

dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fdingtalkcool.vaiwan.cn%2F%23%2FAnnouncement%2F$DOUBLE_ENCCID$&pc_slide=true

 

小酷日程:

- 移动端地址:

dingtalk://dingtalkclient/action/im_open_hybrid_panel?panelHeight=percent60&hybridType=online&pageUrl={URL编码后的首页地址}%2F%23%2FSchedule%2F$DOUBLE_ENCCID$

- 示例:

dingtalk://dingtalkclient/action/im_open_hybrid_panel?panelHeight=percent60&hybridType=online&pageUrl=http%3A%2F%2Fdingtalkcool.vaiwan.cn%2F%23%2FSchedule%2F$DOUBLE_ENCCID$

- 桌面端地址:

dingtalk://dingtalkclient/page/link?url={URL编码后的首页地址}%2F%23%2FSchedule%2F$DOUBLE_ENCCID$&pc_slide=true

- 示例:

dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fdingtalkcool.vaiwan.cn%2F%23%2FSchedule%2F$DOUBLE_ENCCID$&pc_slide=true

 

4、互动卡片

 

Demo中已植入调用互动卡片接口代码,可在Demo中详细查看。

 

5、启动应用

 

参考文档::https://open.dingtalk.com/document/org/install-group-applications

 

a.  启动应用:启动命令(以mac系统为例):

 

./dingBoot-mac.sh start {项目名} {端口号} {appKey} {appSecret} {agentId} {corpId}

 

b.  发布应用:进入版本管理与发布页面,发布应用,发布后即可在PC钉钉或移动钉钉工作台访问应用。

 

c.  客户端添加并启动应用:

 

image.png

启动首页示例

 

image.png

公告页面示例

 

image.png

日程页面示例

 

image.png

群互动卡片消息示例

 

image.png

群应用入口示例

 

五、Q&A

 

Q:酷应用开发是否需要定制开发服务商的资质?

A:不需要。

 

Q:酷应用企业自建ISV要走上架,也视为一种三方应用吗?

A:是的。

 

Q:第三方酷应用如何开发?

A:第三方酷应用的开发和企业自建酷应用的开发基本差不多,只是多了一个上架审核的流程,同时其主应用需要上架到市场。

 

Q:第三方酷应用和企业自建酷应用在权限上是否有区别?

A:酷应用没有,在其它一般的主用上,API权限有些差异。

 

Q:第三方酷应用未上架前想要在群内进行测试,该如何操作?

A:第三方酷应用上架之前有扩展到群的入口,测试的话可以安装到体验组织,在体验组织内进行测试即可。其安装流程有一些hack的方式:将酷应用的code复制下来,在群应用市场多次点击后可以打开测试入口(详见本篇第三节第5小节图片)。

 

Q:酷应用成熟的应用场景有哪些?机器人学习有开源吗?是否提供一些成熟的机制?

A:目前比较典型的合作像对接OKR、任务管理、招聘之类的,需要结合企业的具体业务,可以一起探索。目前钉钉机器人的后台算法还没有开源出来。

 

Q:第三方酷应用可以有多个不同的应用在多个群使用吗?

A:目前一个第三方应用只支持一款酷应用,这款酷应用可以在不同的群使用,如果一个三方应用需要多个场景和多个酷应用的情况下,可以和钉钉负责运营的同学具体沟通下,也是可以放开的。

 

Q:酷应用和主应用的关系和区别是什么?

A:当主应用具备了一定的扩展能力则可以成为酷应用,二者并不是非此即彼的关系。在一定的维度内,主应用是指偏传统的应用,像在工作台打开,具备完整的业务流程等;酷应用是指在某些IM比如群会话场景下的应用,具备完整闭环的业务流程实现。

 

Q:酷应用有开发交流群吗?

A:没有交流群,近期会有一些开发培训的训练营,欢迎关注。

相关文章
|
3月前
|
JavaScript 前端开发 持续交付
Prettier 高级应用:集成 CI/CD 流水线与插件开发
【10月更文挑战第18天】Prettier 是一款流行的代码格式化工具,它能够自动将代码格式化成一致的风格,从而提高代码的可读性和维护性。对于希望进一步发挥 Prettier 潜力的高级用户而言,将 Prettier 集成到持续集成(CI)和持续部署(CD)流程中,确保每次提交的代码都符合团队标准,是非常重要的。此外,通过开发自定义插件来支持更多语言或扩展 Prettier 的功能也是值得探索的方向。本文将详细介绍这两方面的内容。
59 2
|
2月前
|
机器学习/深度学习 Python
堆叠集成策略的原理、实现方法及Python应用。堆叠通过多层模型组合,先用不同基础模型生成预测,再用元学习器整合这些预测,提升模型性能
本文深入探讨了堆叠集成策略的原理、实现方法及Python应用。堆叠通过多层模型组合,先用不同基础模型生成预测,再用元学习器整合这些预测,提升模型性能。文章详细介绍了堆叠的实现步骤,包括数据准备、基础模型训练、新训练集构建及元学习器训练,并讨论了其优缺点。
58 3
|
2月前
|
jenkins 测试技术 持续交付
探索自动化测试在持续集成中的应用与挑战
本文深入探讨了自动化测试在现代软件开发流程,特别是持续集成(CI)环境中的关键作用。通过分析自动化测试的优势、实施策略以及面临的主要挑战,旨在为开发团队提供实用的指导和建议。文章不仅概述了自动化测试的基本原理和最佳实践,还详细讨论了如何克服实施过程中遇到的技术难题和管理障碍,以实现更高效、更可靠的软件交付。
|
2月前
|
消息中间件 Java Kafka
Spring Boot 与 Apache Kafka 集成详解:构建高效消息驱动应用
Spring Boot 与 Apache Kafka 集成详解:构建高效消息驱动应用
52 1
|
2月前
|
开发框架 JavaScript 前端开发
TypeScript 是一种静态类型的编程语言,它扩展了 JavaScript,为 Web 开发带来了强大的类型系统、组件化开发支持、与主流框架的无缝集成、大型项目管理能力和提升开发体验等多方面优势
TypeScript 是一种静态类型的编程语言,它扩展了 JavaScript,为 Web 开发带来了强大的类型系统、组件化开发支持、与主流框架的无缝集成、大型项目管理能力和提升开发体验等多方面优势。通过明确的类型定义,TypeScript 能够在编码阶段发现潜在错误,提高代码质量;支持组件的清晰定义与复用,增强代码的可维护性;与 React、Vue 等框架结合,提供更佳的开发体验;适用于大型项目,优化代码结构和性能。随着 Web 技术的发展,TypeScript 的应用前景广阔,将继续引领 Web 开发的新趋势。
42 2
|
2月前
|
传感器 前端开发 Android开发
在 Flutter 开发中,插件开发与集成至关重要,它能扩展应用功能,满足复杂业务需求
在 Flutter 开发中,插件开发与集成至关重要,它能扩展应用功能,满足复杂业务需求。本文深入探讨了插件开发的基本概念、流程、集成方法、常见类型及开发实例,如相机插件的开发步骤,同时强调了版本兼容性、性能优化等注意事项,并展望了插件开发的未来趋势。
45 2
|
2月前
|
安全 测试技术 数据安全/隐私保护
原生鸿蒙应用市场开发者服务的技术解析:从集成到应用发布的完整体验
原生鸿蒙应用市场开发者服务的技术解析:从集成到应用发布的完整体验
|
3月前
|
Dart Android开发
鸿蒙Flutter实战:03-鸿蒙Flutter开发中集成Webview
本文介绍了在OpenHarmony平台上集成WebView的两种方法:一是使用第三方库`flutter_inappwebview`,通过配置pubspec.lock文件实现;二是编写原生ArkTS代码,自定义PlatformView,涉及创建入口能力、注册视图工厂、处理方法调用及页面构建等步骤。
76 0
|
3月前
|
开发框架 监控 搜索推荐
GoFly快速开发框架集成ZincSearch全文搜索引擎 - Elasticsearch轻量级替代为ZincSearch全文搜索引擎
本文介绍了在项目开发中使用ZincSearch作为全文搜索引擎的优势,包括其轻量级、易于安装和使用、资源占用低等特点,以及如何在GoFly快速开发框架中集成和使用ZincSearch,提供了详细的开发文档和实例代码,帮助开发者高效地实现搜索功能。
210 0

热门文章

最新文章