Difference between revisions of "Yealink"

From IPitomy Wiki
Jump to navigation Jump to search
Line 95: Line 95:
[[File:Directory button.jpg|left|frame]]
[[File:Directory button.jpg|left|frame]]

Revision as of 15:29, 15 February 2022

Beginning in PBX software version 5.2.1-10, we have begun including more integrated support for Yealink phones. They can now be found via autodiscovery and assigned to extensions, although they do not currently respond to configure or restart commands. Yealink phones CAN autoprovision from the pbx once assigned, however, by either logging into each phone's webGUI, or using our quick setup utility. The quick setup utility can be downloaded here Yealink Quick Setup utility

Auto Provisioning a Yealink Phone

PBX ver 6.0.5 or later method

Starting in version 6.0.5, we have added the ability to configure and restart Yealink phones from the autodiscovery section of the pbx, eliminating much of the process previously needed to set these phones up.

1) Under Destinations=>Autodiscovery, after scanning the network, go to the commands tab and click the Yealink Detect link:

File:Yealink detect.JPG

2) Press the Start button

File:Yealink detect 2.JPG

3) In the list of phones discovered, you can now check the boxes, and assign, configure, and restart them as if they were IPitomy HD phones, using the buttons at the top of the page.

Important notes: 

This only works for FACTORY DEFAULTED Yealink phones.  Phones that have been previously provisioned will NOT respond to configure or restart commands from this process.

The Yealink discovery function will run for about 10 minutes before shutting itself back off.  You can restart it by going to the commands tab and hitting start, if it has stopped.  If it is running, it will say "Listening" on that page.

PBX ver 5.2 method

You must assign a phone to an extension either manually or using Auto-Discovery:

Manual – Navigate to Destinations -> Extensions -> Edit Extension -> Advanced and enter the MAC address of the phone into the “Phone MAC:” field.  SAVE CHANGES then APPLY CHANGES.


Auto Discovery - If the phones are on the same LAN as the PBX you can use Auto Discovery. Navigate to Destinations -> Extensions. Click the “Auto-Discovery” tab at the top, and then click “Auto-Discovery (scan network)”


Once the scan has completed:

1. Select the extension you would like to assign to the Yealink phone(s) from the drop down list.

2. Check the box next to each Yealink phone you are assigning.

3. Click the Assign button.

AD Assign.jpg

This will automate the process of entering the Yealink phone’s MAC address into each extensions Phone MAC field in it’s advanced settings section.

►Yealink phones shown in the Auto Discovery section will not show up colored green even though they may well be assigned and using the PBX.  The coloring is merely cosmetic and will not affect the operation of the phone.

Once the phones are assigned to extensions they can now be provisioned, either manually or if the phones are on the same LAN as the PBX the Quick Setup utility can be used.

  • Log into the GUI interface of phone via its IP Address (user: admin/pass:admin)
  • Navigate to Settings=>Auto Provision
  • If the phone is local: Set Server URL to
    TFTP://<IP address of pbx>/
  • If the phone is remote: Set server URL to
    http://<public IP address of pbx>/ippbx/phonecfg/
  • If the phone is remote: Set the username to admin, and the password to (Password is found under PBX Setup > Phone Global > Phone HTTP Download)
  • Click Confirm at the bottom of the page
  • Click Auto Provision Now

The phone's screen should change to indicate that it is updating its config, and will then register if successful.

NOTE: All Yealink conference phones can use the CP860 phone type for provisioning

NOTE: You can use the Yealink Generic phone type for provisioning a single extension to Yealink DECT Wireless phones W52P & W56P, additional extensions must be manually added.

Quick Setup Guide

Use this in conjunction with the quick setup utility

http://admin:1234@<public IP of PBX>/ippbx/phonecfg

Additional programming tips:

Updating the Directory Button

  • You can update the Directory button on the phone so it will use the Remote Phonebook from the pbx.
  • Program the Programmable Softkey 2 to XML Phonebook and label it Directory
  • Make sure you have the URL for the Remote Phonebook for the pbx the phone is registered to. Here it is a cloud instance which requires the username and password for HTTP Download which is found under PBX Setup > Phone Global > Phone HTTP Download. example: http://admin:JH5BmmyhqT3ZKk3N@c0060.ec2.ipitomy.com/ippbx/phonecfg//RemotePhonebook.xml
  • You can name the Display Name whatever you want.
Directory button.jpg


  • When configuring the Park key manually, set the type to DTMF, and the value to ##700#.
  • When configuring a Record key manually, set the type to DTMF, and the value to *#
  • When configuring the Day/Night key manually, set the type to BLF and the value to ff.
  • Under the DSS key tab is a link for Line Keys. Be sure to set the Line Keys to Account 1 if you want them to function as a line key, otherwise you can configure them just like any other programmable key.
  • Yealink Phones - Blind BLF transfers to voicemail
    Use a prefix key on the Yealink phones to handle blind transfers directly to a BLF extensions voicemail.
    Key Type: Prefix     Label: VM Xfer     Value: *
    While on the call press: TRANSFER -> VM Xfer -> BLF of the extension -> TRANSFER
  • EXP20 Expansion module for Yealink T2 Series phones - Key #1 AND Key #21 must be left blank in order for the Page Switch to work properly.

To Remove/Disable the DND Softkey on Yealink Phones:

Add this line:  features.dnd.allow = 0

to the Yealink Phone Configuration Template found in PBX Setup -> Phone Global. (add the line to the "Options found in the MAC config" section) Save and Apply settings then reboot the phones.

NOTE: Yealink T27 models the DND Softkey remains visible on the phone, but it is disabled so pressing it will not activate DND mode.


To set up multicast on your Yealink phone:

  • Log into the GUI interface of phone via its IP Address (user: admin/pass:admin)
  • Navigate to Contacts=>MulticastIP
  • Populate the Listening Address field with the mutlicast IP of the multicast group built in the PBX, followed by a colon and the port configured for the group.
    • eg.
  • Populate the Label field with a name that will display on the LCD when paged by the multicast group
  • Click the Confirm key and your settings will be saved, allowing the phone to receive multicast pages.

A dealer has brought to our attention this link to a Yealink forum that has a firmware for multicast. I know in our testing, the .143 version had the settings needed. But its possible you may need this version as that is what the dealer needed, so we are linking to the information.



Yealink phones do play a tone when they receive a unicast page, it is tied into the ringer volume, so if it is set too low it is very difficult to hear. There is currently no way to use another tone for this, but we can tweak the tone that does play a little bit so that it can be better heard. Log into the phones web interface, click the "Settings" tab at the top, and then select "Tones" from the menu on the left.

The "Auto Answer" tone is what plays when the phone receives a unicast page.  We can adjust the frequency of that tone to be a little bit more noticable then the default.  We recommend setting the Auto Answer field to:


then click "Confirm" to save.

Yealink Tones1.jpg

Enable and Configure User Access Levels

Here is what you need to do to implement User Access Levels on Yealink phones. Add the following lines (colored green) to the Common Config section of the Yealink Phone Configuration Template found in PBX Setup -> Phone Global:

To enable user access levels add this line:

static.security.var_enable = 1

Set default user access level to user:

static.security.default_access_level = 0

URL path for WebItemsLevel.cfg replace IP with what the PBX is set to:

static.web_item_level.url = tftp://

Set passwords change newpassword for each login level:

static.security.user_name.admin = admin

static.security.user_password = admin:newpassword

static.security.user_name.var = var

static.security.user_password = var:newpassword

static.security.user_name.user = user

static.security.user_password = user:newpassword

Upload the WebItemsLevel.cfg file to the TFTP Files section found in PBX Setup -> Services this is the file that sets level access to every option and setting on the Yealink phones. I already set this one to lock out every setting that could alter the phones operation using the phone menu in any way, however feel free to edit it as needed.

Turning on the user access levels activates a third login "var" we recommend to just set the password for var to be the same as the admin password.

Also when we set the default user level to "user", pressing and holding the OK button for 5 seconds to return the phone to factory defaults will no longer work since that is an admin level function.

Save and Apply Changes, then reboot the phones to download the new configuration.

Here is the WebItemsLevel.cfg file (you will need to un-zip it first)

FILE LINK: WebItemsLevel.zip

The numbers after each line entry define the user level needed to access that particular setting/feature.

The settings that relate to accessing settings/features by using the Menu in the phone are found under the [GUI] section.

0 = User

1 = Var

2 = Admin

Remote Phonebook files

Yealink phones use a specific XML format for remote phonebook files.

Here is an example, red text can be changed:

<?xml version="1.0" encoding="UTF-8"?>

      <Name>Spanky McFarland</Name>


      <Name>Alfalfa Switzer</Name>


save the file with .xml extension

Enhanced DSS Keys

In Yealink V81 and greater firmware version, the phones support a feature called EDK (Enhanced DSS Keys) that can be used to program advanced dial strings.

1.      Modify the Yealink Global Template under PBX Setup -> Phone Global.  Enable EDK feature via auto provision by entering the parameter as below:


Be sure to save and Apply Changes, then reboot the phone.

Now there will be a "Custom" key type added to the phone istelf. Log into the phone and set a key to "Custom" and the set the value by using the EDK commands:


  • Hang up (hu)
  • hold (h)
  • waitconnect (wc)
  • pause <number of seconds> (p <num sec>) where the maximum value is 10
     Example: 4411$Cwc$$Cp10$ defines dialing 4411>>waitconnect>>connected and lasts 10 seconds

  • invite
  • dtmf
  • refer

     Example: *338$Tdtmf$ defines sending the *338 by the type of dtmf

To program a custom key to dial VM pause a moment and then enter the VM PIN 4321:


Agent Log IN / Log OUT using a custom key:

Log IN example using agent number 444 and password 777:


Log OUT example:


Hot Desking

Yealink phones support hot desking via DSS key. At the moment, this has to be programmed directly on the yealink phone itself. In a future release we will have a key option on the pbx for autoprovisioning.

File:Dss key.JPG

Pressing this button on the phone will bring up an on-screen prompt asking for the new extension and SIP password (found on destinations->extensions, target extension number, and under the advanced section).

Entering the new extension information will keep your current sip server address (usually the pbx or cloud instance), and all of your current DSS keys, but will use the new extension number.  Use the button again to change back to the previous extension as needed.

NOTE: Be sure to avoid having 2 phones programmed with the same extension at the same time, as they will conflict over the registration.  It's best to have specially designated "floating" extensions for phones that are expected to be used with hot desking.

As a general tip, it may be advised, as an ease of use for the end user, to change the SIP password to something easier to type on the phones being used, such as an all-numeric password.  If you do this, be sure you are also increasing pbx security to compensate, either via log watch & ban, or sip ACL rules, as making the password easier will also make it easier to guess for malicious outside attackers.


  • T38G firmware version fixes an issue with Parked calls bonding with other calls incorrectly.  Extract the .rom from the Zip folder and load it into the phone.


Yealink Documentation

The T29 guide covers basic usage of the entire T2 series of Yealink phones.  The T48 guide covers basic usage of the entire T4 series of Yealink phones.

File:Yealink SIP-T29G Quick Start Guide V82 20.pdf

File:Yealink SIP-T48S Quick Start Guide V82 20.pdf

Yealink Power Usage

Yealink PoE.jpg

Yealink Tips, Tricks and Useful Info

Webgui login credentials

The factory default login and password combo is admin/admin On PBX software version 6.0.5 or later on a provisioned phone, the login is admin and the password is IPitomy956

Transfer/Park tips

When transferring or parking a call, the "End Call" softkey does NOT complete the operation. It cancels it. In this case, it leaves the call on hold instead of moving it where it was intended to go. Complete the transfer with the "Transfer" softkey instead.

Blind Transfer, Attended Transfer, Semi-Attended Transfer

Yealink xfers.jpg

Transferring a call to an outside number

On a Yealink phone, a DSS key can be created to transfer a call to a specific outside number. You can use the DTMF Key Type (Transfer key type is going to be available in a future release) and either a system speed dial, or an arbitrary number, as follows:

Key Type: DTMF Value: ##number# (this does a blind transfer to whatever number you set for it, such as one of the 2 digit system speed dials, or a full 10 or 11 digit number, as required by your provider) Label: An on screen label for this key

This is useful if you frequently transfer calls to the same number. System speed dials can be found under PBX Setup=>Feature Codes, at the bottom of the page.