配置内容理解识别结果

聚焦模式

字号

最后更新时间： 2026-05-09 10:54:55

注意：
当前功能仅支持白名单用户使用，需开通白名单权限后方可访问。
进入 Chat 控制台 > 云端审核，选择审核配置，并下拉至最后，可看到审核结果配置模块。
﻿
﻿
﻿
返回审核结果配置
审核结果可以通过配置基础回调的方式，将结果转发给您的 App 后台。具体操作如下：
返回审核结果开关默认关闭。如果需要打开，点击审核结果配置模块右上角的编辑，打开返回审核结果按钮，点击确定。
﻿
﻿
﻿
审核结果将使用回调发送至您在基础配置中配置的 URL 地址，如果您在开启返回审核结果开关前未配置基础回调 URL，请在打开开关时弹出的弹窗中填写基础回调 URL，详情请参见 基础回调配置。
﻿
﻿
﻿
开关开启后，内容回调的结果将通过基础回调抄送到 App 后台，支持拦截、所有结果的配置选项。
注意：
App 后台在收到回调请求之后，务必校验请求 URL 中的参数 SDKAppID 是否为自己的 SDKAppID。
接口说明
请求 URL 示例
以下示例中 App 配置的回调 URL 为 https://www.example.com 。
示例：
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json
请求参数说明
参数
说明
https
请求协议为 HTTPS，请求方式为 POST。
www.example.com
回调 URL。
SdkAppId
创建应用时在 控制台分配的 SDKAppID。
CallbackCommand
固定为：ContentCallback.ResultNotify。
contenttype
请求包体固定为 JSON。
请求包示例
{
    "Scene":"C2C",
    "SdkAppId":1400187352,
    "From_Account":"jared",
    "ContactItem":{
        "ContactType":1,
        "To_Account":"Jonh"
    },
    "ContentType":"Text",
    "TextContent":[
        "aaabbbccc",
        "1234567"
    ],
    "MsgID":"1434460578_4137340972_1661154487",
    "CtxcbResult":1,
    "CtxcbRequestId":"241ed925-4c56-4357-95dd-1e6e7798f214"
}
请求包字段说明
字段
类型
说明
Scene
String
识别场景：
单聊 = C2C。
单聊自定义消息 = C2CCustom。
群聊 = Group。
群聊自定义消息 = GroupCustom。
群资料 = GroupInfo。
群成员资料 = GroupMemberInfo。
关系链 = RelationChain。
用户资料 = UserInfo。
From_Account
String
识别内容的发起者 UserID。
ContactItem
Object
消息识别时，表示消息接收对象。
ContactType
Integer
消息识别时，区分接收对象为群组或单聊。
ContactType = 1表示单聊。
ContactType = 2表示群聊。
To_Account
String
ContactType = 1时，表示消息接收方 UserID。
ToGroupId
String
ContactType = 2时，表示消息接收方 GroupID。
ContentType
String
表示识别的内容类型：
文本 = Text。
图片 = Image。
音频 = Audio。
视频 = Video
TextContent
Array
当 ContentType 为 Text 时，表示识别的文本内容。
FileURL
String
当 ContentType 为 Image/Audio/Video 时，表示识别的文件 URL。
MsgID
String
单聊识别，MsgID 为单聊消息 MsgKey；群聊识别，MsgID 为群聊消息 MsgSeq。
CtxcbResult
Integer
云端审核服务识别结果：
1：表示拦截。
0：表示放过。
CtxcbRequestId
String
云端审核服务识别标识。
CtxcbKeywords
Array
文本命中的敏感词。
CtxcbSuggestion
String
第三方内容安全服务识别建议：Block/Review/Pass。
CtxcbLabel
String
识别命中的违规分类的一级标签: Illegal(违法) / Abuse(谩骂) / Polity(涉政) / Ad(广告) / Porn(色情) / Sexy(性感) / Terror(暴恐) / Composite(综合)。
IsRestAPI
Bool
是否为主动识别触发的回调：false=IM 内部识别触发；true=主动识别接口触发，一般为主动识别音视频结果回调。
应答包示例
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0
}
应答包字段说明
字段
类型
属性
说明
ActionStatus
String
必填
请求处理的结果：
OK：表示处理成功。
FAIL：表示失败。
ErrorCode
Integer
必填
错误码：
0：表示 App 后台处理成功。
1：表示 App 后台处理失败。
ErrorInfo
String
必填
错误码。
拦截策略设置
默认仅拦截被识别为违规的内容，如果您需要拦截疑似和违规，或者设置均不拦截，请点击编辑进行操作。点击确认，2分钟后生效。
﻿
﻿
﻿
注意：
拦截策略与送审策略互不影响。
下发拦截错误码
针对图文同步识别，默认下发拦截错误码，即消息发送方会收到消息被拦截的错误码提示。
如果需要发送方对被消息拦截无感知，即发送方不需要收到消息下发失败的提示，可通过关闭“下发拦截错误码”开关实现。具体操作如下：
点击审核结果配置模块右上角的编辑，关闭下发拦截错误码按钮，点击确定。
﻿
﻿
﻿
注意：
为方便您回溯消息未成功发送的原因，您需要在关闭下发拦截错误码按钮前，开启返回审核结果按钮，接收识别结果。开启返回审核结果按钮步骤详情请参见 返回审核结果。
违规字替换策略
用于配置消息内容中识别到的违规字是否做替换，仅拦截时生效，生效后会对消息内容中的违规字进行替换。
﻿
﻿
﻿
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

即时通信 IM

配置内容理解识别结果

返回审核结果配置

接口说明

请求 URL 示例

请求参数说明

请求包示例

请求包字段说明

应答包示例

应答包字段说明

拦截策略设置

下发拦截错误码

违规字替换策略

帮助和支持

参数	说明
https	请求协议为 HTTPS，请求方式为 POST。
www.example.com	回调 URL。
SdkAppId	创建应用时在控制台分配的 SDKAppID。
CallbackCommand	固定为：ContentCallback.ResultNotify。
contenttype	请求包体固定为 JSON。

字段	类型	说明
Scene	String	识别场景：单聊 = C2C。单聊自定义消息 = C2CCustom。群聊 = Group。群聊自定义消息 = GroupCustom。群资料 = GroupInfo。群成员资料 = GroupMemberInfo。关系链 = RelationChain。用户资料 = UserInfo。
From_Account	String	识别内容的发起者 UserID。
ContactItem	Object	消息识别时，表示消息接收对象。
ContactType	Integer	消息识别时，区分接收对象为群组或单聊。 ContactType = 1表示单聊。 ContactType = 2表示群聊。
To_Account	String	ContactType = 1时，表示消息接收方 UserID。
ToGroupId	String	ContactType = 2时，表示消息接收方 GroupID。
ContentType	String	表示识别的内容类型：文本 = Text。图片 = Image。音频 = Audio。视频 = Video
TextContent	Array	当 ContentType 为 Text 时，表示识别的文本内容。
FileURL	String	当 ContentType 为 Image/Audio/Video 时，表示识别的文件 URL。
MsgID	String	单聊识别，MsgID 为单聊消息 MsgKey；群聊识别，MsgID 为群聊消息 MsgSeq。
CtxcbResult	Integer	云端审核服务识别结果： 1：表示拦截。 0：表示放过。
CtxcbRequestId	String	云端审核服务识别标识。
CtxcbKeywords	Array	文本命中的敏感词。
CtxcbSuggestion	String	第三方内容安全服务识别建议：Block/Review/Pass。
CtxcbLabel	String	识别命中的违规分类的一级标签: Illegal(违法) / Abuse(谩骂) / Polity(涉政) / Ad(广告) / Porn(色情) / Sexy(性感) / Terror(暴恐) / Composite(综合)。
IsRestAPI	Bool	是否为主动识别触发的回调：false=IM 内部识别触发；true=主动识别接口触发，一般为主动识别音视频结果回调。

字段	类型	属性	说明
ActionStatus	String	必填	请求处理的结果： OK：表示处理成功。 FAIL：表示失败。
ErrorCode	Integer	必填	错误码： 0：表示 App 后台处理成功。 1：表示 App 后台处理失败。
ErrorInfo	String	必填	错误码。