API 参考
圈组

IM 会话已读数据抄送

更新时间: 2024/07/17 17:57:35

网易云信服务端可以通过抄送功能将会话(单聊和群聊)的已读数据实时同步至您预设的服务器,满足您的应用对于会话已读/未读数据的本地存储和相关业务处理的需求。

当客户端清理会话未读数时(标记为已读)会触发该抄送,如清空未读数等操作。

会话事件消息抄送对应的抄送类型(eventType)为 85,更多消息抄送类型请参见消息抄送类型

本文示例均假设您预设的服务器地址为http://yunxinservice.com.cn/receiveMsg.action

前提条件

本抄送功能需要单独开通后才能使用。如需开通,可通过云信控台自助开通(应用管理->应用配置->消息抄送->抄送类型->会话已读回执),具体请参考开通和配置消息抄送

抄送数据 JSON 字段说明

会话中的以下字段信息,可抄送至您指定的服务器。

参数 类型 说明
eventType String 值为 85,表示是会话已读数据抄送事件
msgType String 消息类型, 0:单聊会话的消息,1:群聊会话的消息
ackMsgTime Long 会话最后一条消息的已读时间戳。如果会话最后一条消息已读,则默认会话所有消息都已读
accid String 发送已读动作的云信 accid
ackAccid String 已读会话对应的云信 accid,msgType 为 0 时可用
ackTeamId String 已读会话对应的云信群组 id,msgType 为 1 时可用

请求示例(curl)

单聊会话已读

curl -X POST -H "Content-Type: application/json" -H "CurTime: 1440570500855" -H "MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01" -d '{"ackAccid":"84851","msgType":"0","accid":"yx","eventType":"85","ackMsgTime":"1658283011566"}' 'http://yunxinservice.com.cn/receiveMsg.action'

群聊会话已读

curl -X POST -H "Content-Type: application/json" -H "CurTime: 1440570500855" -H "MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01" -d '{"ackTeamId":"2348369454","msgType":"1","accid":"yx1","eventType":"85","ackMsgTime":"1658283965194"}' 'http://yunxinservice.com.cn/receiveMsg.action'

请求示例(HTTP)

单聊会话已读

POST  /receiveMsg.action   HTTP/1.1
Host:  yunxinservice.com.cn
Content-Type:  application/json
CurTime: 1440570500855    //当前UTC时间戳,从1970年1月1日0点0 分0 秒开始到现在的毫秒数(String)
MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   //根据请求中的request body计算出来的MD5值。
CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01

{"ackAccid":"84851","msgType":"0","accid":"yx","eventType":"85","ackMsgTime":"1658283011566"}

群聊会话已读

POST  /receiveMsg.action   HTTP/1.1
Host:  yunxinservice.com.cn
Content-Type:  application/json
CurTime: 1440570500855    //当前UTC时间戳,从1970年1月1日0点0 分0 秒开始到现在的毫秒数(String)
MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   //根据请求中的request body计算出来的MD5值。
CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01

{"ackTeamId":"2348369454","msgType":"1","accid":"yx1","eventType":"85","ackMsgTime":"1658283965194"}
此文档是否对你有帮助?
有帮助
去反馈
  • 前提条件
  • 抄送数据 JSON 字段说明
  • 请求示例(curl)
  • 单聊会话已读
  • 群聊会话已读
  • 请求示例(HTTP)
  • 单聊会话已读
  • 群聊会话已读