开通消息抄送服务

更新时间: 2023/09/27 07:22:59

消息抄送服务可以将互动白板业务下的消息或事件等数据,以 HTTP/HTTPS 请求的形式实时同步给您预设的服务器。使用消息抄送服务之前需要在网易云信控制台中配置抄送地址,并联系商务经理或技术支持开通互动白板消息抄送服务。

前提条件

  • 已开通互动白板产品。

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

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

    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 应判断为非必传字段。否则可能会导致抄送地址校验失败。

背景信息

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

操作步骤

  1. 登录网易云信控制台

  2. 在控制台首页应用管理中选择应用进入应用配置页面。

  3. 在顶部选择消息抄送页签,单击编辑,填写消息抄送地址,并单击确定

    开通消息抄送.png

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

    • 如果控制台提示校验失败,请确认抄送地址和本地处理逻辑的正确性,可以使用 Postman 等工具辅助自测。
    • 如果您的抄送地址是 IM 和互动白板共用,对于收到的云信服务器发送的请求,HTTTP Header 中的 type 字段应判断为非必传字段,否则可能会导致抄送地址校验失败。
  4. 配置完抄送地址后,联系商务经理或技术支持开通对应的互动白板事件消息抄送功能。

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