IVR 接入准备工作

1、IVR简介

IVR(Interactive Voice Response)即互动式语音应答，是一种功能强大的电话自动服务系统。它用预先录制或TTS文本转语音技术合成的语音进行自动应答，提供一种为客户进行菜单导航的功能。您只须调用外呼接口或呼入的方式即可进入服务中心，可以根据语音文件收听播放的提示音，也可以根据用户输入的内容播放语音信息。 云通讯平台IVR有两种接入方式：

(1)外呼方式：通过调用云通讯平台提供的rest IVR外呼接口；

(2)呼入方式：通过PSTN呼入云通讯平台提供的IVR接入号或者通过云通讯平台提供的呼入serviceid。

2、核心概念

(1)生产环境：应用上线后的正式生产环境，对应的接入域名为：https://app.cloopen.com:8883

(2)沙盒环境：应用开发测试时使用的调试环境，对应的接入域名为：https://sandboxapp.cloopen.com:8883

(3)开发者主账号：每个开发者在云通讯平台对应一个主账号

(a)ACCOUNT SID：主账号id。

(b)AUTH TOKEN：主账号验证token。

(4)AppID：应用标识，每个创建的应用都对应唯一的id标识。

(5)IVR接入号：IVR呼入的号码，当应用上线后勾选“启用IVR”后由云通讯平台进行分配，一个接入号只能绑定一个应用，但是一个应用可以绑定多个接入号。需要在测试环境调试IVR呼入可以使用云通讯平台提供IVR测试接入号01083035690进行调试。如果正式使用需要联系售前同事绑定接入号。

(6)serviceid：应用服务id，创建应用生成的绑定唯一id，用户的IVR接入号，等同于IVR接入号的作用，只能是绑定应用下面的子账号使用。暂时没有在官方网站提供，需要联系技术支持人员进行提供。

说明：每一个注册开发者对应一个主账号。每一个主账号下可以创建多个App。

3、集成流程

(1)注册成为云通讯平台用户。

(2)登陆云通讯平台，进入管理控制台，创建自己的应用实现ivr的流程。

4、前期准备

(1)注册成为云通讯的用户，详见 新手指引

(2)登陆云通讯平台，进入管理控制台，创建自己的应用，IVR只能用创建应用进行测试，在创建IVR类应用的时候，需填写应用名称并且勾选"启用IVR"后在“IVR通知消息URL”中填写服务器的回调地址，如果需要坐席的功能需要将坐席管理功能开关勾选为启用状态，如果需要用的文本转语音的业务就需要勾选"启用TTS"(必须企业认证)，不必选择"启用应用回调地址"、"服务器白名单"等选项。

IVR通知消息URL填写注意：

1).URL中如果没有加上端口则是默认端口80；

2).云通讯平台只支持http的消息发送，如果填写https则无法回调；

(3)应用创建成功后，在"应用列表"里面里面可以看见自己刚刚创建的应用，可以对该应用进行编辑和删除操作。当该应用集成完云通讯IVR能力后准备正式对外发布时，需要点击"上线"申请，此时应用才可以在云通讯的生产环境使用，否则只能在沙盒环境使用。

(4)如果需要上传IVR放音文件，在"应用列表"里面里面可以看见自己刚刚创建的应用，然后点创建的应用名称，在进入的页面点“语音库管理”后再点“上传新语音”即可，上传成功后就等待云通讯的审核人员进行审核了，可以在当前页面中的“语音库”中进行查看审核的状态，审核通过后才能在云通讯平台进行播放，注意单条语音最大为5M。放音文件的格式样本如下：位速 128kbps，音频采样大小16位，频道 1(单声道)， 音频采样级别 8 kHz，音频格式 PCM，这样能保证放音的清晰度。

(5)测试阶段如果是呼入方式则需要绑定ivr测试号码，直接呼叫IVR测试号码01083035690，因为所有的用户都是用01083035690的IVR接入号进行调试，所以需要在创建的应用下面进行绑定主叫号码，绑定完成后呼入就会路由到对应的应用，否则呼入只能是云通讯平台的体验。需要注意的是，多个应用下面不能绑定相同的主叫号码，否则只有一个有效。绑定主叫的号码步聚：

1)在“管理”--“测试号码”页面中填写测试的号码，然后进行验证通过

2)在“应用”列表中“应用管理”的“应用列表”页面中点击需要绑定主叫号码的应用名称

3)在应用名称页面中找到“配置号码”后点击“IVR测试号码”后面的“绑定/更改IVR应用测试号”，在弹出的页面中勾选需要绑定的主叫号码，完成后点击确定就完成配置。

文档更新时间：2016年9月7日