CreateCustomCallTagging

更新时间:
复制 MD 格式

You can invoke CreateCustomCallTagging to create one or more inbound number tags under a specified instance.

Note

This API has been deprecated. We recommend migrating to CCC(2020-07-01) - CreateCustomCallTaggings for enhanced functionality and continued support. While the deprecated API remains temporarily accessible, no further updates or bug fixes will be provided.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

Instance ID.

ccc-test

CustomNumberList

string

Yes

A list of inbound control tags, formatted as a JSON array string. The number of array elements must be between 1 and 10,000. Each element in the array is an object with the following properties: number (must be a numeric string of 4 to 32 characters), description, and callTagNameList. The callTagNameList is an array whose elements are number labels (ensure that these number labels have already been created).

[{"number":"1312121****","description":"王先生","callTagNameList":["TagA"]},{"number":"1388888****","description":"张先生","callTagNameList":["TagB"]}]

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

BA03159C-E808-4FF1-B27E-A61B6E888D7F

HttpStatusCode

integer

The HTTP status code.

200

Code

string

The response code.

OK

Message

string

The response message.

Data

array<object>

The list of inbound number tags that failed to be created.

object

Information about an inbound number tag that failed to be created.

Item

string

The number of the inbound number tag that failed to be created.

1312121****

Reason

string

The reason why the creation of the inbound number tag failed.

Valid values:

  • CUSTOM_NUMBER_ILLEGAL :

    The input list contains numbers with invalid formats.

  • CUSTOM_NUMBER_DUPLICATED :

    The input list contains duplicate numbers.

  • CUSTOM_NUMBER_ALREADY_EXISTS :

    The input list contains numbers for which tags already exist.

  • CUSTOM_NUMBER_TAG_NOT_EXIST :

    The input list contains numbers associated with tags that have not been created.

  • CUSTOM_NUMBER_INSERT_DUPLICATED :

    Duplicate entries were detected when writing inbound number tags to the backend.

  • CUSTOM_NUMBER_TOO_MANY_TAGS :

    The input list contains numbers that exceed the maximum allowed number of tags per number.

CUSTOM_NUMBER_DUPLICATED

Examples

Success response

JSON format

{
  "RequestId": "BA03159C-E808-4FF1-B27E-A61B6E888D7F",
  "HttpStatusCode": 200,
  "Code": "OK",
  "Message": "无",
  "Data": [
    {
      "Item": "1312121****",
      "Reason": "CUSTOM_NUMBER_DUPLICATED"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 Parameter.Blank The parameter %s must not be null or empty.
400 Parameter.Maximum The parameter %s must be less than or equal to %s.
500 InternalService.DB An internal DB service error occurred. %s
404 NotExists.InstanceId The specified instance %s does not exist.
404 NotExists.RamId RAM user %s does not exist.
409 AlreadyExists.CustomNumber Custom number already exists.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.