Provisioning the Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P for 3CX
This guide shows you how to provision the Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P series of IP phones for use with 3CX Phone System and has been tested with the latest firmware versions supported by 3CX Phone System 14.0 and 12.5. Some phone models may only be available in the latest versions of the 3CX Phone System.
To learn how to provision other supported Yealink IP Phones, check out the Yealink T23P/G, T27P, T29G, T32G, T38G, T40P, T41P, T42G, T46G, T48G provisioning guide, the Yealink VP530 video phone guide, as well as the Yealink DECT W52P guide. If you prefer to provision your phone manually, take a look at Step 2B of this guide.
Please note that the Yealink T20P can’t integrate with the 3CX Phone Book functionality.
The easiest way to set up a Yealink phone for use with 3CX Phone System is to use the built-in plug and play provisioning functionality inside 3CX Phone System. By auto provisioning your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P your phone configures itself by retrieving a 3CX-generated phone configuration file. If you prefer configuring your phone using the DHCP and option 66, check out this DHCP Option 66 Configuration guide.
Step 1: Verify the Firmware on Your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P
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 IP Phone has installed. Simply power up the phone and click “Menu”, then the “Status” and see “Firmware:”. 3CX Phone System 14 & 12.5 users that have 3CX Maintenance Agreement can update their Yealink firmware directly by logging into the 3CX Management Console once the phone is provisioned. To do this, visit the Phones node and select your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P and click the “Upgrade Firmware” button.
Step 2A: Provisioning a Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P Phone Using Plug and Play
To begin Plug and Play provisioning plug your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P 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.
Now you’ll need to approve Yealink’s registration and assign an extension. It’s really easy to do. Simply follow the steps below:
- Click on the Phones node within the 3CX Management Console
- When you’ve plugged in your Yealink phone, you’ll see it appear at the top of the list in bold
- By right clicking on your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P, you’re given the option to select the following:
- Add Extension – this will create a new extension
- Assign to Existing Extension – this will assign an existing extension
- Now assign or create an extension and click OK
- You will be taken to the Edit Extension settings page
- To configure BLF function keys or speed dials in the ‘Phone Provisioning’ tab see the Optional Step at the end of this guide.
- Click OK.
3CX Phone System will send a provisioning link to your Yealink phone. Once your Yealink T19P, T20P, T21P/E2, T22P, T26P, T28P phone receives the link, a restart will be performed. The phone will reboot and apply the configuration and your phone will be ready to use.
Step 2B: Provisioning a Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P 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:
- Log in to your 3CX Management Console.
- Go to the extensions node and create or select the extension that you want to assign to your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P IP Phone.
- Click on the Phone provisioning tab and fill in your phone’s MAC Address. You can find the Mac Address of your Yealink T19P/E2, T20P, T21P/E2, 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).
- 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’.
- Press OK when you have selected your desired settings to save them.
- Click on the “System Status” tab and copy the “Provisioning URL” as that will be used in the next step. In Split-DNS installation only one URL will be displayed and can be used for both internal or external phones.
This procedure will create a provisioning file for your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P 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
- 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 10.172.0.197 and the External IP address of the server (or PC) where 3CX Phone System is installed ismybusiness.contoso.com
- Point your browser to the web interface of your Yealink IP phone, which in this example is http://10.172.0.197.
- Enter your phone’s login credentials – username and password is admin by default to log in to your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P IP Phone Web Interface.
- 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).
- Press the Autoprovision now button to have your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P 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 on Your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P IP Phone
Your Yealink phone has function keys that can be provisioned. This can be done in the 3CX Management Console from the BLF (Busy Lamp Field) tab in the extension settings. The T19P/E2, T20P, T21P/E2, T22P do not have any BLF buttons. The T26/T28 have the BLF buttons to the right side of the handset, the buttons to the right of the LCD screen are reserved for lines
- In the Edit Extension page, navigate to the BLF (Busy Lamp Field) tab
- Configure the function keys for BLF, Shared Parking and other various types of Speed Dials
- Click OK
Once you’ve clicked OK, your Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P will reboot and provision itself automatically. Congratulations! You have configured your new Yealink T19P/E2, T20P, T21P/E2, T22P, T26P, T28P phone using 3CX Phone System.