UC Office Manager Manual

UC Office Manager – Advanced Yealink Phone Programming

In most cases, we recommend using Yealink phones.  The UC platform allows programming of all Yealink functions.

Programming the DSS Keys

The ‘button builder’ easily allows configuration of the DSS programmable keys.  Each Key can programmed as:

Setting Description
Line Appearance A phone extension that allows the user to receive and make calls.  All phones should have at least one line.
BLF (Busy Lamp field) A BLF functions as a speeddial for an internal extension, and also shows if that extension is in use.  (Green LED when not in use, Red when busy)
Call park See call park
Timeframe Toggle This feature enables a user to manually override a time frame.  See Timeframe Override Toggle
Queue Toggle This feature enables the user to log in and out of the queues that they are a member of.  The light shows red when logged out and green when logged in.
Shared Line Appearance See ‘shared line appearance’
DTMF Not in use

For each key, there is a field for the value (for example extension), and the label that will appear on the phone next to the key.

Next to each key is the ‘more’ icon.  When programming BLF keys, this allows the remaining keys to be programmed using the directory.  When set to static, the keys will not change when the directory is updated.  In dynamic mode, the keys will be reprogrammed when the extensions in the directory have changed (after a reboot).

The key at the top right has the ‘Additional phone settings” option.


The Yealink phones have literally hundreds of settings that can change the appearance and functionality of the phone.  The overrides allow any setting to be included.  These have priority over and other settings, or defaults.

The full list of the programming variables for the Yealink phones can viewed here.

The format for these is

setting=”value”    (no spaces)

To remove the value of a setting, deleting the line from the override will not remove the setting.  Use the following:

setting=”%NULL%”    (no spaces)

Some common settings that may be included here:

Setting Common Options
Backlight
phone_setting.backlight_time="0"   (always on)
phone_setting.backlight_time="30" (stays on for 30 seconds)
Do Not Disturb Key
programablekey.3.type="0"    (DND key is hidden.  Avoids accidental use) 
programablekey.3.type="5"    (DND key is shown) 
DSS Transfer Type
transfer.dsskey_deal_type="1"   (DSS BLF keys are attended transfer)
transfer.dsskey_deal_type="2"      (DSS BLF keys are blind transfer)
Language
lang.gui="English"

lang.gui="French"
Timezone
local_time.time_zone="-5"     (Timezone offset from GMT)
Paging To allow the phone to receive pages, add:

multicast.listen_address.1.ip_address="224.5.6.20:10008"
multicast.listen_address.1.label="page all"
multicast.receive_priority.priority="0"
multicast.receive_priority.enable="0"

To program a key to page other phones (for example DSS key number 2):

linekey.2.type="24"
linekey.2.value="224.5.6.20:10008"
linekey.2.label="Page All"

It is also possible to add multiple paging groups, and specialist paging units.  Contact support for more information

Ringtones The ringer for internal calls can be set to ringer 1 as :

distinctive_ring_tones.alert_info.1.ringer="1" 

For external incoming  calls set to ringer 4:
account.1.ringtone.ring_type="Ring4.wav"
Click to hear the selection of ringtones 
Wifi Login For phones that have built in wifi, or accept a USB wifi dongle, the wifi can be preprogrammed.  Multiple wifi logins can be set up.  The following would setup the first wifi network. (Replace the ‘1’ for subsequent networks)

static.wifi.1.label="Your wifi name"
static.wifi.1.ssid="Your SSID"
static.wifi.1.security_mode="WPA2-PSK"
static.wifi.1.cipher_type="TKIP CCMP"
static.wifi.1.password="YourPassword"

Don’t forget, the first time you program the phone, it needs to either  be connected by manually setting up the wifi using the phone keyboard, or by plugging into a wired network to get the initial settings.

 

Firmware You can specify the firmware level required, and the phone will upgrade to that level if necessary.  Available Yealink firmware versions can be found here.

firmware.url="http://sipcfg.io/frm/yealink/vXX"

firmware.url.server_type="http"

[REPLACE vXX with the firmware version, example v86]

TLS TLS encryption is enabled by default.  There are a few older devices (pre V83 firmware) that do not support TLS.  You would need to disable TLS for these devices to register.

account.1.sip_server.1.transport_type="0"
Wallpaper For the Yealink T48, there are usually 2 wallpapers required.

The first is when the DSS keys are not expanded.  In this case, there is blankspace in the middle of the screen that can be used for a larger logo.

The second is when the DSS keys are expanded (by pressing the “+More” key).  Generally, the logo will make the keys hard to read.  The logo either needs to be moved to the bottom where there are no keys, or made to be less prominent.

Both logos are 800×480 px png files.  They will need to be uploaded to a server where they can be access by url.

There is a trick here:  Both logos can’t be uploaded and set in one reboot.

Step 1:  Add these 2 lines to the ‘additional phone settings’ (in this example, the file path is https://yourserver.com/ and filename is t48-main.png).  This will add the wallpaper for the main screen.

phone_setting.backgrounds="Config:t48-main.png"
wallpaper_upload.url="https://yourserver.com/t48-main.png"

Save and sync.  The main page wallpaper will now be active.

Step 2:  Remove the lines above from the ‘additional phone settings’  and replace with the lines below (the filename in the example is t48-main-keys.png).  This will add the wallpaper for the screen when the DSS keys are expanded.

phone_setting.backgrounds_with_dsskey_unfold="Config:t48-main-keys.png"
wallpaper_upload.url="https://yourserver.com/t48-main-keys.png"

Again, save and sync.  You may need to reboot the phone for the settings to work rather than just sync.  Both the wallpaper files will now be active.  Which one is used depends on the status of the DSS keys.

Saving Configuration

The ‘Save’ button has the options:

  • Save – Save, but do not push the settings to the phone
  • Save and resync – Pushes in new settings to the phone.  For this to work correctly, the phone needs to be already registered to the same extension.  If the phone is not registered, or the extension has changed, the phone will need to be manually rebooted to collect the new settings:
  • Save as template – There is a template button at the top that allows re-use of an existing template.