【顶顶通呼叫中心中间件(mod_cti 基于 FreeSWITCH)-拨号方案和路由配置】

介绍

为了实现动态组合拨号方案避免重复配置，把拨号方案拆分成了2个部分，一个是cti_dialplan_extensio@domain,保存单个拨号方案配置，一个是cti_dialplan_context@domain把多个拨号方案组合一个路由表。拨号方案和路由配置修改后会实时生效。

用法

通道变量

拨号方案的原理就是对通道变量执行正则表达式匹配，如果匹配上了，就执行对应的动作(APP)。fs的很多特性是通过设置通道变量来实现的。这里介绍一下常用的通道变量，更详细的说明参考 https://freeswitch.org/confluence/display/FREESWITCH/Channel+Variables 和 https://freeswitch.org/confluence/display/FREESWITCH/Variables+Master+List

• caller_id_number 来电号码
• network_addr 来电IP
• destination_number DID

下面几个时设置系统特性常用的通道变量

• absolute_codec_string 设置声音编码
• call_timeout 设置呼叫超时 ，只作用于后续桥接的通道
• effective_caller_id_number 设置主叫号码，只作用于后续桥接的通道
• originate_timeout 设置呼叫超时 ，只作用于本端，一般添加在拨号串里，或者export设置
• origination_caller_id_number 设置主叫号码，只作用于本端，一般添加在拨号串里，或者export设置

fs的通道变量非常多，怎么查看通话的通道变量呢，有2个方法 方法1 执行fs控制台命令 uuid_dump 通话UUID，方法2 拨号方案里面执行fs的动作info 也可以输出通道变量，info输出的通道变量有些名字和uuid_dump的不一样，文末复制了一个fs官方文档里面的对应关系。

拨号方案中调用http接口

通过API cti_http_get url [connect_timeout] [response_timeout] [varname] 可以在拨号方案任意位置调用http接口,可以把通道变量作为 http接口的参数，传递给接口。

• connect_timeout 连接超时
• response_timeout 等待返回超时
• varname 返回的数据写入这个变量，如果不设置，就会写入默认变量cti_http_get_last_result
• 例子
  • 例子1 eval ${cti_http_get(http://ip?arg=${通道变量})}
    执行http请求，返回的结果会写入默认变量cti_http_get_last_result
  • 例子2 set myval=${cti_http_get(http://ip?arg=${通道变量})}
    把cti_http_get返回的结果写入myval变量
• 接口返回数据说明
  • 返回文本数据
    返回文本数据不会进行解析和也不会去除空格换行，会把原始数据设置到变量里面。
  • 返回JSON数据
    {"header":{"value1":"1","value2":"2"},"body":""}
    head可用来设置自定义的变量，body会写入cti_http_get_last_result，或者自定义的变量名里面。

拨号方案的condition(条件)，也可以调用http接口，根据返回的结果和正则表达式进行匹配。具体可以看下图的例子。注意返回的数据前后不要有空格换行等不可见字符，会导致和正则表达式匹配不上。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-vMaJvNes-1661834141133)(dialplan/image-20220830104137369.png)]

拨号方案中写redis和读redis

cti_hash_get hash field [varname] ，cti模块定义了cti_hash_get这个同名的API和APP，用来读取redis的hash表.

• hash 表的key

• field hash表的 field

• varname 读取到的value存放的变量

cti_hash_set hash field value cti模块定义了cti_hash_set这个同名的API和APP，用来设置redis的hash表

APP就是一个动作，拨号方案里面可以直接添加动作，拨号方案调用API就和使用变量一样${API名字(参数)}，多个参数用空格隔开，可以用set 这个APP把API的返回结果写入变量。也可以嵌套使用比如${cti_extension_exists(${cti_hash_get(callhistory@${cti_domain} ${cti_mid_string(${caller_id_number} -11)})})},如果不需要把返回结果写入变量，只是想执行这个API，可以用eval ，这个什么也不做的APP去调用API。

通过http接口返回动作

APP cti_curl http://ip/app?number=${destination_number} cti_curl 这个APP会调用http，执行接口返回的动作。

返回例子说明，数组格式，支持多个动作。

[{"application":"log","data":"INFO 3text"}]

配置

1. cti_dialplan_extensio@domain [哈希表]

• key 拨号方案的名字
• value

录音的例子
{
    "condition": [
        {
            "field": "${record_filename}",
            "description": "测试是否已经启动录音",
            "expression": ".+",
            "anti-action": [
                {
                    "application": "export",
                    "data": "RECORD_READ_ONLY=false",
                    "description": "是否只录音对方"
                },
                {
                    "application": "export",
                    "data": "RECORD_WRITE_ONLY=false",
                    "description": "是否只录音本方"
                },
                {
                    "application": "export",
                    "data": "RECORD_BRIDGE_REQ=false",
                    "description": "是否应答后开始录音"
                },
                {
                    "application": "export",
                    "data": "RECORD_STEREO=false",
                    "description": "是否双道录音"
                },
                {
                    "application": "export",
                    "data": "record_filename=$${recordings_dir}/${strftime(%Y-%m-%d)}/${caller_id_number}.${destination_number}.${strftime(%H-%M-%S)}.${uuid}.wav",
                    "description": "录音录音文件名"
                },
                {
                    "application": "record_session",
                    "data": "${record_filename}",
                    "description": "开始录音"
                }
            ]
        }
    ],
    "continue": true
}

外呼的例子
{
    "condition": [
        {
            "field": "destination_number",
            "expression": "^00\\d*$",
            "description": "静止呼叫国际长途",
            "action": [
                {
                    "application": "hangup",
                    "description": "00开始的号码挂断"
                }
            ],
            "break": "on-true"
        },
        {
            "field": "destination_number",
            "expression": "^\\d+$",
            "description": "允许全数字号码呼出",
            "action": [
                {
                    "application": "bridge",
                    "description": "通过default网关呼出",
                    "data": "sofia/gateway/default/${destination_number}"
                }
            ]
        }
    ]
}

这里就不做解释了，具体参考FreeSWITCH的拨号方案写法。
支持嵌套等XML拨号方案的所有功能。

2. cti_dialplan_context@domain [list]

[
    "call extension",
    "call trunk",
    "testabc"
]

CTI模块根据顺序把cti_dialplan_extensio@domain里面的内容组合成一个拨号方案的XML文件。

呼叫路由规则

1. 分机呼叫使用的呼叫路由规则
   如果分机配置了呼叫路由，就优先使用分机配置的呼叫路由，如果分机没单独配置呼叫路由，就使用SIP配置internal(分机注册的那个profile)的呼叫路由，如果sip的profile配置也没配置呼叫路由，就使用default这个呼叫路由。
2. 网关呼入使用的呼叫路由
   如果网关配置了呼叫路由，就使用网关配置的呼叫路由，如果网关配置没配置呼叫路由，就使用SIp配置external(关联网关的那个profile)的呼叫路由，如果sip的profile配置也没配置呼叫路由，就使用default这个呼叫路由。
3. 呼叫路由配置必须小心，防止给盗打，网关和external配置的呼叫路由不能配置呼叫外线的拨号方案。

Info Application Variable Names (variable_xxxx)

Some variables, as shown from the info app, may have variable_ in front of their names. For example, if you pass a header variable called type from the proxy server, it will get displayed as variable_sip_h_type in FreeSWITCH™. To access that variable, you should strip off the variable_, and just do ${sip_h_type}. Other variables shown in the info app are prepended with channel, which should be stripped as well. The example below show a list of info app variables and the corresponding channel variable names: