調(diào)用MakeCall發(fā)起呼叫，被叫可以是內(nèi)部坐席，也可以是外部客戶(hù) 。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
請(qǐng)求參數(shù)
| 名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 實(shí)例 ID。 | ccc-test |
| UserId | string | 否 | 發(fā)起外呼的坐席 ID，非必填，不填默認(rèn)使用當(dāng)前 RAM 賬號(hào)映射的坐席。 | agent@ccc-test |
| DeviceId | string | 是 | 設(shè)備 ID，無(wú)意義，可以隨便填寫(xiě)。 | device |
| Caller | string | 否 | 主叫號(hào)碼，如果是內(nèi)部呼叫，這此參數(shù)無(wú)效，如果是外部呼叫，此參數(shù)為當(dāng)前坐席可用的外呼號(hào)碼，需要確保該號(hào)碼可外呼且坐席對(duì)該號(hào)碼有使用權(quán)，使用權(quán)通過(guò)兩種途徑獲得，一是將號(hào)碼綁定到當(dāng)前坐席簽入的技能組上，二是將號(hào)碼設(shè)置為坐席的個(gè)人外呼號(hào)碼。 | 010989**** |
| Callee | string | 是 | 被叫號(hào)碼，如果是內(nèi)部呼叫，該字段填寫(xiě)目標(biāo)坐席的分機(jī)號(hào)，如果是外呼呼叫，填寫(xiě)客戶(hù)的電話(huà)號(hào)碼。 | 1318888**** |
| TimeoutSeconds | integer | 否 | 超時(shí)時(shí)間，呼叫在經(jīng)過(guò)該參數(shù)指定的時(shí)間仍然未接通的情況下，則主動(dòng)掛斷，取值范圍 30-300，單位秒。 | 30 |
| Tags | string | 否 | 隨路數(shù)據(jù)，客戶(hù)無(wú)需關(guān)心。 | tags |
| MaskedCallee | string | 否 | 脫敏后的被叫號(hào)碼，如果該字段不為空，表示需要對(duì)被叫號(hào)碼脫敏，脫敏規(guī)則由客戶(hù)自行定義，只需將脫敏后的被叫號(hào)碼填入即可，使用脫敏被叫會(huì)導(dǎo)致某些場(chǎng)景下看到的是脫敏后的被叫號(hào)碼，無(wú)法查看真實(shí)被叫號(hào)碼。 | 131****8888 |
| MediaType | string | 否 | 媒體類(lèi)型，默認(rèn)是語(yǔ)音(AUDIO), 其他可選參數(shù)包括 VIDEO。 | AUDIO |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "無(wú)",
"RequestId": "26A34338-5CD9-4C95-A7A6-5BDCE76C6B94",
"Params": [
"無(wú)"
],
"Data": {
"ContextId": 123456,
"CallContext": {
"CallType": "OUTBOUND",
"InstanceId": "ccc-test",
"JobId": "job-6570007401392****",
"ChannelContexts": [
{
"ReleaseInitiator": "無(wú)",
"ChannelState": "NONE",
"Destination": "8001****",
"UserId": "agent@ccc-test",
"ChannelFlags": "MONITORING",
"Timestamp": 1609225718295,
"ReleaseReason": "無(wú)",
"CallType": "OUTBOUND",
"JobId": "job-6570007401392****",
"ChannelId": "ch:user:1390501****->8032****:1609138902226:job-653821410368****",
"Originator": "1318888****",
"UserExtension": "8001****",
"MediaType": "Audio"
}
]
},
"UserContext": {
"Extension": "8001****",
"WorkMode": "ON_SITE",
"DeviceId": "ACC-YUNBS-1.0.10-****",
"JobId": "job-6570007401392****",
"UserId": "agent@ccc-test",
"BreakCode": "Warm-up",
"InstanceId": "ccc-test",
"OutboundScenario": false,
"UserState": "READY",
"SignedSkillGroupIdList": [
"skillgroup1@ccc-test"
]
}
}
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | UserBusy | The user %s you called was busy. Please try again later. | 您呼叫的用戶(hù)正忙，請(qǐng)稍后再試。 |
| 400 | InvalidOperation.ChannelState | The operation is not allowed. Channel stats (%s) does not meet expectations (%s). | - |
| 400 | InvalidOperation.UserState | The operation is not allowed. User state (%s) does not meet expectations (%s). | 非法操作，用戶(hù)狀態(tài)不符合預(yù)期。 |
| 404 | NotExists.UserId | The user %s does not exist in instance %s. | 呼叫中心實(shí)例中不存在指定的用戶(hù)。 |
| 404 | NotExists.InstanceId | The specified instance %s does not exist. | 指定的呼叫中心實(shí)例不存在。 |
| 404 | NotExists.Extension | No available extension number exists. | 沒(méi)有可分配的分機(jī)號(hào)。 |
| 500 | InternalService.CTI | An internal CTI service error occurred. %s | 內(nèi)部CTI服務(wù)錯(cuò)誤。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-08-30 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2024-01-11 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更、OpenAPI 返回結(jié)構(gòu)發(fā)生變更 | 查看變更詳情 |
| 2023-10-26 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |