| 用户会话列表 | POST | /im/v2/conversation/list | 用户会话列表(置顶优先/updatedAt 倒序)。 | 否 |
| 设置会话置顶/草稿/提醒级别 | POST | /im/v2/conversation/settings | 设置会话置顶/草稿/提醒级别(服务端代操作)。 | 否 |
| 清空会话未读 | POST | /im/v2/conversation/unread/clear | 清空会话未读。 | 是 |
| 将会话归入标签 | POST | /im/v2/conversation/tag/set | 将会话归入标签(同一会话可属多个标签,最多 20 个)。 | 是 |
| 将会话从标签移除 | POST | /im/v2/conversation/tag/remove | 将会话从标签移除。 | 否 |
| 查询用户的会话标签 | POST | /im/v2/conversation/tag/list | 查询用户的会话标签(tag 省略返回全部标签及其会话)。 | 否 |
| 查询单个会话属性 | POST | /im/v2/conversation/attribute/get | 查询单个会话属性:置顶、免打扰(notificationLevel/mute)、未读数、草稿、@ 计数、标签与最后一条消息;会话不存在返回缺省值(不创建会话)。覆盖融云 /conversation/attribute/get.json。 | 否 |
| 查询用户按会话类型设置的默认通知级别 | POST | /im/v2/conversation/type/notification/get | 查询用户按会话类型设置的默认通知级别:0 全部通知 / 1 仅 @ / 2 免打扰;未设置返回 0。conversationType 支持 1 单聊 / 2 群 / 3 聊天室 / 6 系统 / 10 超级群。覆盖融云 /conversation/type/notification/get.json。 | 否 |
| 设置用户按会话类型的默认通知级别 | POST | /im/v2/conversation/type/notification/set | 设置用户按会话类型的默认通知级别(0 全部 / 1 仅 @ / 2 免打扰),按 {app}:{user}:{conversationType} 持久化。覆盖融云 /conversation/type/notification/set.json(unpushLevel/isMuted 均可作为入参别名)。 | 是 |
| 创建会话标签 | POST | /im/v2/conversation/tag/create | 创建会话标签:tagName ≤16 字符;tagId 可选(≤32 字符,[A-Za-z0-9_.-],缺省由 tagName 派生);单用户最多 20 个标签(超出 1031)。覆盖融云 /conversation/tag/create.json。 | 否 |
| 重命名会话标签 | POST | /im/v2/conversation/tag/update | 重命名会话标签(tagId 不变)。覆盖融云 /conversation/tag/update.json。 | 否 |
| 删除会话标签 | POST | /im/v2/conversation/tag/delete | 删除会话标签,同时清除标签内会话引用;标签不存在返回 1032。覆盖融云 /conversation/tag/delete.json。 | 否 |
| 查询用户全部标签 | POST | /im/v2/conversation/tag/get | 查询用户全部标签(含 conversationCount),按创建顺序返回。覆盖融云 /conversation/tag/get.json。 | 否 |
| 把会话加入标签 | POST | /im/v2/conversation/tag/conversations/add | 把会话加入标签:单次 ≤100 条(items 支持对象数组或 "type:target" 字符串),幂等;单标签最多 1000 个会话(超出 1033)。覆盖融云 /conversation/tag/conversations/add.json。 | 否 |
| 把会话移出标签 | POST | /im/v2/conversation/tag/conversations/remove | 把会话移出标签:单次 ≤100 条,幂等。覆盖融云 /conversation/tag/conversations/remove.json。 | 否 |
| 分页查询标签内会话 | POST | /im/v2/conversation/tag/conversations/get | 分页查询标签内会话(含 top、unreadCount、lastMessageAt;limit 默认 50 上限 200)。覆盖融云 /conversation/tag/conversations/get.json。 | 否 |
| 查询某个会话所属标签列表 | POST | /im/v2/conversation/tag/of/conversation | 查询某个会话所属标签列表。覆盖融云 /conversation/tag/of/conversation.json。 | 否 |
| 标签内未读汇总 | POST | /im/v2/conversation/tag/unread/get | 标签内未读汇总(unreadCount 消息总数 + unreadConversations 有未读的会话数)。覆盖融云 /conversation/tag/unread/get.json。 | 否 |
| 标签内置顶/取消置顶会话 | POST | /im/v2/conversation/tag/top/set | 标签内置顶/取消置顶会话,同时更新会话 is_pinned;会话不在标签内返回 1034。覆盖融云 /conversation/tag/top/set.json。 | 否 |
| 删除会话记录 | POST | /im/v2/conversation/delete | 删除会话记录(列表项/未读/草稿/置顶),历史消息保留;同时从该用户所有标签移除;幂等(removed=false 表示本就不存在)。覆盖融云 /conversation/delete.json。 | 否 |