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

製品アップデート情報

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 ポリシー

プライバシーポリシー

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

用語集

Start Call (By Robot)

PDF

フォーカスモード

フォントサイズ

最終更新日: 2026-01-15 21:35:49

Feature Description
The App admin can use this API to initiate a robot call.
API Call Description
Sample Request URL
https://console.tim.qq.com/v4/call_engine_http_srv/start_call_by_robot?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Request Parameters
The following table lists only the parameters involved in modification when calling this API and their descriptions. For more details about the parameters, please refer to REST API Introduction.
Parameters
Overview
xxxxxx
SDKAppID resides in the country/region where the dedicated domain name is located.
China: console.tim.qq.com
Singapore: adminapisgp.im.qcloud.com
Seoul: adminapikr.im.qcloud.com
Frankfurt: adminapiger.im.qcloud.com
Silicon Valley: adminapiusa.im.qcloud.com
Jakarta: adminapiidn.im.qcloud.com
v4/call_engine_http_srv/start_call_by_robot
Request API.
sdkappid
The SDKAppID assigned by the IM console when creating an application.
identifier
Must be an App administrator account. For more details, see App admin.
usersig
The generated signature of the App administrator account. For specific operations, see generate UserSig.
random
Enter a random 32-bit unsigned integer, value ranges from 0 to 4294967295.
contenttype
The request format is fixed as json.
Maximum Calling Frequency
200 times/second.
Sample Request Packet
Basic form
{
    "Robot_Account":"user1",
    "CalleeList_Account":["user5"],
    "Timeout":300000,
    "UserData":"userdata-12345687",
    "CallInfo":{
        "MediaType": "Audio",
        "RoomIdType":2,
        "RoomId":"roomid-1234"
    },
    "OfflinePushInfo": {
        "PushFlag": 0,
        "Title":"This is the push title",
        "Desc": "This is the offline push content"
        "Ext": "This is the transmitted content"
    }
}
Request Packet Fields
Field
Type
Attribute
Overview
Robot_Account
String
Required
Caller robot UserID. The backend does not perform heartbeat health check or busy line check on this UserID.
CalleeList_Account
Array
Required
Callee UserID list.
Timeout
Integer
Required
Timeout period (unit: ms), range: 10000 - 600000 ms.
UserData
String
Optional
Custom data will be passed to the callee side through call initiation notification, with a maximum of 1000 bytes.
CallInfo
Object
Required
Call information.
MediaType
String
Required
Media type:
Video call 
Audio call
RoomId
String
Optional
TRTC Room ID.
RoomIdType
Integer
Optional
RoomId type:
1:digit room ID.
2:string Room Number.
OfflinePushInfo
Object
Optional
Offline Push Notification Configuration. Please see Message Format Description.
Response Payload Example
Basic form
{
    "ErrorCode": 0,
    "ErrorInfo": "",
    "ActionStatus": "OK",
    "RequestId": "Id-431454f25a44462d8155bdff4fed38cc-O-Seq-19029769"
}
Response Packet Fields
Field
Type
Overview
ErrorCode
Integer
Error code: 0 indicates success, non-0 indicates failure.
ErrorInfo
String
Error Message.
ActionStatus
String
Request processing result. OK: processing successful; FAIL: processing failed.
RequestId
String
Unique request ID, returned for each request. To troubleshoot a request, its RequestId should be provided.
Error Code Description
Unless a network error occurs (such as 502), this API's HTTP return code is 200. The actual error code and error information are in the response payload's ErrorCode and ErrorInfo.
Common error codes (60000 to 79999), see the Error Code document.
Private error codes of this API are as follows:
Error Code
Description
101001
Internal server error, please retry.
101002
Invalid parameter. Check whether the request is correct according to the error description.
101004
The call does not exist, or it may have existed but has already ended.
﻿

ヘルプとサポート

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

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

フィードバック

tencent cloud

Tencent Real-Time Communication

Start Call (By Robot)

Feature Description

API Call Description

Sample Request URL

Request Parameters

Maximum Calling Frequency

Sample Request Packet

Request Packet Fields

Response Payload Example

Response Packet Fields

Error Code Description

ヘルプとサポート

Parameters	Overview
xxxxxx	SDKAppID resides in the country/region where the dedicated domain name is located. China: `console.tim.qq.com` Singapore: `adminapisgp.im.qcloud.com` Seoul: `adminapikr.im.qcloud.com` Frankfurt: `adminapiger.im.qcloud.com` Silicon Valley: `adminapiusa.im.qcloud.com` Jakarta: `adminapiidn.im.qcloud.com`
v4/call_engine_http_srv/start_call_by_robot	Request API.
sdkappid	The SDKAppID assigned by the IM console when creating an application.
identifier	Must be an App administrator account. For more details, see App admin.
usersig	The generated signature of the App administrator account. For specific operations, see generate UserSig.
random	Enter a random 32-bit unsigned integer, value ranges from 0 to 4294967295.
contenttype	The request format is fixed as `json`.

Field	Type	Attribute	Overview
Robot_Account	String	Required	Caller robot UserID. The backend does not perform heartbeat health check or busy line check on this UserID.
CalleeList_Account	Array	Required	Callee UserID list.
Timeout	Integer	Required	Timeout period (unit: ms), range: 10000 - 600000 ms.
UserData	String	Optional	Custom data will be passed to the callee side through call initiation notification, with a maximum of 1000 bytes.
CallInfo	Object	Required	Call information.
MediaType	String	Required	Media type: Video call Audio call
RoomId	String	Optional	TRTC Room ID.
RoomIdType	Integer	Optional	RoomId type: `1`:digit room ID. `2`:string Room Number.
OfflinePushInfo	Object	Optional	Offline Push Notification Configuration. Please see Message Format Description.

Error Code	Description
101001	Internal server error, please retry.
101002	Invalid parameter. Check whether the request is correct according to the error description.
101004	The call does not exist, or it may have existed but has already ended.