FreeSWITCH：呼叫前校验外部API的实现方案咨询

阿华AIGC实验室

2026-5-25

在FreeSWITCH拨号计划中实现外呼前API验证的方案

不用折腾开发ESL扩展啦！FreeSWITCH自带的模块和拨号计划功能完全能搞定这个外呼前API验证的需求，我给你详细讲讲具体的配置思路和实现步骤：

核心思路

利用FreeSWITCH的mod_curl模块（默认已加载）发起HTTP请求调用你的验证API，获取响应后通过cond应用判断结果，只有返回"OK"时才继续发起外呼，否则直接终止呼叫并给出提示。

具体拨号计划配置示例

你可以在对应的context（比如default或者自定义的外呼context）里添加如下扩展：

<extension name="outbound_pre_validation">
  <condition field="destination_number" expression="^\+?[0-9]{7,15}$">
    <!-- 1. 调用外部验证API，传递主叫、被叫参数 -->
    <!-- 这里可以根据API需求调整请求方式（GET/POST）和参数 -->
    <action application="set" data="api_response=${curl(-m 3 http://your-api-domain/validate?caller=${caller_id_number}&dest=${destination_number})}"/>
    
    <!-- 2. 判断API响应是否为"OK"，是则执行桥接呼叫 -->
    <action application="cond" data="${api_response} == OK?bridge(user/${destination_number})"/>
    
    <!-- 3. 验证不通过时，播放提示音并挂断 -->
    <action application="playback" data="ivr/ivr-you_cannot_make_this_call.wav"/>
    <action application="hangup" data="403"/>
  </condition>
</extension>

关键细节说明

API请求参数：caller_id_number是主叫号码变量，你也可以根据实际配置换成effective_caller_id_number；destination_number是被叫号码，确保这些变量能正确获取到对应值。

请求方式调整：如果你的API需要POST请求，可以修改curl命令：

api_response=${curl(-X POST -d "caller=${caller_id_number}&dest=${destination_number}" -m 3 http://your-api-domain/validate)}

超时处理：-m 3设置3秒超时，避免因API响应慢导致呼叫阻塞，超时后api_response会为空，自然会走到验证不通过的逻辑。

精细化提示：如果API返回更具体的错误（比如"INSUFFICIENT_BALANCE"、"BLOCKED_DEST"），可以添加多个cond判断，播放对应提示音：

<action application="cond" data="${api_response} == INSUFFICIENT_BALANCE?playback(ivr/ivr-insufficient_funds.wav)"/>
<action application="cond" data="${api_response} == BLOCKED_DEST?playback(ivr/ivr-number_blocked.wav)"/>