Help Center/ Customer Engagement Center/ API Reference/ Outbound Call Interface Reference/ Reserved Outbound Call Interfaces/ Updating the Result of a Reserved Outbound Call
Updated on 2025-11-13 GMT+08:00
View PDF
Share

Updating the Result of a Reserved Outbound Call

Prerequisites

  • You have applied for a developer account.

Scenario

This interface is invoked to update a reserved outbound call task.

The result of a reserved automatic outbound call is automatically updated. You do not need to invoke this interface to update the result.

Method

This interface supports only the POST method.

URL

https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/appoint/updateResult

In the URL, ip indicates the IP address of the CC-iSales server, and port indicates the HTTPS port number of the CC-iSales server.

Table 1 Parameter in the URL

No.

Parameter

Value Type

Mandatory

Description

1

vdnId

Integer

Yes

VCC ID.

The value is an integer ranging from 1 to 9999.

Request Description

Table 2 Request header parameters

No.

Parameter

Value Type

Mandatory

Description

1

Content-Type

String

Yes

The value is fixed at application/json; charset=UTF-8.

2

Authorization

String

Yes

For details about the generation mode, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication.
Table 3 Request body parameters

No.

Parameter

Value Type

Mandatory

Description

1

appointId

String

Yes

ID of a reservation task.

2

userAccount

String

No

Business account of an agent. This parameter is mandatory in scenarios other than the OP independent deployment scenario.

3

workNo

String

No

Agent ID. This parameter is mandatory in the OP independent deployment scenario.

4

callerNo

String

No

Calling number.

5

failCode

String

No

Failure cause code. The result code is obtained from the CTI. The result code 00000 indicates that the call is successful. Other result codes indicate that the call fails.

6

callId

String

No

Call record ID, which is used to associate with call data such as CDRs on the CTI.

7

busiResult

String

No

Business result ID.

8

busiSubStatus

String

No

Sub-business result ID.

9

beginTime

TimeStamp

No

Call start time.

10

endTime

TimeStamp

No

Call end time.

Response Description

Table 4 Response body parameters

No.

Parameter

Value Type

Description

1

resultCode

String

Error code. The value 0200000 indicates success, and other values indicate failure.

For details, see Table 5.

2

resultDesc

String

Description.

3

returnCode

String

Error code. The value 0200000 indicates success, and other values indicate failure.

For details, see Table 5.

4

returnDesc

String

Description.

Triggered Event

None

Error Codes

Table 5 Error code description

No.

Error Code

Description

1

0200001

Parameter error. For details about the error, see resultDesc.

2

0200006

Database operation error.

3

02000001

Empty parameter.

4

02000002

The parameter contains invalid characters.

5

02000003

The parameter length cannot exceed the maximum length.

6

04000004

The reserved outbound campaign does not exist.

Example

  • The following provides an example of the request body of this interface: 
    {
    "appointId": "174738152455111432454674595509",
    "failCode": "00000",
    "callId" :"1747316188-341779",
    "busiResult":"17549503",
    "busiSubStatus":"17124429",
    "beginTime": 1747220297000,
    "endTime":1747220365000
}
  • The following provides an example of the response body of this interface: 
    {
    "returnCode": "0200000",
    "resultCode": "0200000",
    "resultDesc": "update success",
    "returnDesc": "update success"
}