跳到主要内容

会话标签功能概述

会话标签是融云即时通讯（IM）服务提供的会话分组管理功能。通过为会话添加标签，您可以对会话进行灵活的分类、管理和展示，提升会话列表的组织效率和用户体验。

会话标签功能适用于企业办公、社交聊天、客服系统等多种场景，帮助您更好地管理和查找相关会话。

功能特性​

标签管理能力​

  • 标签数量限制：每个用户最多可以创建 20 个会话标签
  • 会话数量限制：通过服务端 API，您总共可添加 1000 个会话
  • 覆盖机制：当标签数量超过 1000 个时，新添加的会话会替换最早添加的会话
  • 多标签支持：单个会话可以同时属于多个标签

支持的会话类型​

会话标签功能支持以下会话类型：

  • 二人会话（conversationType: 1）：单聊会话
  • 群组会话（conversationType: 3）：群聊会话
  • 系统会话（conversationType: 6）：系统消息会话
提示

会话标签功能不适用于聊天室、超级群。

应用场景​

会话标签功能可以满足多种业务场景需求：

场景一：企业办公分组​

在企业办公环境中，您可以通过标签对工作相关的会话进行分类：

  • 部门群：将同部门的群聊会话归类
  • 项目组：按项目划分相关讨论群
  • 客户对接：标记与客户沟通的会话
  • 内部协作：区分内部协作与外部沟通

场景二：社交关系管理​

在社交应用中，您可以按照关系亲密度或类型进行分组：

  • 家人：家庭成员相关会话
  • 朋友：好友聊天会话
  • 同事：工作同事会话
  • 同学：校友、同学会话

场景三：会话优先级管理​

根据会话的重要程度进行标签分类：

  • 重要：需要优先处理的会话
  • 工作：工作相关的正式沟通
  • 日常：日常闲聊会话
  • 临时：临时性讨论会话

API 功能分类​

会话标签相关的服务端 API 按功能可分为两个主要类别：

用户标签管理 API 用于创建、查询和删除用户的标签信息。这是您使用会话标签功能的基础。

功能描述API 接口说明
设置用户会话标签设置用户会话标签为用户创建标签信息，包括标签 ID 和标签名称。您需要先创建标签才能为会话设置标签。单次最多可创建 20 个标签。
获取用户会话标签列表获取用户会话标签列表查询指定用户创建的所有标签信息，包括标签 ID、名称和创建时间。用于管理和查看用户的标签体系。
删除用户会话标签删除用户会话标签删除用户的一个或多个标签。删除标签时会同时解除标签与会话的关联关系。单次最多可删除 20 个标签。
提示
  • 标签 ID 长度不超过 20 个字符，单个用户下标签 ID 不能重复
  • 标签名称长度不超过 15 个字符
  • 单次操作最多支持 20 个标签

使用流程​

典型的会话标签使用流程如下：

  1. 创建标签：使用设置用户会话标签 API 为用户创建标签信息
  2. 标记会话：使用设置会话所属标签 API 将会话添加到标签下
  3. 查询管理：
  4. 维护更新：
最后于 更新