tencent cloud

Chat

제품 소개
제품 개요
Basic Concepts
응용 시나리오
기능 소개
계정 시스템
사용자 정보 및 관계망
메시지 관리
그룹 시스템
Official Account
Audio/Video Call
사용 제한
구매 가이드
과금 개요
요금 안내
Purchase Instructions
Renewal Guide
연체 안내
Refund Policy
다운로드 센터
SDK & Demo 소스 코드
업데이트 로그
시나리오 솔루션
Live Streaming Setup Guide
AI Chatbot
대규모 엔터테인먼트 협업 커뮤니티
Discord 구현 가이드
IM을 게임에 통합하는 방법
WhatsApp Channel-style Official Account Integration Solution
Send Red Packet
Firewall Restrictions
클라이언트 APIs
SDK API(Web)
Android
iOS & macOS
Swift
Flutter
Electron
Unity
React Native
C APIs
C++
서버 APIs
Secure authentication with UserSig
RESTful APIs
Webhooks
콘솔 가이드
New Console Introduction
애플리케이션 생성 및 업그레이드
기본 설정
기능 설정
계정 관리
그룹 관리
Official Channel Management
콜백 설정
모니터링 대시보드
Viewing Guide for Resource Packages
Real-Time Monitor
개발 보조 툴
액세스 관리
Advanced Features
FAQ
uni-app FAQs
구매
SDK 관련 질문
계정 인증
사용자 정보 및 관계망
메시지
그룹
라이브 방송 그룹
닉네임 및 프로필 사진
협약 및 인증
Service Level Agreement
컴플라이언스 인증
IM 정책
개인 정보 보호 정책
데이터 개인 정보 보호 및 보안 계약
에러 코드
문의하기
문서Chat서버 APIsWebhooksContent Understanding WebhooksCloud Moderation Webhooks

Cloud Moderation Webhooks

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-03-13 11:05:41

Overview

Once Content Understanding is enabled, moderation results can be sent to your app backend using webhook configuration.

Notes

To activate webhooks, set the webhook URL and enable the corresponding switch. For configuration steps, refer to Third-Party Callback Introduction.
Webhook requests are sent from the Chat backend to your app backend via HTTP POST.
When your app backend receives a webhook request, it must verify that the SDKAppID parameter in the request URL matches your own SDKAppID.
By default, only moderation results for violations are sent via webhook. If needed, you can configure the webhook to forward all moderation results to your app backend.

API Description

Request URL Example

In this example, the webhook URL configured by the app is https://www.example.com:
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json

Request parameters

Field
Description
https
The request protocol is HTTPS, and the request method is POST.
www.example.com
Webhook URL.
SdkAppid
SDKAppID assigned in the Chat console when creating the application.
CallbackCommand
Fixed value: ContentCallback.ResultNotify.
contenttype
Request body type is always json.

Request Example

{
    "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",
    "CtxcbKeywords":["aaabbbccc","1234567"],
    "CtxcbSuggestion":"Review",
    "CtxcbLabel":"Sexy",
    "CtxcbSubLabel":"InsinuationPorn",
    "CtxcbSubLabelDesc":"XXXX",
    "CtxcbLibName":"test",    
    "CloudCustomData":"aaabbbccc"
}

Request Fields

Field
Type
Description
Scene
String
Moderation scenario:
C2C Chat = C2C
C2C Custom Message = C2CCustom
Group Chat = Group
Group Custom Message = GroupCustom
Group Profile = GroupInfo
Group Member Profile = GroupMemberInfo
Relationship Chain = RelationChain
User Profile = UserInfo
From_Account
String
UserID of the sender of the content submitted for moderation.
ContactItem
Object
Indicates the recipient of the message during moderation.
ContactType
Integer
Distinguishes whether the recipient is a group or C2C Chat:
ContactType = 1 indicates C2C Chat.
ContactType = 2 indicates Group Chat.
To_Account
String
When ContactType = 1, recipient UserID.
ToGroupId
String
When ContactType = 2, recipient GroupID.
ContentType
String
Type of content submitted for moderation:
Text = Text
Image = Image
Audio = Audio
Video = Video
TextContent
Array
When ContentType is Text, contains the text content submitted for moderation. Custom text messages may return multiple array elements; other message types return only one array element.
FileURL
String
When ContentType is Image/Audio/Video, the file URL submitted for moderation.
MsgID
String
For C2C moderation, MsgID is the C2C message MsgKey.
For Group moderation, MsgID is the group message MsgSeq. If a group message has no MsgID, it indicates the message was blocked due to violation or not delivered for other reasons.
CtxcbResult
Integer
Chat handling strategy:
1: Blocked.
0: Allowed.
CtxcbRequestId
String
Identifier for third-party content moderation service.
CtxcbKeywords
Array
Sensitive keywords detected in the text.
CtxcbSuggestion
String
Moderation suggestion from third-party content moderation service: Block/Review/Normal.
CtxcbLabel
String
Primary violation category detected during moderation: Normal/Illegal/Abuse/Polity/Ad/Porn/Sexy/Terror/Composite.
CtxcbSubLabel
String
Secondary violation category detected during moderation. This field is present only when triggered by the model.
CtxcbSubLabelDesc
String
Chinese description corresponding to the secondary violation category detected during moderation.
CtxcbLibName
String
Name of the custom keyword library triggered by keyword detection. This field is present only when keywords are matched.
CloudCustomData
String
For C2C or group message moderation, the CloudCustomData custom field in the message body is returned as-is. For other moderation scenarios, this field is empty.

Response Example

{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0
}

Response Fields

Field
Type
Description
ActionStatus
String
Processing result:
OK indicates success.
FAIL indicates failure.
ErrorCode
Integer
Error code:
0: App backend processed successfully.
1: App backend processing failed.
ErrorInfo
String
Error message.
이전 주제: Callback After the Group Owner Changed다음 주제: Callback After Sending a One-to-One Message to a Chatbot

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백