FreeSWITCH配置外呼：从基础到进阶的完整指南

一、外呼功能在FreeSWITCH中的核心地位

FreeSWITCH作为开源的软交换平台，其外呼功能（Outbound Dialing）是企业通信系统的核心能力之一。无论是呼叫中心的外呼营销、IVR自动回访，还是企业分支间的语音互通，都依赖精准的外呼配置。与内呼（Inbound）相比，外呼需要处理更复杂的路由逻辑、号码格式转换及运营商网关交互，因此配置难度更高。

1.1 外呼场景的典型需求

批量外呼：通过CSV文件导入号码列表，结合定时任务实现自动拨打
动态路由：根据主叫号码归属地、被叫号码类型（固话/移动）选择最优网关
预测式外呼：结合AI算法控制拨号节奏，提升坐席利用率
隐私保护：通过中间号技术隐藏真实主被叫号码

二、外呼配置的基础架构

2.1 网关（Gateway）配置

网关是FreeSWITCH连接运营商的核心组件，需在sip_profiles/external/目录下配置。以下是一个典型网关配置示例：

<gateway name="china_mobile">
  <param name="realm" value="sip.chinamobile.com"/>
  <param name="username" value="your_account"/>
  <param name="password" value="your_password"/>
  <param name="register" value="true"/>
  <param name="proxy" value="sip.chinamobile.com:5060"/>
  <param name="expire-seconds" value="3600"/>
  <variables>
    <variable name="dial_string" value="{presence_id=$${dialed_user}@$${domain}}$${sofia_contact(*/$${dialed_user}@$${domain})}"/>
  </variables>
</gateway>

关键参数说明：

register：是否向网关注册（通常运营商要求注册）
expire-seconds：注册有效期，需与运营商要求一致
dial_string：定义拨号字符串的格式，影响后续路由

2.2 拨号计划（Dialplan）设计

拨号计划是外呼逻辑的核心，通过conf/dialplan/default.xml或自定义上下文实现。以下是一个支持多网关选择的拨号计划示例：

<context name="outbound_calls">
  <extension name="mobile_outbound">
    <condition field="destination_number" expression="^1[3-9]\d{9}$">
      <action application="set" data="gateway=china_mobile"/>
      <action application="bridge" data="[${gateway}]$${destination_number}"/>
    </condition>
  </extension>
  <extension name="landline_outbound">
    <condition field="destination_number" expression="^0\d{2,3}-?[1-9]\d{6,7}$">
      <action application="set" data="gateway=china_telecom"/>
      <action application="bridge" data="[${gateway}]$${destination_number|number_normalize}"/>
    </condition>
  </extension>
</context>

设计要点：

正则表达式匹配：精准识别手机号码（11位）和固话号码（含区号）
变量替换：$${destination_number}自动获取被叫号码
号码归一化：通过number_normalize模块处理带-或空格的号码

三、进阶配置技巧

3.1 动态网关选择

通过mod_db模块结合数据库查询实现动态路由：

<extension name="dynamic_gateway">
  <condition field="destination_number" expression="^(\d{3,4})-?(\d{7,8})$">
    <action application="set" data="area_code=${regex_group(1)}"/>
    <action application="db_query" data="select gateway from routing_rules where area_code='${area_code}'"/>
    <action application="bridge" data="[${db_result}]$${destination_number}"/>
  </condition>
</extension>

实现步骤：

创建MySQL表routing_rules，存储区号与网关的映射关系
配置mod_db连接数据库
在拨号计划中通过db_query获取结果

3.2 外呼限速控制

通过mod_ratelimit模块限制并发外呼数量：

<configuration name="ratelimit.conf" description="Rate Limiting">
  <settings>
    <param name="global-rate" value="100"/> <!-- 全局并发限制 -->
    <param name="per-gateway-rate" value="20"/> <!-- 每个网关并发限制 -->
  </settings>
</configuration>

应用场景：

避免触发运营商的并发呼叫限制
平衡多个网关的负载

3.3 隐私保护配置

使用中间号技术隐藏真实号码：

<extension name="privacy_call">
  <condition field="destination_number" expression="^1[3-9]\d{9}$">
    <action application="set" data="proxy_number=4001234567"/> <!-- 中间号 -->
    <action application="set" data="real_caller=${caller_id_number}"/>
    <action application="bridge" data="[china_mobile]${proxy_number}"/>
    <!-- 通过API将real_caller与proxy_number绑定 -->
  </condition>
</extension>

实现方式：

部署中间号管理服务
通过ESL（Event Socket Library）在拨号时动态绑定号码

四、常见问题与解决方案

4.1 403 Forbidden错误

原因：

网关注册失败（密码错误/IP白名单限制）
拨号字符串格式错误

排查步骤：

检查sofia status gateway reg确认注册状态
启用console loglevel DEBUG查看详细SIP信令

4.2 号码格式不匹配

解决方案：

使用mod_dptools的number_normalize应用：

<action application="set" data="normalized_number=${number_normalize(${destination_number})}"/>
<action application="bridge" data="[china_mobile]${normalized_number}"/>

4.3 并发超限

优化建议：

调整mod_ratelimit参数

启用mod_fifo实现排队机制：

<action application="fifo" data="outbound_queue wait=${fifo_wait}"/>

五、性能调优建议

5.1 内存优化

限制max-dialogs参数（默认1000）：

<param name="max-dialogs" value="5000"/>

禁用不必要的模块（如mod_xml_rpc）

5.2 日志管理

配置loglevel为INFO减少日志量
使用rsyslog分割日志文件

5.3 监控告警

通过fsprof监控实时呼叫状态
集成Prometheus+Grafana实现可视化监控

六、总结与展望

FreeSWITCH的外呼配置是一个涉及网络、协议、业务的复杂系统工程。通过合理设计网关架构、拨号计划逻辑及安全控制机制，可以构建高可用、高并发的外呼系统。未来，随着5G和AI技术的发展，FreeSWITCH的外呼功能将进一步与智能路由、语音识别等技术融合，为企业提供更智能的通信解决方案。

推荐学习资源：

FreeSWITCH官方文档《Outbound Calling》
《FreeSWITCH Cookbook》第5章
GitHub开源项目：freeswitch-outbound-demo

通过本文的配置指南与实践建议，开发者可以快速掌握FreeSWITCH外呼的核心技术，并根据实际业务需求进行定制化开发。

FreeSWITCH外呼配置全攻略：从基础到进阶的实战指南