概述 - 钉钉 API

本文介绍了会话管理的相关内容介绍。

什么是会话管理

会话管理是钉钉通过开放多样的方式根据业务的需要创建、设置和管理群以及群内的成员，还可以为用户提供基于具体业务场景下的群内服务，将沟通和协同融合起来，让组织成员在群聊中通过丰富的群能力实现高效的、结构化的、明确的协作和沟通，提高协同办公效率。

名词解释

术语说明

概念	说明
会话	钉钉开放的会话类型主要包括人与人单聊会话、群聊会话2种。
群成员	指群聊会话中所有的组成成员。
群管理身份	指群聊会话中具备不同群管理权限的身份类型，包括群主、群管理员、群普通成员，它们具备的群管理权限范围为群主>群管理员>群普通成员。
群角色	指群成员在群中被群主或群管理员赋予的角色，例如「产品经理」、「HR」等。
群模板	通过预设群模板，并使用群模板创建群聊会话、或将普通内部群转为套用群模板的群，你可以将集群设置项、群内机器人、群内快捷入口等于一身的多样功能一次性安装到群内，你还可以通过群模板实现对群聊会话的批量化管理；同时，群模板支持设置可见范围并在+号建群入口中展示，让组织内用户直接在钉钉端内一键创建自定义类型的群聊会话。
吊顶	群聊会话支持通过API将指定的内容填入指定群的吊顶中，展示通知、公告等信息，提高信息触达。
快捷入口	原群插件。通过群内的快捷栏快速打开常用的应用，无需跳转到工作台或应用广场，在群内实现业务高效流转群聊会话支持通过群模板和酷应用自定义指定群的快捷入口，包括具体的入口链接、顺序等；单聊机器人会话中的快捷入口也可通过API根据组织维度进行设定
互动卡片	互动卡片在会话中是动态消息的一种类型，具有动态性、可交互性、多端统一等特点，能够更丰富的去展示信息，并且促进用户即刻沟通互动。

ID说明

ID	说明
chatId	chatId用于唯一标识群聊会话，通过创建群接口返回值获取。重要后续版本中chatid将不再使用，请将openConversationId作为群会话唯一标识。
openConversationId	openConversationId用于唯一识别群聊会话，通过创建群接口返回值获取。
templateId	群模板的唯一识别ID，开发者后台-开放能力-场景群-群模板的详情页面中可获取。

会话1.0与会话2.0区别

钉钉会话管理分为「会话1.0」和「会话2.0」两代版本，两个版本均可以实现群聊会话的基本管理功能，但是会话管理2.0对群聊会话在组织协同方面做了更多功能扩充：

功能简介

功能说明	会话管理1.0	会话管理2.0
群聊会话及成员的基本管理	✅	✅
实现群聊会话中高级功能的预置（如群吊顶、群快捷入口、群机器人等）	❌	✅
根据群模板实现API批量管理群聊会话的功能	❌	✅
根据群模板自定义组织内的群类型及其功能	❌	✅

API概览

分类	会话1.0	会话2.0
群管理	创建群	创建群
更新群	更新群
查询群信息	查询群信息
更新群成员的群昵称	更新群成员的群昵称
更新群管理员	更新群管理员
批量更新群管理员	更新群管理员
设置禁止群成员私聊	—
获取入群二维码链接	—
获取会话的OpenConverstationId	—
—	新增群成员
—	删除群成员
—	设置群成员禁言状态
—	查询群禁言状态
—	查询群简要信息
—	查询群成员
—	查询群内群模板机器人
群模板	—	启用群模板
—	停用群模板
群吊顶	—	创建并开启互动卡片吊顶
—	关闭互动卡片吊顶
群助手	—	发送群模板机器人消息

概述

什么是会话管理#

名词解释#

术语说明#

ID说明#

会话1.0与会话2.0区别#

功能简介#

API概览#