# Provision a Wildix IP Phone With provisioning, Cloud Voice pushes an extension and its settings straight to a handset, so a Wildix phone comes into service without anyone typing SIP (Session Initiation Protocol) credentials into it by hand. The method you choose comes down to how many phones you are bringing online. The examples below follow a Wildix WP480R3 on firmware 63.145.10.168, but the same steps carry over to the other supported models. ## Supported models and firmware Provisioning only succeeds when the handset and Cloud Voice both meet the minimum firmware below. Every model requires Cloud Voice on **84.15.0.22 or later**. Locate your model and check both versions before you start. | Model | Minimum phone firmware | Minimum Cloud Voice firmware | | --- | --- | --- | | WP410R2 | 50.145.6.169 or later | 84.15.0.22 or later | | WP480R2 | 55.145.6.111 or later | 84.15.0.22 or later | | WP480R3 | 63.145.10.168 or later | 84.15.0.22 or later | | WP480R4 | 65.145.6.38 or later | 84.15.0.22 or later | | WP490R2 | 59.145.6.148 or later | 84.15.0.22 or later | | WP490R3 | 67.145.8.107 or later | 84.15.0.22 or later | :::caution If either the phone firmware or Cloud Voice is below the version listed for your model, provisioning fails. Upgrade the handset (or ask an administrator to upgrade Cloud Voice) to meet both minimums before you continue. ::: ## Choose a provisioning method Match the method to the size of your deployment. | Setting up | What to do | | --- | --- | | One Wildix phone | Add the phone in Cloud Voice, then enter the generated provisioning link in the phone's own web interface. The phone pulls its configuration from that link. | | Several Wildix phones | Add each phone in Cloud Voice, then hand out the provisioning link through DHCP (Dynamic Host Configuration Protocol) option 66. Each phone on the subnet picks up the link at boot and configures itself. | ## Provision a single phone manually ### Before you start - Confirm the provisioning template for your model is already downloaded to Cloud Voice. Templates live under **Auto Provisioning > Resource Repository > Default Templates**. - Factory-reset the phone if it has been used before, so no stale configuration interferes. - Collect the phone's vendor, model, and MAC address (Media Access Control, the phone's unique hardware address). You enter these when you add the phone. ### Step 1: Add the phone in Cloud Voice Adding the phone prompts Cloud Voice to build a configuration file tied to that handset's MAC address. 1. Sign in to the Cloud Voice web portal and go to **Auto Provisioning > Phones**. 2. Click **Add > Add**. 3. In the **IP Phone** section, identify the device. ![The IP Phone fields filled in with vendor, model, and MAC address for a Wildix handset](/images/pbx/add-wildix-phone.png) - **Vendor**: Choose **Wildix**. - **Model**: Choose your phone model. In this example, choose **WP480R3**. - **MAC Address**: Type the phone's MAC address. 4. In the **Options** section, set the provisioning details. ![Cloud Voice, provisioning options for the Wildix handset, showing the template and the generated provisioning link](/images/pbx/wildix-option.png) - **Template**: Pick a template from the drop-down list. :::note Use the default template that matches your phone model, or create your own custom template. ::: - **Provisioning Link**: Generated for you automatically. It points to where the phone's configuration file is stored. :::note Note down the provisioning link, you need it in Step 2. ::: 5. In the **Assign Extension** section, choose the extension to bind to this phone. ![Choosing an extension to assign to the phone during provisioning](/images/pbx/assign-an-extension-pnp.png) :::tip If the extension you want is missing from the drop-down list, it is already bound to another phone. You have two options: - Release the extension from its current phone first, see **Release an Extension from a Provisioned IP Phone**. - Keep the existing association and enable concurrent registration for the extension. By default Cloud Voice lets an extension register with only one SIP endpoint, so turning on concurrent registration lets it register on this phone too. ::: 6. Click **Save**. ### Step 2: Point the phone at the provisioning server Enter the provisioning link Cloud Voice generated into the Wildix phone's own web interface. 1. Log in to the phone's web interface. ![Signing in to the Wildix phone's web interface](/images/pbx/wildix-login-page.png) 1. Type the phone's IP address into your browser's address bar. 2. Enter the username and its password. In this example, use the default username `admin` and password `admin`. :::note `admin` / `admin` are the factory defaults. If login fails, the credentials were changed at some point, so use the current ones for that handset. ::: 3. Click **Login**. 2. In the left navigation bar, go to **Update > Advance > Manual Autop**. 3. Paste the provisioning link into the **URL** field. ![Cloud Voice, the provisioning link pasted into the phone's URL field](/images/pbx/wildix-prov-link.png) 4. Click **AutoP Immediate**. ### Result :::note Some phones reboot on their own. If yours does not, reboot it manually so the new configuration takes effect. ::: Once the phone restarts, it downloads its configuration from Cloud Voice and applies the settings, and the assigned extension registers on the handset. To confirm, open **Auto Provisioning > Phones** in the Cloud Voice web portal and check the registration status. ![The Wildix phone listed as provisioned and registered in the Cloud Voice phone list](/images/pbx/wildix-provisioned-pce.png) ## Provision multiple phones automatically ### Before you start - Confirm the provisioning template for your model is already downloaded to Cloud Voice (**Auto Provisioning > Resource Repository > Default Templates**). - Factory-reset any phone that has been used before. - Have each phone's vendor, model, and MAC address ready. :::caution The subnet where the phones are deployed must have exactly one DHCP server. If a second DHCP server is active, a phone can take a lease from the wrong one, fail to get an IP address, and never reach the provisioning link. ::: ### Step 1: Add each phone in Cloud Voice Add every phone so Cloud Voice builds a configuration file for each MAC address. Repeat these steps for each handset. 1. Sign in to the Cloud Voice web portal and go to **Auto Provisioning > Phones**. 2. Click **Add > Add**. 3. In the **IP Phone** section, set **Vendor** to **Wildix**, choose the **Model** (for example, **WP480R3**), and type the phone's **MAC Address**. 4. In the **Options** section, pick a **Template** and note the **Provisioning Link** that Cloud Voice generates, you use it in Step 2. 5. In the **Assign Extension** section, choose the extension to bind to this phone. 6. Click **Save**. :::tip The **IP Phone**, **Options**, and **Assign Extension** fields here are identical to the single-phone method. See [Step 1: Add the phone in Cloud Voice](#step-1-add-the-phone-in-cloud-voice) above for the field-by-field screenshots and notes, including how to handle an extension that is already bound to another phone. ::: ### Step 2: Configure DHCP option 66 On the subnet where the phones live, publish the provisioning link through option 66 on your DHCP server. 1. In the Cloud Voice web portal, open a phone's detail page and copy its provisioning link. ![The provisioning link shown on a phone's detail page in Cloud Voice](/images/pbx/wildix-prov.png) 2. On the DHCP server, set option 66 to the provisioning link. The example below shows a typical router configuration. ![Cloud Voice, DHCP option 66 set to the provisioning link on a router](/images/pbx/dhcp-option-66-on-router-pce.png) ### Result :::note Some phones reboot on their own. If yours does not, reboot it manually so the new configuration takes effect. ::: After each phone restarts, it obtains an IP address from the DHCP server, downloads its configuration from Cloud Voice over the provisioning link, and applies the settings automatically. The assigned extension then registers on the handset. To confirm, open **Auto Provisioning > Phones** in the Cloud Voice web portal and check the registration status. ![The Wildix phone listed as provisioned and registered in the Cloud Voice phone list](/images/pbx/wildix-provisioned-pce.png)