消息回应概述

消息回应（Message Reaction）允许用户对一条已发送成功的消息添加或移除回应，并查询回应摘要、回应列表和回应用户列表。你可以使用服务端 API 为单聊、群聊和超级群消息实现点赞、表态、轻量反馈等互动能力。

服务端 API 仅支持对云存储中的消息添加、移除和查询回应。使用前，请确认目标消息所在会话已开通对应的消息云存储能力。

功能特性

支持的会话类型

• 单聊会话：支持对单聊消息添加、移除和查询回应。
• 群聊会话：支持对群聊消息添加、移除和查询回应。
• 超级群会话：支持对超级群消息添加、移除和查询回应。若原消息发送在频道中，请在添加或移除回应时传入相同的频道 ID。

核心能力

• 添加消息回应：为指定消息添加一个回应。同一用户对同一条消息的相同回应只保留最早的一次回应时间。
• 移除消息回应：移除指定用户已添加的回应。
• 批量查询消息回应摘要：批量查询多条消息的回应摘要，适合在消息列表展示时补齐回应数据。
• 查询消息回应列表：分页查询单条消息上的所有回应类型。
• 查询消息回应用户列表：分页查询指定回应下的用户列表。

接口列表

能力	接口
添加消息回应	添加消息回应
移除消息回应	移除消息回应
批量查询消息回应摘要	批量查询消息回应摘要
查询单条消息的回应列表	查询消息回应列表
查询指定回应的用户列表	查询消息回应用户列表

限制说明

消息回应功能无需单独开通，所有应用默认可用。使用时需注意以下前提和限制：

限制项	默认值	说明
云存储前提	-	仅支持对云存储中的消息添加、移除和查询回应。单聊和群聊参见单群聊消息云端存储时长，超级群参见超级群历史消息存储。
单条消息回应数量上限	50 个	一条消息最多支持 50 个不同的回应。
单个回应用户数量上限	100 人	同一个回应最多支持 100 个用户添加。
reactionId 格式	-	服务端 API 仅支持英文字母和数字组合，长度不超过 16 个字符。跨端使用时，请确保 Android、iOS、Web 对同一种回应使用同一个 reactionId。

使用场景

消息回应功能适用于以下场景：

• 社交互动：用户对聊天消息快速表态，如点赞、点踩。
• 情感表达：用户使用不同回应表达情绪。
• 消息列表展示：业务服务端批量查询回应摘要后，下发给客户端展示。