Configuring desk phone provision templates
Provision templates allow Zoom Phone admins to customize desk phone settings by creating templates with custom settings that can be applied to the entire account, multiple sites, a group of desk phones, or a single desk phone. Provision templates can be easily modified, reassigned, and removed. The settings in provision templates can be specified using key-value pairs.
Important:
- Carefully read this guide before using provision templates.
- This article is for admins who are familiar with provision template parameters. Admins take full responsibility for the outcomes of creating and assigning provision templates.
- Provision template parameters are determined by the desk phone manufacturer (for example, Poly or Yealink). Zoom does not provide support for the provision template parameters.
- AudioCodes MP series ATAs support incremental provisioning. This means that a resync from the Zoom web portal will not clear the local parameters on devices, and ongoing calls will not be affected. Incremental provisioning support also eliminates the need to bind a custom provision template to specify the local parameters since the resync will not clear the local parameters.
Limitation: When provisioning a device for the first time, it will clear any local parameters that are non-default values. After the first successful provisioning, users are still required to set any desired local parameters on their device. Any subsequent resyncs will not clear the device's local parameters.
This article covers:
Requirements for configuring desk phone provision templates
Limitations of provision templates
Configuring desk phone provision templates has the following limitations:
- Each provision template can contain no more than 102,400 characters. The template name should be unique.
- The provision template only applies to desk phones. End-of-sale models are not supported.
- Each template can only apply to one manufacturer since each manufacturer supports different parameters. Visit the manufacturer's support site and edit the template by following each manufacturer's supported parameters.
- Changing the order of supported codecs priorities or adding the unsupported codec(s) is not recommended. Changing codecs will likely cause audio quality issues.
- For best results, make sure the desk phones are supported and running the recommended firmware. See the supported desk phone features before you create provision templates.
- The SIP registration-related parameters are limited. The provision template will not be able to save if the admin attempts to change or overwrite any SIP registration-related parameters.
- The provision template section only supports key-value pairs. Other than the SIP-related parameters, Zoom does not have limitations or controls for what being added to the field. Account owners and admins take full responsibility for the outcomes of creating and assigning provision templates.
- The provision template is applied to the assigned phone when you complete provisioning or re-sync the phone.
- The following parameters are reserved and can't be changed:
account.[1-9]
CONFIG_FILES
dm.enable
feature.obitalk.enabled
msg.mwi
obitalk.accountCode
reg.[1-9]
security/ca_certificate
sec.TLS.customCaCert
sip.* (except sip.ld)
static.auto_provision.server.url
static.trusted_certificates.url
system/type
voice_mail.number
voip/line/[1-9]
voip/signalling/sip
How to create a provision template
- Sign in to the Zoom web portal as an admin with the privilege to edit account settings.
- In the navigation panel, click Phone System Management then Company Info.
- Click Account Settings.
- In the Desk Phone section, click Manage under Provision Template.
- Click Add.
- Enter the following:
- Name: Enter a display name to identify the template. Include the manufacturer's name since each template can only apply to one manufacturer.
- Description (optional): Enter a description to help you identify the template.
- Template: Enter key-value pairs supported by the manufacturer. For more details, see parameter examples and supported parameters.
Supported parameters
For detailed specification of all parameters, visit the support site of the desk phone manufacturer:
Here are some frequently requested features that can be configured using provision templates:
Parameter formatting examples
Make sure you follow these formatting rules exactly as specified. Each desk phone manufacturer has a different format for key-value pairs.
These examples show the formatting required to define NTP server(s):
AudioCodes
- Key name for NTP server: system/ntp/primary_server_address
system/ntp/primary_server_address=ntp_server_addr
system/ntp/secondary_server_address=ntp_server_addr2
Avaya
Avaya provisioning templates example:
SET SNTPSRVR 192.168.0.5
SET FORCE_WEB_ADMIN_PASSWORD HelloWorld!01
SET ADMIN_PASSWORD ComPlexPSWD12?!
Cisco
- Key name for NTP server: Primary_NTP_Server
<!-- Primary NTP Server -->
<Primary_NTP_Server ua="rw">192.168.1.11</Primary_NTP_Server>
<!-- Secondary NTP Server -->
<Secondary_NTP_Server ua="rw">192.168.1.22</Secondary_NTP_Server>
Grandstream
GRP series provisioning template examples:
- Example: Change the NTP servers
<!-- # NTP Server -->
<item name="dateTime.ntp.server.1">your_ntp_server_address</item>
<!-- # Secondary NTP Server -->
<!-- # String -->
<item name="dateTime.ntp.server.2">your_ntp_server_address</item>
ATA HT8xx series examples:
For ATA HT8xx series, they only support P-Value format for configurations, so the provisioning template needs to be P-Value. Please refer to the Grandstream Configuration Template for specific parameters for ATA HT80xx and HT81xx series.
<!-- Codec settings: 0 - PCMU, 8 - PCMA, 4 - G.723, 18 - G.729, 2 - G.726-32, 97 - iLBC, 123 - OPUS, 9 - G722 -->
<P57>123</P57>
<P58>9</P58>
<P59>8</P59>
<P60>8</P60>
<P61>8</P61>
<P62>8</P62>
<P46>8</P46>
<P98>8</P98>
<!-- # NTP Server address-->
<P30>your_ntp_server_address</P30>
Poly
device.sntp.serverName=“ntp_server_addr”
Yealink
local_time.ntp_server1=ntp_server_addr
local_time.ntp_server2=ntp_server_addr2
How to assign a provision template to a provisioned desk phone
- Sign in to the Zoom web portal as an admin with the privilege to edit account settings.
- In the navigation menu, click Phone System Management then Phones & Devices.
- Find the desk phone you want to assign a template to.
- In the right column, click the ellipsis icon , then click Bind Provision Template.
Note: You can only assign one provision template to each desk phone. If there's already a template assigned, click Unbind Provision Template to remove the template from the desk phone, or you can change the assigned provision template. - In the Target Template drop-down menu, select the template to assign, then click Bind.
- Re-sync the desk phone to finish assigning the provision template.
How to assign a provision template to multiple desk phones or all desk phones in a site
- Sign in to the Zoom web portal as an admin with the privilege to edit account settings.
- In the navigation menu, click Phone System Management then Phones & Devices.
- In the Site drop-down menu located at the top-right area, select a site to view associated desk phones.
- Click the check box in the first column of the header row to select all desk phones listed.
- In the Provision Template drop-down menu, click Bind.
- In the Target Template drop-down menu, select the template to assign, then click Bind.
- Re-sync the desk phones to finish assigning the provision template.
How to batch assign provision templates
You can batch-assign provision templates when importing/updating phone users or importing unassigned devices. You need to specify the provision template name in the CSV file.
How to assign a provision template during provisioning
- Follow the steps to add a desk phone.
Note: Make sure you specify a desk phone that supports provision templates. You can't select a provision template if the desk phone doesn't support it. - In the Provision Template (Optional) drop-down menu, select the template to assign, then click Save.
The template will be applied to the desk phone during the provisioning process.
How to change or remove an assigned provision template
If you already assigned a provision template to a desk phone, follow these steps to assign a different template or remove the current template.
- Sign in to the Zoom web portal as an admin with the privilege to edit account settings.
- In the navigation menu, click Phone System Management then Phones & Devices.
- Click the desk phone name you want to change.
- Next to Provision Template, click one of these options:
- Edit: Assign a different template to the phone. In the Target Template drop-down menu, select a provision template, then click Bind.
- Unbind: Remove the template from the phone. The template will still be available to assign.
- Re-sync the desk phone to apply changes. The desk phone will restart several times.