修改消息

大约 2 分钟

修改消息

消息修改后,声网服务器会按照发送后回调规则向你的 App Server 发送回调请求,App Server 可通过该回调查看修改后的消息,进行数据同步。

提示

  1. 如果需要消息修改事件,你需要在环信控制台open in new window设置发送后回调规则,详见配置发送后回调规则
  2. 发送后回调的相关介绍,详见回调说明

回调时机

  1. 客户端修改各类消息。
  2. 调用 RESTful API 修改文本或自定义消息。

回调请求

请求示例

{
    "callId":"XXXX#XXXX_8924312242322", 
    "timestamp": 1737454241444,
    "appkey": "XXXX#XXXX",
    "from": "user1",
    "to": "user2",
    "msg_id": "1373914689292994516",
    "chat_type": "edit",
    "payload": {
        "bodies": [
            {
                "msg": "rest消息",
                "type": "txt"
            }
        ],
        "edit_message_id": "1373914550281177044",
        "from": "p1",
        "meta": {
            "edit_msg": {
                "count": 1, 
                "edit_time": 1737454241444,
                "operator": "easemob_rest_app_admin", 
                "send_time": 1737454209069,
                "sender": "p1" 
            }
        },
        "to": "p2",
        "type": "edit"
    },
    "securityVersion":"1.0.0",
    "security":"2ca02c394bef9e7abc83958bcc3156d3"
}

请求字段说明

回调请求包体字段描述:

字段数据类型描述
callIdStringcallId 为每个回调请求的唯一标识。
timestamplong环信服务器接收到此消息的 Unix 时间戳,单位为 ms。
appkeyString你在环信管理后台注册的应用唯一标识。
fromString内部字段,开发者可忽略。
toString内部字段,开发者可忽略。
msg_idString该消息修改事件消息的 ID。
chat_typeStringedit,表示修改消息。
securityVersionString安全校验版本,目前为 1.0.0。开发者可忽略该参数。
securityString签名,格式如下: MD5(callId+secret+timestamp)。Secret 见配置环信控制台回调规则

payload 为事件内容,其中的字段如下表所示:

字段数据类型描述
bodiesJSON Array修改消息的具体内容。与通过 RESTful API 发送过来的一致,查看 历史消息内容
edit_message_idString被修改的原消息 ID。
fromString修改消息的发送方。
meta.edit_msgJSON消息修改详情。
meta.edit_msg.countJSON消息修改次数。
meta.edit_msg.edit_timeLong消息修改时间。
meta.edit_msg.operatorString修改消息的用户。easemob_rest_app_admin 表示 app 管理员。
meta.edit_msg.send_timeLong原消息的发送时间。
meta.edit_msg.senderString原消息的发送方。
toString消息接收方。
- 单聊为接收方用户 ID;
- 群聊为群组 ID;
- 聊天室聊天为聊天室 ID。
typeString消息修改事件,值为 edit