Updated on 2023-09-27 GMT+08:00

POST /CCISQM/rest/ccisqm/v1/appraisecall/detail

Scenario

The interface is invoked to obtain the inspection result of a call.

Method

POST

URI

https://Domain name/apiaccess/CCISQM/rest/ccisqm/v1/appraisecall/detail (For example, the domain name is service.besclouds.com.)

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory or Not

Description

1

Content-Type

String

No

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

2

x-app-key

String

No

App key. Contact operations personnel to obtain it.

3

Authorization

String

Yes

Authentication field. The format is Bearer {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.1

call_uuid

String

Yes

Call ID

You can obtain the value of call_uuid from the result returned by the appraisecall/details interface.

Response Description

  • Status code: 200
Table 3 Response body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

left_speed

Number

No

Left channel speaking speed. The speaker is determined by the left_channel parameter.

1.2

left_speech_ratio

Number

No

Left channel speaking proportion. The speaker is determined by the left_channel parameter.

1.3

file_name

String

No

Inspection file name

1.4

left_channel

String

No

Left channel speaker. The options are Customer and Agent.

1.5

right_speech_ratio

Number

No

Right channel speaking proportion. The speaker is determined by the right_channel parameter.

1.6

call_time

Number

No

Call start time.

1.7

right_channel

String

No

Right channel speaker. The options are Customer and Agent.

1.8

call_id

Number

No

Call ID

1.9

left_silence_time

Number

No

Silence duration of the speaker

1.10

segments

Array [Object]

No

ASR text segment result

1.10.1

asr_text

String

No

ASR text

1.10.2

speaker

Number

No

Speaker

1.10.3

start_time

Number

No

Speaking start time

1.10.4

end_time

Number

No

Speaking end time

1.10.5

segment_id

Number

No

ASR text segment ID

1.11

duration

Number

No

Call duration

1.12

right_silence_time

Number

No

Silence duration of the speaker. The speaker is determined by the right_channel parameter.

1.13

upload_time

Number

No

Call upload time.

1.14

left_emotions

Array [Object]

No

Tone, which is applicable only to agents. This parameter is valid only when left_channel is set to Agent.

1.14.1

type

String

No

Tone type. The options are positive and negative.

1.14.2

score

Number

No

Tone score

1.15

right_speed

Number

No

Right channel speaking speed. The speaker is determined by the right_channel parameter.

1.16

staff_id

String

No

User ID of an agent

You can sign in to the system and go to the agent management page to view the value of accountId returned by an interface.

1.17

call_uuid

String

No

Call ID

1.18

call_type

Number

No

Inspection call type

  • 2: text
  • 0: voice call

1.19

status

String

No

Inspection status

  • 0: The call is waiting for inspection.
  • 1: The inspection is in progress.
  • 2: The inspection is successful.
  • 3: The ASR is in progress.
  • 9: The inspection fails. An error occurs, or the data volume of inspection audio files or the number of daily inspection files reaches the upper limit.
  • 31: The voice content of the ASR result is empty.
  • 32: The ASR fails.
  • 33: The voice file fails to be uploaded to the ASR.
  • 34: The iFLYTEK ASR result transfer task fails to be submitted.
  • 35: The multimedia inspection task fails to be executed.
  • 36: The TUC inspection fails.
  • 37: The ASR fails to convert the voice file to a text file.
  • 38: The inspection result fails to be updated.
  • 39: The inspection task fails to be executed.
  • 40: The voice file is invalid.

1.20

right_emotions

Array [Object]

No

Tone, which is applicable only to agents. This parameter is valid only when right_channel is set to Agent.

1.20.1

type

String

No

Tone type. The options are positive and negative.

1.20.2

score

Number

No

Tone score

1.21

staff_name

String

No

Agent name

1.22

create_time

String

No

Creation time

  • 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

  • Scenario: Obtain the inspection result of a call.

    Request header:

    x-app-key:XXXXXXXXXXX  
    Authorization:Bearer XXXXXXXXXXX

    Request parameters:

    {
    	"call_uuid": "822bbf4d-c4f8-473a-9144-199058375be8"
    }

    Response parameters:

    {
    	"staff_name": "xieyiling",
    	"left_speed": 324.068,
    	"create_time": 1635318854,
    	"left_speech_ratio": 0.6081,
    	"file_name": "1111",
    	"right_speech_ratio": 0.185,
    	"left_channel": "customer",
    	"call_time": 1635318854,
    	"right_channel": "staff",
    	"call_id": "17af55af-e51d-4cc0-8a62-84222e1d1eea",
    	"segments": [{
    		"start_time": 0.0,
    		"asr_text": "Would you like to ask for the price",
    		"speaker": "customer",
    		"end_time": 11.32,
    		"segment_id": 1
    	}, {
    		"start_time": 13.36,
    		"asr_text": "Yes",
    		"speaker": "staff",
    		"end_time": 13.88,
    		"segment_id": 2
    	}, {
    		"start_time": 14.56,
    		"asr_text": "Are you going to buy a car in Beijing",
    		"speaker": "customer",
    		"end_time": 16.74,
    		"segment_id": 3
    	}, {
    		"start_time": 18.74,
    		"asr_text": "Yes",
    		"speaker": "staff",
    		"end_time": 19.68,
    		"segment_id": 4
    	}, {
    		"start_time": 20.28,
    		"asr_text": "Are you going to apply for a local license",
    		"speaker": "customer",
    		"end_time": 23.66,
    		"segment_id": 5
    	}, {
    		"start_time": 25.76,
    		"asr_text": "Can I get Hebei license in Beijing",
    		"speaker": "staff",
    		"end_time": 28.4,
    		"segment_id": 6
    	}, {
    		"start_time": 29.24,
    		"asr_text": "Different cities have different license requirements",
    		"speaker": "customer",
    		"end_time": 37.48,
    		"segment_id": 7
    	}, {
    		"start_time": 38.04,
    		"asr_text": "I'll call you back later",
    		"speaker": "customer",
    		"end_time": 47.42,
    		"segment_id": 8
    	}, {
    		"start_time": 49.12,
    		"asr_text": "OK",
    		"speaker": "staff",
    		"end_time": 50.22,
    		"segment_id": 9
    	}, {
    		"start_time": 51.0,
    		"asr_text": "Are you going to buy a car in Beijing",
    		"speaker": "customer",
    		"end_time": 53.22,
    		"segment_id": 10
    	}, {
    		"start_time": 56.26,
    		"asr_text": "Is there any discount",
    		"speaker": "staff",
    		"end_time": 62.96,
    		"segment_id": 11
    	}, {
    		"start_time": 61.7,
    		"asr_text": "Yes, it is",
    		"speaker": "customer",
    		"end_time": 62.64,
    		"segment_id": 12
    	}, {
    		"start_time": 63.74,
    		"asr_text": "Some vehicles are available with zero down payment",
    		"speaker": "customer",
    		"end_time": 73.28,
    		"segment_id": 13
    	}, {
    		"start_time": 73.76,
    		"asr_text": "I'll ask our professional consultant to introduce you in detail later",
    		"speaker": "customer",
    		"end_time": 78.34,
    		"segment_id": 14
    	}, {
    		"start_time": 80.1,
    		"asr_text": "OK",
    		"speaker": "staff",
    		"end_time": 81.68,
    		"segment_id": 15
    	}, {
    		"start_time": 82.54,
    		"asr_text": "When will you be available",
    		"speaker": "customer",
    		"end_time": 85.48,
    		"segment_id": 16
    	}, {
    		"start_time": 86.7,
    		"asr_text": "Anytime",
    		"speaker": "staff",
    		"end_time": 91.28,
    		"segment_id": 17
    	}, {
    		"start_time": 91.72,
    		"asr_text": "OK",
    		"speaker": "staff",
    		"end_time": 92.04,
    		"segment_id": 18
    	}, {
    		"start_time": 92.16,
    		"asr_text": "I'll ask my colleague to contact you later",
    		"speaker": "customer",
    		"end_time": 95.68,
    		"segment_id": 19
    	}, {
    		"start_time": 93.76,
    		"asr_text": "All right",
    		"speaker": "staff",
    		"end_time": 94.04,
    		"segment_id": 20
    	}, {
    		"start_time": 96.18,
    		"asr_text": "Do you have any other questions",
    		"speaker": "customer",
    		"end_time": 97.82,
    		"segment_id": 21
    	}, {
    		"start_time": 99.52,
    		"asr_text": "No",
    		"speaker": "staff",
    		"end_time": 100.12,
    		"segment_id": 22
    	}, {
    		"start_time": 100.68,
    		"asr_text": "Ok I'll hang up Have a nice life Goodbye",
    		"speaker": "customer",
    		"end_time": 104.12,
    		"segment_id": 23
    	}],
    	"left_silence_time": 40.8,
    	"duration": 104.12,
    	"right_emotions": [{
    		"score": 32.0,
    		"type": "negative"
    	}, {
    		"score": 69.0,
    		"type": "positive"
    	}],
    	"right_silence_time": 84.86,
    	"upload_time": 1635318854,
    	"left_emotions": [{
    		"score": 65.0,
    		"type": "negative"
    	}, {
    		"score": 80.0,
    		"type": "positive"
    	}],
    	"right_speed": 230.53,
    	"staff_id": "xieyiling",
    	"call_type": 0,
    	"status": 2
    }