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

Interface for Obtaining Outbound Call Tasks

Scenario

This interface is used by the CTI-OBS to obtain outbound call tasks.

Method

Post

URI

https://Domain name/rest/isales/v1/openapi/obs/business/tasks. An example of the domain name is service.besclouds.com.

Request Description

Table 1 Request header parameters

No.

Parameter

Value Type

Mandatory or Not

Description

1

Authorization

String

Yes

Authentication token.

2

Content-Type

String

No

The value is application/json.

Table 2 Request body parameters

No.

Parameter

Mandatory or Not

Value Type

Description

1

subCCNo

Yes

String

ID of a call center.

2

vdnId

Yes

String

ID of a VCC.

Response Description

  • Response status code: 200
    Table 3 Response body parameters

    No.

    Parameter

    Value Type

    Description

    1

    result

    String

    Error code. The options are as follows:

    0: success

    Other values: failure

    2

    resultData

    Object

    Object in the returned result after a successful query.

    Table 4 resultData object

    No.

    Parameter

    Value Type

    Description

    1

    serviceId

    String

    Keyword of an outbound call task.

Error Codes

  • Response status code: 400

    Incorrect request. Check the request path and parameters.

  • Response status code: 401

    Unauthorized operation. 1. Check whether you have purchased related services. 2. Contact customer service to check the status of your account.

  • Response status code: 403

    Authentication failed.

  • Response status code: 404

    The requested content is not found. Check the request path.

  • Response status code: 500

    Business failure. Check the values of parameters in the request.

Example

  • Request header:
Authorization:Bearer e3fca9398eaa5cef4b57b523b9c75fae
Content-Type:application/json

  • Request message:
{
       "subCCNo":1,
       "vdnId":1       
}

  • Response message:
    {
           "result":0, 
          "resultData":{
            "taskData":[
            {
                "serviceId":"12345",   }
     
    ]
           } 
    }