Updated on 2025-11-13 GMT+08:00

Suspending an Outbound Call Batch

Prerequisites

You have applied for a developer account.

An outbound call task in draft, executing, or completed state exists.

Scenario

This interface is invoked to suspend an outbound batch for an outbound campaign.

Method

This interface supports only the POST method.

URL

https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/callbatch/{campaignId}/pause

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 Parameters 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.

2

campaignId

Integer

Yes

ID of an outbound campaign.

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

id

String

Yes

ID of the batch to be suspended.

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

0200007

The outbound campaign does not exist.

4

02000001

Empty parameter.

5

03000002

Batch suspension is not allowed for the outbound campaign.

6

03000004

Batch ID not found.

7

03000006

The batch has been suspended and cannot be suspended again.

Example

  • The following provides an example of the request body of this interface:
    {
        "id": "174712034211433247704877116507"
    }
  • The following provides an example of the response body of this interface:
    {
        "returnCode": "0200000",
        "resultCode": "0200000",
        "resultDesc": "success",
        "returnDesc": "success"
    }