Help Center/ Cognitive Engagement Center/ API Reference/ Agent Workbench Interface Reference/ App Personal Settings/ Creating App Personal Settings (create)
Updated on 2023-09-27 GMT+08:00
View PDF

Creating App Personal Settings (create)

Scenario

This interface provided by the AICC is invoked to create app personal settings for the AppCube.

Method

POST

URI

https://{Domain name}/apiaccess/CC-Management/v1/openapp/agentsettings/create, where, Domain name can be service.besclouds.com.

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory or Not

Description

1

X-APP-Key

String

Yes

App key, which is the user ID.

2

Authorization

String

No

Authentication field. The format is Bearer (space){Value of AccessToken returned by the tokenByAkSk interface}. (A space is required after Bearer.)
Table 2 Request body parameters

No.

Parameter

Type

Mandatory or Not

Description

1

callType

String

No

Call type.

0: direct call

1: bidirectional call

2: pass-through call

2

userId

String

Yes

User ID.

Value of USER_ID in the t_aicc_pub_appcube_user table.

3

callerPresent

String[]

No

Display number of the called party.

A maximum of five numbers are displayed. Use commas (,) to separate multiple numbers.

Length limit of each number: string (15)

4

callNumber

String[]

No

Agent softphone number.

A maximum of five numbers are displayed. Use commas (,) to separate multiple numbers.

Length limit of each number: string (15)

5

callNumberDefault

String

No

Default softphone number bound to the agent.

Length limit: string (15)

6

callerPresentDefault

String

No

Default display number of the called party.

Length limit: string (15)

Response Description

  • Status code: 200
    Table 3 Response body parameters

    No.

    Parameter

    Type

    Mandatory or Not

    Description

    1

    id

    String

    No

    Primary key ID.

    2

    returnCode

    String

    Yes
    • 0: success
    • Other values: failure

    3

    returnDesc

    String

    No

    Response result description.
  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

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

  • Status code: 404

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

  • Status code: 500

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

Error Codes

None

Example

Request header:

x-app-key:9******************************3  
Authorization:Bearer e******************************e  
Content-Type:application/json
Request parameters: 
{
"callType":"1",
"userId":"1660270845627002401",
"callerPresent":["12323","232232","12323","12323"],
"callNumber":["12323","232343","233","232343"],
"callNumberDefault":"23232323",
"callerPresentDefault":"1212121212"
}

Response header:

{
	"connection": "keep-alive",
	"content-type": "application/json;charset=UTF-8"
}

Response parameters:

{
"returnCode": "0",
"returnDesc": "The AgentSettings created successfully.",
"id": "1307145259662215169"
}
Parent topic: App Personal Settings