原理:通过ASR接口(依赖cti_asr接口),识别出实时识别说话内容,然后和关键词匹配执行挂机等动作。支持群集,配置和记录都存储到REDIS。
使用实例
<action application="export" data="nolocal:execute_on_answer_qc=cti_qc_session:bleg_group|common_group"/>
<action application="set" data="execute_on_answer_qc=cti_qc_session:aleg_group|common_group"/>
<action application="export" data="execute_on_answer_asr=cti_detect_speech_session:^^|127.0.0.1:9988|0|150|1000|3|0.2|5000|60000|''|''|0|''|1"/>
<action application="bridge" data="sofia/external/callin@180.76.224.191:35580"/>
redis 配置说明
cti_rt_call_qc_keyword 和cti_rt_call_qc_keyword@domain[哈希表] 配置实时质检关键词和对应的动作,关键词支持正则表达式。
cti_rt_call_qc_keyword和cti_rt_call_qc_keyword@domain的区别,cti_rt_call_qc_keyword@domain指定的domain的fs才加载,cti_rt_call_qc_keyword连接这个redis的所有fs都会加载用于群集模式。
- key 组名
- value 具体关键词JSON格式
- keyword 关键词列表,如果正则表达式用前缀“regex:”。
- command 匹配到关键词执行的API,可以执行挂机,发送通知等命令。
- params API参数,参数前面会自动加上UUID。
cti_rt_call_qc_keyword 改变通知
cti_rt_call_qc_keyword 改变PUBLISH 通知到config@all [通道] ,cti_rt_call_qc_keyword@domain改变PUBLISH 通知到config@domain[通道]
|
qc 通知
配置cti.json
"qc": { "log": true, "redis": { "qc_asr": { "channel": "cti_qc", "list": "cti_rt_call_qc_asr" }, "qc_hit": { "channel": "cti_qc", "list": "cti_rt_call_qc_hit" }, "qc_start": { "channel": "cti_qc", "list": "cti_rt_call_qc_start", "variables": [ "caller_id_number", "callee_id_number", "direction" ] }, } }} |
- log 是否输出qc记录日志
- channel qc记录推送redis的channels名字
- list qc记录写入redis的list名字
qc_start 启动通知
|
- groupnames start_qcc 使用的关键词组
- uuid 通道的uuid
- call_uuid call_uuid 如果有通话的双方,2边会使用一样的call_uuid,估计是主叫的uuid
qc_stop 停止通知
|
qc_asr asrt通知
{
"uuid": "71bda206-0cbb-4ea0-b975-64a995b7b59e",
"type": "qc_asr",
"domian": "my",
"datetime": "2021-07-21 20:58:58",
"bridge_uuid": "f26805ca-7069-4a28-bde0-6bcbd32ad570",
"call_uuid": "71bda206-0cbb-4ea0-b975-64a995b7b59e"
"speak_start": "说话开始时间,接通开始计算单位毫秒",
"speak_stop": "说话停止时间,接通开始计算单位毫秒",
"text": "识别到的句子,第一个字符F表示句子,E表示错误",
"domian":"cti.conf.xlm配置的domain,用于分别来自那台fs",
}
- bridge_uuid 桥接的通道ID(通话的对方)
- datetime 开始说话的事件
qc_hit 匹配关键词通知
{
"uuid":"uuid",
"type": "qc_hit",
"datetime": "2021-07-21 20:59:04",
"bridge_uuid": "f26805ca-7069-4a28-bde0-6bcbd32ad570",
"call_uuid": "71bda206-0cbb-4ea0-b975-64a995b7b59e",
"speak_start": "说话开始时间,接通开始计算单位毫秒",
"speak_stop": "说话停止时间,接通开始计算单位毫秒",
"text": "识别到的句子,第一个字符F表示句子,E表示错误,S表示没识别到说话停止就挂掉",
"domian":"cti.conf.xlm配置的domain,用于分别来自那台fs",
"group":"组名,cti_rt_call_qc_keyword的KEY",
"category":"keyword所属的分类",
"keyword": "关键词",
"match":"keyword和text的匹配信息",
"command":"执行命令信息"
}
FreeSWITCH 接口说明
APP cti_start_qc(group) 开始实时通话质检
- group rt_call_qc_keyword配置的组,多个组用|隔开,使用那些组中的关键词。
API uuid_cti_start_qc uuid group 开始实时通话质检
参数和start_qc一样。
API uuid_cti_stop_ac uuid 停止实时通话质检
API cti show qc_all 显示qc已经加载的关键词组