お知らせ・リリースノート

製品アップデート情報

Tencent Cloudオーディオビデオ端末SDKの再生アップグレードおよび承認チェック追加に関するお知らせ

TRTCアプリケーションのサブスクリプションパッケージサービスのリリースに関する説明について

製品の説明

製品概要

基礎概念

製品の機能

製品の強み

ユースケース

性能データ

購入ガイド

Billing Overview

無料時間の説明

Monthly subscription

Pay-as-you-go

TRTC Overdue and Suspension Policy

課金に関するよくあるご質問

Refund Instructions

初心者ガイド

Demo体験

Call

コンポーネントの説明（TUICallKit）

Activate the Service

Run Demo

クイック導入

オフライン通知

Conversational Chat

クラウドレコーディング（TUICallKit）

AI Noise Reduction

インターフェースのカスタマイズ

Calls integration to Chat

Additional Features

No UI Integration

Server APIs

Client APIs

Solution

ErrorCode

公開ログ

よくある質問

ライブ配信

Billing of Video Live Component

Overview

Activating the Service (TUILiveKit)

Demo のクイックスタート

No UI Integration

UI Customization

Live Broadcast Monitoring

Video Live Streaming

Voice Chat Room

Advanced Features

Client APIs

Server APIs

Error Codes

Release Notes

FAQs

RTC Engine

Activate Service

SDKのダウンロード

APIコードサンプル

Usage Guidelines

クライアント側 API

高度な機能

RTC RESTFUL API

History

Introduction

API Category

Room Management APIs

Stream mixing and relay APIs

On-cloud recording APIs

Data Monitoring APIs

Pull stream Relay Related interface

Web Record APIs

AI Service APIs

Cloud Slicing APIs

Cloud Moderation APIs

Making API Requests

Call Quality Monitoring APIs

Usage Statistics APIs

Data Types

Appendix

Error Codes

コンソールガイド

アプリケーション管理

使用統計

監視ダッシュボード

開発支援

Solution

Real-Time Chorus

よくあるご質問

課金関連問題

機能関連

UserSig関連

ファイアウォールの制限の対応関連

インストールパッケージの圧縮に関するご質問

AndriodおよびiOS関連

Web端末関連

Flutter関連

Electron関連

TRTCCalling Web関連

オーディオビデオ品質関連

その他のご質問

旧バージョンのドキュメント

TUIRoom（Web）の統合

TUIRoom (Android)の統合

TUIRoom (iOS)の統合

TUIRoom (Flutter)の統合

TUIRoom (Electron)の統合

TUIRoom APIのクエリー

クラウドレコーディングと再生の実現（旧）

Protocols and Policies

セキュリティコンプライアンス認証

セキュリティホワイトペーパー

情報セキュリティの説明

Service Level Agreement

Apple Privacy Policy: PrivacyInfo.xcprivacy

TRTC ポリシー

プライバシーポリシー

データ処理とセキュリティ契約

用語集

Webhook After Creating Battle

PDF

フォーカスモード

フォントサイズ

最終更新日: 2026-03-27 11:42:01

Feature Description
The app server can use this webhook to monitor battle started.
Must-Knows
To enable the webhook, the webhook must be configured URL, and turn on the switch corresponding to this webhook protocol. For configuration methods, see Third-party Webhook Configuration Document.
The direction of the webhook is that the live backend initiates an HTTP POST request to the app backend.
After receiving the webhook request, the app backend must verify whether the parameter SDKAppID in the request URL is its own SDKAppID.
Scenarios That May Trigger This Webhook
After creating a battle with , it can directly enter the started state without waiting when .
After the battle is created, once all callees have processed the battle request, as long as there is at least one room owner of the callee who agrees to join the battle, the battle officially begins.
Timing Of Webhook Occurrence
After the battle is officially launched.
API Description
Request URL Sample:
In the following example, the webhook URL configured for the App is https://www.example.com.
Example:
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform
Description Of Request Parameters
Parameter
Description
https
Request Protocol: HTTPS, Request Method: POST.
www.example.com
Webhook URL.
SdkAppid
The SDKAppID assigned in the Chat console when creating an application.
CallbackCommand
Fixed as Live.CallbackAfterStartBattle.
contenttype
The fixed value is json.
ClientIP
Client IP, format as: 127.0.0.1.
OptPlatform
Client platform. For the value, see Introduction to Third-Party Webhook for the parameter meaning of OptPlatform.
Request Packet Sample
{
    "CallbackCommand": "Live.CallbackAfterStartBattle",  
    "BattleId": "4siHsNsWN/T3aub9zKraqI4zZAyPRpXQhdtKv1q4HOs=", // battle id
    "Duration": 60000, // battle duration
    "CreateTime": 1739954005, // battle creation time, in seconds
    "StartTime": 1739954005, // battle start time, in seconds
    "FromRoomInfo": {  // Caller information in battle
        "RoomId": "pk-3",
        "Owner_Account": "brennan"
    },
    "ToRoomList": [ // Called party information in battle
        {
            "RoomId": "pk-5",
            "Owner_Account": "tandy"
        }
    ],
    "EventTime": 1739954005000, // Callback trigger time, in milliseconds
}
Description Of Request Packet Fields
Field
Type
Description
CallbackCommand
String
Webhook command.
BattleId
String
Battle ID.
Duration
Integer
Battle duration in milliseconds.
CreateTime
Integer
Creation time of the battle, Unix time.
StartTime
Integer
Start time of the battle, Unix time.
FromRoomInfo
String
Caller information in battle.
ToRoomList
Array
Information of the callee participating in the battle.
RoomId
String
Room ID.
Owner_Account
String
The owner ID of room.
EventTime
Integer
Millisecond-level timestamp triggered by the event.
Response Packet Example
After the app synchronizes data in the background, it sends a webhook response packet.
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0 // Ignore webhook result
}
Description Of Response Packet Fields
Field
Type
Attribute
Description
ActionStatus
String
Required
Result of request processing. OK indicates success and FAIL indicates failure.
ErrorCode
Integer
Required
Error code. Fill in 0 here to ignore the webhook result.
ErrorInfo
String
Required
Error message.
Reference
﻿Introduction to Third-Party Webhook﻿

ヘルプとサポート

この記事はお役に立ちましたか？

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

tencent cloud

Tencent Real-Time Communication

Webhook After Creating Battle

Feature Description

Must-Knows

Scenarios That May Trigger This Webhook

Timing Of Webhook Occurrence

API Description

Request URL Sample:

Description Of Request Parameters

Request Packet Sample

Description Of Request Packet Fields

Response Packet Example

Description Of Response Packet Fields

Reference

ヘルプとサポート

Parameter	Description
https	Request Protocol: HTTPS, Request Method: POST.
www.example.com	Webhook URL.
SdkAppid	The SDKAppID assigned in the Chat console when creating an application.
CallbackCommand	Fixed as `Live.CallbackAfterStartBattle`.
contenttype	The fixed value is `json`.
ClientIP	Client IP, format as: `127.0.0.1`.
OptPlatform	Client platform. For the value, see Introduction to Third-Party Webhook for the parameter meaning of OptPlatform.

Field	Type	Description
CallbackCommand	String	Webhook command.
BattleId	String	Battle ID.
Duration	Integer	Battle duration in milliseconds.
CreateTime	Integer	Creation time of the battle, Unix time.
StartTime	Integer	Start time of the battle, Unix time.
FromRoomInfo	String	Caller information in battle.
ToRoomList	Array	Information of the callee participating in the battle.
RoomId	String	Room ID.
Owner_Account	String	The owner ID of room.
EventTime	Integer	Millisecond-level timestamp triggered by the event.

Field	Type	Attribute	Description
ActionStatus	String	Required	Result of request processing. OK indicates success and FAIL indicates failure.
ErrorCode	Integer	Required	Error code. Fill in 0 here to ignore the webhook result.
ErrorInfo	String	Required	Error message.