## 座席外呼
>[info] **功能说明**
> 系统自动拨打被叫号码，被叫号码摘机后，系统自动播放录制好的语音文件，播放完毕后系统挂机，播放完毕后也可以接收用户电话按键。
> 语音文件可以是单个语音文件，也可以是多个语音文件拼接，多个语音文件使用符号“!”分割，如：1.wav!2.wav!3.wav，多系统会依次播放多个语音文件，用会员体验是一段完整的语音。
> 拨打完毕后，回调通话结果，如：用户是否接听，用户接听时长等信息。
* **请求地址**
```
{base_url}/{api_version}/vocMessage
```
* **请求参数**
| 参数 | 是否必选 | 类型 | 描述 |
| --- | --- | --- | --- |
| phone | 是 | string | 被叫号码 |
| vocFile | 是 | string | 语音文件，可以是一个语音文件，或者多个语音文件。 |
| demandDtmf | 是 | string | 是否要求用户电话按键，y需要接收用户电话按键，n不需要接收用户电话按键。如果需要接收用户电话按键，那么语音文件中需要有有引导用户按键的语音提示，如：确认请按1，取消请按2.....。 |
| trunkName | 是 | string | 中继名称，如果服务器上接入了多个运营商的中继，可以选择使用哪个运营商的中继线路拨打电话 |
| data | 否 | string | json字符串格式，本次通话的客户数据，如客户ID,案件ID等等，在通话完毕回调时会原样回调。 |
| logFileName | 否 | string | 话单日志文件名，通话结束后，服务器可以将话单记录为日志文件，开发人员可以去消费日志进行统计分析。 |
| callbackDomain | 否 | string | 回调地址，http或https开头的完整url地址，通话结束后，系统会将本次通话结果，包括data数据，以post的方式提交到该地址。 |
* **响应参数**
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| status | string | 请求结果：success：成功。failed：失败，注意，此处的成功仅仅表示系统收到了呼叫请求，因为通话是异步的，系统此时并不能知道外呼是否会成功，被叫是否会摘机，通话时长等数据，等本次通话结束后，本次通话的结果会实时回调的。|
| callid | string | 本次通话的唯一编号，业务系统可以记录该值，可以通过该编号调用其他接口，进行录音查询，话单信息查询等操作。 |
| msg | string | 如果返回failed，对失败原因的描述 。|
* **响应示例**
```
{
"status": "success",
"callid": "49b98696-2451-437f-b1bd-abf29a6f8302",
"msg": ""
}
```
