预约使用
即接即用,玖云平台为您提供稳定的通信能力
开发者账户使用使用指南
开放接口使用指南
平台审核标准
平台服务标准
Rest API接口介绍
取消通话接口
通话记录查询接口
录音及下载接口
专线语音接口
专号通接口
专号通号码申请接口
专号通号码查询接口
专号通号码释放接口
应用映射号码查询接口
语音通知下发接口
取消预约语音通知接口
语音通知记录查询接口
语音验证码接口
智能语音验证接口
订单小号绑定接口
订单小号解绑接口
订单小号查询接口
订单小号话单查询接口
虚拟小号绑定接口
虚拟小号解绑接口
虚拟小号查询接口
虚拟小号在线呼叫接口
虚拟小号话单查询接口
工作号被叫绑定接口
云呼小号在线呼叫接口
批量上传号码接口
手机专号通绑定接口
手机专号通解绑接口
手机专号通更新接口
手机专号通查询接口
手机专号通双呼接口
云话机回拨接口
SDK产品简介
SDK集成指南
来电推送配置指南
Web
Android
Ios
更多
常见问题
专线语音回调通知接口
专号通回调通知接口
语音通知状态回调接口
语音验证码回调接口
智能语音验证回调接口
订单小号状态回调接口
虚拟小号状态回调接口
云呼小号状态回调
AI智能语音回调接口
语音回呼回调接口
手机专号通回调接口
云双呼回调接口
云呼AXB回调接口
云话机回调通知接口
全局错误码表
1.1.创建应用
开发者可以在用户控制中心,为自己的账户创建多个应用。
(1).应用名称
自定义名称,最长不超过20个汉字
(2).应用类型
该项为可选项,用户根据自己的应用属于的类型,建议选择
(3).回调
用户可根据自己的需求设置回调地址,如勾选“开启”,并正确配置回调地址。开发者调用REST接口成功后,玖云平台会进行过程回调,开发者可以根据回调内容结束接口运行结果等信息。 查看回调通知接口
(4).未进行企业认证不能进行应用创建
1.2.应用列表
开发者可在应用列表界面查询所有应用,并对应用进行管理,其中包括查询、编辑、查看详情以及删除等操作。
应用较多时,平台提供两种查询条件进行筛选:
(1).应用类型
根据创建应用时选择的所属行业进行查询
(2).应用名称
根据应用名称进行查询,支持模糊查找,已删除应用仍在列表中显示,并支持查询
2.1.号码管理
玖云平台提供的专线语音接口,支持号码显示功能。使用的号码必须合法且提交审核通过后才可正式使用。每个号码的作用域为应用,同一个号码可以提交到多个应用中进行使用。
进入号码管理界面后,展示的为所有应用列表。点击应用对应的“点击管理”按钮,可对该应用的号码进行管理。
号码管理界面共分为四部分,下面分别介绍四部分的功能:
(1).添加号码
a.单个号码添加
开发者可填入具有合法使用权限的号码,点击“+”将号码添加进批量提交号码池中。
b.号段添加
开发者可填入连续号段,例如9588812300—9588812400。以此格式用户可以快速的添加100号码。
c.批量提交
单个号码以及号段添加后,都处于待定批量添加的号码池中,用户进行二次检查后,点击批量提交。号码提交审核期间,不能再次进行号码提交。
d.移除号码
单个号码以及号段添加后,都处于待定批量添加的号码池中,用户可以进行二次检查,如号码有误,可选中错误号码或者号段,点击“移除号码”将其从号码池中删除。
(2).待审核号码
开发者添加号码并批量提交后,号码处于待审核状态。待审核记录中会显示所有正在审核的号码及号段。此时不能进行删除或修改操作。
(3).审核通过可显号码
显示所有审核通过的号码,可对号码进行查询及删除操作。
(4).审核未通过记录
对于所有审核不通过的号码及审核不通过原因,将在第四部分显示。
2.2.铃声管理
玖云平台提供的专线语音接口,支持自定义接通等待铃声功能。铃声内容必须合法且提交审核通过后才可正式使用。每个铃声的作用域为应用,每一个应用只能对应一个铃声,开发者可以修改替换原有铃声。 若开发者未进行铃声自定义,则使用平台默认铃声。
进入铃声管理界面后,展示的为所有应用列表。若应用未上传铃声,则显示为“新建”;若应用已上传铃声并审核通过,则显示为“编辑”、“查看”、“删除”操作。下面详细介绍各个操作:
(1).新建
开发者可上传铃声文件,铃声只支持原生WAV格式,最大支持2M。提交后后台会进行审核,审核通过后可正式使用。
(2).编辑
开发者可对审核通过的铃声进行编辑,即替换原有铃声。替换后需重新审核,审核期间原铃声继续生效。
(3).查看
开发者可查看已上传铃声,并支持铃声下载。
(4).删除
开发者可删除已上传铃声。删除后,使用平台默认铃声。
2.3.消费总览
专线语音月结账单中,点击“消费总览”可查看消费的基本情况。目前最大支持查看当前月份之前的三个月的记录(不包含当月)。
消费总览界面包含三部分。下面分别介绍三部分功能:
(1).消费概览
显示该月消费总金额,单位为(万元)
(2).近期消费走势
显示该月的每日消费走势图
(3).应用消费情况
显示该月每个账户下每个应用的消费总金额,以柱状图方式显示
2.4.通话记录
开放接口月结账单中,点击“通话记录”可查看详细通话记录。进入界面,默认数据为空,用户可根据查询条件进行通话记录查询。
(1).查询时间
支持三个月内的通话记录查询
(2).应用名称
开发者账户下可有多个应用,每次查询必须选定一个应用进行通话记录查询
(3).主叫号码
用户请求接口时的主叫电话号码
(4).被叫号码
用户请求接口时的被叫电话号码
(5).Call Id
用户请求接口时生成的标记该通话的唯一标示
(6).通话时长
用户可根据通话时长进行查询,单位为秒,例如:查询通话时间为30秒—59秒的所有通话记录
(7).接通状态
接通状态分为“接通”及“未接通”两种
(8).话单文件导出
玖云平台支持12个月的话单下载,下载到的话单文件为zip格式,解压后为txt格式文件
2.5.数据日报
专线语音数据分析中,点击“数据日报”可查看近3个月内的通话日报表。且支持12个月的数据日报导出。
导出的数据日报表为Excel文档,具体内容字段如下图:
3.1.号码展示
专号通业务为玖云平台提供的保护呼叫双方号码的通信接口。为实现号码,玖云平台将为客户提供专属号码池,用于呼叫时显号。号码全部由玖云平台提供,开发者可在用户控制中心进行查看,不支持编辑操作
(1).应用名称
开发者账户下可有多个应用,每次查询必须选定一个应用进行通话记录查询
(2).APP ID
应用对应的唯一表示
(3).城市
专属号码池具有城市属性,即可根据城市来分配及使用号码
(4).区号
城市对应的区号
(5).号码
具体电话号码
3.2.铃声管理
此处上传铃声为回呼失效提示。专号通接通等待铃声与专线语音共用有,同一个应用只能支持上传一个呼叫等待铃声
具体操作与专线语音相同
3.3.通话记录
专号通通话分为专号回拨及专号回呼两种。专号回拨通话记录分A、B路展示,即一通电话产生两条通话记录;专号回呼通话记录为一条
(1).序号
通话记录序号
(2).应用名称
通话所属应用的名称
(3).Call ID
通话ID,唯一标示
(4).城市
专属号码所属城市,也可为全国
(5).业务类型
分为专号回呼及专号回拨两种
(6).呼叫类型
若为专号回拨则分为呼入及呼出,专号回呼不分类
(7).主叫号码
主叫电话号码
(8).被叫号码
被叫电话号码
(9).专属号码
主被叫映射的专属号码
(10).接通状态
分为已接通及未接通两种
(11).通话开始时间
若为专号回拨则为该路通话开始时间,若为专号回呼则为被叫接听时间
(12).通话结束时间
通话结束时间
(13).通话实际时长
实际通话时长按秒计
(14).通话计费时长
计费通话时长按分钟计,不满一分钟按一分钟计算
(15).通话费用
实际通话费用
(16).录音费用
若开启录音则为录音费用
(17).录音下载
若开启录音则可以进行录音点击下载
1 应用管理
2 专线语音
3 专号通