Meta tags:
description=概述 环信服务器收到用户发送的上行单聊、群组或聊天室消息之后、将该消息下发给目标用户之前，环信服务器会通过 HTTP/HTTPS POST 请求通知给你的应用服务器。应用服务器可以通过发送前回调实时处理用户的聊天消息，例如，拦截包含文本、图片、自定义消息等类型的消息。 发送前回调只对客户端发送的消息有效，不包含通过 RESTful API 发送的消息。...;

Headings (most frequently used words):

发送前回调, uikit, 概述, 实现步骤, 回调规则, 与发送后回调的关系, 回调示例, 常见问题, 请求示例, 请求字段说明, 响应示例, 响应字段说明, 单群聊, 聊天室, 平台, 框架,

Text of the page (most frequently used words):
valid (7), open (7), new (7), window (7), 发送前回调 (6), code (6), api (6), payload (4), http (4), callid (4), 回调规则 (4), 环信控制台 (4), xxxx (4), web (4), ios (4), android (4), 常见问题 (3), secret (3), 客户端提示 (3), custom (3), 响应字段说明 (3), 响应示例 (3), 请求字段说明 (3), timestamp (3), 请求示例 (3), https (3), post (3), 回调示例 (3), 与发送后回调的关系 (3), 实现步骤 (3), flutter (3), react (3), native (3), uikit (3), 200 (2), 调用失败时默认策略 (2), false (2), internal (2), error (2), logic (2), string (2), high (2), chatroom_msg_level (2), true (2), 具体的消息内容 (2), security (2), restful (2), msg_id (2), from (2), group_id (2), chatroom (2), chat_type (2), uuid (2), app (2), 规则配置说明 (2), sdk (2), 内容审核 (2), 服务端 (2), harmonyos (2), 文档反馈, 2026, 上次编辑于, 可能是你的服务器在发送前回调规则中配置的等待时间内未返回响应, 这种情况下, 如果你在环信控制台的发送前回调规则页面配置的, 消息则会下发, 为了避免这种情况, 建议将, 默认为, 参数的值提升, 增加至, 3000, 添加回调地址, 消息回调, 功能配置, 即时通讯, 等待响应时间, 发送前回调响应中的, 但为什么消息还是下发了, 修改后的消息内容, 若无需修改消息内容, 若需修改消息内容, 可以回传修改后的内容, 格式需与传入的消息内容一致, 默认仅支持文本消息的消息内容和扩展信息, 并且消息大小不能超过, 若要支持修改图片, 位置和自定义类型的相关内容和扩展信息, 消息大小不能超过, 需要联系商务, 对于附件类型的消息, 若要修改, 需关闭访问限制开关, 否则端上可能因访问密钥, 验证失败, 导致下载附件失败, 不支持修改透传消息, url, 请勿传该参数, object, 客户端上报的自定义发送前回调错误, 环信控制台上的, 页面中的, 设置为, 的内容为客户端提示的错误, 错误分为以下几种情况, 的内容为字符串类型, 客户端上的错误为该参数的内容, 响应中不包含, 为空字符串, 移动客户端提示, 若在指定时间内未收到应答包, 则按默认配置处理, 如果返回的应答包出现错误, 包括缺少必填字段, 或字段类型不符合约定类型, message, blocked, external, denied, 消息拦截报错时显示, 聊天室消息的优先级, low, normal, 根据你的服务器设定的规则判断消息是否合法, 消息合法, 环信服务器应下发该消息, 消息非法, 环信服务器应拦截该消息, bool, 是否必需, 响应内容不能超过, 000, 个字符, 否则环信服务器会认为是攻击, 导致回调失败, 消息发送到你的应用服务器后, 应用服务器需返回, 响应码, 状态决定是否进行下发, 环信服务若未收到响应或你的应用服务器没有返回, 该条消息会根据默认设置, 规则中的, 不会重试, 后续消息依然正常执行回调, 仅支持文本类型消息, 10000, 格式如下, md5, 消息内容, 与通过, 发送过来的一致, 消息格式文档, 消息的, 消息的接收方, 单聊为消息接收方, 群组聊天和聊天室为群组, 和聊天室, 消息的发送方, 回调消息所在的群组或聊天室, 该参数仅对群组聊天或聊天室中的消息回调生效, 聊天类型, 为单聊, 为群组聊天, 为聊天室, group, chat, 服务器接收到此消息的时间戳, 为随机生成, 作为每条回调的唯一标识, appkey, 2ca02c394bef9e7abc83958bcc3156d3, 8924312242322, user2, user1, 16934809238921545, 1600060847294, test_0990a64f, 8696, cf3b48b20e7e, 以下示例为在聊天室中发送消息, 消息发送给接收方之前, 环信服务器会向你的应用服务器发送, 正文部分为, json, 格式的字符串, 字符集为, utf, 若同时设置了消息发送前和发送后两种回调, 且消息发送前回调返回拒绝, 则消息发送后回调将不会被触发, 对同一, 可针对不同消息类型配置不同的规则, 也支持通过同一规则选择两种以上消息类型同时回调至一个指定服务器地址, 接收到消息后, 你可以根据消息类型进行分类处理, 要使用发送前回调, 你需要在, 配置回调规则, 环信服务器向你的应用服务器发送, 配置发送前回调规则, 开通回调服务, 开通消息回调服务, 发送前回调不支持群组, 聊天室的定向消息, 发送前回调支持文本, 自定义消息和合并消息, 发送前回调只对客户端发送的消息有效, 不包含通过, 发送的消息, 环信服务器收到用户发送的上行单聊, 群组或聊天室消息之后, 将该消息下发给目标用户之前, 环信服务器会通过, 请求通知给你的应用服务器, 应用服务器可以通过发送前回调实时处理用户的聊天消息, 拦截包含文本, 自定义消息等类型的消息, rest, 此页内容, 已废弃内容, 特性限制, server, 回调异常处理, 回调事件, 发送后回调, 回调概述, 错误码, rtc, 离线推送, 用户相关, 聊天室管理, 群组管理, 消息管理, token, 调用频率限制, 搜索关键词, 语音转文字, 即时推送, 消息翻译, 实时音视频, 增值服务, uni, 小程序, unity, windows, callkit, 聊天室, uniapp, 单群聊, 产品介绍, 跳至主要內容, 即时通讯im开发, 环信im文档,

Text of the page (random words):
即时通讯im开发 发送前回调 环信im文档 跳至主要內容 im 文档 v4 x v4 x open in new window v3 x open in new window v2 x open in new window 产品介绍 uikit 单群聊 uikit android ios web harmonyos uniapp react native flutter 聊天室 uikit android ios web react native flutter callkit android ios web sdk 平台 android ios web harmonyos windows 框架 react native flutter unity 小程序 uni app 服务端 增值服务 内容审核 实时音视频 消息翻译 即时推送 语音转文字 搜索关键词 登录 注册 服务端 api 概述 api 调用频率限制 token 鉴权 消息管理 群组管理 聊天室管理 用户相关 离线推送 rtc 用量 内容审核 错误码 回调 回调概述 发送前回调 概述 实现步骤 回调规则 与发送后回调的关系 回调示例 请求示例 请求字段说明 响应示例 响应字段说明 常见问题 发送后回调 回调事件 回调异常处理 server sdk api 参考 特性限制 已废弃内容 发送前回调 大约 6 分钟 此页内容 概述 实现步骤 回调规则 与发送后回调的关系 回调示例 请求示例 请求字段说明 响应示例 响应字段说明 常见问题 rest api 发送前回调 概述 环信服务器收到用户发送的上行单聊 群组或聊天室消息之后 将该消息下发给目标用户之前 环信服务器会通过 http https post 请求通知给你的应用服务器 应用服务器可以通过发送前回调实时处理用户的聊天消息 例如 拦截包含文本 图片 自定义消息等类型的消息 发送前回调只对客户端发送的消息有效 不包含通过 restful api 发送的消息 发送前回调支持文本 图片 位置 音频 视频 文件 透传 自定义消息和合并消息 发送前回调不支持群组 聊天室的定向消息 实现步骤 开通回调服务 在 环信控制台 open in new window 开通消息回调服务 配置发送前回调规则 详见 环信控制台 open in new window 规则配置说明 环信服务器向你的应用服务器发送 http https post 请求 回调规则 要使用发送前回调 你需要在 环信控制台 open in new window 配置回调规则 详见 规则配置说明 对同一 app 可针对不同消息类型配置不同的规则 也支持通过同一规则选择两种以上消息类型同时回调至一个指定服务器地址 接收到消息后 你可以根据消息类型进行分类处理 与发送后回调的关系 若同时设置了消息发送前和发送后两种回调 且消息发送前回调返回拒绝 则消息发送后回调将不会被触发 回调示例 消息发送给接收方之前 环信服务器会向你的应用服务器发送 http https post 请求 正文部分为 json 格式的字符串 字符集为 utf 8 请求示例 以下示例为在聊天室中发送消息 callid xxxx xxxx test_0990a64f xxxx xxxx 8696 cf3b48b20e7e timestamp 1600060847294 chat_type chatroom group_id 16934809238921545 from user1 to user2 msg_id 8924312242322 payload 具体的消息内容 security 2ca02c394bef9e7abc83958bcc3156d3 参数 类型 callid callid 为 appkey _ uuid 其中 uuid 为随机生成 作为每条回调的唯一标识 timestamp 环信 im 服务器接收到此消息的时间戳 chat_type 聊天类型 chat 为单聊 group 为群组聊天 chatroom 为聊天室 group_id 回调消息所在的群组或聊天室 该参数仅对群组聊天或聊天室中的消息回调生效 from 消息的发送方 to 消息的接收方 单聊为消息接收方 群组聊天和聊天室为群组 id 和聊天室 id msg_id 消息的 id payload 消息内容 与通过 restful api 发送过来的一致 查看 消息格式文档 security 签名 格式如下 md5 callid secret timestamp secret 见 环信控制台 open in new window 回调规则 请求字段说明 响应示例 valid true code hx 10000 chatroom_msg_level high payload 具体的消息内容 仅支持文本类型消息 响应字段说明 消息发送到你的应用服务器后 应用服务器需返回 http 响应码 200 和 valid 属性 根据 valid 状态决定是否进行下发 环信服务若未收到响应或你的应用服务器没有返回 valid 状态 该条消息会根据默认设置 规则中的 调用失败时默认策略 处理 不会重试 后续消息依然正常执行回调 响应内容不能超过 1 000 个字符 否则环信服务器会认为是攻击 导致回调失败 参数 类型 是否必需 描述 valid bool 是 根据你的服务器设定的规则判断消息是否合法 true 消息合法 环信服务器应下发该消息 false 消息非法 环信服务器应拦截该消息 chatroom_msg_level string 否 聊天室消息的优先级 high 高 normal 普通 low 低 code string 否 客户端上报的自定义发送前回调错误 环信控制台上的 发送前回调 页面中的 消息拦截报错时显示 设置为 报错 时 该 code 的内容为客户端提示的错误 错误分为以下几种情况 若 code 的内容为字符串类型 客户端上的错误为该参数的内容 响应中不包含 code 字段 客户端提示 custom logic denied 若 code 为空字符串 移动客户端提示 message blocked by external logic 错误 若在指定时间内未收到应答包 则按默认配置处理 客户端提示 custom internal error 错误 如果返回的应答包出现错误 包括缺少必填字段 valid 或字段类型不符合约定类型 客户端提示 custom internal error 错误 payload object 否 修改后的消息内容 若无需修改消息内容 请勿传该参数 若需修改消息内容 可以回传修改后的内容 格式需与传入的消息内容一致 目前 默认仅支持文本消息的消息内容和扩展信息 并且消息大小不能超过 1 kb 若要支持修改图片 音频 视频 位置和自定义类型的相关内容和扩展信息 消息大小不能超过 5 kb 需要联系商务 注意 对于附件类型的消息 若要修改 url 字段 需关闭访问限制开关 否则端上可能因访问密钥 secret 验证失败 导致下载附件失败 不支持修改透传消息 常见问题 q 发送前回调响应中的 valid 为 false 但为什么消息还是下发了 a 可能是你的服务器在发送前回调规则中配置的等待时间内未返回响应 这种情况下 如果你在环信控制台的发送前回调规则页面配置的 调用失败时默认策略 为 放行 消息则会下发 为了避免这种情况 建议将 等待响应时间 即时通讯 功能配置 消息回调 添加回调地址 发送前回调 默认为 200 毫秒 参数的值提升 例如 增加至 3000 毫秒 上次编辑于 环信 im 文档 环信 2026 文档反馈