tencent cloud

Data Types
Last updated: 2025-11-11 10:20:10
Data Types
Last updated: 2025-11-11 10:20:10

AIAgentInfo

Intelligent agent info.

Used by actions: DescribeAIAgentInfoList.

Name Type Description
AIAgentId Integer Intelligent agent ID.
AIAgentName String Intelligent agent name.

AIAnalysisResult

AI conversation analytics result.

Used by actions: DescribeAIAnalysisResult.

Name Type Description
Type String Summary: describes the session summary.
mood: specifies the emotion analysis.
intention extraction.
Result String AI session analysis result.

AICallExtractConfigElement

AI call extraction configuration item.

Used by actions: CreateAICall.

Name Type Required Description
InfoType String Yes Configuration item type, including.
Text.
Selector option.
Boolean value.
Number.
InfoName String Yes Configuration item name, duplicat.
InfoContent String No Specific content of the configuration item.
Examples Array of String No Example of extracted content from the configuration item.
Choices Array of String No When infotype is selector, this field needs to be configured.

AICallExtractResultElement

AI call extraction result.

Used by actions: DescribeAICallExtractResult.

Name Type Description
InfoType String Type of extracted information.
Text.
Selector options.
Boolean value.
Number.
InfoName String Name of the extracted information.
InfoContent String Specific description of the extracted information.
Result AICallExtractResultInfo Specific result of the extracted information.

AICallExtractResultInfo

Specific information of AI call result.

Used by actions: DescribeAICallExtractResult.

Name Type Description
Text String The extracted type is text.
Chosen Array of String The extracted type is option.
Boolean Boolean The extracted type is a boolean value.
Number Float The extracted type is a number.

AILatencyDetail

AI latency details.

Used by actions: DescribeAILatency.

Name Type Description
RoundId String Dialog ID.
ASRLatency Integer Specifies the asr latency in milliseconds.
TTSLatency Integer Specifies the tts delay in milliseconds.
LLMLatency Integer llm latency (ms).
LLMFirstTokenLatency Integer llm first token latency (ms).
ETELatency Integer End-To-End delay (ms).

AILatencyStatistics

AI latency statistics.

Used by actions: DescribeAILatency.

Name Type Description
ASRLatency AILatencyStatisticsInfo Specifies the asr latency statistics.
TTSLatency AILatencyStatisticsInfo Specifies the statistics of tts delay.
LLMLatency AILatencyStatisticsInfo llm latency statistics.
ETELatency AILatencyStatisticsInfo Specifies the end-to-end latency statistics.

AILatencyStatisticsInfo

AI latency statistics.

Used by actions: DescribeAILatency.

Name Type Description
MinLatency Integer Specifies the minimum value.
MiddleLatency Integer Specifies the median.
P90Latency Integer p90

AITransferItem

AI to human configuration item.

Used by actions: CreateAICall.

Name Type Required Description
TransferFunctionName String Yes Name of the function calling for transfer to human.
TransferFunctionDesc String Yes Takes effect when transferfunctionenable is true; the description of transfer_to_human function calling defaults to "transfer to human when the user has to transfer to human (like says transfer to human) or you are instructed to do so.".
TransferSkillGroupId Integer Yes Skill group id for transferring to human agent.

AsrData

Speech-to-text information

Used by actions: DescribeTelRecordAsr.

Name Type Description
User String User side.
Message String Message content.
Start Integer Sentence start time, unix millisecond timestamp.
End Integer Sentence end time, unix millisecond timestamp.

AudioFileInfo

Audio file review information

Used by actions: DescribeIvrAudioList, UploadIvrAudio.

Name Type Description
FileId Integer File id.
CustomFileName String File alias.
AudioFileName String Filename.
Status Integer Review status: 0 - unreviewed, 1 - approved, 2 - rejected.

AutoCalloutTaskCalleeInfo

Outbound call task called information.

Used by actions: DescribeAutoCalloutTask.

Name Type Description
Callee String Called number.
State Integer Call status 0 - initial, 1 - answered, 2 - unanswered, 3 - calling, 4 - pending retry.
Sessions Array of String List of session ids.

AutoCalloutTaskInfo

Automatic outbound call task list item.

Used by actions: DescribeAutoCalloutTasks.

Name Type Description
Name String Task name.
CalleeCount Integer Number of called parties.
Callers Array of String List of calling numbers.
NotBefore Integer Start timestamp.
NotAfter Integer End timestamp
.
Note: this field may return null, indicating that no valid values can be obtained.
IvrId Integer IvrId used by the task.
State Integer Task status:.
0 initial: task creation, call not started.
1 running.
2 completed: all calls in the task are completed.
3 ending: the task has expired, but there are still some calls not ended.
4 ended: task terminated due to expiration.
TaskId Integer .

CallInMetrics

Real-Time inbound metric.

Used by actions: DescribeCallInMetrics.

Name Type Description
IvrCount Integer Number of ivr residency.
QueueCount Integer Number in queue.
RingCount Integer Number in ringing.
AcceptCount Integer Number of connections.
TransferOuterCount Integer Number of customer service transferring to the external line.
MaxQueueDuration Integer Maximum queue duration.
AvgQueueDuration Integer Average queue duration.
MaxRingDuration Integer Maximum ringing duration.
AvgRingDuration Integer Average ringing duration.
MaxAcceptDuration Integer Maximum connection duration.
AvgAcceptDuration Integer Average connection duration.

CallInNumberMetrics

Inbound line dimension metrics.

Used by actions: DescribeCallInMetrics.

Name Type Description
Number String Line number.
Metrics CallInMetrics Line-Related metrics.
SkillGroupMetrics Array of CallInSkillGroupMetrics Bound skill group metrics.

CallInSkillGroupMetrics

Inbound capability group metrics.

Used by actions: DescribeCallInMetrics.

Name Type Description
SkillGroupId Integer Skill group id.
Metrics CallInMetrics Data metrics.
Name String Skill group name.

CalleeAttribute

Property of the called.

Used by actions: CreateAutoCalloutTask, CreatePredictiveDialingCampaign, UpdatePredictiveDialingCampaign.

Name Type Required Description
Callee String Yes Called number.
UUI String No Accompanying data.
Variables Array of Variable No Parameter.

ClientInfo

Terminal information of the logged-in agent.

Used by actions: DescribeStaffStatusMetrics.

Name Type Description
ClientType String Endpoint type for login. "Web" means Web workbench. "WeChatMiniProgram" refers to wechat mini program.
IsConnected Boolean Whether the currently logged-in endpoint is in the foreground. if the endpoint is Web, the value is true. if the endpoint is WeChatMiniProgram, true indicates the wechat mini program is open, and false indicates it is in the background.

DescribePredictiveDialingCampaignsElement

Query the predictive outbound call task list elements.

Used by actions: DescribePredictiveDialingCampaigns.

Name Type Description
CampaignId Integer .
Name String Task name.
Status Integer Task status 0 - ready to start, 1 - in progress, 2 - paused, 3 - terminated, 4 - completed.
StatusReason Integer Task status reasons 0 - normal, 1 - manually ended, 2 - ended due to overtime.
CalleeCount Integer Number of called numbers.
FinishedCalleeCount Integer Number of completed calls.
Priority Integer Running priority of multiple tasks in the same application, from high to low 1 - 5.
SkillGroupId Integer ID of the used skill group of agents.

ErrStaffItem

When adding customer service personnel in batches, information of the customer service personnel with an error is returned.

Used by actions: CreateStaff.

Name Type Description
StaffEmail String Agent email address.
Code String Error code.
Message String Error description.

EventStaffDetail

Event details.

Used by actions: DescribeSessionDetail.

Name Type Required Description
Staffs Array of EventStaffElement No Specifies the agent data.

EventStaffElement

Agent information.

Used by actions: DescribeSessionDetail.

Name Type Required Description
Mail String No Agent email address.
StaffNumber String No Agent id.

ExtensionInfo

Telephone information.

Used by actions: DescribeExtensions.

Name Type Description
SdkAppId Integer Instance id.
FullExtensionId String Extension full name.
ExtensionId String Extension.
SkillGroupId String Affiliated skill group list.
ExtensionName String Extension name.
CreateTime Integer Creation time.
ModifyTime Integer Last modification time.
Status Integer Telephone status (0 offline, 100 free, 200 busy).
Register Boolean Whether to register.
Relation String Bind agent email.
RelationName String Bind agent name.

ForwardingConfig

Call forwarding configuration.

Used by actions: DescribeStaffInfoList, ModifyStaff.

Name Type Required Description
Enabled Boolean No Whether to enable.
Condition Integer No 1 unconditional call forwarding 2 conditional call forwarding.
Target ForwardingTarget No Call forwarding destination.

ForwardingTarget

Call forwarding destination.

Used by actions: ModifyStaff.

Name Type Required Description
Type Integer No Call forwarding target type. valid values: 1 (agent), 2 (skill group), 3 (extension).
StaffUserId String No Specifies the agent account when the call forwarding target is set to agent and Type is 1.
SkillGroupId Integer No Specifies the ID of the skill group as the call forwarding target. fill when Type is 2.
Extension String No The account to which the call is forwarded is an extension. fill when Type is 3.

IVRKeyPressedElement

IVR Key Information.

Used by actions: DescribeProtectedTelCdr, DescribeSessionDetail, DescribeTelCdr.

Name Type Description
Key String Hit keyword or press.
Label String Tag associated with the key.
Timestamp Integer UNIX millisecond timestamp.
NodeLabel String Node tags.
OriginalContent String User'S original input.
TTSPrompt String TTS prompt content.

Interface

Callback api.

Used by actions: BindNumberCallInInterface.

Name Type Required Description
URL String Yes API address

InvokeLLM

Service invocation actively initiates requests to the LLM.

Used by actions: ControlAIConversation.

Name Type Required Description
Content String No Specifies the content of the LLM request.
Interrupt Boolean No Whether the text is allowed to interrupt the robot speaking.

NumberInfo

Number information.

Used by actions: DescribeNumbers.

Name Type Description
Number String Number.
CallOutSkillGroupIds Array of Integer Bound outbound call skill group.
State Integer Number status, 1-normal, 2-disabled due to overdue payment, 4-disabled by the administrator, 5-disabled due to violation.

OwnNumberApplyDetailItem

User-owned number approval detail data type

Used by actions: CreateOwnNumberApply, ModifyOwnNumberApply.

Name Type Required Description
CallType Integer Yes Number type: 0 - inbound | 1 - outbound | 2 - inbound and outbound.
PhoneNumber String Yes Line number.
MaxCallCount Integer Yes Maximum concurrent call number.
MaxCallPSec Integer Yes Maximum number of concurrencies per second.
OutboundCalleeFormat String No Outbound called number format, use {+e.164} or {e.164}.
CarrierPhoneNumber String No Specifies the carrier number.

PSTNSession

PSTN session type.

Used by actions: DescribeTelSession.

Name Type Description
SessionID String Session id.
RoomID String Temporary room id for session.
Caller String Caller.
Callee String Called.
StartTimestamp Integer Start time. unix timestamp.
RingTimestamp Integer Ring time. unix timestamp.
AcceptTimestamp Integer Answer time. unix timestamp.
StaffEmail String Agent email.
StaffNumber String Agent id.
SessionStatus String Session status.
Ringing - in progress.
SeatJoining - waiting for the agent to answer.
InProgress: in progress.
Finished - completed.
Direction Integer Session call direction, 0 - inbound | 1 - outbound.
OutBoundCaller String The number used for transferring to the external line (outbound caller).
OutBoundCallee String Outbound callee.
ProtectedCaller String Caller number protection id. effective when the number protection map feature is activated, and the caller field is empty.
ProtectedCallee String Called number protection id. effective when the number protection map feature is activated, and the callee field is empty.

PSTNSessionInfo

PSTN Session Information.

Used by actions: DescribePSTNActiveSessionList.

Name Type Description
SessionID String Session id.
RoomID String Temporary room id for session.
Caller String Caller.
Callee String Called.
StartTimestamp String Start time. unix timestamp.
AcceptTimestamp String Answer time. unix timestamp.
StaffEmail String Agent email.
StaffNumber String Agent id.
SessionStatus String Agent status inprogress ongoing.
Direction Integer Session call direction, 0 - inbound | 1 - outbound.
RingTimestamp Integer Ring time. unix timestamp.
ProtectedCaller String Caller number protection id. effective when the number protection map feature is activated, and the caller field is empty.
ProtectedCallee String Called number protection id. effective when the number protection map feature is activated, and the callee field is empty.

PackageBuyInfo

Package purchase information.

Used by actions: DescribeCCCBuyInfoList.

Name Type Description
PackageId String Package id.
Type Integer Package type, 0 - outbound call package | 1 - 400 inbound call package.
CapacitySize Integer .
CapacityRemain Integer Remaining package balance.
BuyTime Integer Purchased timestamp.
EndTime Integer Deadline timestamp.

PhoneNumBuyInfo

Number purchase information.

Used by actions: DescribeCCCBuyInfoList.

Name Type Description
PhoneNum String Telephone number.
Type Integer Number type, 0 - landline | 1 - virtual business number | 2 - ISP number | 3 - 400 number.
CallType Integer Call type of the number, 1 - inbound | 2 - outbound | 3 - inbound and outbound.
BuyTime Integer Purchased timestamp.
EndTime Integer Deadline timestamp.
State Integer Number status, 1-normal | 2-suspended due to non-payment | 4-admin suspended | 5-suspended due to violation.

SdkAppIdBuyInfo

Application purchase information.

Used by actions: DescribeCCCBuyInfoList.

Name Type Description
SdkAppId Integer Application id.
Name String Application name.
StaffBuyNum Integer Agent purchase count (still within the validity period).
StaffBuyList Array of StaffBuyInfo Agent purchase list (still within the validity period).
PhoneNumBuyList Array of PhoneNumBuyInfo List of numbers purchased.
SipBuyNum Integer Number of office telephones purchased (still within the validity period).

SeatUserInfo

Agent User Information

Used by actions: CreateStaff, DescribeProtectedTelCdr, DescribeTelCdr.

Name Type Required Description
Name String Yes Agent name.
Mail String Yes Agent email.
StaffNumber String Yes Worker number.
Phone String No Agent'S telephone number (with 0086 prefix).
Nick String No Agent nickname.
UserId String No User id.
SkillGroupNameList Array of String No List of skill groups associated with the agent.
Role Integer No 1: admin.
2: quality inspector.
3: ordinary agent.
Else: custom role id.
ExtensionNumber String No Agent extension number (starting with 1 to 8, 4 - 6 digits).

ServeParticipant

Participant information.

Used by actions: DescribeProtectedTelCdr, DescribeSessionDetail, DescribeTelCdr.

Name Type Description
Mail String Agent email.
Phone String Agent phone number.
RingTimestamp Integer Ringing timestamp, unix second-level timestamp.
AcceptTimestamp Integer Answer timestamp. unix second-level timestamp.
EndedTimestamp Integer End timestamp. unix second-level timestamp.
RecordId String Recording id can be indexed to the agent side recording.
Type String Participant type: "staffseat", "outboundseat", "staffphoneseat".
TransferFrom String Transfer source agent information.
TransferFromType String Transfer source participant type is consistent with the type value.
TransferTo String Transfer destination agent information.
TransferToType String Transfer destination participant type, which is consistent with type values.
SkillGroupId Integer Skill group id.
EndStatusString String Ending status.
RecordURL String Recording url.
Sequence Integer Participant sequence number, starting from 0.
StartTimestamp Integer Start timestamp. unix second-level timestamp.
SkillGroupName String Skill group name.
CustomRecordURL String Address of the third-party cos for transferring recording.

ServerPushText

Server controls the chatbot to broadcast specified text.

Used by actions: ControlAIConversation.

Name Type Required Description
Text String No Specifies the server push broadcast text.
Interrupt Boolean No Whether to allow the text to interrupt the robot's speaking.
StopAfterPlay Boolean No Specifies whether to automatically close the dialogue task after broadcasting the text.
Audio String No Specifies the server push broadcast audio.
Format description: audio must be mono, sampling rate should be consistent with the corresponding TTS, and coded as a Base64 string.
Input rules: when the Audio field is provided, the system will not accept input in the Text field. the system will play the Audio content in the Audio field directly.
DropMode Integer No Defaults to 0. valid only when Interrupt is false.
-0 indicates that messages with Interrupt set to false will be dropped when there is an interaction.
-Indicates that when there is an interaction in progress, messages with Interrupt set to false will not be dropped but cached and processed after the current interaction is completed.

Note: when DropMode is 1, the cache allows multiple messages. if an interruption occurs subsequently, cached messages will be cleared.
Priority Integer No Message priority of ServerPushText. 0 means interruptible. 1 means not interruptible.
Note: after receiving a message with Priority=1, any other messages will be ignored (including messages with Priority=1) until the message processing of Priority=1 is complete. this field can be used together with the Interrupt and DropMode fields.
Example.
-Priority=1, Interrupt=true. specifies to Interrupt existing interaction and broadcast immediately. the broadcast will not be interrupted during the process.
-Priority=1, Interrupt=false, DropMode=1. waits for the current interaction to complete before broadcasting. the broadcast will not be interrupted during the process.
AddHistory Boolean No Specifies whether the text is added to the llm history context.

SessionEvent

Call event.

Used by actions: DescribeSessionDetail.

Name Type Required Description
Timestamp Integer No Event timestamp. Unix second-level timestamp.
EventType String No Event type. currently supports StaffHold, StaffUnhold, StaffMute, StaffUnmute.
StaffEventDetail EventStaffDetail No Describes event details related to the agent.

SetStaffStatusItem

Describes the information item for creating a staff.

Used by actions: SetStaffStatus.

Name Type Required Description
StaffUserId String Yes Agent account.
Status String Yes Status. specifies the instance status. valid values: free (idle), notReady (busy), rest (short break).
Reason String No Specifies the reason if the break state is set.

SetStaffStatusRspItem

Specifies the staff status response item.

Used by actions: SetStaffStatus.

Name Type Required Description
StaffUserId String No Agent account.
ErrorCode String No Error code. see the overall error code in the protocol.
ErrorMessage String No Error message.
Status String No Current status.
Reason String No Status if it is on break. specifies the reason.
PreviousStatus String No Previous status.
PreviousReason String No If the earlier status is on break, this is the reason.

SkillGroupInfoItem

Skill group information.

Used by actions: DescribeSkillGroupInfoList.

Name Type Description
SkillGroupId Integer Skill group id.
SkillGroupName String Skill group name.
Type String (Deprecated) type: im, tel, all (full media).
RoutePolicy String Session allocation policy.
UsingLastSeat Integer Whether the session is allocated to the last serviced agent first.
MaxConcurrency Integer Maximum concurrency number of single client service (default 1 for telephone type).
LastModifyTimestamp Integer Last modification time.
SkillGroupType Integer Skill group type 0-cell phone, 1-online, 3-audio, 4-video. .
Alias String Intra-Skill group line number.
RingAll Boolean Specifies whether to enable simultaneous ring.

SkillGroupItem

Skill group information.

Used by actions: DescribeStaffInfoList.

Name Type Description
SkillGroupId Integer Skill group id.
SkillGroupName String Skill group name.
Priority Integer Priority.
Type String Type: im, tel, all (full media).

StaffBuyInfo

Agent purchase information

Used by actions: DescribeCCCBuyInfoList.

Name Type Description
Num Integer Number of agents purchased.
BuyTime Integer Purchased timestamp.
EndTime Integer Deadline timestamp.
SipNum Integer Quantity of office telephones purchased.

StaffInfo

Agent Information with Skill Group Priority

Used by actions: DescribeStaffInfoList.

Name Type Description
Name String Agent name.
Mail String Agent email.
Phone String Agent phone number.
Nick String Agent nickname.
StaffNumber String Agent id.
RoleList Array of Integer Specifies the user role id list.
SkillGroupList Array of SkillGroupItem Affiliated skill group list.
LastModifyTimestamp Integer Last modification time.
ExtensionNumber String Agent extension number (starting with 1 to 8, 4 - 6 digits).
ForwardingConfig ForwardingConfig Call forwarding configuration.

StaffSkillGroupList

Bound skill group list for agents.

Used by actions: BindStaffSkillGroupList.

Name Type Required Description
SkillGroupId Integer Yes Skill group id.
Priority Integer No Priority of the agent in the skill group (1 is the highest, 5 is the lowest, 3 by default).

StaffStatus

Agent status.

Used by actions: DescribeStaffStatusHistory.

Name Type Required Description
Cursor String No Specifies the cursor used for querying in pagination scenarios.
Timestamp Integer No Status timestamp. Unix second-level timestamp.
Status String No Agent status free | busy | rest | notReady | afterCallWork | offline.
SessionId String No Specifies the session Id for status association.
Reason String No Reason for break.
StaffEmail String No Agent email.
StaffNo String No Agent id.

StaffStatusExtra

Supplementary Information on Agent Status

Used by actions: DescribeStaffStatusMetrics.

Name Type Description
Type String IM - text | tel - cell phone | all - full media.
Direct String IN - inbound | out - outbound.

StaffStatusMetrics

Agent status-related information

Used by actions: DescribeStaffStatusMetrics.

Name Type Description
Email String Agent email.
Status String Agent status free available | busy busy | rest on break | notready not ready | aftercallwork post-call adjustment | offline offline.
StatusExtra StaffStatusExtra Supplementary information on agent status.
OnlineDuration Integer Total online duration of the day.
FreeDuration Integer Total available duration of the day.
BusyDuration Integer Total busy duration of the day.
NotReadyDuration Integer Total not ready status duration of the day.
RestDuration Integer Total break duration of the day.
AfterCallWorkDuration Integer Adjust the total duration of after-call work for the day.
Reason String Reason for break.
ReserveRest Boolean Whether to reserve break status.
ReserveNotReady Boolean Whether to reserve not ready status.
UseMobileAccept Integer Cell phone answering pattern: 0 - off | 1 - only when offline | 2 - always.
UseMobileCallOut Boolean Cell phone outbound call switch.
LastOnlineTimestamp Integer Last online timestamp.
Note: this field may return null, indicating that no valid values can be obtained.
LastStatusTimestamp Integer Last status timestamp.
Note: this field may return null, indicating that no valid values can be obtained.
ClientInfo Array of ClientInfo Specifies the endpoint information for customer service logon.

TelCdrInfo

Phone call information

Used by actions: DescribeProtectedTelCdr, DescribeTelCdr.

Name Type Description
Caller String Caller number.
Callee String Called number.
Time Integer Call initiation timestamp, unix timestamp.
Direction Integer Call direction: 0 - inbound, 1 - outbound.
CallType Integer Call Type: 1. Voice outbound call 2. Voice Inbound call 3. Audio Inbound 5 Predictive Dialing Call 6. Internal Call between Staff
Duration Integer Call duration.
RecordURL String Recording information.
RecordId String Recording id.
SeatUser SeatUserInfo Agent information.
EndStatus Integer EndStatus corresponds one-to-one with EndStatusString. the specific enumeration is as follows:.

Scenario EndStatus EndStatusString Status description.

Incoming & outgoing calls. 1. ok. normal call.

IVR period user give up.

User give up while in queue.

Inbound call 104 ringingGiveUp. specifies the user gives up during ringing.

Inbound call 105. specifies no agent online.

Inbound call notWorkTime off hours.

IVR ends automatically (no manual intervention).

Inbound call. 100. blocklist (system side).

restrictedCallee. specifies the global outbound call risk number interception (system side).

Outbound call 109 tooManyRequest outbound call frequency control interception (system side).

Outbound call 110 restrictedArea block outgoing calls by region (system side).

restrictedTime. specifies the outbound call interception period on the system side.

202 notAnswer callee unanswered.

Outbound call 203 userReject callee reject hangup.

Power off. callee powered off.

205 numberNotExist callee nonexistent number.

Busy. specifies the callee is busy.

Outbound call 207 outOfCredit callee in arrears.

208 operatorError indicates operator channel exception.

Outgoing call caller cancellation.

Outgoing call 210 notInService callee out of service area.

Phone call in/out 211 clientError client error.

Outgoing call 212 carrierBlocked carrier blocklist.

Note: call reminder.

Outbound call 215 numberInvalid called number is invalid.

Outbound call 216 callRestricted. note: call restricted.

Callee restricted by blocklist.

Outbound call 218 areaRestricted. callee area restricted.

Prompt call forwarding.

Caller cancellation during ringing.

Caller cancel without ring.

Audio dial-in 501 call conflict VoIP user call termination.

VoIP user client timeout.

Audio dial-in 503 VoIP user client error.

Chinese description (https://www.tencentcloud.com/zh/document/product/1229/71847).

English description (https://www.tencentcloud.com/document/product/1229/71847?lang=en).
SkillGroup String Skill group name.
CallerLocation String Caller'S location.
IVRDuration Integer Time spent in ivr stage.
RingTimestamp Integer Ring timestamp. unix second-level timestamp.
AcceptTimestamp Integer Answer timestamp. unix second-level timestamp.
EndedTimestamp Integer End timestamp. unix second-level timestamp.
IVRKeyPressed Array of String IVR key information, e.g. ["1","2","3"].
HungUpSide String Hang-Up side, seat, user, system.
ServeParticipants Array of ServeParticipant Service participant list.
SkillGroupId Integer Skill group id.
EndStatusString String Refers to the EndStatus field.
StartTimestamp Integer Session start timestamp. unix second-level timestamp.
QueuedTimestamp Integer Queue entry time. unix second-level timestamp.
PostIVRKeyPressed Array of IVRKeyPressedElement Post-IVR key information (e.g. [{"key":"1","label":"very satisfied"}]).
QueuedSkillGroupId Integer Queue skill group id.
SessionId String Session id.
ProtectedCaller String Caller number protection id. effective when the number protection map feature is activated, and the caller field is empty.
ProtectedCallee String Called number protection id. effective when the number protection map feature is activated, and the callee field is empty.
UUI String Customer custom data. (user - to - user interface).
IVRKeyPressedEx Array of IVRKeyPressedElement IVR key information (e.g. [{"key":"1","label":"very satisfied"}]).
AsrUrl String Access to the asr text information address of the recording.
AsrStatus String ASRUrl status: complete.
Completed;.
Processing.
Generating.
NotExists.
No record (offline asr generation is not enabled or no package is available).
CustomRecordURL String Address of the third-party cos for transferring recording.
Remark String Remarks.
QueuedSkillGroupName String Queue skill group name.
VoicemailRecordURL Array of String Audio message recording url during call.
VoicemailAsrURL Array of String Text information address of asr audio message during a call.

TimeRange

Time range, 24-hour system, format: 09:00:00.

Used by actions: CreateAutoCalloutTask, CreatePredictiveDialingCampaign.

Name Type Required Description
StartTime String No Start time.
EndTime String No End time.

ToneWordInfo

Undertake filler word info.

Used by actions: CreateAICall.

Name Type Required Description
FirstSentenceTimeout Float No Specifies the timeout period for the first request in seconds.
ZHToneWords ZHToneWordsInfo No Undertakes a modal particle.

UploadAudioInfo

Upload Audio File Information

Used by actions: UploadIvrAudio.

Name Type Required Description
CustomFileName String Yes File alias (can be duplicated).
AudioUrl String Yes Audio file link (supports mp3 and wav formats, file size not exceeding 5mb).

UploadIvrAudioFailedInfo

Failed to upload audio file information

Used by actions: UploadIvrAudio.

Name Type Description
FileName String Filename.
FailedMsg String Reason for failure.

Variable

Variable.

Used by actions: CreateAIAgentCall, CreateAICall, CreateAutoCalloutTask, CreateIVRSession, CreatePredictiveDialingCampaign, UpdatePredictiveDialingCampaign.

Name Type Required Description
Key String Yes Variable name.
Value String Yes Variable value.

ZHToneWordsInfo

Undertake filler word.

Used by actions: CreateAICall.

Name Type Required Description
Neutral Array of String No Specifies the word list.
Positive Array of String No Positive word list.
Negative Array of String No Negative word list.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback