Provisioning the Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P for 3CX

This guide shows you how to provision the Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P series of IP phone for use with 3CX Phone System and has been tested with the latest firmware versions supported by 3CX Phone System 11 & 12.

An image showing the Yealink P series of phones, which includes Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P IP Phones

Check out the Yealink G Series provisioning guides for the following IP phones: Yealink T32G, Yealink T38G, Yealink T42G, Yealink T46G as well as the Yealink VP530 video phone.

Please note that the Yealink T20P can’t integrate with the 3CX Phone Book functionality.

The easiest way to set up the Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P IP phones for use with 3CX Phone System is to use the built-in plug and play provisioning functionality inside 3CX Phone System. This will allow the Yealink phone to automatically configure itself by retrieving a 3CX-generated phone configuration file. Alternatively you can configure your Yealink phone using the DHCP and option 66.  For more information on using this option, check out this configuration guide.

Step 1: Verify the Firmware on Your Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P

You’ll need to verify the firmware version that’s installed on your Yealink phone as older firmwares will not have the plug and play feature. It’s easy to check which firmware your Yealink P Series has installed. Simply turn on the phone and click on the Menu, then the Status and then click on Firmware. If you see that you don’t have the latest firmware installed on your Yealink phones, go to the Yealink Support site and download the latest firmware for your phone. 3CX Phone System 12 users that have 3CX Maintenance Agreement can update their Yealink firmware directly in 3CX Phone System 12 by logging into the 3CX Management Console. To do this, visit the Phones node and select your YealinkT19P, T20P, T21P, T22P, T26P, T28P, T41P  and click on the Upgrade Firmware button

Step 2A: Provisioning a Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P  Phone Using Plug and Play

To begin Plug and Play provisioning plug your Yealink IP phone into the same LAN subnet as the PBX and power it up. Make sure you’ve plugged your phone into the same LAN subnet as the machine that has 3CX installed on it (3CX Phone System must run on port 5060). If you are trying to provision an extension in a remote network (WAN) in a different subnet, or on a PBX whose default port is not 5060 please skip this step and see Step 2B.

Yealink PnP

Now you’ll need to approve Yealink’s registration and assign an extension. It’s really easy to do. Simply follow the 6 steps below:

  1. Log into the 3CX Management Console and go to the Phones” node
  2. Your Yealink IP phone will appear at the top of the list in bold, as long as you’ve plugged it into the same LAN where 3CX Phone System is sitting comfortably on
  3. Right click on your Yealink P series phone. You’re given the following two options:
    • “Add Extension” – this will create a new extension
    • “Assign to Existing Extension” – this will assign an existing extension
  4. Now assign or create an extension and click OK
  5. You’ll be taken to the “Edit Extension” settings page
  6. To configure BLF function keys or speed dials in the ‘Phone Provisioning’ tab see the Optional Step at the end of this guide.
  7. Click OK and your done

3CX Phone System will send a provisioning link to your Yealink P Series phone. Once the link has been sent, you’ll notice that your phone will reboot and apply the configuration. Once your phone has restarted itself, you’re ready to rock and roll away with your Yealink IP phone!

Step 2B: Provisioning a Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P Phone IP Phone Using a Provisioning Link

This method can be used to provision a Yealink  IP Phone which does not reside in the same LAN subnet as the 3CX Phone System (including Lan2Lan VPN), on a system which the 3CX Phone System Service is not running on SIP Port 5060 or the IP phone is a remote extension connected via WAN to the 3CX Phone System. This process can also be automated if your network features a DHCP Server with Option 66. If you are attempting to provision a remote extension you should also be familiar with the concepts and information in the Remote Extension Provisioning Guide. To provision an extension please follow the next steps:
  1. Log in to your 3CX Management Console.
  2. Go to the extensions node and create or select the extension that you want to assign to your Yealink T20P, T22P, T26P, T28P,T41 IP Phone.
  3. Click on the Phone provisioning tab and fill in your phone’s MAC Address. You can find the Mac Address of your Yealink T20P, T22P, T26P, T28P, by pressing the OK button on the phone  or by turning the phone over and looking at the MAC sticket on the back. Select  a Model from the drop down list  (according to which one you are configuring).
  4. Select your display language, and make sure that the ‘Select Provisioning Method’ is set to ‘Remote Extension (STUN)’ if you are provisioning an extension in a remote network or if you are provisioning an extension in another subnet select ‘Local Lan’.
  5. If you want to change your Codec Priority or configure BLFs please see the Optional Step at the end of this Guide. Press OK when you have selected your desired settings to save them.
  6. Click on the Settings tab and select the Phone Provisioning tab. Write down the External Provisioning URL (or the Internal one if you are provisioning an extension in a local subnet) as that will be used in the next step.

This procedure will create a provisioning file for your Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P IP Phone. The next step will be to instruct the phone to retrieve that file.

Getting your Remote Yealink IP Phone to Register with 3CX

  1. Start up your Yealink IP phone and identify its IP address. To find your phone’s IP address, simply press the OK key on the phone. In this example we’re going to assume that the IP address of your Yealink phone is and the External IP address of the server (or PC) where 3CX Phone System is installed is
  2. Point your browser to the web interface of your Yealink G series phone, which in this example is
  3. Enter your phone’s login credentials – username and password is admin by default to log in to yourYealink T19P, T20P, T21P, T22P, T26P, T28P, T41P IP Phone Web Interface.
  4. Click on the Settings tab and select the Auto Provision tab from the left menu. Paste the link that you copied in step 6 of Part 2B into the ‘Server URL’ field as shown above (note that in the above image only part of the Provisioning URL is shown due to the field length).
  5. Press the Autoprovision now button to have your Yealink T19P, T20P, T21P, T22P, T26P, T28P, T41P IP Phone retrieve the provisioning file from 3CX Phone System and apply it. Your Yealink phone will reboot and once it restarts your phone will be provisioned and connected to 3CX Phone System.

 Optional Step – Configure BLF Function Keys / Codec Priority on Your Yealink P Series IP Phone

If you want to configure the BLF function keys available on the Yealink T21P, T22P, T26P, T28P, T41P, check out the following steps:

  1. While in the Edit Extension page, navigate to the Phone Provisioning tab
  2. Select codec priority and phone LCD display language
  3. Select and configure BLF function keys, shared parking and various types of speed dials, which you can see outlined in red in the above screenshot
  4. Click OK.
  5. Your Yealink T21P, T22P, T26P, T28P, T41P will reboot and provision itself automatically

Important Note: if you use the EXP40 module with T4! you will need to start provisioning BLFs at position 14 and above for them to appear on the EXP40 module.  Also be aware that support for the EXP module has been added in 3CX Phone System 12 SP6.

Congratulations! You have configured your new Yealink T21P, T22P, T26P, T28P, T41P IP phone using the 3CX.

Supported IP Phones

Preferred / Recommended