IVR接入指南
1、核心概念
- (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。
2、集成流程
- (1)注册成为云通讯平台用户。
- (2)登陆云通讯平台,进入管理控制台,创建自己的应用实现ivr的流程。
3、前期准备
- (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应用测试号”,在弹出的页面中勾选需要绑定的主叫号码,完成后点击确定就完成配置。