消息抄送服务

功能概述

消息抄送是一种云信消息同步服务,通过这一服务,可以将消息/事件等数据实时同步给第三方开发者服务器。开发者可以通过该服务实现自主的历史消息存储、同步用户在线状态、特殊事件处理等功能。

抄送类型

抄送类型 类型说明
会话类型抄送 会话类型的消息,目前包括单聊消息,群聊消息,群组操作,好友操作
登录事件抄送 用户登录事件的消息
登出事件抄送 用户登出事件的消息
聊天室消息抄送 聊天室中聊天的消息
实时音视频/白板通话消息抄送 汇报实时音视频通话时长、白板事件时长的消息
音视频/白板文件存储信息抄送 表示音视频/白板存储文件的大小、下载地址等消息
单聊消息撤回抄送 表示单聊消息撤回抄送
群聊消息撤回抄送 表示群聊消息撤回抄送
主播或管理员进出聊天室事件抄送 汇报主播或管理员进出聊天室事件消息
专线电话通话结束回调抄送 汇报专线电话通话结束回调抄送的消息
短信回执抄送 汇报短信回执抄送的消息
短信上行抄送 汇报短信上行消息

抄送服务配置

若需要使用消息抄送功能,需要先配置接受抄送的URL地址。具体步骤如下:

  1. 登录网易云控制台:http://app.netease.im/login

  2. 点击需要开启抄送服务的应用,进入应用管理页,点击「消息抄送配置」,下拉找到消息抄送配置模块

    消息抄送配置

    消息抄送配置

  3. 输入消息抄送配置地址,点击校验按钮,校验成功后,即可开启消息抄送功能。校验说明请参见:抄送地址检验说明

  4. 配置成功后,可以在下方勾选所需要的抄送类型。目前部分抄送类型暂不支持自助开通配置,如有需要,请联系您的客户经理。

其他说明

  1. 抄送消息时,若开发者服务器处于离线状态或者由于其他原因导致连接不上消息接收地址,网易云通信会根据一定策略再尝试抄送一定次数,若开发者服务器仍然无法连接,默认情况下,网易云通信将会丢弃抄送失败的消息。若有特殊需求不能丢弃消息,请联系客户经理以获得帮助。
  2. 考虑到网络环境的不稳定,为了确保开发者的消息接口能收到抄送的消息,网易云通信可能会重复发送同一条消息,建议开发者对所收到的消息进行一定的去重操作
  3. 网易云通信消息抄送服务对于一条消息是否抄送成功具有超时判定机制(超时时间为 5s ),若超时,将会尝试重新抄送一定次数。如果第三方消息接收接口在接收到消息之后,会做比较耗时的操作(例如 DB 入库等操作)的话,建议将该接口做成异步机制(例如可以将消息先存到 MQ 中),以免被网易云通信判定为超时;

消息抄送服务端开发指南详见:服务端API开发文档:消息抄送