拨号计划配置与呼叫路由

XML 拨号计划配置、呼叫路由逻辑和拨号计划变量的综合指南。

拨号计划配置 / 呼叫路由

TAS 使用与标准电信 XML 拨号计划格式兼容的 XML 拨号计划，变量由 TAS 填充。这意味着您可以根据需要定义自己的拨号计划，包含运营商的业务逻辑，但拥有所有所需的数据，如存储库数据、SS7 路由信息、IMPI / IMPU 身份、拨号计划规范化等。

拨号计划写入 priv/templates，形式如下：

mo_dialplan.xml - 移动发起呼叫拨号计划
mo_emergency_dialplan.xml - 移动发起紧急呼叫拨号计划
mt_dialplan.xml - 移动终止呼叫拨号计划

您可以在 Web UI 中查看拨号计划。

路由视图

在 XML 被解析之前，TAS 设置了各种变量，这些变量在呼叫开始时以其当前值打印到日志中，对于定义自己的呼叫逻辑非常有帮助。

FreeSWITCH XML 拨号计划基础

OmniTAS 使用与 FreeSWITCH 项目相同的 XML 呼叫路由系统，这允许灵活的呼叫路由以满足您的需求。

本节解释核心概念并提供实际示例。

基本结构

拨号计划由包含条件和动作的扩展组成：

<extension name="description-of-what-this-does">
  <condition field="${variable}" expression="regex-pattern">
    <action application="app_name" data="parameters"/>
    <anti-action application="app_name" data="parameters"/>
  </condition>
</extension>

扩展按从上到下的顺序进行评估。当条件匹配时，其动作执行。

条件和正则匹配

条件测试变量与正则表达式。如果正则匹配，则执行动作；如果不匹配，则执行反向动作。

基本精确匹配：

<condition field="${tas_destination_number}" expression="2222">
  <action application="log" data="INFO 正在拨打语音信箱访问号码"/>
</condition>

多个号码匹配：

<condition field="${tas_destination_number}" expression="^(2222|3444|3445)$">
  <action application="log" data="INFO 正在拨打特殊服务"/>
</condition>

带捕获组的模式匹配：

<condition field="${tas_destination_number}" expression="^1(8[0-9]{9})$">
  <!-- 匹配 1 后跟 8 和 9 个数字 -->
  <action application="log" data="INFO 匹配免付费号码: $1"/>
  <action application="bridge" data="sofia/gateway/trunk/${tas_destination_number}"/>
</condition>

前缀匹配：

<condition field="${tas_destination_number}" expression="^00">
  <!-- 匹配以 00 开头的任何号码（国际） -->
  <action application="log" data="INFO 检测到国际呼叫"/>
</condition>

范围匹配：

<condition field="${msisdn}" expression="^5551241[0-9]{4}$">
  <!-- 匹配 55512410000 到 55512419999 -->
  <action application="log" data="INFO 订阅者在范围内"/>
</condition>

动作与反向动作

动作在条件匹配时执行。反向动作 在条件不匹配时执行。

<condition field="${cli_withheld}" expression="true">
  <!-- 如果 CLI 被隐瞒则执行 -->
  <action application="set" data="effective_caller_id_number=anonymous"/>
  <action application="set" data="origination_privacy=hide_number"/>

  <!-- 如果 CLI NOT 被隐瞒则执行 -->
  <anti-action application="log" data="DEBUG CLI 是正常的"/>
  <anti-action application="set" data="effective_caller_id_number=${msisdn}"/>
</condition>

continue="true" 属性

默认情况下，当扩展的条件匹配时，拨号计划停止处理进一步的扩展。continue="true" 属性允许处理继续到下一个扩展。

没有 continue（默认行为）：

<extension name="First-Check">
  <condition field="${tas_destination_number}" expression="^(.*)$">
    <action application="log" data="INFO 正在处理呼叫"/>
  </condition>
</extension>

<extension name="Never-Reached">
  <!-- 这永远不会执行，因为前一个扩展匹配 -->
  <condition field="${tas_destination_number}" expression="^(.*)$">
    <action application="log" data="INFO 这不会打印"/>
  </condition>
</extension>

使用 continue="true":

<extension name="Print-Vars" continue="true">
  <condition field="${tas_destination_number}" expression="^(.*)$">
    <action application="info" data=""/>
  </condition>
</extension>

<extension name="Check-Balance" continue="true">
  <condition field="${hangup_case}" expression="OUTGOING_CALL_BARRED">
    <action application="log" data="ERROR 余额不足"/>
    <action application="hangup" data="${hangup_case}"/>
  </condition>
</extension>

<extension name="Route-Call">
  <!-- 这个扩展仍然会被评估 -->
  <condition field="${tas_destination_number}" expression="^(.*)$">
    <action application="bridge" data="sofia/gateway/trunk/${tas_destination_number}"/>
  </condition>
</extension>

使用 continue="true" 用于：

日志记录/调试扩展
设置适用于多种场景的变量
验证检查，不路由呼叫

常见应用

呼叫控制

answer - 接听呼叫（发送 200 OK）

<action application="answer" data=""/>

hangup - 以特定原因终止呼叫

<action application="hangup" data="NORMAL_CLEARING"/>
<action application="hangup" data="USER_BUSY"/>
<action application="hangup" data="NO_ANSWER"/>

bridge - 将呼叫连接到另一个目的地

<!-- 桥接到外部网关 -->
<action application="bridge" data="sofia/gateway/trunk/+12125551234"/>

<!-- 桥接到具有编解码器首选项的内部分机 -->
<action application="bridge" data="{absolute_codec_string=AMR-WB,AMR,PCMA}sofia/internal/sip:user@domain.com"/>

<!-- 带超时的桥接 -->
<action application="bridge" data="{originate_timeout=30}sofia/gateway/trunk/${tas_destination_number}"/>

变量和通道数据

set - 设置通道变量

<action application="set" data="my_variable=my_value"/>
<action application="set" data="sip_h_X-Custom-Header=CustomValue"/>
<action application="set" data="effective_caller_id_number=anonymous"/>

unset - 移除通道变量

<action application="unset" data="sip_h_P-Asserted-Identity"/>

export - 设置变量并导出到 B-leg（桥接呼叫）

<action application="export" data="sip_h_X-Account-Code=ABC123"/>

媒体和提示

playback - 播放音频文件

<action application="playback" data="/sounds/en/us/callie/misc/8000/out_of_credit.wav"/>
<action application="playback" data="$${base_dir}/sounds/custom_prompt.wav"/>

sleep - 暂停指定的毫秒数

<action application="sleep" data="1000"/>  <!-- 暂停 1 秒 -->

echo - 将音频回显给呼叫者（测试）

<action application="echo" data=""/>

conference - 将呼叫放入会议中

<action application="conference" data="room-${destination_number}@wideband"/>

语音信箱

voicemail - 访问语音信箱系统

<!-- 为邮箱留语音信箱 -->
<action application="voicemail" data="default default ${msisdn}"/>

<!-- 使用授权检查语音信箱 -->
<action application="voicemail" data="check auth default default ${msisdn}"/>

日志记录和调试

log - 写入日志文件

<action application="log" data="INFO 正在处理来自 ${msisdn} 的呼叫"/>
<action application="log" data="DEBUG 目的地: ${tas_destination_number}"/>
<action application="log" data="ERROR 呼叫失败，原因: ${hangup_cause}"/>

info - 将所有通道变量转储到日志

<action application="info" data=""/>

杂项应用

say - 文本到语音号码读取

<action application="say" data="en number iterated ${tas_destination_number}"/>

send_dtmf - 发送 DTMF 音调

<action application="send_dtmf" data="1234#"/>

实际示例

紧急服务路由：

<extension name="Emergency-911">
  <condition field="${tas_destination_number}" expression="^(911|112)$">
    <action application="log" data="ALERT 来自 ${msisdn} 的紧急呼叫"/>
    <action application="answer" data=""/>
    <action application="playback" data="/sounds/emergency_services_transfer.wav"/>
    <action application="bridge" data="sofia/gateway/emergency_gw/${tas_destination_number}"/>
  </condition>
</extension>

基于余额的条件路由：

<extension name="Check-Credit">
  <condition field="${hangup_case}" expression="OUTGOING_CALL_BARRED">
    <action application="answer" data=""/>
    <action application="playback" data="/sounds/out_of_credit.wav"/>
    <action application="hangup" data="CALL_REJECTED"/>
  </condition>
</extension>

On-Net 与 Off-Net 路由：

<extension name="Route-Decision">
  <condition field="${on_net_status}" expression="true">
    <!-- On-net: 通过 TAS 路由 -->
    <action application="log" data="INFO 路由到 on-net 订阅者"/>
    <action application="bridge" data="sofia/internal/+${tas_destination_number}@10.179.3.60"/>
    <anti-action application="log" data="INFO 路由到 off-net"/>
    <anti-action application="bridge" data="sofia/gateway/trunk/+${tas_destination_number}"/>
  </condition>
</extension>

匿名呼叫者 ID 处理：

<extension name="CLI-Privacy" continue="true">
  <condition field="${cli_withheld}" expression="true">
    <action application="set" data="effective_caller_id_name=anonymous"/>
    <action application="set" data="effective_caller_id_number=anonymous"/>
    <action application="set" data="origination_privacy=hide_number"/>
  </condition>
</extension>

未接来电时的语音信箱：

<extension name="Try-Bridge-Then-VM">
  <condition field="${tas_destination_number}" expression="^(555124115\d{2})$">
    <action application="set" data="call_timeout=30"/>
    <action application="bridge" data="sofia/internal/${tas_destination_number}@domain.com"/>

    <!-- 如果桥接失败，则转到语音信箱 -->
    <action application="log" data="INFO 桥接失败，路由到语音信箱"/>
    <action application="answer" data=""/>
    <action application="voicemail" data="default default ${tas_destination_number}"/>
  </condition>
</extension>

号码范围路由：

<extension name="Local-Numbers">
  <condition field="${tas_destination_number}" expression="^([2-9]\d{2})$">
    <!-- 3 位本地分机 200-999 -->
    <action application="log" data="INFO 本地分机: $1"/>
    <action application="bridge" data="sofia/internal/$1@pbx.local"/>
  </condition>
</extension>

<extension name="National-Numbers">
  <condition field="${tas_destination_number}" expression="^555\d{7}$">
    <!-- 国家移动号码 -->
    <action application="log" data="INFO 国家移动呼叫"/>
    <action application="bridge" data="sofia/gateway/national_trunk/${tas_destination_number}"/>
  </condition>
</extension>

<extension name="International">
  <condition field="${tas_destination_number}" expression="^00\d+$">
    <!-- 以 00 开头的国际呼叫 -->
    <action application="log" data="INFO 国际呼叫"/>
    <action application="bridge" data="sofia/gateway/intl_trunk/${tas_destination_number}"/>
  </condition>
</extension>

进一步文档

有关每个应用程序的完整详细信息：

FreeSWITCH 拨号计划文档： https://freeswitch.org/confluence/display/FREESWITCH/Dialplan
FreeSWITCH mod_dptools： https://freeswitch.org/confluence/display/FREESWITCH/mod_dptools (完整应用程序参考)
正则表达式参考： https://freeswitch.org/confluence/display/FREESWITCH/Regular+Expression
通道变量： https://freeswitch.org/confluence/display/FREESWITCH/Channel+Variables

FreeSWITCH wiki 包含每个拨号计划应用程序的详细文档，包括所有参数和用例。

拨号计划变量

TAS 在 XML 拨号计划逻辑中设置的变量：

常见变量（所有呼叫类型）

初始设置：

destination_number - 转换后的目的地号码
tas_destination_number - 转换后的目的地号码
effective_caller_id_number - 转换后的源号码

紧急呼叫

hangup_case - "none"
ims_private_identity - 私有用户身份
ims_public_identity - 公共用户身份
msisdn - 订阅者号码（去掉 +）
imsi - 来自私有身份的 IMSI
ims_domain - 来自私有身份的域名

MT 呼叫（移动终止）

ims_private_identity - 私有用户身份
ims_public_identity - 公共用户身份
msisdn - 订阅者号码（去掉 +）
imsi - 来自私有身份的 IMSI
ims_domain - 来自私有身份的域名
call_forward_all_destination - CFA 目的地或 "none"
call_forward_not_reachable_destination - CFNRc 目的地
scscf_address - S-CSCF 地址或 "none"
scscf_domain - S-CSCF 域名或 "none"
no_reply_timer - 无应答超时
hangup_case - "none" 或 "UNALLOCATED_NUMBER"
msrn - 来自 PRN 的 MSRN（如果漫游）或来自 SRI 的转发号码（如果呼叫转移激活）
tas_destination_number - 路由目的地覆盖（设置为 MSRN 或转发号码）

MO 呼叫（移动发起）

hangup_case - "none", "OUTGOING_CALL_BARRED", 或 "UNALLOCATED_NUMBER"
ims_private_identity - 私有用户身份
ims_public_identity - 公共用户身份
msisdn - 订阅者号码（去掉 +）
imsi - 来自私有身份的 IMSI
ims_domain - 来自私有身份的域名
allocated_time - OCS 分配的时间（如果启用在线计费）
cli_withheld - "true" 或 "false" 字符串
on_net_status - "true" 或 "false" 字符串（目的地是否在网内）
msrn - 漫游订阅者的 MSRN（如果适用）
tas_destination_number - MSRN 覆盖（如果漫游）

紧急呼叫

紧急呼叫通过 emergency_call_codes 配置参数控制，并在呼叫授权期间自动检测。

配置

在您的 TAS 配置文件中配置紧急呼叫代码：

配置参数：

emergency_call_codes: 检测的紧急服务号码列表
常见代码: "911"（美国）、"112"（欧盟）、"000"（澳大利亚）、"999"（英国）、"sos"
这些代码在 SIP 紧急 URN（例如，<urn:service:sos>）之外进行检查
系统对目的地号码执行 精确匹配 比较

示例配置值：

美国部署: ["911", "933"] - 911 用于紧急情况，933 用于测试
欧洲部署: ["112", "999"]
澳大利亚部署: ["000", "106"] - 000 用于紧急情况，106 用于文字中继
多区域: ["911", "112", "000", "sos"]

紧急检测工作原理

系统检查两个条件：

SIP URI 紧急服务 URN: 检测 <urn:service:sos> 或任何包含 "service:sos" 的 URI
目的地号码匹配: 将 Caller-Destination-Number 与配置的 emergency_call_codes 进行比较

如果 任一条件 为真，则呼叫被分类为紧急呼叫。

处理流程

呼叫流程详细信息：

呼叫到达 TAS
授权模块检查目的地与紧急模式
如果检测到紧急情况：
- 呼叫类型设置为 :emergency
- 使用 mo_emergency_dialplan.xml 模板
- OCS 授权通常被绕过
- 呼叫路由到 PSAP 网关
指标记录为 call_type: emergency 标签

拨号计划路由

在 priv/templates/mo_emergency_dialplan.xml 中定义紧急呼叫的路由。此模板决定如何根据您的市场需求将呼叫路由到 PSAP（公共安全应答点）网关或 SIP URI。

示例紧急拨号计��：

<extension name="Emergency-SOS">
  <condition field="${destination_number}" expression="^(911|912|913|sos)$">
    <action application="log" data="ALERT 来自 ${msisdn} 的紧急呼叫"/>
    <action application="answer" data=""/>
    <action application="bridge" data="sofia/gateway/psap_gw/${destination_number}"/>
  </condition>
</extension>

最佳实践

始终包括 "sos" 在您的紧急代码列表中以兼容 SIP URN
包括您管辖区的所有本地紧急号码（例如，911、112、000、999）
定期测试紧急路由 使用呼叫模拟器
绕过 OCS 以确保紧急呼叫始终连接（通过 skipped_regex 配置）
配置 PSAP 网关 以实现高可用性和冗余
监控紧急呼叫指标 以确保系统可靠性

IVR 菜单

IVR 菜单允许呼叫者在路由之前通过 DTMF 数字选择选项。菜单定义为 XML 文件，并通过拨号计划使用 ivr 应用程序调用。

添加 IVR 菜单

在 hosts/<environment>/group_vars/ivr_menus/ 中创建 XML 文件：

<include>
  <menu name="my_menu"
        greet-long="$${base_dir}/sounds/en/us/callie/misc/8000/my_greeting.wav"
        greet-short="$${base_dir}/sounds/en/us/callie/misc/8000/my_greeting.wav"
        invalid-sound="silence_stream://250"
        exit-sound=""
        timeout="5000"
        max-failures="1"
        max-timeouts="1"
        digit-len="1">

    <!-- 每个数字可以顺序执行多个动作 -->
    <entry action="menu-exec-app" digits="1" param="playback $${base_dir}/sounds/option1.wav"/>
    <entry action="menu-exec-app" digits="1" param="bridge sofia/internal/100@$${domain}"/>

    <entry action="menu-exec-app" digits="2" param="playback $${base_dir}/sounds/option2.wav"/>
    <entry action="menu-exec-app" digits="2" param="bridge sofia/internal/200@$${domain}"/>

    <!-- 处理超时和无效输入 -->
    <entry action="menu-exec-app" digits="timeout" param="bridge sofia/internal/default@$${domain}"/>
    <entry action="menu-exec-app" digits="invalid" param="bridge sofia/internal/default@$${domain}"/>
  </menu>
</include>

从您的拨号计划中调用菜单：

<extension name="my_ivr_extension">
  <condition field="destination_number" expression="^1234$">
    <action application="answer"/>
    <action application="ivr" data="my_menu"/>
  </condition>
</extension>

通过 Ansible 部署

菜单属性

属性	描述
`name`	在拨号计划 `ivr` 应用程序中使用的菜单标识符
`greet-long`	首次进入时播放的音频文件
`greet-short`	无效输入后播放的音频文件
`timeout`	等待输入的毫秒数
`max-failures`	无效输入触发 `invalid` 动作的次数
`max-timeouts`	超时触发 `timeout` 动作的次数
`digit-len`	要收集的数字数量

条目动作

条目使用 action="menu-exec-app" 执行拨号计划应用程序。多个条目使用相同数字时按顺序执行：

条目类型	描述
`digits="1"`	当呼叫者按下 1 时执行
`digits="timeout"`	当呼叫者没有按下任何内容时执行
`digits="invalid"`	当呼叫者按下未识别的数字时执行

常见应用程序：playback、bridge、transfer、hangup

On-Net 移动发起呼叫到 On-Net 移动终止订阅者

当订阅者呼叫您网络中的另一位订阅者（在网呼叫）时，正确的方法是将 MO 呼叫路由回 TAS 进行 MT 处理。这确保被叫方接收到完整的 MT 呼叫处理，包括呼叫转移、语音信箱、漫游的 MSRN 路由以及所有其他订阅者服务。

为什么将 MO 路由到 MT？

没有 MT 处理（直接路由）：

被叫方的呼叫转移设置被忽略
没有无应答时的语音信箱
漫游订阅者没有 MSRN 路由
��少订阅者服务逻辑

有 MT 处理（路由回 TAS）：

完整的呼叫转移支持（CFU、CFB、CFNRy、CFNRc）
忙碌/无应答时的语音信箱
CS 漫游订阅者的 MSRN 路由
完整的订阅者服务体验
对双方的呼叫状态进行正确跟踪

实施

MO 拨号计划检查目的地是否在网（由您的 TAS 提供），如果是，则将呼叫路由回 TAS 本身。TAS 将其视为新的 MT 呼叫，并通过 mt_dialplan.xml 模板进行处理。

示例拨号计划片段：

<extension name="On-Net-Route">
  <condition field="${on_net_status}" expression="true">
    <action application="log" data="DEBUG On-Net MO 呼叫 - 路由回 TAS" />

    <!-- 清理内部路由的头部 -->
    <action application="set" data="sip_copy_multipart=false"/>
    <action application="set" data="sip_h_Request-Disposition=no-fork"/>

    <!-- 路由回 TAS（成为 MT 呼叫） -->
    <action application="bridge"
      data="{absolute_codec_string='AMR-WB,AMR,PCMA,PCMU',originate_retries=1,originate_timeout=60,sip_invite_call_id=${sip_call_id}}sofia/internal/${tas_destination_number}@${sip_local_network_addr}" />
    <action application="hangup" data="" />
  </condition>
</extension>

关键参数：

${sip_local_network_addr} - TAS IP ��址（例如，10.179.3.60）
${tas_destination_number} - 被叫方的 MSISDN
sip_invite_call_id=${sip_call_id} - 保留呼叫 ID 以便跟踪
sip_copy_multipart=false - 防止多部分消息复制
sip_h_Request-Disposition=no-fork - 确保顺序处理

呼叫流程：

重要配置：

TAS IP（例如，10.179.3.60）必须在您的 allowed_sbc_source_ips 配置列表中
这允许 TAS 从自身接收呼叫进行 MT 处理
否则，TAS 将拒绝该呼叫，认为其来自未经授��的源

MSRN 用于 2G/3G 漫游订阅者的使用

当订阅者在 2G/3G 电路交换（CS）网络中漫游时，TAS 必须获取 MSRN（移动台漫游号码）以将来电路由到订阅者的当前位置。本节解释 MSRN 检索和路由的工作原理。

什么是 MSRN？

MSRN（移动台漫游号码） 是由访问网络的 VLR（访客位置注册）分配的临时路由号码，用于将呼叫路由到漫游订阅者。它充当指向订阅者在 CS 网络中当前位置的临时目的地号码。

MSRN 检索流程

TAS 通过 SS7 MAP（移动应用部分）协议使用两步流程检索 MSRN 数据：

实施细节

第一步：发送路由信息 (SRI)

TAS 通过 SS7 MAP 查询 HLR 以获取被叫订阅者的路由信息。

SRI 响应场景：

SRI 中直接 MSRN - 漫游订阅者的 MSRN 已可用
- 响应包括：MSISDN、GMSC、IMSI 和 MSRN
- 示例 MSRN: 61412345678（澳大利亚手机号码格式）
IMSI + VLR 号码 - 订阅者在 CS 网络中注册（需要 PRN）
- 响应包括：MSISDN、GMSC、IMSI 和 MSC/VLR 号码
- 表示订阅者在 CS 网络中，但必须请求 MSRN
仅 IMSI（无 VLR） - 订阅者不在 CS 网络中（仅 IMS/PS）
- 响应包括：MSISDN、GMSC、IMSI
- 表示订阅者在 IMS/4G 中注册，不在 CS 网络中
呼叫转发激活 - SRI 返回转发信息
- 响应包括转发原因（无条件、忙碌、无应答、不可达）
- 响应包括转发到的号码

第二步：提供漫游号码 (PRN) - 如果需要

如果 SRI 返回 IMSI + VLR 但没有 MSRN，TAS 将向 VLR 发送 PRN 请求以获取 MSRN。

VLR 从其池中分配一个临时 MSRN，并将其返回给 TAS。此 MSRN 仅在此特定呼叫设置期间有效。

示例 PRN 响应： MSRN 61412345678

拨号计划变量： `msrn`

一旦通过 SS7 MAP 检索到 MSRN，它将作为拨号计划变量设置，可以在 MT 拨号计划中使用。

变量： ${msrn}

类型： 字符串（E.164 号码，无前导 +）
示例： "61412345678"（澳大利亚手机格式）
用途： 将呼叫路由到 CS 漫游订阅者
由：在 MT 呼叫处理期间的 HLR 数据检索过程设置

在 mt_dialplan.xml 中路由到 MSRN

MSRN 变量在 MT 拨号计划模板中用于将呼叫路由到漫游订阅者。

拨号计划逻辑：

检查 MSRN：扩展检查 msrn 变量是否设置（包含数字）
设置超时参数：
- 进度超时：接收早期媒体的 10 秒
- 桥接应答超时：使用订阅者配置的无应答计时器
桥接到 MSRN：通过 CS 网关将呼叫路由到 MSRN
- 使用 ignore_early_media=ring_ready 以获得一致的响铃
- 编解码器首选项：AMR（移动）、PCMA/PCMU（有线）
- 网关：sofia/gateway/CS_Gateway/+${msrn}
失败时回退：如果桥接失败，则路由到呼叫转发目的地

示例拨号计划片段：

<extension name="Route-to-CS-MSRN" continue="false">
  <condition field="msrn" expression="^(\d+)$">
    <!-- 配置超时 -->
    <action application="set" data="progress_timeout=10" />
    <action application="set" data="bridge_answer_timeout=${no_reply_timer}" />

    <!-- 通过 CS 网关桥接到 MSRN -->
    <action application="bridge"
      data="{ignore_early_media=ring_ready,absolute_codec_string='AMR,PCMA,PCMU',continue_on_fail=true,originate_retries=1,originate_timeout=60}sofia/gateway/CS_Gateway/+${msrn}" />

    <!-- 失败时回退到语音信箱/呼叫转发 -->
    <action application="bridge"
      data="sofia/internal/${call_forward_not_reachable_destination}@${local_ip_v4}" />
  </condition>
</extension>

关键点

MSRN 是临时的 - 仅在呼叫设置期间有效
仅限 CS 网络 - MSRN 用于 2G/3G 漫游，不用于 VoLTE/IMS 漫游
MT 流程中的优先级 - MSRN 检查发生在标准 IMS 路由之前
回退到转发 - 如果 MSRN 桥接失败，则路由到呼叫转发目的地
HLR 优先于 Sh - HLR 中的 MSRN 优先于 Sh 订阅者数据

配置

必须在 TAS 配置中启用 SS7 MAP 集成：

所需设置：

enabled: 设置为 true 以启用 SS7 MAP 查询
http_map_server_url_base: 您�� SS7 MAP 网关的 URL（例如，"http://10.1.1.100:5001"）
gmsc: SRI/PRN 请求的网关 MSC 号码（例如，"61400000000"）
timeout_ms: 查询超时（默认：5000 毫秒）

请参阅 SS7 MAP 文档 以获取完整的配置详细信息。

呼叫转移数据使用

呼叫转移设置决定了当主要目的地不可用时，呼叫如何路由。TAS 从两个来源检索呼叫转移数据：Sh 接口（HSS）和 SS7 MAP（HLR），HLR 数据优先。

呼叫转移类型

系统支持四种类型的呼叫转移：

转移类型	变量	激活时
无条件呼叫转移 (CFU)	`call_forward_all_destination`	始终立即转移所有呼叫
忙碌呼叫转移 (CFB)	`call_forward_not_reachable_destination`	订阅者的线路忙碌
无应答呼叫转移 (CFNRy)	`call_forward_not_reachable_destination`	订阅者在超时内未应答
不可达呼叫转移 (CFNRc)	`call_forward_not_reachable_destination`	订阅者不可达/离线

数据来源

1. Sh 接口 (HSS)

静态配置 存储在 HSS 订阅者配置文件中。

TAS 在呼叫处理期间通过 Sh 接口从 HSS 检索呼叫转移设置。这些是为订阅者配置的/默认设置。

示例检索数据：

call_forward_all_destination: CFU 目的地（例如，"61412345678"）
call_forward_not_reachable_destination: CFB/CFNRy/CFNRc 目的地（例如，"61487654321"）
no_reply_timer: CFNRy 触发之前的秒数（例如，"20"）

2. SS7 MAP (HLR)

实时数据 来自 HLR，可能与 HSS 不同，如果订阅者通过 USSD/MMI 代码更改了设置（例如，拨打 *21* 代码）。

TAS 在呼叫设置期间通过 SS7 MAP 查询 HLR 以获取当前/活动的转移设置。

HLR 转移响应包括：

forwarded_to_number: 转发的目的地号码（例如，"61412345678"）
reason: 转移类型（无条件、忙碌、无应答、不可达）
notification flags: 是否通知呼叫方、转移方等。

映射到拨号计划变量：

如果原因是 无条件 → 设置 call_forward_all_destination
如果原因是 忙碌、无应答或不可达 → 设置 call_forward_not_reachable_destination

变量合并优先级

HLR 数据覆盖 Sh 数据 当两者都存在时。

TAS 在 MT 呼叫处理期间从两个来源检索订阅者数据：

首先，通过 Sh 接口从 HSS 检索静态配置
然后，通过 SS7 MAP 查询 HLR 以获取实时设置
合并数据，HLR 值优先于 Sh 值

这确保了最近的订阅者更改（通过 USSD 代码）得到尊重，即使 HSS 尚未更新。

拨号计划变量

在 MT 呼叫中可用：

变量	类型	示例	描述
`call_forward_all_destination`	字符串	`"61412345678"`	CFU 目的地号码
`call_forward_not_reachable_destination`	字符串	`"61487654321"`	CFB/CFNRy/CFNRc 目的地
`no_reply_timer`	字符串	`"20"`	CFNRy 的超时（秒）

默认值：

如果未配置："none"（字符串）
检查存在性：使用正则表达式 ^(?!none$).* 匹配任何值，除了 "none"

在 mt_dialplan.xml 中的呼叫转移

示例 1：无条件呼叫转移 (CFU)

立即将所有传入呼叫路由到转移目的地。转移目的地通常是一个离网号码，因此使用外部网关。

使用的网关： sofia/gateway/ExternalSIPGateway（您的 PSTN/互联网关）

模板示例：

<extension name="Check-Call-Forward-All">
  <condition field="${call_forward_all_destination}" expression="^(?!none$).*">
    <action application="log" data="INFO 呼叫转移全部设置为重定向到 ${call_forward_all_destination}" />

    <!-- 为呼叫转移设置 History-Info 头 -->
    <action application="set" data="sip_h_History-Info=<sip:${destination_number}@${ims_domain}>;index=1.1" />

    <!-- 标记呼叫 ID 以指示呼叫转移类型 -->
    <action application="set" data="sip_call_id=${sip_call_id};CALL_FORWARD_UNCONDITIONAL" />

    <!-- 桥接到离网转移目的地 -->
    <action application="bridge"
      data="{absolute_codec_string='AMR-WB,AMR,PCMA,PCMU',originate_retries=1,originate_timeout=60}sofia/gateway/ExternalSIPGateway/+${call_forward_all_destination}" />
  </condition>
</extension>

关键点：

使用外部网关，因为转移通常是到离网号码
用 ;CALL_FORWARD_UNCONDITIONAL 标记呼叫 ID 以便跟踪
设置 History-Info 头以识别原始被叫号码
示例：订阅者 61412345678 的 CFU 到 61487654321 - 所有呼叫立即转移

示例 2：无应答/不可达呼叫转移

在桥接到主要目的地失败时使用（订阅者未应答、忙碌或不可达）。

示例拨号计划片段：

<!-- 在桥接到 MSRN 或 IMS 失败后... -->
<action application="log" data="INFO 桥接失败 - 路由到呼叫转发无应答目的地" />

<!-- 设置 History-Info 以指示转移 -->
<action application="set" data="sip_h_History-Info=<sip:${destination_number}@${ims_domain}>;index=1.1" />

<!-- 路由到转移目的地 -->
<action application="bridge"
  data="{absolute_codec_string='AMR,PCMU,PCMA',originate_timeout=65}sofia/gateway/ExternalSIPGateway/${call_forward_not_reachable_destination}" />

示例场景：

订阅者 61412345678 的 CFNRy 到语音信箱号码 61487654321
来电尝试联系订阅者
20 秒后无应答（no_reply_timer）
呼叫转移到 61487654321，并保留原始目的地的 History-Info 头

History-Info 头

History-Info SIP 头跟踪呼叫转移：

<action application="set" data="sip_h_History-Info=<sip:${destination_number}@${ims_domain}>;index=1.1" />

目的：

指示呼叫原本是针对 ${destination_number}
允许下游系统识别转移的呼叫
被语音信箱系统用于存储到正确的邮箱

示例在语音信箱路由中的使用：

<extension name="Voicemail Route" continue="false">
  <condition field="${tas_destination_number}" expression="^(555121|555122)$">
    <!-- 从 History Info 中提取电话号码 -->
    <action application="set" data="history_info_value=${sip_i_history_info}"/>
    <action application="log" data="DEBUG 呼叫语音信箱存储号码为 ${history_info_value}" />

    <!-- 将语音信箱存储到原始被叫方，而不是语音信箱服务号码 -->
    <action application="voicemail" data="default default ${history_info_value}"/>
  </condition>
</extension>

工作原理：

语音信箱服务号码：555121、555122（通用短代码）
当呼叫转移到语音信箱时，History-Info 包含原始目的地
语音信箱系统从 History-Info 头中提取原始号码
语音信箱存储到原始被叫方的邮箱，而不是语音信箱服务号码

最佳实践

始终检查 "none" - 使用正则表达式 ^(?!none$).* 避免路由到字面字符串 "none"
设置 History-Info - 在转移时始终设置以便进行适当的呼叫跟踪
使用 continue_on_fail - 允许在主要路由失败时回退到转移
调整 CLI 格式 - 国家与国际前缀格式（参见呼叫者 ID 部分）
测试转移循环 - 确保转移目的地不会创建路由循环

呼叫者 ID (CLI) 管理

TAS 在整个呼叫流程中管理呼叫线路识别（CLI）的呈现和格式，处理隐私请求、前缀规范化和网络特定的格式要求。

CLI 变量

拨号计划中的核心 CLI 变量：

变量	用法	示例
`msisdn`	订阅者的号码（无 +）	`"61412345678"`
`effective_caller_id_number`	显示的呼叫者号码	`"+61412345678"` 或 `"anonymous"`
`effective_caller_id_name`	显示的呼叫者姓名	`"+61412345678"` 或 `"anonymous"`
`origination_caller_id_number`	出站腿的 CLI	`"+61412345678"`
`caller_id_number`	标准 FreeSWITCH CLI 变量	`"+61412345678"`
`sip_from_user`	SIP From 头部用户部分	`"0412345678"` 或 `"+61412345678"`
`cli_withheld`	隐私标志	`"true"` 或 `"false"`（字符串）
`origination_privacy`	隐私设置	`"hide_number"`

CLI 隐私（隐瞒/匿名）

检测方法

TAS 通过三种方法检测 CLI 隐私请求：

1. 拨打号码中的阻止前缀

订阅者在目的地号码前拨打前缀以阻止其呼叫者 ID。

常见前缀：

*67 - 北美标准
#31# - 欧洲/GSM 标准
1831 - 替代格式

TAS 检查拨打的号码是否以任何配置的阻止 CLI 前缀开头。如果检测到，则将 cli_withheld 变量设置为 "true"。

示例： 订阅者拨打 *67555 1234 - 检测到 *67 前缀并移除，呼叫继续到 5551234，CLI 被隐瞒。

2. From 头中的匿名

用户设备（UE）在 SIP From 头中将呼叫者姓名设置为 "anonymous"。

TAS 检查 Caller-Orig-Caller-ID-Name 字段（不区分大小写）是否包含字符串 "anonymous"。如果找到，则将 cli_withheld 设置为 "true"。

3. SIP 隐私头

S-CSCF 可能在 SIP INVITE 中设置 Privacy: id 头，这在拨号计划中被尊重。

拨号计划实施

拨号计划检查 cli_withheld 变量并相应地设置所有 CLI 相关变量。

示例拨号计划片段：

<extension name="Manage-Caller-ID" continue="true">
  <condition field="${cli_withheld}" expression="true">
    <!-- CLI 被隐瞒 - 设置为匿名 -->
    <action application="log" data="DEBUG 检测到 CLI 隐瞒" />
    <action application="set" data="effective_caller_id_name=anonymous" />
    <action application="set" data="effective_caller_id_number=anonymous" />
    <action application="set" data="origination_caller_id_number=anonymous" />
    <action application="set" data="origination_privacy=hide_number" />

    <!-- CLI NOT 被隐瞒 - 使用正常的 MSISDN -->
    <anti-action application="log" data="DEBUG CLI 是正常的（未隐瞒）" />
    <anti-action application="set" data="effective_caller_id_number=${msisdn}" />
  </condition>
</extension>

注意： 此扩展使用 continue="true"，因此即使设置了 CLI，呼叫处理仍将继续到路由扩展。

CLI 格式：国家与国际

不同的目的地可能需要根据您的网络要求不同的 CLI 格式。

示例：国家��式

对于您国家内的国内呼叫，您可能需要以不带国家代码的形式呈现 CLI。

示例拨号计划片段（澳大利亚移动网络）：

<extension name="Outgoing-Call-CLI-National" continue="true">
  <condition field="${msisdn}" expression="^61(.*)$">
    <action application="log" data="为国家设置源 CLI 为 $1" />
    <action application="set" data="effective_caller_id_number=$1"/>  <!-- 0412345678 -->
    <action application="set" data="effective_caller_id_name=$1"/>
    <action application="set" data="sip_from_user=$1"/>
    <action application="set" data="sip_cid_type=pid"/>
  </condition>
</extension>

工作原理：

正则表达式 ^61(.*)$ 捕获国家代码 61 之后的所有内容
输入：msisdn="61412345678" → 输出：$1="412345678" 或 "0412345678"
在国内呼叫中以国家格式呈现 CLI

示例：国际格式

对于国际呼叫，以完整的 E.164 格式呈现 CLI，带有 + 前缀。

示例拨号计划片段：

<extension name="Outgoing-Call-CLI-International" continue="true">
  <condition field="${tas_destination_number}" expression="^61(.*)$">
    <action application="log" data="呼叫是国家呼叫" />

    <!-- 反向动作在目的地不是国家时运行 -->
    <anti-action application="log" data="为国际设置源 CLI" />
    <anti-action application="set" data="effective_caller_id_number=+${msisdn}"/>  <!-- +61412345678 -->
    <anti-action application="set" data="effective_caller_id_name=+${msisdn}"/>
    <anti-action application="set" data="sip_from_user=+${msisdn}"/>
    <anti-action application="set" data="sip_cid_type=pid"/>
  </condition>
</extension>

工作原理：

条件检查目的地是否以国家前缀开头（例如，澳大利亚的 61）
<anti-action> 在条件不匹配时执行（国际呼叫）
为国际呼叫添加 + 前缀以获得完整的 E.164 格式

呼叫转移时的 CLI 格式

在路由到呼叫转移目的地时，您可能需要根据转移到的号码是网内还是离网来调整 CLI 格式。

示例：调整呼叫转移目的地的 CLI 前缀

<!-- 如果需要，调整 CLI 格式 -->
<action application="set" data="effective_caller_id_number=${effective_caller_id_number:3}"/>
<action application="set" data="effective_caller_id_name=${effective_caller_id_name:3}"/>

字符串切片： ${variable:N} 移除前 N 个字符

输入：effective_caller_id_number="+61412345678" 与 :3 → 输出："412345678"
输入：effective_caller_id_number="+61412345678" 与 :1 → 输出："61412345678"

用例：

为国家转移移除 +：使用 :1
为本地格式移除国家代码：使用适当的偏移量（：3 对于 +61，：2 对于 +1 等等）

SIP P-Asserted-Identity (PAI)

sip_cid_type=pid 设置控制如何呈现呼叫者 ID：

<action application="set" data="sip_cid_type=pid"/>

效果：

使用呼叫者信息设置 SIP P-Asserted-Identity 头
用于 IMS 网络的信任网络呼叫者 ID 断言
IMS 网络的标准

移除专有头

为了防止泄露内部网络信息，拨号计划应在路由呼叫到离网之前移除专有或内部头。

示例：在外部路由之前清理头

<action application="set" data="sip_copy_multipart=false"/>
<action application="set" data="sip_copy_custom_headers=false"/>
<action application="unset" data="sip_h_P-Internal-Correlation-ID"/>
<action application="unset" data="sip_h_P-Access-Network-Info"/>
<!-- 根据需要添加更多供应商特定或内部头 -->

目的：

防止内部路由数据到达外部网络
移除供应商特定的专有头
隐私和安全最佳实践
减少 SIP 消息大小

需要移除的常见头：

内部关联/跟踪 ID
访问网络信息（可能会泄露网络拓扑��
供应商特定的 P 头
仅用于内部使用的自定义应用程序头

最佳实践

对 CLI 扩展使用 continue="true" - 允许多个 CLI 格式规则
设置 sip_cid_type=pid - IMS 网络合规所需
测试 CLI 隐瞒 - 验证 *67 和 #31# 前缀是否有效
根据目的地格式化 - 国家与国际 CLI 格式化
移除专有头 - 防止内部数据泄露
优雅处理匿名 - 显示和路由应适用于匿名 CLI

桥接到网关

TAS 使用 FreeSWITCH 的 bridge 应用程序将呼叫桥接到外部网关（IMS 核心、PSTN 等），并仔细配置编解码器协商、超时处理和重试逻辑的参数。

网关配置

网关配置为 SIP 中继到外部系统。TAS 使用单个 SIP 接口处理所有流量，为不同目的地定义不同的网关。

示例网关配置：

<gateway name="CS_Gateway">
  <param name="proxy" value="10.1.1.100:5060"/>
  <param name="register" value="false"/>
  <param name="caller-id-in-from" value="true"/>
  <param name="extension-in-contact" value="true"/>
</gateway>

请参阅 配置指南 以获取完整的网关设置。

桥接语法

呼叫通过以下语法桥接到网关：

基本语法：

<action application="bridge" data="sofia/gateway/GATEWAY_NAME/DESTINATION_NUMBER" />

带参数：

<action application="bridge" data="{param1=value1,param2=value2}sofia/gateway/GATEWAY_NAME/DESTINATION_NUMBER" />

其中 GATEWAY_NAME 是在您的配置中定义的网关名称（例如，IMS_Core、PSTN_Primary、International_Gateway）。

桥接参数

编解码器选择

absolute_codec_string - 优先编解码器列表以进行协商：

<action application="bridge" data="{absolute_codec_string='AMR,PCMA,PCMU'}sofia/gateway/IMS_Gateway/+${msisdn}" />

编解码器优先级顺序：

AMR（自适应多速率） - 移动优化，优先用于蜂窝
PCMA（G.711 a-law） - 欧洲/国际的固定线路标准
PCMU（G.711 μ-law） - 北美的固定线路标准

模板使用： priv/templates/mt_dialplan.xml:80、mo_dialplan.xml:124、mo_dialplan.xml:202

超时配置

originate_timeout - 等待应答的最大秒数（包括响铃）：

<action application="set" data="originate_timeout=60"/>
<action application="bridge" data="{originate_timeout=60}sofia/gateway/CS_Gateway/+${msisdn}" />

progress_timeout - 等待 180/183（早期媒体/响铃）的秒数：

<action application="set" data="progress_timeout=10" />

bridge_answer_timeout - 在响铃开始后等待 200 OK 的秒数：

<action application="set" data="bridge_answer_timeout=${no_reply_timer}" />

leg_progress_timeout - 每条腿的进度超时：

<action application="set" data="leg_progress_timeout=${no_reply_timer}" />

模板示例： priv/templates/mt_dialplan.xml:73-76

<action application="set" data="progress_timeout=10" />
<!-- 我们在 INVITE 和 200 OK 之间等待多长时间（包括响铃） -->
<action application="set" data="bridge_answer_timeout=${no_reply_timer}" />
<action application="set" data="leg_progress_timeout=${no_reply_timer}" />

变量： ${no_reply_timer} 来自订阅者数据（通常为 20-30 秒）

重试和失败处理

originate_retries - 重试尝试的次数：

<action application="bridge" data="{originate_retries=1}sofia/gateway/CS_Gateway/+${msisdn}" />

continue_on_fail - 在桥接失败后继续拨号计划执行：

<action application="set" data="continue_on_fail=true" />
<action application="bridge" data="{continue_on_fail=true}sofia/gateway/CS_Gateway/+${msisdn}" />
<!-- 如果桥接失败，后续动作执行 -->
<action application="log" data="INFO 桥接失败 - 路由到语音信箱" />

hangup_after_bridge - 当 B-leg 挂断时挂断 A-leg：

<action application="set" data="hangup_after_bridge=true"/>

早期媒体处理

ignore_early_media - 控制早期媒体行为：

<action application="set" data="ignore_early_media=ring_ready" />
<action application="bridge" data="{ignore_early_media=ring_ready}sofia/gateway/CS_Gateway/+${msisdn}" />

选项：

ring_ready - 生成本地响铃，忽略远程早期媒体
true - 完全忽略早期媒体
false（默认） - 传递早期媒体（公告、音调）

为什么使用 ring_ready？ - 防止呼叫者听到来自远程网络的公告或音调

模板示例： priv/templates/mt_dialplan.xml:78-79

<action application="set" data="ignore_early_media=ring_ready" />
<action application="bridge" data="{ignore_early_media=ring_ready,...}sofia/gateway/CS_Gateway/+${msrn}" />

在网与离网呼叫者处理：

<extension name="Route-to-IMS-Sub-Early-Media" continue="true">
  <condition field="${on_net_caller}" expression="true">
    <!-- On-net 呼叫者 - 使用 ring_ready -->
    <action application="log" data="INFO On-net 呼叫者 ${effective_caller_id_number} - 使用 ignore_early_media=ring_ready"/>
    <action application="set" data="ignore_early_media=ring_ready"/>

    <!-- Off-net 呼叫者 - 提供即时响铃 -->
    <anti-action application="log" data="INFO Off-net 呼叫者 ${effective_caller_id_number} - 设置即时响铃"/>
    <anti-action application="set" data="instant_ringback=true"/>
    <anti-action application="set" data="ringback=${fr-ring}"/>
    <anti-action application="set" data="transfer_ringback=${fr-ring}"/>
  </condition>
</extension>

注意： ${on_net_caller} 变量根据您的网络的订阅者编号计划设置。您还可以使用正则表达式模式来匹配您的特定号码范围。

呼叫 ID 参数

sip_cid_type=pid - 使用 P-Asserted-Identity 进行呼叫 ID：

<action application="set" data="sip_cid_type=pid" />
<action application="bridge" data="{sip_cid_type=pid}sofia/gateway/CS_Gateway/+${msisdn}" />

常见桥接模式

模式 1：通过 IMS 域路由到 IMS 订阅者

将 MT 呼叫路由到 IMS 订阅者，通过发送到 IMS 域（S-CSCF 将解析并路由）。

模板示例：

<extension name="Route-to-IMS-Sub" continue="false">
  <condition field="destination_number" expression="^(.*)$">
    <action application="set" data="continue_on_fail=true" />
    <action application="set" data="hangup_after_bridge=true"/>
    <action application="set" data="progress_timeout=10" />

    <!-- 我们在 INVITE 和 200 OK 之间等待多长时间（包括响铃） -->
    <action application="set" data="bridge_answer_timeout=${no_reply_timer}" />
    <action application="set" data="leg_progress_timeout=${no_reply_timer}" />

    <!-- 将呼叫发送到 IMS 域（S-CSCF 解析） -->
    <action application="set" data="ignore_early_media=ring_ready" />
    <action application="set" data="sip_cid_type=pid" />

    <action application="bridge"
      data="{absolute_codec_string='AMR-WB,AMR,PCMA,PCMU',ignore_early_media=ring_ready,continue_on_fail=true,sip_cid_type=pid,originate_retries=1,originate_timeout=${no_reply_timer},sip_invite_call_id=${sip_call_id}}sofia/internal/${msisdn}@${ims_domain}" />

    <!-- 如果桥接失败，则提供到呼叫转发的回退 -->
    <action application="log" data="INFO 呼叫桥接失败 - 路由到呼叫转发无应答目的地" />
    <action application="set" data="sip_h_History-Info=<sip:${destination_number}@${ims_domain}>;index=1.1" />
    <action application="set" data="sip_h_Diversion=<sip:${destination_number:2}@${ims_domain}>;reason=busy" />

    <!-- 路由到离网网关进行呼叫转发 -->
    <action application="bridge"
      data="{absolute_codec_string='AMR-WB,AMR,PCMU,PCMA',originate_timeout=65,originate_retries=0}sofia/gateway/ExternalSIPGateway/${call_forward_not_reachable_destination}" />
  </condition>
</extension>

关键点：

路由到 ${msisdn}@${ims_domain}（例如，5551234567@ims.mnc380.mcc313.3gppnetwork.org）
IMS 核心（S-CSCF/I-CSCF）处理最终路由到订阅者
ignore_early_media=ring_ready 提供一致的响铃
失败时使用外部网关进行离网呼叫转发
设置 History-Info 和 Diversion 头以便呼叫转发跟踪

模式 2：路由到 MSRN（CS 漫游）

通过 CS 网络路由到漫游订阅者：

模板： priv/templates/mt_dialplan.xml:67-80

<extension name="Route-to-CS-MSRN" continue="false">
  <condition field="msrn" expression="^(\d+)$">
    <action application="set" data="continue_on_fail=true" />
    <action application="set" data="hangup_after_bridge=true"/>
    <action application="set" data="progress_timeout=10" />
    <action application="set" data="bridge_answer_timeout=${no_reply_timer}" />
    <action application="set" data="leg_progress_timeout=${no_reply_timer}" />

    <!-- 通过网关发送呼叫到 MSRN -->
    <action application="set" data="ignore_early_media=ring_ready" />
    <action application="set" data="sip_cid_type=pid" />
    <action application="bridge"
      data="{ignore_early_media=ring_ready,absolute_codec_string='AMR,PCMA,PCMU',continue_on_fail=true,sip_cid_type=pid,originate_retries=1,originate_timeout=60}sofia/gateway/CS_Gateway/+${msrn}" />
  </condition>
</extension>

模式 3：On-Net 路由（MO 到 MT 通过 TAS）

当订阅者呼叫另一位在网订阅者时，呼叫必须路由回 TAS 以进行完整的 MT 处理。此模式对于确保在网呼叫获得与外部 MT 呼叫相同的服务处理至关重要。

为什么需要此模式：

没有路由回 TAS，On-net 呼叫将完全绕过 MT 处理，这意味着：

呼叫转移设置将不被尊重
无应答时没有语音信箱
漫游订阅者没有 MSRN 路由
跳过订阅者服务逻辑

通过将 MO 呼叫路由回 TAS 作为新的 MT 呼叫，被叫方获得完整的服务处理。

模板示例：

<extension name="On-Net-Route">
  <condition field="${on_net_status}" expression="true">
    <action application="log" data="DEBUG On-Net MO 呼叫 - 路由回 TAS" />

    <!-- 清理内部路由的头部 -->
    <action application="set" data="sip_copy_multipart=false"/>
    <action application="set" data="sip_h_Request-Disposition=no-fork"/>

    <!-- 路由回 TAS（成为 MT 呼叫） -->
    <action application="bridge"
      data="{absolute_codec_string='AMR-WB,AMR,PCMA,PCMU',originate_retries=1,originate_timeout=60,sip_invite_call_id=${sip_call_id}}sofia/internal/${tas_destination_number}@${sip_local_network_addr}" />
    <action application="hangup" data="" />
  </condition>
</extension>

工作原理：

MO 呼叫到达：订阅者 A 呼叫订阅者 B（均在网内）
检查 On-Net 状态：TAS 确定目的地在网内，通过 ${on_net_status} 变量
路由到 TAS：桥接到 sofia/internal/${tas_destination_number}@${sip_local_network_addr}
- 使用 TAS 自身的 IP 地址作为目的地
- 保留原始呼叫 ID 以便跟踪
MT 处理：TAS 将呼叫视为新的 MT 呼叫，并处理 mt_dialplan.xml
- 检查呼叫转移设置（CFU、CFB、CFNRy、CFNRc）
- 如果订阅者漫游，则查询 MSRN
- 路由到 IMS 域或适当转发
完整服务：被叫订阅者获得完整的 MT 处理

关键点：

路由到 ${sip_local_network_addr}（TAS IP 地址，例如 10.179.3.60）
呼叫作为新的 MT 呼叫重新处理到目的地订阅者
使用 sip_invite_call_id 参数保留呼叫 ID 以便端到端跟踪
启用所有 MT 特性：呼叫转移、语音信箱、MSRN 路由、订阅者服务
对双方进行正确的呼叫状态跟踪和 CDR 生成
On-net 呼叫获得与外部 MT 呼叫相同的服务处理
TAS IP 必须在 allowed_sbc_source_ips 配置

相关文档​

核心文档​

呼叫处理流程​

服务实现​

监控​

拨号计划配置 / 呼叫路由​

FreeSWITCH XML 拨号计划基础​

基本结构​

条件和正则匹配​

动作与反向动作​

continue="true" 属性​

常见应用​

呼叫控制​

变量和通道数据​

媒体和提示​

语音信箱​

日志记录和调试​

杂项应用​

实际示例​

进一步文档​

拨号计划变量​

常见变量（所有呼叫类型）​

紧急呼叫​

MT 呼叫（移动终止）​

MO 呼叫（移动发起）​

紧急呼叫​

配置​

紧急检测工作原理​

处理流程​

拨号计划路由​

最佳实践​

IVR 菜单​

添加 IVR 菜单​

菜单属性​

条目动作​

On-Net 移动发起呼叫到 On-Net 移动终止订阅者​

为什么将 MO 路由到 MT？​

实施​

MSRN 用于 2G/3G 漫游订阅者的使用​

什么是 MSRN？​

MSRN 检索流程​

实施细节​

第一步：发送路由信息 (SRI)​

第二步：提供漫游号码 (PRN) - 如果需要​

拨号计划变量： msrn​

在 mt_dialplan.xml 中路由到 MSRN​

关键点​

配置​

呼叫转移数据使用​

呼叫转移类型​

数据来源​

1. Sh 接口 (HSS)​

2. SS7 MAP (HLR)​

变量合并优先级​

拨号计划变量​

在 mt_dialplan.xml 中的呼叫转移​

示例 1：无条件呼叫转移 (CFU)​

示例 2：无应答/不可达呼叫转移​

History-Info 头​

最佳实践​

呼叫者 ID (CLI) 管理​

CLI 变量​

CLI 隐私（隐瞒/匿名）​

检测方法​

拨号计划实施​

CLI 格式：国家与国际​

示例：国家���式​

示例：国际格式​

呼叫转移时的 CLI 格式​

SIP P-Asserted-Identity (PAI)​

移除专有头​

最佳实践​

桥接到网关​

网关配置​

桥接语法​

桥接参数​

编解码器选择​

超时配置​

重试和失败处理​

早期媒体处理​

相关文档

核心文档

呼叫处理流程

服务实现

监控

拨号计划配置 / 呼叫路由

FreeSWITCH XML 拨号计划基础

基本结构

条件和正则匹配

动作与反向动作

continue="true" 属性

常见应用

呼叫控制

变量和通道数据

媒体和提示

语音信箱

日志记录和调试

杂项应用

实际示例

进一步文档

拨号计划变量

常见变量（所有呼叫类型）

紧急呼叫

MT 呼叫（移动终止）

MO 呼叫（移动发起）

紧急呼叫

配置

紧急检测工作原理

处理流程

拨号计划路由

最佳实践

IVR 菜单

添加 IVR 菜单

菜单属性

条目动作

On-Net 移动发起呼叫到 On-Net 移动终止订阅者

为什么将 MO 路由到 MT？

实施

MSRN 用于 2G/3G 漫游订阅者的使用

什么是 MSRN？

MSRN 检索流程

实施细节

第一步：发送路由信息 (SRI)

第二步：提供漫游号码 (PRN) - 如果需要

拨号计划变量： `msrn`

在 mt_dialplan.xml 中路由到 MSRN

关键点

配置

呼叫转移数据使用

呼叫转移类型

数据来源

1. Sh 接口 (HSS)

2. SS7 MAP (HLR)

变量合并优先级

拨号计划变量

在 mt_dialplan.xml 中的呼叫转移

示例 1：无条件呼叫转移 (CFU)

示例 2：无应答/不可达呼叫转移

History-Info 头

最佳实践

呼叫者 ID (CLI) 管理

CLI 变量

CLI 隐私（隐瞒/匿名）

检测方法

拨号计划实施

CLI 格式：国家与国际

示例：国家��式

示例：国际格式

呼叫转移时的 CLI 格式

SIP P-Asserted-Identity (PAI)

移除专有头

最佳实践

桥接到网关

网关配置

桥接语法

桥接参数

编解码器选择

超时配置

重试和失败处理

早期媒体处理