3.11 API+侬好解决方案
API和侬好可以同时使用且互不干扰,实现原理图如下:
侬好相当于一个中间件,可以将OM和应用服务器发送的消息相互转发给对方。
限制条件
侬好服务端版本:V2.3.2及以上。
配置方法
OM设备启用侬好,并配置API消息转发信息,侬好转发话单到第三方应用平台,失败会保存到内置存储,供第三方应用平台下载更新。
侬好服务端支持http远程配置侬好的API转发服务器信息。
步骤一:登录OM设备,进入应用服务器 > API,选择“侬好”,保存。
步骤二:在OM浏览器配置URL,如:http://192.168.130.214:8787/Auth?method=gw.config.set&api_server_addr=www.163.com:9090&url=api/call.html&cdr=1&online=1&offline=1&pass=ISMvKXpXpadDiUoOSoAfww==。
图解:
URL说明:
路径 | /Auth?method=gw.config.set | 必须项 |
---|---|---|
参数api_server_addr | ip:port,支持域名 | 可选项 |
参数url | api server的url | 可选项 |
参数cdr | 话单记录,1转发,0不转发,默认0 | 可选项 |
参数online | IP分机上线,1转发,0不转发,默认0 | 可选项 |
参数offline | IP分机离线,1转发,0不转发,默认0 | 可选项 |
参数all | API所有事件,1转发,0不转发,默认0,其他全0时默认1 | 可选项 |
参数wait | CDR转发等待响应success,1等待,0不等待,默认0,当设为1时等待响应success,否则认为失败会缓存话单,等待超时时间3秒 | 可选项 |
参数voicekey | 满意度评分按键设置信息,默认*88 | 可选项 |
参数savecall | 只保留通话记录,不转发,与api_server_addr不共用,0关闭1开启,默认0 | 可选项 |
参数callday | 通话记录保存天数,默认保存30天,最大一年365天 | 可选项 |
参数filemin | 通话记录保存文件命名,默认按一小时60,可以设置10,20,30分钟 | 可选项 |
参数pass | web管理员密码=base64(MD5(password)),MD5 32位,点击这里下载加密算法工具 | 必选项 |
配置返回ok成功,即时生效。
应用系统只需要配置cdr=1,让侬好服务端转发话单,转发失败会重传一次,重传失败保存内置存储的APICdr目录,供应用系统下载更新。
如果是转发,话单保存格式: APICdr/cdr_yyyymmdd.txt。
如果是只保留,话单保存格式: APICdr/yyyymmdd/cdr_hh.txt或APICdr/yyyymmdd/cdr_hhmi.txt(如cdr_1000.txt,cdr_1020.txt,cdr_1030.txt等)。
测试使用
下面以测试工具为例,向OM发送API消息测试下吧。
监听端口:需和通过配OM URL中的应用服务器端口保持一致,应为8888;
发送地址和端口:OM设备IP地址及侬好端口,如192.168.130.122:8787。