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:没有交流群,近期会有一些开发培训的训练营,欢迎关注。

相关文章
|
弹性计算 机器人 应用服务中间件
一键部署开源Qwen3并集成到钉钉、企业微信
Qwen3系列模型现已正式发布并开源,包含8款“混合推理模型”,其中涵盖两款MoE模型(Qwen3-235B-A22B与Qwen3-30B-A3B)及六个Dense模型。阿里云计算巢已支持Qwen3-235B-A22B和Qwen3-32B的私有化部署,用户可通过计算巢轻松完成部署,并借助AppFlow集成至钉钉机器人或企业微信。文档详细介绍了从模型部署、创建应用到配置机器人的全流程,帮助用户快速实现智能助手的接入与使用。
1709 19
一键部署开源Qwen3并集成到钉钉、企业微信
|
人工智能 运维 API
Dify开发者必看:如何破解MCP集成与Prompt迭代难题?
Dify 是一个面向AI时代的开源大语言模型(LLM)应用开发平台,致力于让复杂的人工智能应用构建变得简单高效,目前已在全球范围内形成显著影响力,其 GitHub 仓库 Star 数截至 2025 年 6 月已突破 100,000+,目前,Dify 已经成为 LLMOps 领域增长最快的开源项目之一。
|
人工智能 数据可视化 API
10 分钟构建 AI 客服并应用到网站、钉钉或微信中测试评
10 分钟构建 AI 客服并应用到网站、钉钉或微信中测试评
566 2
|
人工智能 运维 API
Dify 开发者必看:如何破解 MCP 集成与 Prompt 迭代难题?
Dify 是面向 AI 时代的开源大语言模型应用开发平台,GitHub Star 数超 10 万,为 LLMOps 领域增长最快项目之一。然而其在 MCP 协议集成、Prompt 敏捷调整及运维配置管理上存在短板。Nacos 3.0 作为阿里巴巴开源的注册配置中心,升级支持 MCP 动态管理、Prompt 实时变更与 Dify 环境变量托管,显著提升 Dify 应用的灵活性与运维效率。通过 Nacos,Dify 可动态发现 MCP 服务、按需路由调用,实现 Prompt 无感更新和配置白屏化运维,大幅降低 AI 应用开发门槛与复杂度。
1710 20
|
人工智能 自然语言处理 机器人
一键部署开源DeepSeek并集成到钉钉
DeepSeek发布了两款先进AI模型V3和R1,分别适用于对话AI、内容生成及推理任务。由于官方API流量限制,阿里云推出了私有化部署方案,无需编写代码即可完成部署,并通过计算巢AppFlow集成到钉钉等渠道。用户可独享资源,避免服务不可用问题。部署步骤包括选择机器资源、配置安全组、创建应用与连接流,最终发布应用版本,实现稳定高效的AI服务。
1346 4
一键部署开源DeepSeek并集成到钉钉
|
人工智能 数据处理 C#
AI Dev Gallery:微软开源 Windows AI 模型本地运行工具包和示例库,助理开发者快速集成 AI 功能
微软推出的AI Dev Gallery,为Windows开发者提供开源AI工具包和示例库,支持本地运行AI模型,提升开发效率。
1294 13
|
安全 测试技术 数据安全/隐私保护
原生鸿蒙应用市场开发者服务的技术解析:从集成到应用发布的完整体验
原生鸿蒙应用市场开发者服务的技术解析:从集成到应用发布的完整体验
|
小程序 Android开发 iOS开发
ISO钉钉小程序小程序webview打开nextjs应用异常
ISO钉钉小程序小程序webview打开nextjs应用异常
411 3
|
人工智能 安全 机器人
Dify开发Agent对接钉钉机器人
这篇文章详细讲解了如何在Dify平台上开发一个Agent并与钉钉机器人集成,实现自动化消息处理和响应功能。
3867 0
|
开发者 持续交付 Android开发
Xamarin开发者的秘密武器:如何通过持续集成与持续部署(CI/CD)实现高效、高质量的软件交付
【8月更文挑战第31天】在当今追求高效、高质量软件交付的时代,Xamarin开发者需像大厨般迅速烹制数字化佳肴,而持续集成(CI)与持续部署(CD)则是关键工具。CI要求开发者频繁将代码集成到共享仓库,利用自动化工具如Azure Pipelines或Jenkins自动编译、测试代码,确保质量。CD在此基础上进一步实现自动化部署,简化从开发到生产的全过程。借助如Visual Studio App Center这样的工具,Xamarin项目得以快速构建、测试并部署至Android和iOS平台,显著提升开发效率和代码质量,助力团队乘风破浪,驶向成功的彼岸。
288 0