## ASR開始事件
>[info] **功能說明**
>電話呼入ASR后,會產生BeginAsr事件。
> 該事件中會以http方式請求話術API接口,機器會人根據返回的響應信息進行下一步操作。
* **請求地址**
```
{base_url}/{api_version}
```
* **請求參數**
| 參數 | 類型 | 描述 | 參數值示例 |
| --- | --- | --- | --- |
| asrEvent | string | 事件名稱 | 固定值:BeginAsr
| callid | string | 本次通話的唯一UUID | ff519d7c-4bad-488d-861d-ade8c0d2ee7e
| callfrom | string | 主叫號碼 | 13999999999
| callto | string | 被叫號碼 | 82176301
* **請求示例**
```
{
asrEvent: "BeginAsr",
callid: "ff519d7c-4bad-488d-861d-ade8c0d2ee7e",
callfrom: 13999999999,
callto: 82176301
}
```
* **響應參數**
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| status | string | 請求結果:success:成功。failure:失敗。|
| data.voc_text | string | data對象中的voc_text;本次通話的文字描述,如:您好!這里是呼叫中心演示系統,請問有什么可以幫您的嗎?。 |
| data.voc_name | string | data對象中的voc_nam;本次播放的語音文件的url地址,如:http://101.101.101.101/welcome.wav;也可以返回TTS合成的URL,請參考TTS合成。|
| data.is_break | string | data對象中的is_break;本次放音是否允許機器人被打斷,y允許;n不允許。|
| data.over_event | string | data對象中的over_event;本次語音播放完成后的動作,參數值有:wait繼續等待,transfer轉接電話,hangup掛機。|
| transfer_num | string | data對象中的transfer_num;如果data.over_event為transfer,那么該參數的值則為被轉接的號碼,如果data.over_event不為transfer,那么服務器會忽略該參數。|
| msg | string | 如果status參數的值為failure,那么該參數請描述失敗原因。|
* **響應示例**
```
{
status: "success",
data:{
voc_text:"您好!這里是呼叫中心演示系統,請問有什么可以幫您的嗎?",
voc_name:"http://101.101.101.101/welcome.wav",
is_break:"n",
over_event:"wait",
transfer_num:""
}
"msg": ""
}
```