播放IVR语音菜单接口

应用场景

外呼自动播放语音菜单对接的系统需要向客户发起一个呼叫，播放语音，与客户进行IVR交互。例如：自动满意度调查，自动外呼放音后，按键转坐席等，都可以调用此接口实现。

支持TTS文本转语音该接口还支持TTS文本转语音后融入IVR播放给客户，需要在服务器安装TTS文本转语音引擎(单次收费服务)。

反极性外呼线路需具有反极性，能够在客户接听时有消息通知系统。如果使用的是普通的无反极性的PSTN线路，那么系统会反复播放一段短提示音（可配置），客户按键后，才会播放正式的IVR语音。

图形化配置

1、 使用助手创建一个IVR语音菜单,TTS参数，对应下面URL中的ttsabc参数

2、 上图收集客户输入的地方填写变量名称，客户的全程按键都可以被保存起来，例如：state=1;satisfact=8

接口描述URL

http://x.x.x.x:12121/bridge/callctrl?token=0123456789&callee=015919xxxxx&toneid=20&ttsabc=你好世界!&opt=IVR_TTS_CALL

参数描述

token用于标记当前的任务，可在后续调用查询接口查询当前任务的状态和结果。建议设置为全局唯一的值。

callee客户电话号码

toneid在助手或者呼叫中心后台配置的IVR编号

ttsXXXtts开头的变量,用于匹配IVR中的TTS变量，用于把文本转语音后，在IVR菜单中播放。

optIVR_TTS_CALL,默认不要修改

x.x.x.x:12121服务器IP通讯地址，12121默认端口，如果手动修改过端口号请使用修改后的端口

接口返回值

200: 操作成功，系统已经开始呼叫

400：参数错误

483：重复提交

401: 需要密码

486: 系统繁忙，稍后再试。

480:系统暂时不可用，稍后再试。

呼叫结果查询URL

http://x.x.x.x:12121/bridge/callctrl?token=xxx&opt= IVR_TTS_CALL_RESULT

返回结果如： state=1;satisfact=8 satisfact：是在使用助手定义语音菜单时,录入的“收集客户输入”的值，用于记录运行期给客户放音过程中的客户按键信息。

0: 正在排队等待呼叫

1: 呼叫成功

2：呼叫失败

3: 空号

4: 正在呼叫中

5: 对方忙

6: 关机，不在服务区

404: id不存在