呼叫中心中间件(mod_cti基于FreeSWITCH)-通话质检接口

原理：通过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都会加载用于群集模式。

1. key 组名

2. 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[通道]

{ "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" ] }, } } }

• 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 停止通知

{ "uu "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",
}

• 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已经加载的关键词组