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