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日