DingTalk「开发者说」第6期 边聊边做场景群

视频地址：一键回看

目录

一、什么是“场景群”

二、群聊开放的核心能力介绍

三、从产品架构解读群聊会话开放

四、解决方案案例解读

五、场景群实践

六、Q&A

正文：

一、什么是“场景群”

案例：企业通过钉钉群智能化养猪

在讲解“场景群”概念之前，先来看一个场景群案例。

机器人自动预警图文消息直观展示互动卡片一键转派工单。

在这个案例中，体现了“场景群”的三个主要功能：

• 机器人自动报警：客户创建“猪舍环境监控”场景群，这个群的主要功能是通过机器人自动预警，如：猪舍温度异常、猪情况异常等；
• 图文消息直观展示：机器人会发送预警内容的详细情况说明；
• 互动卡片一键转派工单：机器人发送预警信息的同时，会有互动卡片给监控人员，提示进行下一步处理的操作，比如转派给他人协助；

在这个案例中，对于猪舍异常情况的发生、跟进和处理结果，都会在“猪舍环境监控”场景群中完成，极大提升了监控工作的效率。

场景群的概念

• 场景群通过Instant Message (IM) 群聊会话的开放能力集成，关注自己的业务场景，构建能够解决具体业务问题的群聊会话；
• 「沟通即业务」，让业务在「群」里跑起来；
• “场景群”是群聊开放的主要能力之一，通过群模板自定义具备特定机器人、群插件功能的场景化群类型。比如钉钉项目群，在其中绑定了很多跟钉钉项目相关的能力，通过群插件与相关业务场景绑定，实现边聊边做的场景。

二、群聊开放的核心能力介绍

钉钉群聊开放的能力模块

钉钉群聊开放的能力包括以下几部分：

• 会话设置：可以通过群模板进行配置；
• 置顶卡片：用来展示需要群里所有人看到的重要信息或事件；
• 机器人：主要功能是帮助开发者通过机器人触达消息到群里；
• 消息；
• 会话应用：群与业务系统进行绑定并通过会话应用接口在群里直接进入业务页面

钉钉群里开放的核心能力介绍

消息与会话管理

• 发送和接收消息：企业的业务系统可以通过机器人与IM群进行互动，发送业务事件；同时接收用户发送的信息并及时进行响应，从而提高沟通效率；
• 会话管理：包括创建、成员管理、群设置等；

机器人
机器人的能力包括：

• 自助办理：智能工作助理帮助员工自助办理如打卡等业务；
• 自助答疑：针对企业内部如行政相关的问题进行自助答疑；
• 答疑群：将一些常见问题配置成知识库，由机器人来进行答疑；
• 数据助理：将业务系统的数据配置关键词由机器人自动回复；
  通过AI对话和意图识别，在群内和服务窗为客户提供智能化个性服务。

互动卡片
互动卡片设计器：钉钉，是一种工作方式

钉钉互动卡片的特点包括：

• 卡片内容排版效果更佳
  对比普通的文本消息或Markdown消息，互动卡片消息排版能力更强大，渲染效果更好；
• 可在卡片内进行轻量级交互，内容动态变更
  互动卡片消息能够让用户直接在卡片内进行轻量级交互，同时能够在减少消息打扰，提升效率，支持实时和异步回调，可以缩短用户操作路径，无需进入二级页面；
• 拖拉拽，傻瓜式卡片设计器
  简单易搭，傻瓜式卡片设计器，降低开发成本；
• 四端一致，四端统一互动
  卡片只需要编写一套模板，便能够在四个平台(iOS、Android、Windows、 macoS)上展示，接入流程简单方便。

群插件

• 基本介绍
  群插件，也叫“群应用”，是群聊会话开放的核心组成部分，其定位为“串联业务的关键节点”
  • 用户在群内点击群插件时，将会带上群的相关参数，开发者将据此确定是“谁在哪个群内于什么时间点击了哪个具体群插件”。以此，ISV能够实现高度智能化和指向明确的业务服务。
  • 一个群聊会话中配置多个群插件，指向一个业务场景中的不同流程和节点，以更加场景化的提供服务；
• 最佳实践
  以家校群为例，通过在群内配置具有明确场景指向的群插件，将教学线上化；
  例如家校本：学生点击进入后，是提交作业的地方；而老师点击进入则是批改作业的地方；此处就利用了同一个插件基于入参的不同进行了不同的业务处理。

群模板

群模板是对场景群的功能定义，包括了对场景群的基本信息（如群类型名称）、机器人、群插件的定义，群模板希望给开发者提供最低成本的场景群接入体验。

一个场景群只能安装一个群模板；对于非场景群，可以通过群模板进行升级，升级后的群具备场景群的功能。

三、从产品架构解读群聊会话开放

会话开放大图

从图中可以看到，钉钉IM开放度非常高，包括：会话管理（会话排序、分组等）、会话设置（群成员、会话信息、标签名称等）、消息（机器人、收发消息等）；在业务方面有IM容器开放（标题区、会话标识、置顶区、消息菜单等）、数据开放；同时还提供功能/工具开放，如会话服务能力和会话开发工具（卡片工厂、机器人工厂），在场景层面有群场景和会话应用等。

从架构设计原理解读“群场景”

钉钉开放的群聊会话能力，如图所示，群场景架构分为四个层次：

• 技术底层：内部群聊会话和外部群聊会话组成IM群聊会话的基础；
• 产品核心模型：
  • 纯内部群：仅限组织内成员；
  • B2B群：仅限多个组织内成员，比如企业和供应商的群；
  • B2C群：组织内&外部成员，比如企业和用户的群；
  • 普通群：没有组织属性；
• 基于场景产生的群：比如根据具体服务场景可以有纯内部服务群、B2B服务群和B2C服务群；
• 会话场景：由各业务特性决定，如服务、客户管理、物流查询、班级、I0T监控等；

群聊会话提供基于内部群聊底层模型的开放能力，让群聊会话的场景更加丰富，生态更加繁荣。

关于群的一些概念科普

• 会话开放vs群聊开放vs场景群开放：
  • 会话开放：包括单聊和群聊会话的能力开放；
  • 群聊开放：是消息、会话、机器人、互动卡片、群插件等所有群聊能力开放的统称；
  • 场景群：是群聊开放的重要能力之一，通过群模板将群基本信息、机器人、群插件进行统一管理；
• 推荐使用场景群的开放能力，也建议将非场景群升级为场景群；
• openConversationId vs chatId：

• 群模板的templateId
  通过群工厂创建的群模板，会有对应的唯一标识（templateId），可以通过templateId调用相应的API，创建对应的场景群，或者把已有的内部群升级为对应的场景群。

四、解决方案案例解读

案例：企业客户服务

业务痛点

• 问题提报、处理在同一群内，信息混杂，小二在钉钉和工单系统频繁切换；
• 客户缺少自助解决问题渠道，小二需要时刻关注群内信息和工单状态；

解决方案

一单一群：小群处理故障，大群实时同步故障处理进度，信息再多也不会乱；

核心价值

• 建单模式：改变在线服务的业务模式，释放生产力；
• 任务单群：有效解决信息过载、任务跟丢的情况，让消息管理、任务跟进更聚焦；

案例：项目应急响应

业务痛点

• 多群响应，信息分散，第一时间故障链路相关人找群难；
• 应急协同不清晰，不清楚SOP是什么，群里谁负责什么；
• 应急时无法及时获取当前进展，依赖爬楼；
• 应急过程中响应、动作、决策无记录，不可回溯，依赖爬楼；

解决方案

• 故障处理群统一管理，通过公告、消息引导至同一群内处理；
• 通过机器人进行人员、流程协同，群内标示人员身份；
• 通过吊顶（置顶卡片）、卡片跨群同步处理进展；
• 结合聊天记录、群内互动信息，自动生成处理过程；

预期价值

基于钉钉IM开放能力，打通监控、运维、调度等业务系统，建设线上协同解决方案，保证应急响应的高效、有序和透明。

 群聊会话开放API集合和有用的文档

• 消息收发API集合：消息通知概述 - 钉钉开放平台
• 会话场景（非场景群）：创建群会话 - 钉钉开放平台
• 会话场景（场景群）：创建场景群 - 钉钉开放平台
• 群模板：启用群模板 - 钉钉开放平台
• 机器人：如何调用机器人API - 钉钉开放平台
• 互动卡片：群插件简介 - 钉钉开放平台
• 群插件：群插件简介 - 钉钉开放平台

近期钉钉将上新20个群开放API，请关注「钉钉开放平台更新日志」（服务端接口更新日志 - 钉钉开放平台），也可以扫码关注“开发者服务窗”获取更新推送。

API集合封装的场景化方案

钉钉将会话开放的API根据常见的业务场景进行了方案整合，用户可以访问「钉钉开放平台能力中心」，筛选「消息通知」和「场景群」，查看会话开放的场景化方案集合。

五、场景群实践

项目需求

搭建一个猪舍监控体系，通过群模板搭建场景群，当猪舍有异常情况，使用机器人智能发送互动卡片提醒，并支持群插件前往猪舍管理中心。

实践步骤

a. 登录钉钉开发者后台创建应用：

• 创建“猪舍监控体系”应用；
• 创建后可获取AppKey和AppSecret；
• 添加接口调用权限，搜索“场景群”，申请场景群接口对应的权限；
• 获取应用访问凭证，以企业内部应用为例，调用获取企业内部应用accessToken。调用场景群相关接口时，通过accessToken鉴权调用者身份。

b. 创建群插件

• 在场景群页面选择群插件，单击新建群插件；

• 根据提示配置群插件，然后单击新建。
• 创建成功后，提交审批。

c. 创建机器人

• 在场景群页面选择机器人，单击新建机器人；

• 配置群机器人信息，然后单击创建；

• 审批；

d. 创建群模板

• 进入开发者后台，单击场景群，然后选择群模板，单击创建群模板；

• 选择应用类型，然后选择一个已创建的钉钉应用，单击下一步；

• 配置群模板信息，在这里绑定刚刚创建的群插件和机器人，然后单击保存编辑；
• 创建灰度群，并发布；

• 点击提交审核，提交后审批会自动通过；

• 点击发布；

e. 创建一个群模板对应的场景群，在创建群模板中已完成。

f. 在群内发消息，机器人进行响应

• 下载一个应用，推荐Spring 的RESTful Web Service应用；
• 下载后可自定义服务，如robot CallBack，在钉钉开放平台的机器人接收消息的消息协议中详细讲解了如何处理钉钉机器人回调消息；
  参考消息类型和数据格式。

g. 通过机器人发送报警消息（卡片消息）到群内

• 创建消息模板，进入钉钉互动卡片搭建平台，点击新增模板创建；

• 编辑模板：模板创建完成之后会自动跳转到模板编辑页面进行编辑，编辑后发布模板；

• 发送卡片消息到群里。

h. 验证群内插件，在猪舍监控体系测试群中进行群内插件验证。

至此完成猪舍监控体系场景群实践流程。

六、Q&A

Q：场景群机器人和普通机器人有什么区别？

A：从能力上来讲二者没有什么区别，都可以通过机器人向群内发消息。但是通过群模版绑定了机器人，只要通过群模板创建的群，会默认启动该机器人；如果是普通机器人，则需要企业管理员或群管理员手动将机器人添加到群里，才可以通过机器人把消息发送到群里。

Q：企业内部的机器人如何发互动卡片？

A：目前已经开放的接口已经支持通过群模版创建的机器人向群内发送互动卡片，也支持企业内部的机器人发送单聊消息的互动卡片，接下来会开放企业内部群（非场景群、非模版创建群）接口，实现企业内部机器人发送向群内发送互动卡片消息。

Q：创建场景群机器人后，场景群里添加机器人后看不到这个机器人是什么原因？

A：有两个可能性，1、机器人是否已通过审核上架；2、通过群模板的创建过程可能存在延迟。

Q：在场景群有一些敏感消息，是否可以设置浏览权限？

A：这个可以通过卡片消息设置比如userID的方式，只有在这个ID列表中的成员才可以查看。如果不设置该成员列表，则默认群内所有人都可以查看。