开通和配置第三方回调
更新时间: 2024/07/05 10:00:56
网易云信的第三方回调功能,是专为企业打造的事件响应机制。简而言之,它允许企业应用服务器主动介入事件处理流程,以实现更精细的控制。通过第三方回调功能,企业不仅可以增强消息传递的可控性,还能深度整合自身的业务流程,实现与网易云信服务的无缝对接,从而更好地满足企业级通信和内容管理的需求。
应用场景
例如,在企业内部通信或内容审核场景中,当发送方尝试发送消息时,网易云信不会立即把消息送达接收方,而是采用以下流程:
-
它首先向您的应用服务器发起一个 POST 请求,邀请您的服务器参与决策。
-
根据您服务器的反馈,网易云信再决定是否继续传递消息。
这种设计特别适用于需要对接第三方内容审查服务,或希望在消息流转中加入额外逻辑检查的企业,确保信息传递既安全又符合特定业务规则。
前提条件
根据下文操作前,请确保您已经:
开通和配置
-
在 网易云信控制台 首页 应用管理 中选择应用,然后单击 IM 即时通讯 下的 功能配置 按钮进入功能配置页。
-
顶部选择 基础功能 页签,在 第三方回调 中配置第三方回调地址(通常为您的应用服务器地址),示例:
POST https://******.com
,单击 保存 完成配置。 -
(可选)如需多环境配置,请跳转至 自定义抄送 / 第三方回调配置 进行配置。
-
在 自定义抄送/第三方回调配置 中单击右侧的 添加 按钮。
-
填写需要映射的环境名称和第三方回调地址。
-
-
单击 子功能配置,配置接口调用失败时的默认策略、第三方回调超时时间及第三方服务的校验范围。
-
接口调用失败时的默认策略:可设置第三方回调超时或其他原因失败后期望的处理策略,默认放行。
-
第三方回调超时时间:可设置第三方回调的超时时间,默认 2S。如果请求失败或者超时,网易云信 IM 服务器会使用网易云信控制台上配置的默认回调结果(放行/不放行)继续处理业务逻辑。
-
第三方服务的校验范围:勾选需要第三方服务的配置项。群组、超大群以及圈组模块下可单独选择。
聊天室消息的回调不在此处开通,需要在聊天室模块中单独开通。在 IM 功能配置页顶部选择 聊天室 页签,开通 聊天室消息回调 功能。
-
集成开发
详情请参考 回调说明。