Using Provision Templates for Zoom Phone Appliances

Configuration templates allow Zoom Phone administrators to customize desk phone settings by creating templates with custom settings that can be applied to the entire account or to individual desk phones. You can easily modify, reassign, and delete configuration templates, and you can use key-value pairs to specify settings in configuration templates.

Notes:

Carefully read this guide before using provision templates.
This article is for admins that 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 provision template parameters.

This article covers:

Limitations of provision templates
Parameter formatting examples
Supported parameters
How to add a configuration template
How to assign configuration templates to provisioned Zoom Phone Appliances
How to edit or delete an assigned configuration template

Prerequisites for using provision templates

Zoom Phone Appliance license

Limitations of provision templates

Each provision template can contain no more than 65,535 characters. The template name should be unique.
Zoom Phone Appliance device type applicable to the configuration template: AudioCodes, Grandstream, Poly, Yealink
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.
It is not allowed to change the Zoom reserved configuration, such as Firmware Url. If the reserved configuration is included, the template cannot be saved.
When binding/unbinding or updating/deleting the template bound to the device, a Resync or Reboot is required for the change to take effect.
When performing Resync after the binding is completed, please ensure that the device has logged in to the APP and is connected to Zoom Device Management (ZDM). Synchronizing the configuration may force the device to restart. If you find that the configuration has not been synchronized, please restart the device manually.

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.

The following example shows the required format for the GUI language parameter:

AudioCodes
```
Key name : display/language
```
Format: Please do not add quotation marks around the value
```
display/language=English
```

Grandstream
```
Key name : language.gui
```
Format : Please use key as the name of the item tag and value as the text.
```
<item name="language.gui">en</item>
```

Poly
```
Key name : lcl.ml.lang
```
Format: Please add double quotes(“) on both sides of the value
```
lcl.ml.lang="English_United_States"
```

YeaLink
```
Key name : lang.gui
```
Format: Please do not add quotation marks around the value
```
lang.gui=English
```

Supported parameters

For detailed specification of all parameters, visit the support site of the phone manufacturer:

How to add a configuration template

Sign in to the Zoom web portal.
Click Device Management, then Device List.
Click Account Settings and select Zoom Phone Appliance.
Find Provision Template and click Manage
Enter the following information：
- Name: Enter a display name to identify the template, it cannot be repeated.
- Description (optional): Enter a description to help you identify the template.
- Template: Enter key-value pairs supported by the manufacturer.

How to assign configuration templates to provisioned Zoom Phone Appliances

Sign in to the Zoom web portal.
Click Device Management then Device List.
Find the Zoom Phone Appliance to which you want to assign a template.
Click the ellipsis icon in the rightmost column, then click Bind Provision Template.
Note: You can assign only one configuration template to each Zoom Phone Appliance.
In the Target template drop-down menu, select the template you want to assign and click Bind.
Resync now or manually restart later to apply the assigned configuration template.

How to edit or delete an assigned configuration template

If you have assigned a configuration template to a machine that has changed or deleted an assigned configuration template, follow these steps to assign a different template or delete the current template.

Sign in to the Zoom web portal.
Click Device Management then Device List.
Click Account Settings and select Zoom Phone Appliance.
Find Provision Template and click manage
Click template name to enter the editing page, then click Edit.
Click the ellipsis on the far right of each template and click Delete.
If there is a device bound to the template edited/deleted this time, the changes will take effect after the next restart.