会话

WuKongIM 会话的核心结构和管理方法

​

概念解释

​

什么是会话？

会话（Conversation）是用户与特定频道之间的交互记录，包含了用户在该频道中的消息历史、未读状态、最后活跃时间等信息。会话是用户界面中聊天列表的基础数据结构。

​

为什么会话很重要？

• 聊天列表：会话列表就是用户看到的聊天列表，显示所有正在进行的对话
• 未读管理：会话记录了每个聊天的未读消息数量，帮助用户快速了解哪些聊天有新消息
• 快速访问：通过会话列表，用户可以快速访问最近的聊天记录

​

与其他概念的关系

• 频道（Channel）：每个会话对应一个频道，会话的 channel_id 就是频道的 ID
• 消息（Message）：会话显示该频道的最后一条消息和未读消息数量
• 用户（User）：会话属于特定用户，不同用户看到的会话列表不同

​

核心结构

会话包含以下核心属性：

属性	类型	说明
channel_id	string	频道标识符
channel_type	integer	频道类型（1=个人，2=群组）
unread	integer	未读消息数量
last_msg_seq	integer	最后消息序号
timestamp	integer	最后更新时间戳
version	integer	会话版本号

​

会话示例

{
  "channel_id": "group123",
  "channel_type": 2,
  "unread": 5,
  "last_msg_seq": 1001,
  "timestamp": 1640995200,
  "version": 100
}

​

相关 API 端点

端点	方法	说明
/conversation/sync	POST	同步会话列表
/conversation/setUnread	POST	设置未读数量
/conversation/clearUnread	POST	清除未读数量
/conversation/delete	POST	删除会话

会话按最后消息时间排序，是用户界面中聊天列表的基础数据结构。