话机配置模板使用的变量
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%% | CyberData 设备的时区格式。 | |
%%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号