freeswitch号码变化方案

概述

freeswitch是一款简单易用的开源音视频软交换平台。

在生产环境中，由于各个线路的号码规则并不统一，经常需要针对中继线路做号码变换的方案。

本文主要介绍fs中有哪些可选的号码变换方案。

环境

centos：CentOS  release 7.0 (Final)或以上版本

freeswitch：v1.8.7

GCC：4.8.5

拨号计划

拨号计划中，condition的匹配项配置中，可以对号码进行正则匹配，并根据格式做简单的号码变换功能。

<include>

<context name="public">

<extension name="test0">

<condition field="destination_number" expression="^test(\d+)$">

<action application="bridge" data="user/$1"/>

</condition>

</extension>

<extension name="test1">

<condition field="destination_number" expression="^000(\d+)$">

<action application="bridge" data="sofia/external/sip:${1}@10.55.55.138:5090"/>

</condition>

</extension>

<extension name="test2">

<condition field="destination_number" expression="^(\d+);.*$">

<action application="bridge" data="{sip_invite_call_id=${sip_call_id}}user/$1"/>

</condition>

</extension>

<extension name="test3">

<condition field="destination_number" expression="^(\d+)$">

<action application="bridge" data="{sip_invite_call_id=${sip_call_id}}user/$1"/>

</condition>

</extension>

</context>

</include>

test0中，对被叫号码删除了号码开头的‘test’字符串。

test1中，对被叫号码删除了号码开头的‘000‘字符串。

test2中，对被叫号码删除了号码中‘;‘后的部分。

test3中，号码不变。

regex接口

mod_dptools: regex接口函数。用法如下。

regex value expression results*

app接口返回‘0555555555‘。

freeswitch@localhost.localdomain> regex 61555555555|^61([0-9]{9})$|0%1

0555555555

app接口返回true。

freeswitch@localhost.localdomain> regex 61555555555|^61([0-9]{9})$

true

拨号计划的实例。

<action application="set" data="effective_caller_id_number=${regex(${caller_id_number}|^61([0-9]{9})$|0%1)}"/>

mod_translate

mod_translate模块通过配置文件和接口形式，支持对号码格式的更新，灵活方便。

并且在拨号计划中，使用translate模块可以在进入拨号计划之前对号码进行变换，这种场景在CDR话单中会有用处。

mod_translate模块默认是不编译安装的，要自行编译安装启动。

配置文件translate.conf.xml。

<include>

<configuration name="translate.conf" description="Number Translation Rules">

<profiles>

<profile name="US">

<rule regex="^\+(\d+)$" replace="$1"/>

<rule regex="^(1[2-9]\d{2}[2-9]\d{6})$" replace="$1"/>

<rule regex="^([2-9]\d{2}[2-9]\d{6})$" replace="1$1"/>

<rule regex="^([2-9]\d{6})$" replace="1${areacode}$1"/>

<rule regex="^011(\d+)$" replace="$1"/>

</profile>

<profile name="GB">

<rule regex="^\+(\d+)$" replace="$1"/>

<rule regex="^$" replace="$1"/>

</profile>

<profile name="HK">

<rule regex="\+(\d+)$" replace="$1"/>

<rule regex="^(852\d{8})$" replace="$1"/>

<rule regex="^(\d{8})$" replace="852$1"/>

</profile>

</profiles>

</configuration>

</include>

API接口。

translate <number> [<profile>]

APP接口。

<action application="translate" data="${destination_number} US"/>

实例1。

freeswitch@localhost.localdomain> translate +86123456 GB

2022-09-01 14:24:49.257196 [INFO] mod_translate.c:329 +86123456 GB

86123456

2022-09-01 14:24:49.257196 [DEBUG] mod_translate.c:128 translating [+86123456] against [GB] profile

2022-09-01 14:24:49.257196 [DEBUG] mod_translate.c:137 +86123456 =~ /^\+(\d+)$/

2022-09-01 14:24:49.257196 [NOTICE] mod_translate.c:348 Translated: 86123456

实例2。

freeswitch@localhost.localdomain> translate +852123456 HK

2022-09-01 14:26:37.117176 [INFO] mod_translate.c:329 +852123456 HK

2022-09-01 14:26:37.117176 [DEBUG] mod_translate.c:128 translating [+852123456] against [HK] profile

2022-09-01 14:26:37.117176 [DEBUG] mod_translate.c:137 +852123456 =~ /\+(\d+)$/

2022-09-01 14:26:37.117176 [NOTICE] mod_translate.c:348 Translated: 852123456

852123456

freeswitch@localhost.localdomain> translate 12345678 HK

2022-09-01 14:29:29.517186 [INFO] mod_translate.c:329 12345678 HK

85212345678

2022-09-01 14:29:29.517186 [DEBUG] mod_translate.c:128 translating [12345678] against [HK] profile

2022-09-01 14:29:29.517186 [DEBUG] mod_translate.c:137 12345678 =~ /\+(\d+)$/

2022-09-01 14:29:29.517186 [DEBUG] mod_translate.c:137 12345678 =~ /^(852\d{8})$/

2022-09-01 14:29:29.517186 [DEBUG] mod_translate.c:137 12345678 =~ /^(\d{8})$/

2022-09-01 14:29:29.517186 [NOTICE] mod_translate.c:348 Translated: 85212345678

总结

freeswitch中对正则表达式的支持有多种形式。

正则表达式对于常见的号码变换场景基本可以完美支持。

mod_translate模块很强大，可以深挖一下逻辑。

空空如常

求真得真