消息发送后回调

描述

用户发送单聊、群聊、房间消息成功或失败后，业务后台可以接收 ZIM 服务端的发送消息回调，将用户发送的消息实时同步至业务服务器，并存储于业务服务器。

回调说明

• 请求方法：POST。

  • 回调数据需要 UrlDecode 解码。
  • 使用 POST 请求方法传递参数时：
    • Body 中的参数直接传 JsonObject 格式即可，无需序列化为 String 格式。
    • Headers 中，设置 “Content-type” 为 “application/json”。

• 请求地址：请在 ZEGO 控制台 上配置回调地址，配置流程请参考控制台文档 ZIM 相关回调配置。

• 传输协议：HTTPS/HTTP，建议使用 HTTPS。

回调参数

msg_body JSON 字符串解析结果参数说明

数据示例

• POST/JSON

{
    "appid": "1",
    "event": "zim_send_msg",
    "nonce": "350176",
    "signature": "signature",
    "timestamp": 1679553625,
    "from_user_id": "350176117361",
    "conv_type": 0,
    "conv_id": "group1",
    "msg_type": 1,
    "msg_body": "msg_body",
    "msg_id": "857639062792568832",
    "payload": "payload",
    "msg_time": 1679554146000,
    "send_result": 0,
    "sub_msg_type": 0,
    "user_list":[
        {"user_id":"userid1","msg_id": "857639062792568822",},
        {"user_id":"userid2","msg_id": "857639062792568833",}
    ]
}

返回响应

收到回调后，如果您的服务器返回的 HTTP status code 为 2XX （例如 200），表示成功；返回其他，表示失败。

回调重试策略

如果 ZEGO 服务器没有收到响应，或收到的 HTTP status code 不为 2XX（例如 200），都会尝试重试，最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败，将不再重试，该回调丢失。

send_result 说明

以下仅列出了回调相关的返回码，完整返回码请参考 全局返回码。