The auto-provisioning configuration depends on the IP phone model. IP phones must support the shared line appearance feature.

Let’s consider Yealink W80B as an example in this instruction. It’s an office phone system with base stations and wireless handsets. Say the phone number 12065558966 should be configured as a shared line on 10 handsets.

Preparation for IP phone models available via the Add-on Mart

Link copied to clipboard
For IP phone models that are available for auto-provisioning out-of-the-box, skip this preparation and proceed directly to step 1.

If the IP phone model is available via the Add-on Mart (like Yealink W80B), you need to:

  1. Start a free trial/paid subscription for the corresponding Add-on Mart module
  2. Check whether your system should be granted access to Add-on Mart services
  3. Enable external CPE provisioning on the Configuration server web interface. For this, set the ExternalCpeProvisioningService.Enabled option to Yes.

    Set the ExternalCpeProvisioningService.Enabled option to Yes

Step 1. Configure IP phones for auto-provisioning

Link copied to clipboard
Refer to the IP phone documentation for details.

To prepare Yealink W80B base stations for auto-provisioning:

  1. One base station should be manually set as DECT (Digital Enhanced Cordless Telecommunications) Manager and use a static IP address (e.g., DECT Manager IP is 192.168.2.203).

    Base station set as a DECT Manager

  2. Other stations (in the “Base” mode) should use the DECT Manager IP address.

    DECT Manager IP address

Step 2. Create a CPE profile and configure generic parameters

Link copied to clipboard

Customer Premises Equipment (CPE) profile allows you to apply general configuration settings to all IP phones that have this assigned profile . When an IP phone connects to the internet, it retrieves its specific configuration file with the configuration settings from the provisioning server.

2.1 Create a new CPE profile:

  1. Go to Infrastructure > Phones/CPEs > CPE profiles
  2. Click Add

    Add a CPE profile

  3. Fill in the details:
    • Name – specify a short descriptive name for this profile
    • Device model – select the model of the IP phones, e.g., Yealink W80B
    • Managed by – if you plan to use this profile for a specific reseller’s customers, choose the reseller from the dropdown list; otherwise leave this as Administrator only.
      If you choose Administrator only, later on you can make this CPE profile available not only to the administrator but also to all resellers. For this, open the created CPE profile and turn on the Shared with resellers toggle.
  4. Effective from – select Immediately.

2.2 Configure generic profile parameters.

To configure CPE profile for Yealink W80B:

  1. Open CPE profile
  2. Go to Status > Base mode and fill in the details:
  3. Go to Handset & account > SIP server template > SIP server 1 settings and specify the SIP server IP address and port.

    CPE profile > SIP server 1 settings

  4. For each handset, go to Handset & account > Account > Handset Registration and fill in the details:
    • Start register handset – select Enabled
    • IPUI – specify the International Portable User Identity (IPUI) code of a specific handset

      CPE profile > Handset Registration

      For example, if you need to configure 10 handsets, repeat this step for Account 1-10.

To not set up all IP phone options in the CPE profile and use default ones, enable partial CPE profile configuration on the Configuration server web interface by setting the UA_Profiles.AllowPartialProfileConfiguration option to Yes.

Step 3. Configure shared line appearance in the CPE profile

Link copied to clipboard

To configure shared line appearance for a Yealink W80B handset:

  1. Go to Handset & account > Account > Advanced settings and select Shared Call Appearance in the Shared line field.

    Handset & account > Account > Advanced settings

  2. Go to Handset & account > Account > Basic settings and fill in the details:
    • Line active – select Enabled
    • Display name – specify a display name, e.g., phone number, which will be displayed on the other phones receiving calls from this user.
    • Register name – specify $id (this is a dynamic variable that will be automatically replaced by the account ID – phone number)
    • User name – specify $id\_1 for account 1, $id\_2 for account 2, and so on for each account (handset). For example, if the account id (phone number) is 16045558921, $id\_1 will be replaced by 16045558921_1.
    • Password – specify the password used to authenticate all calls made using this account
    • SIP server template – specify “1” (as we configured “SIP server 1 settings” at step 2.2.c)
    • Media transmit enabled – select Enabled

    Handset & account > Account > Basic settings

Step 4. Create IP phone entry in the CPE inventory

Link copied to clipboard

You can upload IP phones to the CPE inventory from a file.

To add an IP phone entry manually:

  1. Go to Infrastructure > Inventory > Phones/CPEs.
  2. On the CPEs Inventory panel, select Phones/CPEs list. On the Create CPE panel that opens, specify the basic CPE device information:
    • Device ID – type a unique ID for the IP phone.
    • Device model – select Yealink W80B from the dropdown list.
    • MAC address – type the hardware ID of the IP phone (typically printed on the back of the device), 6 hexadecimal numbers, separated by colons. Make sure you enter the full value of the MAC address, including the colons.
    • Managed by – select Administrator only from the drop-down list.
    • CPE profile – select the IP device profile you created at step 2.
  3. Click Save.

Step 5. Assign the IP phone to the account for auto-provisioning

Link copied to clipboard

Assign the IP phone created at step 4 to the PortaBilling account.

Since Yealink W80B is an office system where all handsets use the same IP address, assign Yealink W80B multiple times with different ports corresponding to each handset. In case you are setting up shared line appearance for regular IP phones, make sure to assign each IP phone with a shared line to the same account.


Account auto-provisioning

Step 6. Initiate auto-provisioning on the IP phone user web interface

Link copied to clipboard

To initiate auto-provisioning:

  1. Go to the Yealink W80B admin web interface > Auto Provision
  2. Specify the provisioning server URL as follows: [hostname or IP address of your PortaBilling web server]/[environment_id]. For example, http://192.168.196.97/3
  3. Click Confirm

Yealink W80B admin web interface > Auto Provision

On this page

Release
What's new
Admin manuals
Handbooks
Developers documentation
UI help