呼叫中心中间件(mod_cti基于FreeSWITCH)-使用指南
本指南使用ccadmin工具作为配置工具，用户可以根据本指南掌握cti中间件的配置和用法，然后开发出自己的web配置界面。ccadmin的实现原理是通过操作redis来实现配置呼叫中心系统，开发web配置界面也是一样，只需要通过操作redis就可以完成呼叫中心系统的配置。
开始使用
启动fs
-
后台启动FreeSWTICH
freeswitch -nonat -nc -nosql -
如果遇到启动问题，需要前台直接启动FreeSWITCH看输出日志
freeswitch -nonat -nosql
执行fs命令
-
FreeSWITCH 已经启动了，进入控制台命令
fs_cli -
在FreeSWITCH控制台可以执行FreeSWTICH的命令，比如下图就是执行status命令，退出控制台的方法时执行命令 /exit
正在上传…重新上传取消 -
生产环境系统运行时会输出大量的日志，也可以不进入控制台在shell终端执行FreeSWTICH命令
fs_cli -x "status"，双引号里面的就是需要执行的命令。
正在上传…重新上传取消
退出fs
- 退出FreeSWITCH，在控制台执行
shutdown - 如果shutdown关闭程序卡了也可以直接kill -9
pgrep freeswitch杀进程
修改控制台输出日志
- 调整控制台输出日志等级，在控制台执行
console loglevel 60-7，7是debug等级 0是console等级。快捷方法按F7直接设置为0，按F8设置为debug。
正在上传…重新上传取消
查看fs的相关路径
-
查看FreeSWTICH日志文件声音文件等路径 fs控制台执行
global_getvar会输出全部的全局变量- log_dir就是日志文件目录
- recordings_dir录音文件目录
- sounds_dir和sound_prefix放音文件目录（sound_prefix更优先）
- conf_dir配置文件目录(cti.json在这个目录，cti.conf.xml在${conf_dir}/autoload_configs这个目录)
- storage_dir是http缓存文件目录(cti的tts文件也会缓存到这个目录)
- mod_dir模块文件目录(mod_cti.so就是在这个目录)。
正在上传…重新上传取消
查看cti模块状态
-
输出cti模块的信息
cti status- domain cti.conf.xml里面配置的域名，用来区分多个freeswitch
- redis_ready 执行同步redis命令的连接是否就绪
- redis_async 执行异步redis命令的连接是否就绪
- redis_subscribe 接收redis订阅发布消息的连接是否就绪（redis配置的外呼任务，线路组，排队技能组等配置改变就是通过redis的订阅发布模式通知cti模块的。）
-
sad_ready 噪音人声模型是否加载成功
正在上传…重新上传取消
跟踪sip信令
-
输出sip信令日志 在控制台执行
sofia global siptrace on,就会输出信令日志到控制台，关闭的方法是sofia global siptrace off -
遇到复杂的媒体问题，比如通话没声音，需要tcpdump抓包 ，shell终端(不是fs控制台)执行
tcpdump -i 网卡 udp -w 1.pcap就会把网络数据抓包到1.pcap，可以在windows电脑安装Wireshark打开抓包文件进行分析。
基础配置
配置SIP端口
默认有2个sofia profile 分别为internal和external,internal主要用来注册分机（auth-calls 必须是勾选），external用来对接网关（网关配置为all）。如果需要修改sip端口，参照下图修改internal和external的sip-port端口。修改sip端口需要重启fs或者重载sofia模块才可以生效。sip端口同时支持tcp和udp，一般都是用UDP的，没特殊要求防火墙开放UDP端口就可以。
正在上传…重新上传取消
配置公网IP
如果需要公网使用sip服务，需要配置公网IP，如果内网使用直接配置为本机内网IP。注意external_ip=1.1.1.1 这样的IP格式，不要后面有空格。
正在上传…重新上传取消
设置RTP端口范围
rtp端口就是传输声音的端口，一个通话需要2个端口，一个是rtp一个是rtcp。端口范围必须是双数，默认16384到32768（UDP端口，不是TCP端口），如果需要设置其他范围可以按照下图所示修改。
正在上传…重新上传取消
设置日志等级
开发阶段需要设置日志等级为debug，上线后可以改成其他等级。默认是打开了 console,info,notice,warning,err,crit,alert，如果需要打开debug日志修改为 debug,console,info,notice,warning,err,crit,alert 就可以。rollover一个日志文件最大多少字节，maximun-rotae 最大保留多少个日志文件。logfile设置日志文件目录。查看日志文件默认目录的方法 执行命令 global_getvar log_dir，修改日志配置生效的方法是执行命令reload mod_logfile。
正在上传…重新上传取消
查看sofia(SIP模块)状态
运维调试界面点一下sip，就会显示sip状态，如果显示不了说明sofia模块没加载成功，可以执行 fs命令 reload mod_sofia，看看输出什么错误。如果修改了sip配置需要重启fs或者重启sofia模块，才能生效。查看data里面的ip和端口是不是和设置的一致。
正在上传…重新上传取消
CCAdmin执行fs命令
如果mod_cti模块和redis连接时正常的，就可以这样通过CCAdmin工具执行执行fs命令。
正在上传…重新上传取消
CCAdmin监视fs日志
可以通过查看日志文件，或者进入fs控制台fs_cli监视fs日志，ccadmin也可以监视fs日志（生成环境建议只能通过tail -f freeswitch.log）来监视fs日志。
IPPBX
这章节介绍ippbx场景下的配置方法
添加分机
CCAdmin创建分机
分机配置里面添加一个分机，密码要设置复杂点，添加分机是实时生效的。创建分机其实就是往redis写入一个数据。
sip客户端注册分机
这里下载 sip客户端，
正在上传…重新上传取消
如果显示注册成功说明分机配置正确了。如果出现注册超时408，就检测防火墙和云服务器的网络完全是否开放好了sip端口。
CCAdmin查看在线分机
CCAdmin的运维调试 SIP, internal的user点一下刷新，就可以显示已经注册的分机。
通话测试
sip的internal默认是使用internal这个路由，internal路由启用放音测试，sip软电话呼叫echo，进行回音测试。电话接通后如果听到提示音，提示音之后可以听到自己说话的声音，说明rtp端口和redis连接都没问题了。（生产环境的路由需要根据业务情况启用，路由要小心配置，防止电话给盗打，不需要的拨号方案不要启用）。
正在上传…重新上传取消
分机互打
再创建一个分机，sip客户端可以同时注册多个分机（同一个软件的2个分机互打），也可以再找个