原理:通过ASR接口(依赖cti_asr接口),识别出实时识别说话内容,然后和关键词匹配执行挂机等动作。支持群集,配置和记录都存储到REDIS。
使用实例
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”: “uuid_kill”, “params”: “” }, “自定义分类”: { “keyword”: [“公账”, “高新”], “command”: “uuid_sendmessage”, “params”: “” } } 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[通道]
{ “type”:“config_change”, “table”:“cti_rt_call_qc_keyword”, “key”:“t1” }
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" ] },
"qc_stop": { "channel": "cti_qc", "list": "cti_rt_call_qc_stop" } 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 } } log 是否输出qc记录日志 channel qc记录推送redis的channels名字 list qc记录写入redis的list名字 qc_start 启动通知 { “datetime”: “2021-07-21 20:58:58”, “domian”: “my”, “type”: “qc_start”, “groupnames”: [“bleg”], “uuid”: “f26805ca-7069-4a28-bde0-6bcbd32ad570”, “call_uuid”: “71bda206-0cbb-4ea0-b975-64a995b7b59e”, “caller_id_number”: “123”, “callee_id_number”: “123”, “direction”: “outbound” } groupnames
start_qcc 使用的关键词组 uuid 通道的uuid call_uuid call_uuid 如果有通话的双方,2边会使用一样的call_uuid,估计是主叫的uuid qc_stop 停止通知 { “uuid”: “f26805ca-7069-4a28-bde0-6bcbd32ad570”, “call_uuid”: “71bda206-0cbb-4ea0-b975-64a995b7b59e”, “domian”: “my”, “type”: “qc_stop”, “datetime”: “2021-07-21 20:59:07” } 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", 1 2 3 4 5 6 7 8 9 10 } 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已经加载的关键词组