当前位置：首页 > news >正文

FreeSWITCH 的 effective_caller_id_name 和 effective_caller_id_number

news 2026/3/26 23:57:35

在 FreeSWITCH 中，effective_caller_id_name和effective_caller_id_number是两个非常重要的通道变量（Channel Variables）。

它们的核心作用是：控制在呼叫去电（Outbound Call）时，被叫方（接收者）手机或话机屏幕上显示的“来电显示”信息。

以下是详细的解释和用法：

1. 核心作用

当你通过 FreeSWITCH 进行bridge（桥接）或者originate（发起呼叫）时，FreeSWITCH 需要决定告诉对方“谁在打这个电话”。

effective_caller_id_name：设置显示的名称（如：Company Support）。
effective_caller_id_number：设置显示的号码（如：01012345678）。

2. 为什么要用 “Effective”（有效的）？

在 FreeSWITCH 中，有两种类型的 Caller ID 变量，它们有微妙的区别：

caller_id_number：通常代表真实的源号码（即拨号者原本的号码）。
effective_caller_id_number：代表对外呈现的号码。

关键逻辑：
当 FreeSWITCH 执行bridge操作发起呼出请求时，它会优先查找effective_caller_id_xxx。如果设置了这两个变量，FreeSWITCH 就会在 SIP 的From头部或者Remote-Party-ID头部使用这些值。如果没有设置，它才会退而求其次使用caller_id_xxx。

3. 常见使用场景

场景 A：企业总线号码代发

公司内部员工的内部短号是1001，但他拨打外部客户手机时，不希望显示1001（因为客户回拨不进来），而是希望显示公司的统一对外大号010-88888888。

操作：在拨号计划（Dialplan）中，将effective_caller_id_number设置为01088888888。

场景 B：呼叫转移（Call Forwarding）

A 打给 B，B 设置了呼叫转移到 C。

如果 B 转发给 C 时，希望 C 看到是 A 在打过来，B 就会把effective_caller_id_number设置成 A 的号码。
如果 B 希望 C 看到是 B 转过来的，就设置成 B 的号码。

4. 如何在 Dialplan 中设置

通常在conf/dialplan/default.xml中使用：

<extensionname="outbound_call"><conditionfield="destination_number"expression="^(\d+)$"><!-- 设置显示的名称 --><actionapplication="set"data="effective_caller_id_name=My Company"/><!-- 设置显示的号码 --><actionapplication="set"data="effective_caller_id_number=01012345678"/><!-- 执行外呼 --><actionapplication="bridge"data="sofia/gateway/my_provider/$1"/></condition></extension>

5. 注意事项

运营商限制：尽管你可以在 FreeSWITCH 里随便设置effective_caller_id_number，但当你通过中继线（Gateway/Trunk）打到公网（移动/联通/电信）时，运营商通常会强制修改或丢弃你自定义的号码，以防止诈骗电话。你只能设置成该中继线合法绑定的号码。
变量继承：这两个变量通常设置在“A腿”（主叫通道）上，当执行bridge时，它们会被传递并应用到“B腿”（被叫通道）的 SIP 消息中。
与origination_caller_id_number的区别：
- 如果你是使用originate命令（通过 API 或脚本发起呼叫），通常使用origination_caller_id_number。
- 如果你是在 Dialplan 中处理现有的通话，通常使用effective_caller_id_number。