开通和配置第三方回调

更新时间: 2024/07/05 10:00:56

网易云信的第三方回调功能,是专为企业打造的事件响应机制。简而言之,它允许企业应用服务器主动介入事件处理流程,以实现更精细的控制。通过第三方回调功能,企业不仅可以增强消息传递的可控性,还能深度整合自身的业务流程,实现与网易云信服务的无缝对接,从而更好地满足企业级通信和内容管理的需求。

应用场景

例如,在企业内部通信或内容审核场景中,当发送方尝试发送消息时,网易云信不会立即把消息送达接收方,而是采用以下流程:

  1. 它首先向您的应用服务器发起一个 POST 请求,邀请您的服务器参与决策。

  2. 根据您服务器的反馈,网易云信再决定是否继续传递消息。

这种设计特别适用于需要对接第三方内容审查服务,或希望在消息流转中加入额外逻辑检查的企业,确保信息传递既安全又符合特定业务规则。

前提条件

根据下文操作前,请确保您已经:

开通和配置

  1. 网易云信控制台 首页 应用管理 中选择应用,然后单击 IM 即时通讯 下的 功能配置 按钮进入功能配置页。

    image.png
  2. 顶部选择 基础功能 页签,在 第三方回调 中配置第三方回调地址(通常为您的应用服务器地址),示例:POST https://******.com,单击 保存 完成配置。

  3. (可选)如需多环境配置,请跳转至 自定义抄送 / 第三方回调配置 进行配置。

    1. 自定义抄送/第三方回调配置 中单击右侧的 添加 按钮。

      添加.png
    2. 填写需要映射的环境名称和第三方回调地址。

      映射环境和回调地址.png
  4. 单击 子功能配置,配置接口调用失败时的默认策略、第三方回调超时时间及第三方服务的校验范围。

    • 接口调用失败时的默认策略:可设置第三方回调超时或其他原因失败后期望的处理策略,默认放行。

    • 第三方回调超时时间:可设置第三方回调的超时时间,默认 2S。如果请求失败或者超时,网易云信 IM 服务器会使用网易云信控制台上配置的默认回调结果(放行/不放行)继续处理业务逻辑。

    • 第三方服务的校验范围:勾选需要第三方服务的配置项。群组、超大群以及圈组模块下可单独选择。

    聊天室消息的回调不在此处开通,需要在聊天室模块中单独开通。在 IM 功能配置页顶部选择 聊天室 页签,开通 聊天室消息回调 功能。

集成开发

详情请参考 回调说明

此文档是否对你有帮助?
有帮助
去反馈
  • 应用场景
  • 前提条件
  • 开通和配置
  • 集成开发