本文是《从零搭建 AI + 人工呼叫中心》的补充篇。主篇用两部软电话互打,所有通话都在服务器内部。要让真实的客户打进来、或者让系统打给客户的手机,需要接入运营商的 SIP 中继线路。本篇讲网关配置、呼入路由、呼出路由、NAT、编码,以及最重要的安全设置。
示例基于 freeswitch-docker 镜像,配置目录是宿主机的
$FS_HOME/conf/。
目录
- 1. 先弄清楚运营商给了什么
- 2. external profile
- 3. 配置网关
- 4. 安全:限制谁能打进来
- 5. 呼入:号码路由到 AI 热线
- 6. 呼出:三种方式
- 7. 主叫号码
- 8. NAT 与公网 IP
- 9. 编码与采样率
- 10. DTMF
- 11. 排障
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,进入
publiccontext,只能执行你在public里明确写出来的路由,拿不到default里的分机和外呼权限。
确认 external profile 在运行:
fs sofia status
fs sofia status profile external3. 配置网关
网关文件放在 $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 章 |
相关链接
- 主篇:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-from-scratch
- freeswitch-docker:https://github.com/taering365/freeswitch-docker
- mod_fcc:https://github.com/taering365/mod_fcc
系列文章
- 主篇:从零搭建 AI + 人工呼叫中心:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-from-scratch
- 系列 1:mod_taering_stream 媒体协议详解:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-01-stream-protocol
- 系列 2:FCC 控制面深入:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-02-fcc
- 系列 3:AI 外呼:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-03-outbound
- 系列 4:实时质检与坐席辅助:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-04-qa-assist
- 系列 5:延迟优化:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-05-latency
- 系列 6:接入运营商线路:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-06-carrier
- 系列 7:生产化:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-07-production
- 系列 8:排障手册:https://www.liaoxinghui.com/archives/freeswitch-ai-callcenter-08-troubleshooting