Auto Provisioning Phone Information Parameters
Auto provisioning lets the phone system push configuration to phones automatically, so you do not have to set up each handset by hand. When you export or import an auto provisioning phone list, each column in the CSV (comma-separated values) file corresponds to one of the parameters below. Use this reference to prepare an import file or to interpret an exported one. Values shown in code format are the literal entries the file expects.
| Parameter | Required? | Format and notes | Default |
|---|---|---|---|
| Vendor | Required | The phone manufacturer. The value must match a supported vendor. | - |
| Model | Required | The phone model. The value must match a supported model for the selected vendor. | - |
| MAC Address | Required | The MAC (Media Access Control) address of the phone, the unique hardware identifier printed on the device. Permitted characters are digits 0-9, letters A-Z or a-z, hyphens (-), and colons (:). The entry can be up to 17 characters long and must contain a 12-character identifier, for example FA-B5-49-1A-2B-3C, FA:B5:49:1A:2B:3C, or FAB5491A2B3C. | - |
| Template | Required | The name of the provisioning template applied to the phone. Enter the name of a default or custom template. | - |
| RPS PIN | Optional | For Yealink phones, the RPS (Redirection and Provisioning Service) PIN a user can enter on the handset to finish RPS provisioning when it is required. Letters and numbers only, up to 31 characters. | - |
| Onsite Proxy UUID | Optional | The UUID (universally unique identifier) of the Onsite Proxy instance used for provisioning. | - |
| Hot Desking Phone | Optional | Whether the phone is configured as a hot desking phone. Enter 0 to disable or 1 to enable. An empty field defaults to 0. | 0 |
| Authentication First-time | Optional | Whether the user must enter authentication details on the phone before the first provisioning run. Enter 0 to disable or 1 to enable. This setting applies only when Onsite Proxy UUID is empty. An empty field is filled with the default shown at right. | 1 when Hot Desking Phone is 0; otherwise 0 |
| Assign Extension | Required when Hot Desking Phone is 0 | The extension assigned to the phone. Digits only. For IP (Internet Protocol) phones, up to 11 characters. For DECT (Digital Enhanced Cordless Telecommunications) phones, up to 1024 characters in the form {Handset Number}:{Extension Number}, separating multiple handsets with &, for example 1:1002&2:1005&3:1006. | - |
Finding parameter values in the console
Section titled “Finding parameter values in the console”Rules that prevent import errors
Section titled “Rules that prevent import errors”Several fields interact with Hot Desking Phone. Getting these combinations wrong causes the import to fail.