3CX Phone Provisioning Templates Variables
pixel500w-500x1
Zero Admin
With the new Dashboard
pixel500w-500x1
Bulletproof Security
With SSL certs and NGINX
pixel500w-500x1
Install on $100 Appliance
Intel MiniPC architecture
pixel500w-500x1
New, Intuitive Windows Client
More themes, more UC
pixel500w-500x1
More CRM Integrations
Scripting Interface to add your own
pixel500w-500x1
Improved Integrated Web Conferencing
iOS and Android apps included
pixel500w-500x1
Personal Click2Meet URLs

Variables used in the 3CX Provisioning Templates

The 3CX Provisioning Templates make use of a set of variables which are replaced by the extension’s details when an extension is provisioned. There are situations where you might need to customize the Phone Provisioning Templates as explained in ‘Editing the Phone Provisioning Templates‘.

The following table documents the variables used in the 3CX Provisioning Templates.

Note: The following variables apply for 3CX Phone System V14 and that some variables are used in the provisioning templates of specific phones. The description of such variables will indicate the phone templates that they apply to.

Variable Description Comments
%%PROVLINK%% Phone provisioning default URL. This is the phone provisioning default URL. Provisioning URL’s are specified in the Settings-> Phone Provisioning tab. The provisioning URL will be automatically set according to the chosen Provisioning Method. Contains FQDN and Provisioning port
%%PROVLINKEXT%% Phone provisioning External/Public URL. Non secure. This is the phone provisioning External/Public URL. It is non secure, because phones will be provisioned using HTTP protocol.
%%PROVLINKEXTSEC%% Phone provisioning External/Public URL. Secure. This is the phone provisioning External/Public URL. It is secure, because phones will be provisioned using HTTPS protocol.
%%PROVLINKLOCAL%% Phone provisioning Internal/Local URL. Non secure. This is the phone provisioning Internal/Local URL. It is non secure, because phones will be provisioned using HTTP protocol.
%%PROVLINKLOCALSEC%% Phone provisioning Internal/Local URL. Secure. This is the phone provisioning Internal/Local URL. It is secure, because phones will be provisioned using HTTPS protocol.
%%pbx_ip%% The IP Address/FQDN of the 3CX Phone System. Can be local or external depending on the context and where it is used.
%%param::sipport%% The SIP Port of the 3CX Phone System installation.
PORT The HTTP Port of the 3CX Phone System Installation.  Example: %%PROVLINK.PORT%% that will provide the provisioning port
HOST The FQDN of the installed 3CX Phone System Example: %%PROVLINK.HOST%% that will provide the FQDN of the system
PATH The Provisioning Path of the System Example: %%PROVLINK.PATH%% that will provide the provisioning path of the system
%%param::PBXPUBLICIP%% Public IP Address/FQDN of the 3CX Phone System.
%%local_sbc_ip%% Session Border Controller IP address. This is the variable used to provision the phones using Session Border Controller mode.
%%local_sbc_port%% Session Border Controller port. This is the variable used to provision the phones using Session Border Controller mode.
%%mac_address%% The MAC address of the phone – used to generate a suitable configuration file for each phone.
%%extension_auth_id%% Extension Authentication ID.
%%extension_auth_pw%% Extension Authentication Password.   SIP authentication password
%%extension_first_name%% Extension First Name.
%%extension_last_name%% Extension Last Name.
%%extension_number%% Extension Number.
%%firmware%% Firmware file name.
%%rtp_port_max%% RTP port range Maximum value.
%%rtp_port_min%% RTP port range Minimum value
%%phonesipport%% The phones local SIP port. Important when configuring a phone as a remote extension using STUN.
%%langlcdUI%% Language used to configure the phone – LCD Screen. Some phones have the ability to configure the LCD and the Web management separately.
%%langwebUI%% Language used to configure the phones web UI.
%%langwebUI2%% Language used to configure the phones web UI. Some phones need extra parameters
%%DKtype%% Key type specific for Yealink phones since they use DK mentioning.
%%Line%% Used only for Yealink phones. Internal to Yealink. Yealink phone need to know line ID in order for a BLF key to change behavior.
%%DKtype%% Used only for Yealink phones. Internal to Yealink. Yealink phone need to know line type in order for a BLF key to change behavior.
%%userphone%% Used only for SNOM phones to change the behavior of a function key.
%%value%% The value required to configure a BLF key. Each phone has different values and each combination of values mean something. The available values are documented in each template in the top part.
%%blf1%% BLF followed by digit – 1, 2, 3 and etc… This is the BLF extension placeholder that will be used to provision a specific key in the phone. In the Extension settings, Provisioning section, you can provision a phone with BLF keys. Depending on how many keys you provision, or how many sidecars (BLF key expansion modules) you attach to your phone, you can configure the entries accordingly.
%%blffirstname1%% First name of selected extension used for BLF. If you provision a phone to monitor extension 105, and the first name of extension 105 is James, you will see James in the LCD display of the BLF key / sidecar.
%%blflastname1%% Last name of selected extension used for BLF. If you provision a phone to monitor extension 105, and the last name of extension 105 is Brown, you will see Brown in the LCD display of the BLF key / sidecar.
%%PickupValue%% Value taken from 3CX Phone System that refers to the PICKUP code. For example: default value is *20*.
%%param::pickup%% Pick up code taken from the 3CX Phone System configuration.
%%param::DIALCODEPROFILE%% Dial Code value taken from 3CX Phone System configuration. Can be used to change user profile status. Default value is *3.
Example:”%%param::DIALCODEPROFILE%%2″ – DND ON and “%%param::DIALCODEPROFILE%%0” – DND OFF.
%%vm_number%% The Voicemail Extension number. The Voicemail Extension number which is provisioned so you can press the VM button on the phone and call the voicemail service directly.
%%VMPIN%% Extension Voicemail PIN Number.  Applies to Snom phones
%%param::time_ntp_server%% NTP (Network Time Protocol) server used.
%%TimeZoneName%% Time zone name in the format – each phone is different.
%%dstEnableDisable%% Configures the phone to read the parameter to enable or disable DST settings.
%%param::time_dst_end_day%% DST parameters – Day where DST ends.
%%param::time_dst_end_hour%% DST parameters – Hour where DST ends.
%%param::time_dst_end_month%% DST parameters – Month where DST ends.
%%param::time_dst_start_day%% DST parameters – Day where DST starts.
%%param::time_dst_start_hour%% DST parameters – Hour where DST starts.
%%param::time_dst_start_month%% DST parameters – Month where DST starts.
%%param::time_dst_saving_minutes%% Daylight savings time in Minutes.
%%param::time_utc_offset_seconds%% DST offset parameter in seconds.  / Not used anymore only Hour is used
%%param::time_utc_offset_minutes%% DST offset parameter in minutes.
%%param::time_timezone_snom%% Time zone formats for SNOM phones.
%%param::time_timezone_yealink%% Time zone formats for Yealink phones.
%%param::time_timezone_fanvil%% Time zone formats for Fanvil phones.
%%param::time_timezone_htek%% Time zone formats for Htek phones.
%%param::time_timezone_aastra%% Time zone formats for Aastra phones.
%%param::time_timezone_linksys%% Time zone formats for Cisco Phones.
%%param::time_timezone_cisco79x0%% Time zone formats for Cisco79X0 phones.
%%param::time_timezone_cisco79x1%% Time zone formats for Cisco79X1 phones.
%%param::time_timezone_cyberdata%% Time zone formats for CyberData devices.
%%param::time_timezone_ grandstream%% Time zone formats for Grandstream Phones.
%%param::time_timezone_ grandstreamexec%% Time zone formats for Grandstream Executive phones.
%%codec1%% Codec value priority 1. In the provisioning section, you can specify the first preferred codec to be used.
%%codec2%% Codec value priority 2. In the provisioning section, you can specify the first preferred codec to be used.
%%codec3%% Codec value priority 3. In the provisioning section, you can specify the first preferred codec to be used.
%%codec4%% Codec value priority 4. In the provisioning section, you can specify the first preferred codec to be used.
%%payload1%% Payload values used to provision phones with specific codecs.
%%payload2%% Payload values used to provision phones with specific codecs.
%%payload3%% Payload values used to provision phones with specific codecs.
%%payload4%% Payload values used to provision phones with specific codecs.
%%VMPIN%% Extension Voicemail PIN Number.
%%DESKPHONE_PASSWORD%% Phone Web login password. Also used for CTI calls authentication.

 

You might also be interested in:

<