开通消息抄送服务

更新时间: 2024/03/25 11:00:39

消息抄送服务可以将音视频通话 2.0 业务下的消息或事件等数据,以 HTTP/HTTPS 请求的形式实时同步给您预设的服务器。使用消息抄送服务之前需要在网易云信控制台中开通消息抄送服务。

前提条件

  • 已开通音视频通话 2.0 产品。

  • 已准备接收抄送消息的服务器地址。

    为保证服务器地址的正确性,建议配置前通过以下命令校验。

    curl -H 'User-Agent: Apache-HttpClient/4.5.9 (Java/1.8.0_151)' -H 'appkey: 0eb**********************' -H 'CurTime: 1608110108512' -H 'MD5: 99914b932bd37a5**********' -H 'CheckSum: ea9e0af4****************' -X POST -d '{}' -i ${YourServerAddress}
    
  • 已在本地服务器实现消息抄送的处理逻辑。

    消息抄送的流程及注意事项请参考消息抄送服务概述

注意事项

  • 配置抄送地址时,云信会发送 POST 请求的方式自动校验该地址。
  • 如果您开通了 IM 消息抄送和音视频通话/互动直播消息抄送,且使用同一个抄送地址,那么在本地处理逻辑中,对于收到的云信服务器发送的 HTTP 请求,Header 中的 type 应判断为非必传字段。否则可能会导致抄送地址校验失败。

背景信息

消息抄送是网易云信提供的消息同步服务,通过这一服务,可以将音视频通话 2.0 业务下的消息或事件等数据,以 HTTP/HTTPS 请求的形式实时同步给您预设的服务器。可以是您的业务服务器,也可以是第三方开发者服务器。您可以通过消息抄送服务实现用户在线状态分析和特殊事件处理等业务。

操作步骤

  1. 网易云信控制台左侧导航栏中单击应用配置,单击消息抄送页签。

  2. 单击消息抄送地址右侧的编辑按钮。

    开通消息抄送.png

  3. 消息抄送地址文本框中输入消息抄送服务器的地址,单击确定

    配置抄送地址后,云信服务器通过发送 POST 请求的方式自动校验该地址。此请求 Header 为鉴权相关参数,body 为 JSON 格式,校验时请求 body 为空。如果在 5 秒内收到该地址返回 HTTP 200 状态码,则校验成功。

    • 如果控制台提示校验失败,请确认抄送地址和本地处理逻辑的正确性,可以使用 Postman 等工具辅助自测。
    • 如果您的抄送地址是 IM 和音视频通话/互动直播 2.0 共用,对于收到的云信服务器发送的请求,HTTTP Header 中的 type 字段应判断为非必传字段,否则可能会导致抄送地址校验失败。
  4. 在消息抄送类型区域,单击音视频通话2.0旁边的编辑按钮,选择需要开通的抄送类型,单击确定

    RTC消息抄送.png

    RTC消息抄送类型.png

    灰色的选项,请联系网易云信技术支持在OMS 后台开通。

此文档是否对你有帮助?
有帮助
去反馈
  • 前提条件
  • 注意事项
  • 背景信息
  • 操作步骤