话机配置模板使用的变量

3CX话机配置模板使用一组变量,在配置分机时,这些变量将被分机的详细信息替换。在某些情况下,您可能需要自定义电话配置模板,如“编辑话机配置模板”中所述。

下表记录了 3CX 配置模板中使用的变量。

变量

描述

意见

%%blf1%%

BLF 后跟数字 1、2、3 等。

用于配置特定话机键的 BLF 分机占位符。在分机设置的配置部分,您可以为话机配置 BLF 键。根据您配置的键数或您连接到电话的 Sidecar(BLF 键扩展模块)数量,相应地配置条目。

%%blffirstname1%%

用于 BLF 的选定分机的名字。

如果您配置一部电话来监控分机 105,并且分机 105 的名字是五,您将在 BLF 键/边车的 LCD 显示屏上看到五。

%%blflastname1%%

用于 BLF 的选定分机的姓氏。

如果您配置一部电话来监控分机 105,并且分机 105 的姓氏是王,您将在 BLF 键/边车的 LCD 显示屏上看到王。

%%blfno%%

用于通过按 BLF 键来接听电话。

%%blktime%%

背光超时时间

指定话机何时调暗显示屏的超时时间

%%codec1%%

编解码器值优先级1。

在配置部分,您可以指定要使用的第一个首选编解码器。

%%codec2%%

编解码器值优先级2。

在配置部分,您可以指定要使用的第一个首选编解码器。

%%codec3%%

编解码器值优先级3。

在配置部分,您可以指定要使用的第一个首选编解码器。

%%codec4%%

编解码器值优先级4。

在配置部分,您可以指定要使用的第一个首选编解码器。

%%datestyle%%

IP 话机的日期格式

指定话机显示屏上显示的日期格式

%%defringtone%%

IP 话机的默认铃声

将用于普通呼叫的铃声

%%DESKPHONE_PASSWORD%%

话机网页登录密码。

也用于 CTI 呼叫认证。

%%DIALCODECONFGATEWAY%%

会议分机号码

%%DKtype%%

仅适用于 Yealink 话机。Yealink 内部使用。

Yealink 话机需要知道线路类型才能让 BLF 键改变行为。

%%dstEnableDisable%%

配置话机读取参数来启用或禁用 DST 设置。

%%dstEnableDisable%%

配置话机读取参数来启用或禁用 DST 设置。

%%extension_auth_id%%

分机身份验证 ID。

%%extension_auth_pw%%

分机认证密码。

SIP认证密码

%%extension_first_name%%

分机名字。

%%extension_last_name%%

分机姓氏。

%%extension_number%%

分机号码。

%%firmware%%

固件文件名。

%%langlcdUI%%

用于配置话机的语言 - LCD 屏幕。

有些话机可以单独配置 LCD 和 网页管理语言。

%%langwebUI%%

用于配置话机 Web UI 的语言。

%%langwebUI2%%

用于配置话机 Web UI 的语言。

有些话机需要额外的参数

%%Line%%

仅适用于 Yealink 话机。Yealink 内部使用。Yealink 话机需要知道线路 ID,才能通过 BLF 键更改行为。

%%lldpenabled%%

启用 LLDP

启用或禁用电话的 LLDP 功能

%%local_sbc_ip%%

会话边界控制器 SBC 的 IP 地址。

这是用于使用会话边界控制器模式配置电话的变量。

%%local_sbc_port%%

会话边界控制器端口。

这是用于使用会话边界控制器模式配置电话的变量。

%%logo_filename%%

Logo 文件名

自定义 logo 文件的名称

%%logo%%

自定义 logo 路径

自定义 logo 文件的路径,包括自定义 logo 文件夹和文件名

%%mac_address%%

话机的 MAC 地址——用于为每部话机生成合适的配置文件。

%%missedled%%

话机有未接来电时电源 LED 功能

启用或禁用 IP 电话未接来电时电源指示灯 LED 闪烁

%%multicastenabled%%

%%multicastrgip1%%

%%multicastrgipport1%%

多播地址

多播响铃组的IP地址和SIP端口

%%multicastrgname1%%

多播标签

多播响铃组标签

%%multicastrgport1%%

%%mwiled%%

当话机有语音邮件时,电源 LED 功能

启用或禁用 IP 电话收到语音邮件时电源指示灯 LED 闪烁

%%param::DIALCODEPROFILE%%

拨号代码值取自 3CX 电话系统配置。

可用于更改用户配置文件状态。默认值为 *3。

例如:“%%param::DIALCODEPROFILE%%2”表示开启免打扰,“%%param::DIALCODEPROFILE%%0”表示关闭免打扰。

%%param::PBXPUBLICIP%%

3CX 电话系统的公共 IP 地址/FQDN。

%%param::pickup%%

获取从 3CX 电话系统配置中的接听 pick up 代码

%%param::sipport%%

3CX 电话系统安装的 SIP 端口。

%%param::time_dst_end_day%%

DST 参数 – DST 结束的时间(天)。

%%param::time_dst_end_hour%%

DST 参数 – DST 结束的时间(小时)。

%%param::time_dst_end_month%%

DST 参数 – DST 结束的时间(月)。

%%param::time_dst_saving_minutes%%

夏令时(分钟)。

%%param::time_dst_start_day%%

DST 参数 – DST 开始的时间(天)。

%%param::time_dst_start_hour%%

DST 参数 – DST 开始的时间(小时)。

%%param::time_dst_start_month%%

DST 参数 – DST 开始的的时间(月)。

%%param::time_ntp_server%%

使用 NTP(网络时间协议)服务器。

%%param::time_timezone_ grandstream%%

Grandstream 话机的时区格式。

%%param::time_timezone_ grandstreamexec%%

Grandstream Executive 话机的时区格式。

%%param::time_timezone_aastra%%

Aastra 话机的时区格式。

%%param::time_timezone_cisco79x0%%

Cisco79X0 话机的时区格式。

%%param::time_timezone_cisco79x1%%

Cisco79X1 话机的时区格式。

%%param::time_timezone_cyberdata%%

Cyber​​Data 设备的时区格式。

%%param::time_timezone_fanvil%%

Fanvil 话机的时区格式。

%%param::time_timezone_htek%%

Htek 话机的时区格式。

%%param::time_timezone_linksys%%

思科话机的时区格式。

%%param::time_timezone_snom%%

SNOM 话机的时区格式。

%%param::time_timezone_yealink%%

Yealink 话机的时区格式。

%%param::time_utc_offset_minutes%%

DST 偏移参数(以分钟为单位)。

%%param::time_utc_offset_seconds%%

DST 偏移参数(以秒为单位)。

/ 不再使用,仅使用小时

%%payload1%%

用于为话机提供特定编解码器的有效载荷值。

%%payload2%%

用于为话机机提供特定编解码器的有效载荷值。

%%payload3%%

用于为话机提供特定编解码器的有效载荷值。

%%payload4%%

用于为话机提供特定编解码器的有效载荷值。

根据上下文和使用地点,可以是本地的或外部的。

%%pbx_ip%%

3CX 电话系统的 IP 地址/FQDN。

%%PHONE_IP%%

话机的IP地址

%%PHONE_WEB_PASSWORD%%

话机的网页登录密码

使用 STUN 将电话配置为远程分机时非常重要。

%%phonesipport%%

话机本地 SIP 端口。

%%PickupValue%%

从 3CX 电话系统获取的引用 PICKUP 代码的值。

默认值为*20*。

%%PROVLINK.HOST%%

已安装的 3CX 电话系统的 FQDN

例如:%%PROVLINK.HOST%% 将提供系统的 FQDN

%%PROVLINK.PATH%%

系统配置路径

例如:%%PROVLINK.PATH%% 将提供系统的配置路径

%%PROVLINK.PORT%%

3CX 电话系统安装的 HTTP 端口。

例如:%%PROVLINK.PORT%% 将提供配置端口

%%PROVLINK.PROTOCOL%%

自动配置协议

只能是HTTP,即“http”

%%PROVLINK%%

话机自动配置默认 URL。

这是话机自动配置的默认 URL。配置 URL 可在“设置”->“话机配置”选项卡中指定。配置 URL 将根据所选的配置方法自动设置。包含 FQDN 和配置端口

%%PROVLINKEXT%%

话机自动配置外部/公网 URL。不安全。

这是话机自动配置的外部/公网 URL。该 URL 不安全,因为话机将使用 HTTP 协议进行配置。

%%PROVLINKEXTSEC%%

话机自动配置外部/公网 URL。安全。

这是话机自动配置的外部/公网 URL。该 URL 是安全的,因为话机将使用 HTTPS 协议进行配置。

%%PROVLINKLOCAL.HOST%%

话机自动配置本地 URL 的Host部分

%%PROVLINKLOCAL.PATH%%

话机自动配置的配置文件夹路径本地完整非安全 URL

%%PROVLINKLOCAL.PORT%%

话机配置的端口部分本地完整非安全 URL

%%PROVLINKLOCAL.PROTOCOL%%

自动配置协议

%%PROVLINKLOCAL%%

话机自动配置内部/本地 URL。不安全。

这是话机自动配置的内部/本地 URL。由于话机将使用 HTTP 协议进行配置,因此该 URL 不安全。

%%queueid%%

IP 话机的自定义队列铃声

当启用“每个队列使用自定义铃声”时使用

%%queueringtone%%

IP 话机默认的队列铃声

当启用“为所有队列使用默认铃声”时使用

%%queueringtonevalue%%

将发送到 IP 话机的“Alert-Info”文本

当启用“每个队列使用自定义铃声”时使用

%%rtp_port_max%%

RTP 端口范围最大值。

%%rtp_port_min%%

RTP 端口范围最小值。

%%scrsavertime%%

屏幕保护超时时间

指定话机何时在显示屏上显示屏幕保护程序的超时时间

%%timestyle%%

IP话机的时间格式

指定话机显示屏上显示的时间格式

%%TimeZoneName%%

时区名称格式 – 每部话机都不同。

%%userphone%%

仅用于 SNOM 话机来更改功能键的行为。

%%value%%

配置 BLF 键所需的值。

每部话机都有不同的值,每种值的组合都有其含义。每个模板的顶部都记录了可用的值。

%%vlanpcenabled%%

PC 口开启 VLAN

启用或禁用话机 PC 口上的 VLAN

%%vlanpcportid%%

PC 端口 VLAN ID

话机 PC 口使用的 VLAN ID

%%vlanpcportpriority%%

PC 端口 VLAN 优先级

话机 PC 口使用的 VLAN 优先级

%%vlanwanenabled%%

WAN 口开启 VLAN

启用或禁用话机 WAN 端口上的 VLAN

%%vlanwanportid%%

WAN 口 VLAN ID

话机 WAN 口使用的 VLAN ID

%%vlanwanportpriority%%

WAN 口 VLAN 优先级

话机 WAN 端口使用的 VLAN 优先级

%%vm_number%%

语音邮箱分机号码。

已配置语音邮箱分机号码,因此您可以按下电话上的语音邮箱按钮直接呼叫语音邮箱服务。

%%VMPIN%%

分机语音邮箱 PIN 码

%%XFERmethod_Value%%

DSS 转接方式

定义 DSS 按键的传输方法(盲传或咨询转)

distinctive_ring_tones.alert_info.X.ringer

distinctive_ring_tones.alert_info.X.text

queuecrt1 (queuecrtX)

sysparam.CUSTOMIZE_QUEUE_RINGTONES

0 - 所有队列使用相同的铃声,1 - 每个队列使用独特的铃声

最后更新

本文档最后更新于2023年9月3号

https://www.3cx.cn/docs/phone-provisioning-variables/