Administrator
发布于 2026-11-21 / 3 阅读
0
0

系列 6:接入运营商线路

本文是《从零搭建 AI + 人工呼叫中心》的补充篇。主篇用两部软电话互打,所有通话都在服务器内部。要让真实的客户打进来、或者让系统打给客户的手机,需要接入运营商的 SIP 中继线路。本篇讲网关配置、呼入路由、呼出路由、NAT、编码,以及最重要的安全设置。

示例基于 freeswitch-docker 镜像,配置目录是宿主机的 $FS_HOME/conf/。


目录


1. 先弄清楚运营商给了什么

开通 SIP 中继后,运营商(或线路商)一般会给你这些信息,配置前先逐项确认:

项目 示例 说明
对接方式 注册 / IP 对接 注册:你的 FreeSWITCH 用账号密码向对方注册;IP 对接:双方互相把对方 IP 加白名单
对方信令地址 sip.carrier.example:5060 或 203.0.113.10
对方媒体地址段 203.0.113.0/24 IP 对接时用于 ACL 和防火墙
账号、密码、认证域 注册方式才有
号码(DID) 02180000000、4008000000 呼入号码,也是外呼可用的主叫号码
号码格式要求 呼出是否加 0、是否带区号、是否要 +86
编码 通常 PCMA(G.711a)
DTMF 方式 RFC2833 / SIP INFO / 带内
并发、CPS 30 路、5 CPS 外呼能开多大,见系列 3
你的出口 IP IP 对接时要报给对方

↑ 回到目录


2. external profile

FreeSWITCH 默认有两个 SIP profile:

profile 端口 用途 来电进入的 context
internal 5060 软电话、坐席注册 default
external 5080 运营商线路 public

运营商相关的配置都放在 external 上,和坐席分开:

  • 坐席的注册和呼叫走 5060,需要认证;
  • 运营商的来电走 5080,进入 public context,只能执行你在 public 里明确写出来的路由,拿不到 default 里的分机和外呼权限。

确认 external profile 在运行:

fs sofia status
fs sofia status profile external

↑ 回到目录


3. 配置网关

网关文件放在 $FS_HOME/conf/sip_profiles/external/ 下,一个网关一个文件。

3.1 注册方式

conf/sip_profiles/external/gw_main.xml:

<include>
  <gateway name="gw_main">
    <param name="realm" value="sip.carrier.example"/>
    <param name="proxy" value="sip.carrier.example:5060"/>
    <param name="username" value="运营商给的账号"/>
    <param name="password" value="运营商给的密码"/>
    <param name="register" value="true"/>
    <param name="register-transport" value="udp"/>
    <param name="expire-seconds" value="600"/>
    <param name="retry-seconds" value="30"/>
    <!-- 定期发送 OPTIONS 探测对方是否在线 -->
    <param name="ping" value="30"/>
    <!-- 把主叫号码放在 From 头里,大多数运营商按 From 识别主叫 -->
    <param name="caller-id-in-from" value="true"/>
  </gateway>
</include>

3.2 IP 对接方式

<include>
  <gateway name="gw_main">
    <param name="proxy" value="203.0.113.10:5060"/>
    <param name="realm" value="203.0.113.10"/>
    <!-- 不注册时 username/password 不会被使用,但 FreeSWITCH 要求这两个参数存在 -->
    <param name="username" value="not-used"/>
    <param name="password" value="not-used"/>
    <param name="register" value="false"/>
    <param name="ping" value="30"/>
    <param name="caller-id-in-from" value="true"/>
  </gateway>
</include>

3.3 让配置生效

fs sofia profile external rescan        # 新增网关用 rescan 即可,不影响已有通话
fs sofia status gateway gw_main         # 注册方式看 State 是否为 REGED;Status 是否为 UP

也可以用 FCC 的接口(在业务后台里做"线路管理"时很方便):

curl -sS -X POST $BASE/sofia/profiles/reload -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' -d '{"profile":"external","mode":"rescan"}'

修改已有网关的参数时,rescan 不一定生效,可以先执行 fs sofia profile external killgw gw_main 再 rescan,或者在低峰期 restart 整个 profile(会断开这个 profile 上的所有通话)。

↑ 回到目录


4. 安全:限制谁能打进来

这是接入线路时最重要的一步。 默认情况下,external profile 不要求来电认证,任何人只要知道你的 IP,都可以向 5080 发起呼叫,进入 public context。如果 public 里的路由写得不严,就可能被人利用来盗打电话。

4.1 ACL 只放行运营商

编辑 conf/autoload_configs/acl.conf.xml,增加一个列表:

<list name="carriers" default="deny">
  <node type="allow" cidr="203.0.113.10/32"/>
  <node type="allow" cidr="203.0.113.0/24"/>
</list>

在 conf/sip_profiles/external.xml 的 <settings> 里加上:

<param name="apply-inbound-acl" value="carriers"/>
fs reloadacl
fs sofia profile external restart       # 会断开 external 上的通话,在低峰期执行

注册方式的运营商,信令地址可能有多个,或者通过域名解析,要向运营商确认完整的地址段。

4.2 防火墙

  • 5080(UDP/TCP)只对运营商的信令地址开放;
  • RTP 端口段(镜像默认 16384–32768/UDP)对运营商的媒体地址段开放;
  • 5060 只对坐席所在网络开放;
  • 8021、18080、18081、9000 等内部端口都不对外。

4.3 public context 只写明确的号码

public 里只为你自己的 DID 写路由,不要写"任意号码转到 default"这类规则。

↑ 回到目录


5. 呼入:号码路由到 AI 热线

运营商的来电进入 public context,destination_number 一般就是你的号码(格式取决于运营商,可能带区号、可能带 +86,先抓包或看日志确认)。

conf/dialplan/public/10_carrier_did.xml:

<include>
  <extension name="did_ai_hotline">
    <!-- 兼容几种常见格式:4008000000 / +864008000000 / 864008000000 -->
    <condition field="destination_number" expression="^(\+?86)?(4008000000)$">
      <action application="set" data="domain_name=$${domain}"/>
      <!-- 直接在这里注册到 FCC:did 记录的就是运营商号码 -->
      <action application="fcc_inbound" data="service=ai_hotline"/>
      <action application="park"/>
      <!-- 决策超时兜底 -->
      <action application="transfer" data="7000 XML default"/>
    </condition>
  </extension>
</include>

和主篇的 4000 分机做的事情一样,只是放在了 public context 里。后面的流程不变:controller 收到 call.incoming,把通话转到 default context 的 8000(AI),AI 再转到 7000(人工)。controller 里 fcc.transfer 默认使用 default context,所以从 public 进来的电话也能正确转过去。

为什么不简单地 transfer 到 4000?fcc_inbound 记录的 did 取自执行它那一刻的被叫号码。先 transfer 到 4000 再注册,did 就变成了"4000",业务后端就分不清客户拨的是哪个号码了。有多个号码时(比如一个售前、一个售后),每个号码各写一条 extension,用不同的 service 区分,controller 按 service 或 did 分流。

fs reloadxml

用手机拨打你的号码,在 fscli 日志里应该能看到来电命中 did_ai_hotline,controller 打印出 call.incoming,caller 是你的手机号。

↑ 回到目录


6. 呼出:三种方式

6.1 FCC 直连网关(AI 外呼推荐)

curl -sS -X POST $BASE/calls -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"request_id":"out-001","caller":"02180000000","callee":"13800138000","route_mode":"direct_gateway","gateway":"gw_main"}'

生成的 endpoint 是 sofia/gateway/gw_main/13800138000,不经过拨号计划,没有 loopback。系列 3 的 dialer.py 用 --route direct_gateway --gateway gw_main 就是这种方式。

6.2 FCC 经拨号计划(需要统一做号码处理时)

route_mode=dialplan 会生成 loopback/<callee>/<context>,由拨号计划决定怎么呼出。在 default context 里加一条外呼规则:

<extension name="outbound_mobile">
  <condition field="destination_number" expression="^(1[3-9]\d{9})$">
    <action application="set" data="effective_caller_id_number=02180000000"/>
    <action application="set" data="hangup_after_bridge=true"/>
    <action application="bridge" data="sofia/gateway/gw_main/$1"/>
  </condition>
</extension>

好处是号码改写、多线路选择、按时段路由都可以集中写在拨号计划里。代价是多了 loopback 通道,推流方向会反转(推流模块会自动处理,见系列 3 第 3 章)。

6.3 坐席手工外呼

坐席用软电话直接拨手机号时,呼叫进入 default context,同样会匹配上面的 outbound_mobile 规则。只有 internal profile 上认证过的分机才能用到这条规则,这也是为什么外呼规则必须写在 default 里、而不是 public 里。

6.4 先用命令行测试

fs originate {origination_caller_id_number=02180000000}sofia/gateway/gw_main/13800138000 \&echo

手机接通后会听到自己的回声,说明信令、媒体、编码都没问题。

↑ 回到目录


7. 主叫号码

  • 主叫号码必须是运营商分配给你、允许外显的号码,否则对方可能直接拒绝(常见挂机原因 CALL_REJECTED),或者把号码替换掉;
  • FCC 外呼时用 caller 字段设置,对应 origination_caller_id_number;
  • 有的运营商要求主叫放在 P-Asserted-Identity 头里,可以在 originate 变量里加 sip_cid_type=pid,或者在拨号计划里 set;
  • 网关参数 caller-id-in-from=true 让主叫出现在 From 头里,大多数运营商需要它。

↑ 回到目录


8. NAT 与公网 IP

服务器在云上或者在 NAT 后面时,FreeSWITCH 要知道自己的公网 IP,并把它写进 SIP 和 SDP,否则会出现"能接通、没声音"。

conf/vars.xml:

<X-PRE-PROCESS cmd="set" data="external_rtp_ip=1.2.3.4"/>
<X-PRE-PROCESS cmd="set" data="external_sip_ip=1.2.3.4"/>

external profile 默认使用这两个变量作为 ext-rtp-ip 和 ext-sip-ip。修改后需要重启(sudo docker compose restart)。

检查:

fs sofia status profile external | grep -Ei 'ext-(rtp|sip)-ip'

其他要点:

  • 云服务器安全组要放行 RTP 端口段,并且是 UDP;
  • 如果运营商在内网专线上(不走公网),external profile 就不应该使用公网 IP,这时可以单独为专线建一个 profile;
  • 运营商侧的 NAT 问题(对方在 NAT 后面)比较少见,遇到时可以尝试 profile 参数 NDLB-force-rport,具体以运营商的说明为准。

↑ 回到目录


9. 编码与采样率

国内运营商线路绝大多数只支持 PCMA(G.711a),采样率 8000 Hz。这会影响 AI:

  • 推流的 sample_rate 是 8000,start 帧里能看到;
  • ASR 收到的是 8k 窄带语音,可以对比 paraformer-realtime-v2(支持任意采样率)和专门针对电话场景的 paraformer-realtime-8k-v2,选识别效果好的;
  • TTS 按 8000 合成即可,CosyVoice 支持;
  • 配套代码会自动以 start 帧的采样率为准,不需要改代码。

编码偏好设置在 conf/vars.xml 里(global_codec_prefs、outbound_codec_prefs)。外呼时让 PCMA 排在前面,可以避免和运营商协商失败(488 Not Acceptable Here):

<X-PRE-PROCESS cmd="set" data="outbound_codec_prefs=PCMA,PCMU"/>

坐席这一侧(internal profile)可以保留 G722、OPUS 等宽带编码。客户和坐席桥接时,如果两边编码不同,FreeSWITCH 会自动转码。

↑ 回到目录


10. DTMF

客户按键(比如"按 1 转人工")通过 DTMF 传递。运营商常见的方式是 RFC2833(RTP 事件)。如果收不到按键:

  • 确认运营商使用的方式;
  • 在网关或 profile 上设置对应的参数(比如 dtmf-type),或者在拨号计划里用 start_dtmf 开启带内检测(会消耗更多 CPU);
  • FCC 会把收到的按键作为 call.dtmf 事件推送,detail 里是 digit=1,duration=…,AI 机器人也可以订阅这个事件做"按键转人工"。

↑ 回到目录


11. 排障

打开 SIP 抓包:

fscli
> sofia global siptrace on
> sofia loglevel all 9          # 更详细,排查完记得调回
现象 常见原因 处理
网关状态 FAIL_WAIT、NOREG 账号密码错误;网络不通;对方地址错 看 siptrace 里 REGISTER 的响应(401/403/超时)
呼出返回 403 主叫号码不允许外显;IP 不在对方白名单 和运营商核对主叫号码、出口 IP
呼出返回 404 / 484 被叫号码格式不对 按运营商要求加 0、去掉 +86 等
呼出返回 488 编码协商失败 outbound_codec_prefs 加上 PCMA
呼出返回 503 / 并发满 超过线路并发或 CPS 降低外呼并发;FCC 设置 max_cps
来电完全进不来 防火墙、ACL、运营商没把号码指到你的 IP siptrace 看有没有 INVITE 进来;看日志里有没有 ACL 拒绝
来电进来了,controller 却没收到 call.incoming public 里的号码格式没匹配上 看日志里实际的 destination_number
接通后单通或无声 NAT:SDP 里是内网 IP;RTP 端口没放行 设置 external_rtp_ip;放行 UDP 端口段
通话约 30 秒或 32 秒后自动断开 ACK 没收到,通常是 NAT 或防火墙问题 检查 external_sip_ip 和防火墙
AI 识别效果明显变差 8k 窄带 试 8k 专用识别模型;调整提示词,容忍识别误差
收不到按键 DTMF 方式不匹配 见第 10 章

相关链接

系列文章

↑ 回到顶部


评论