获取未读消息计数

获取当前用户的未读消息统计信息.

查询参数:

conversation_id:可选,会话ID

如果提供:返回指定会话的未读消息数量

如果不提供:返回所有会话的总未读消息数量

返回信息包含:

全局未读统计:

总未读消息数量

有未读消息的会话数量

最近未读消息的时间

会话未读统计:

指定会话的未读消息数量

最后一条未读消息的内容和时间

未读消息的发送者信息

未读消息类型:

普通文本消息

图片、文件、语音等媒体消息

@提及消息(优先级较高)

系统通知消息

群聊消息

统计特性:

实时更新:

未读计数实时更新

支持WebSocket推送更新

离线期间的消息会累计

智能过滤:

不统计已读消息

不统计已删除的消息

不统计草稿消息

不统计发送失败的消息

性能优化:

缓存未读计数减少数据库查询

批量更新提高效率

定期清理过期计数

提醒设置:

支持消息提醒开关

支持免打扰时间设置

支持关键词提醒设置

支持特定联系人提醒设置

数据准确性:

保证计数准确性,不遗漏也不重复

处理并发消息的计数同步

支持消息状态的实时同步

使用场景:

主界面未读消息提醒

会话列表未读标显示

消息中心未读统计

推送通知触发条件

权限要求: 需要用户登录
数据隔离: 只能查看自己的未读消息统计

OAuth 2.0

Password

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: /api/v1/auth/login

application/json

Successful Response

Body

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "total": 0,
        "by_conversation": {
            "property1": 0,
            "property2": 0
        }
    }
}

获取未读消息计数

Request

Request Code Samples

Responses