DescribeJob - 返回一個(gè)作業(yè)的對(duì)話數(shù)據(jù)
返回一個(gè)作業(yè)的對(duì)話數(shù)據(jù)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeJob | 系統(tǒng)規(guī)定參數(shù)。取值:DescribeJob。 |
InstanceId | String | 是 | af81a389-91f0-4157-8d82-720edd02b66a | 實(shí)例ID。 |
JobId | String | 是 | c8a2b7f2-ad1a-4865-b872-d0080d9802d9 | 作業(yè)ID。 |
WithScript | Boolean | 否 | false | 是否返回任務(wù)場(chǎng)景信息。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
HttpStatusCode | Integer | 200 | HTTP狀態(tài)碼。 |
Code | String | OK | 接口狀態(tài)碼。 |
Message | String | Success | 接口提示信息。 |
RequestId | String | 254EB995-DEDF-48A4-9101-9CA5B72FFBCC | 請(qǐng)求ID。 |
Success | Boolean | true | 是否成功。 |
Job | Object | 作業(yè)信息。 |
|
Status | String | Succeeded | 作業(yè)狀態(tài)。
|
ActualTime | Long | 1640068026385 | 作業(yè)實(shí)際執(zhí)行時(shí)間。 |
Priority | Integer | 5 | 作業(yè)優(yōu)先級(jí)。 |
DsReport | String | - | 任務(wù)命中標(biāo)簽情況。 |
NextExecutionTime | Long | 1640068026385 | 任務(wù)下次執(zhí)行的時(shí)間。 |
FailureReason | String | NoAnswer | 作業(yè)失敗原因。 |
SystemPriority | Integer | 1 | 作業(yè)系統(tǒng)優(yōu)先級(jí)。 |
InstanceId | String | d5971d98-7312-4f0e-a918-a17d67133e28 | 實(shí)例ID。 |
CalledNumber | String | 137****7777 | 被叫號(hào)碼。 |
ReferenceId | String | d5971d98-7312-4f0e-a918-a17d67133e28 | 作業(yè)的業(yè)務(wù)ID,有業(yè)務(wù)方自定義。 |
JobGroupId | String | fce6c599-8ede-40e3-9f78-0928eda7b4e8 | 任務(wù)ID。 |
ScenarioId | String | ade80092-03d9-4f4d-ad4f-ab8a247d3150 | 場(chǎng)景ID。 |
StrategyId | String | c8a2b7f2-ad1a-4865-b872-d0080d9802d9 | 策略ID。 |
EndReason | Integer | 1 | 通話完結(jié)原因,取值范圍
|
JobId | String | b72425bd-7871-4050-838e-033d80d754b7 | 作業(yè)ID。 |
Contacts | Array of Contact | 聯(lián)系人信息。 |
|
PhoneNumber | String | 1358****8888 | 電話號(hào)碼。 |
State | String | Available | 聯(lián)系人狀態(tài)。 |
ContactId | String | db3db762-e421-44c9-9a01-cb423470757c | 聯(lián)系人ID。 |
Honorific | String | 張先生 | 聯(lián)系人尊稱。 |
JobId | String | 72dcd26b-f12d-4c27-b3af-18f6aed5b160 | 作業(yè)ID。 |
ContactName | String | 張三 | 聯(lián)系人名字。 |
Role | String | * | 聯(lián)系人角色。 |
ReferenceId | String | 2fa6bac3-06da-4315-82ab-72d6fd3a6f34 | 聯(lián)系人的業(yè)務(wù)ID。 |
Extras | Array of KeyValuePair | 業(yè)務(wù)參數(shù)。 |
|
Key | String | djrq | 業(yè)務(wù)參數(shù)名字。 |
Value | String | 2019-08-21 09:49:59.0 | 業(yè)務(wù)參數(shù)值。 |
Summary | Array of Summary | 對(duì)話摘要數(shù)據(jù)。 |
|
SummaryName | String | score | 摘要名字。 |
Category | String | {} | 對(duì)話摘要類別(歷史字段,不再使用)。 |
Content | String | 5 | 摘要內(nèi)容。 |
Tasks | Array of Task | 通話列表。 |
|
Status | String | Succeeded | 通話狀態(tài)。 |
PlanedTime | Long | 1579068424883 | 計(jì)劃撥打時(shí)間。 |
ChatbotId | String | 1234 | 對(duì)話的機(jī)器人ID。 |
ActualTime | Long | 1579068424883 | 實(shí)際執(zhí)行時(shí)間。 |
CalledNumber | String | 135****8888 | 被叫號(hào)碼。 |
EndTime | Long | 1579068424883 | 實(shí)際結(jié)束的時(shí)間。 |
ScenarioId | String | ade80092-03d9-4f4d-ad4f-ab8a247d3150 | 場(chǎng)景ID。 |
EndReason | String | FINISHED | 完結(jié)原因。 |
JobId | String | b72425bd-7871-4050-838e-033d80d754b7 | 作業(yè)ID。 |
CallId | String | 1528189846043 | SIP call id。 |
CallingNumber | String | 0571****3106 | 主叫號(hào)碼。 |
Brief | String | 1 | 業(yè)務(wù)結(jié)果(歷史字段,不再使用)。 |
Duration | Integer | 120 | 對(duì)話持續(xù)時(shí)間。 |
TaskId | String | ff44709e-39a6-43ba-959b-20fcabe3e496 | 通話ID。 |
Conversation | Array of ConversationDetail | 任務(wù)的對(duì)話文本列表 |
|
ActionParams | String | {} | 指令參數(shù)。 |
Action | String | Broadcast | 指令。 |
Timestamp | Long | 1579068424883 | 摘要?jiǎng)?chuàng)建時(shí)間。 |
Speaker | String | Robot | 對(duì)話是誰說的,Robot 機(jī)器人 ,Contact 聯(lián)系人。 |
Script | String | 你好,我是**客服 | 對(duì)話文本。 |
Summary | Array of Summary | 對(duì)話摘要數(shù)據(jù)(歷史數(shù)據(jù),不再使用)。 |
|
SummaryName | String | score | 摘要名字。 |
Category | String | {} | 對(duì)話摘要類別(歷史字段,不再使用)。 |
Content | String | 5 | 摘要內(nèi)容。 |
SequenceId | String | fd279983-93b9-b13b-9a34-64e5df473225 | 會(huì)話ID。 |
Contact | Object | 聯(lián)系人信息。 |
|
PhoneNumber | String | 1351****8888 | 電話號(hào)碼。 |
State | String | Available | 聯(lián)系人狀態(tài)。 |
ContactId | String | db3db762-e421-44c9-9a01-cb423470757c | 聯(lián)系人ID。 |
Honorific | String | 張先生 | 聯(lián)系人尊稱。 |
JobId | String | b72425bd-7871-4050-838e-033d80d754b7 | 作業(yè)id |
ContactName | String | 張三 | 聯(lián)系人名字 |
Role | String | * | 聯(lián)系人角色 |
ReferenceId | String | 2fa6bac3-06da-4315-82ab-72d6fd3a6f34 | 聯(lián)系人業(yè)務(wù)系統(tǒng)ID。 |
HangUpDirection | String | client | 掛斷方。 |
RingingDuration | Long | 25 | 響鈴持續(xù)時(shí)間。 |
SipCode | String | 200 | 呼叫任務(wù)的SIP狀態(tài)碼。 |
RealRingingDuration | Long | 25 | 真實(shí)振鈴持續(xù)時(shí)長(zhǎng)。 |
SipDuration | Long | 25 | sip信令時(shí)長(zhǎng) 。 |
CallingNumbers | Array of String | ["0571****3106"] | 主叫號(hào)碼。 |
Script | Object | 話術(shù)場(chǎng)景。 |
|
Status | String | DRAFTED | 狀態(tài)。 |
UpdateTime | Long | 1578881227000 | 更新時(shí)間。 |
ChatbotId | String | chatbot-cn-EJfqqa*** | 對(duì)話機(jī)器人ID。 |
ScriptId | String | 810b5872-57f0-4b27-80ab-7b3f4d8a6374 | 話術(shù)ID。 |
IsDebugDrafted | Boolean | true | 調(diào)試版本是否為草稿態(tài)。 |
Industry | String | 金融 | 行業(yè)。 |
ScriptDescription | String | 催收話術(shù) | 話術(shù)描述。 |
MiniPlaybackConfigEnabled | Boolean | true | 語氣承接功能開關(guān)。 |
IsDrafted | Boolean | true | 是否是草稿狀態(tài)。 |
TtsConfig | String | {\"voice\":\"xiaobei\",\"volume\":\"50\",\"speechRate\":\"-150\",\"pitchRate\":\"0\"} | 話術(shù)的TTS配置。 |
DebugStatus | String | DRAFTED | 調(diào)試狀態(tài)。 |
AsrConfig | String | {\"AppKey\":\"3GHttnsvir1FeWWb\"} | 話術(shù)的ASR配置。 |
Scene | String | 催收 | 場(chǎng)景。 |
Name | String | 催收話術(shù) | 話術(shù)名字。 |
示例
請(qǐng)求示例
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeJobResponse>
<HttpStatusCode>200</HttpStatusCode>
<Code>OK</Code>
<Message>Success</Message>
<RequestId>254EB995-DEDF-48A4-9101-9CA5B72FFBCC</RequestId>
<Success>true</Success>
<Job>
<Status>Succeeded</Status>
<ActualTime>1640068026385</ActualTime>
<Priority>5</Priority>
<DsReport>-</DsReport>
<NextExecutionTime>1640068026385</NextExecutionTime>
<FailureReason>NoAnswer</FailureReason>
<SystemPriority>1</SystemPriority>
<InstanceId>d5971d98-7312-4f0e-a918-a17d67133e28</InstanceId>
<CalledNumber>137****7777</CalledNumber>
<ReferenceId>d5971d98-7312-4f0e-a918-a17d67133e28</ReferenceId>
<JobGroupId>fce6c599-8ede-40e3-9f78-0928eda7b4e8</JobGroupId>
<ScenarioId>ade80092-03d9-4f4d-ad4f-ab8a247d3150</ScenarioId>
<StrategyId>c8a2b7f2-ad1a-4865-b872-d0080d9802d9</StrategyId>
<EndReason>1</EndReason>
<JobId>b72425bd-7871-4050-838e-033d80d754b7</JobId>
<Contacts>
<PhoneNumber>1358****8888</PhoneNumber>
<State>Available</State>
<ContactId>db3db762-e421-44c9-9a01-cb423470757c</ContactId>
<Honorific>張先生</Honorific>
<JobId>72dcd26b-f12d-4c27-b3af-18f6aed5b160</JobId>
<ContactName>張三</ContactName>
<Role>*</Role>
<ReferenceId>2fa6bac3-06da-4315-82ab-72d6fd3a6f34</ReferenceId>
</Contacts>
<Extras>
<Key>djrq</Key>
<Value>2019-08-21 09:49:59.0</Value>
</Extras>
<Summary>
<SummaryName>score</SummaryName>
<Category>{}</Category>
<Content>5</Content>
</Summary>
<Tasks>
<Status>Succeeded</Status>
<PlanedTime>1579068424883</PlanedTime>
<ChatbotId>1234</ChatbotId>
<ActualTime>1579068424883</ActualTime>
<CalledNumber>135****8888</CalledNumber>
<EndTime>1579068424883</EndTime>
<ScenarioId>ade80092-03d9-4f4d-ad4f-ab8a247d3150</ScenarioId>
<EndReason>FINISHED</EndReason>
<JobId>b72425bd-7871-4050-838e-033d80d754b7</JobId>
<CallId>1528189846043</CallId>
<CallingNumber>0571****3106</CallingNumber>
<Brief>1</Brief>
<Duration>120</Duration>
<TaskId>ff44709e-39a6-43ba-959b-20fcabe3e496</TaskId>
<Conversation>
<ActionParams>{}</ActionParams>
<Action>Broadcast</Action>
<Timestamp>1579068424883</Timestamp>
<Speaker>Robot</Speaker>
<Script>你好,我是**客服</Script>
<Summary>
<SummaryName>score</SummaryName>
<Category>{}</Category>
<Content>5</Content>
</Summary>
<SequenceId>fd279983-93b9-b13b-9a34-64e5df473225</SequenceId>
</Conversation>
<Contact>
<PhoneNumber>1351****8888</PhoneNumber>
<State>Available</State>
<ContactId>db3db762-e421-44c9-9a01-cb423470757c</ContactId>
<Honorific>張先生</Honorific>
<JobId>b72425bd-7871-4050-838e-033d80d754b7</JobId>
<ContactName>張三</ContactName>
<Role>*</Role>
<ReferenceId>2fa6bac3-06da-4315-82ab-72d6fd3a6f34</ReferenceId>
</Contact>
<HangUpDirection>client</HangUpDirection>
<RingingDuration>25</RingingDuration>
<SipCode>200</SipCode>
<RealRingingDuration>25</RealRingingDuration>
<SipDuration>25</SipDuration>
</Tasks>
<CallingNumbers>["0571****3106"]</CallingNumbers>
<Script>
<Status>DRAFTED</Status>
<UpdateTime>1578881227000</UpdateTime>
<ChatbotId>chatbot-cn-EJfqqa***</ChatbotId>
<ScriptId>810b5872-57f0-4b27-80ab-7b3f4d8a6374</ScriptId>
<IsDebugDrafted>true</IsDebugDrafted>
<Industry>金融</Industry>
<ScriptDescription>催收話術(shù)</ScriptDescription>
<MiniPlaybackConfigEnabled>true</MiniPlaybackConfigEnabled>
<IsDrafted>true</IsDrafted>
<TtsConfig>{\"voice\":\"xiaobei\",\"volume\":\"50\",\"speechRate\":\"-150\",\"pitchRate\":\"0\"}</TtsConfig>
<DebugStatus>DRAFTED</DebugStatus>
<AsrConfig>{\"AppKey\":\"3GHttnsvir1FeWWb\"}</AsrConfig>
<Scene>催收</Scene>
<Name>催收話術(shù)</Name>
</Script>
</Job>
</DescribeJobResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"HttpStatusCode" : 200,
"Code" : "OK",
"Message" : "Success",
"RequestId" : "254EB995-DEDF-48A4-9101-9CA5B72FFBCC",
"Success" : true,
"Job" : {
"Status" : "Succeeded",
"ActualTime" : 1640068026385,
"Priority" : 5,
"DsReport" : "-",
"NextExecutionTime" : 1640068026385,
"FailureReason" : "NoAnswer",
"SystemPriority" : 1,
"InstanceId" : "d5971d98-7312-4f0e-a918-a17d67133e28",
"CalledNumber" : "137****7777",
"ReferenceId" : "d5971d98-7312-4f0e-a918-a17d67133e28",
"JobGroupId" : "fce6c599-8ede-40e3-9f78-0928eda7b4e8",
"ScenarioId" : "ade80092-03d9-4f4d-ad4f-ab8a247d3150",
"StrategyId" : "c8a2b7f2-ad1a-4865-b872-d0080d9802d9",
"EndReason" : 1,
"JobId" : "b72425bd-7871-4050-838e-033d80d754b7",
"Contacts" : [ {
"PhoneNumber" : "1358****8888",
"State" : "Available",
"ContactId" : "db3db762-e421-44c9-9a01-cb423470757c",
"Honorific" : "張先生",
"JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5b160",
"ContactName" : "張三",
"Role" : "*",
"ReferenceId" : "2fa6bac3-06da-4315-82ab-72d6fd3a6f34"
} ],
"Extras" : [ {
"Key" : "djrq",
"Value" : "2019-08-21 09:49:59.0"
} ],
"Summary" : [ {
"SummaryName" : "score",
"Category" : "{}",
"Content" : "5"
} ],
"Tasks" : [ {
"Status" : "Succeeded",
"PlanedTime" : 1579068424883,
"ChatbotId" : "1234",
"ActualTime" : 1579068424883,
"CalledNumber" : "135****8888",
"EndTime" : 1579068424883,
"ScenarioId" : "ade80092-03d9-4f4d-ad4f-ab8a247d3150",
"EndReason" : "FINISHED",
"JobId" : "b72425bd-7871-4050-838e-033d80d754b7",
"CallId" : "1528189846043",
"CallingNumber" : "0571****3106",
"Brief" : "1",
"Duration" : 120,
"TaskId" : "ff44709e-39a6-43ba-959b-20fcabe3e496",
"Conversation" : [ {
"ActionParams" : "{}",
"Action" : "Broadcast",
"Timestamp" : 1579068424883,
"Speaker" : "Robot",
"Script" : "你好,我是**客服",
"Summary" : [ {
"SummaryName" : "score",
"Category" : "{}",
"Content" : "5"
} ],
"SequenceId" : "fd279983-93b9-b13b-9a34-64e5df473225"
} ],
"Contact" : {
"PhoneNumber" : "1351****8888",
"State" : "Available",
"ContactId" : "db3db762-e421-44c9-9a01-cb423470757c",
"Honorific" : "張先生",
"JobId" : "b72425bd-7871-4050-838e-033d80d754b7",
"ContactName" : "張三",
"Role" : "*",
"ReferenceId" : "2fa6bac3-06da-4315-82ab-72d6fd3a6f34"
},
"HangUpDirection" : "client",
"RingingDuration" : 25,
"SipCode" : "200",
"RealRingingDuration" : 25,
"SipDuration" : 25
} ],
"CallingNumbers" : [ "[\"0571****3106\"]" ],
"Script" : {
"Status" : "DRAFTED",
"UpdateTime" : 1578881227000,
"ChatbotId" : "chatbot-cn-EJfqqa***",
"ScriptId" : "810b5872-57f0-4b27-80ab-7b3f4d8a6374",
"IsDebugDrafted" : true,
"Industry" : "金融",
"ScriptDescription" : "催收話術(shù)",
"MiniPlaybackConfigEnabled" : true,
"IsDrafted" : true,
"TtsConfig" : "{\\\"voice\\\":\\\"xiaobei\\\",\\\"volume\\\":\\\"50\\\",\\\"speechRate\\\":\\\"-150\\\",\\\"pitchRate\\\":\\\"0\\\"}",
"DebugStatus" : "DRAFTED",
"AsrConfig" : "{\\\"AppKey\\\":\\\"3GHttnsvir1FeWWb\\\"}",
"Scene" : "催收",
"Name" : "催收話術(shù)"
}
}
}
錯(cuò)誤碼
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
404 | NotExist.Instance | The specified Instance does not exist. | 指定的實(shí)例不存在。 |
404 | NotExist.Job | The specified Job does not exist. | 指定的任務(wù)不存在。 |
500 | InternalError | An error occurred while processing your request. Please try again later. Submit a ticket if the error still exists. | 內(nèi)部錯(cuò)誤。建議重試,如果多次重試報(bào)錯(cuò)請(qǐng)?zhí)峤还巍?/td> |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。