Knowledgebase: Hosted PBX > Phones & Devices
Yealink Auto Provision Overrides
Posted by , Last modified by Erick Bruce on 29 September 2021 09:53 AM


How to configure Auto Provisioning Overrides for Yealink devices.

 

The RingLogix device auto provisioning system will configure the main line appearances and several of the features supported by most devices like BLF, speed dials, feature toggles, etc... 

However, some custom features or customer requirements may require settings not built into the auto provisioning system. To avoid having to manually update devices we support adding overrides to the provisioning files. Overrides can be added on the override section of the add/edit device modal.

Below we have provided a list of common overrides that can be added. 

*Please note that this list is provided as a courtesy and may differ slightly depending on the firmware version currently active on the device. Please refer to the manufacture’s documentation for more override examples and more detailed information on individual settings.

 

Some Important Notes

  • When programming the device, the values must be in quotation marks and there must be no spaces in the line. This is particularly important when exporting configs from an existing device.
  • When making configuration changes in the Web User Interface after obtaining the IP address of the device.
    • Use factory Username: admin
    • Use factory default password: admin
  • After entering the override codes, the device must be rebooted




Key Types for Overrides

Yealink devices contain 4 different types of keys that will require different settings contingent on which key used.
**Note: Replace ‘X’ with desired key

Line Key = Busy Lamp Field (BLF) next to screen

  • linekey.X.type=
  • linekey.X.line=
  • linekey.X.label=
  • linekey.X.value=
  • linekey.X.pickup_value=
  • linekey.X.xml_phonebook=

Memory Key = Physical key away from screen

  • memory.X.type=
  • memory.X.line=
  • memory.X.label=
  • memory.X.value=
  • memory.X.pickup_value=
  • memory.X.xml_phonebook=

Programmable Key = Physical buttons

  • programmablekey.X.type=
  • programmablekey.X.line=
  • programmablekey.X.label=
  • programmablekey.X.value=
  • programmablekey.X.pickup_value=
  • programmablekey.X.xml_phonebook=

Expansion Module Key = Keys positioned on side cars

  • expansion_module.X.type=
  • expansion_module.X.line=
  • expansion_module.X.label=
  • expansion_module.X.value=
  • expansion_module.X.pickup_value=
  • expansion_module.X.xml_phonebook=

 

Values for Key types 

#

Type

#

Type

#

Type

#

Type

0

N/A

8

SMS

16

BLF

34

Hot Desking

1

Conference

9

Call Pickup

17

URL

35

URL Record

2

Forward

10

Call Park

18

Group Listening

38

LDAP

3

Transfer

11

DTMF

22

XML Group

40

Prefix

4

Hold

12

Voicemail

23

Group Pickup

42

ACD

5

DND

13

Speed Dial

24

Multicast Paging

43

Local Group

6

Call Return

14

Intercom

25

Record

50

Keypad Lock

7

Call Return

15

Line

27

XML Browser

61

Favorite

 


Popular Overrides Examples

Customize Display

  • account.1.label=”Ringlogix”
  • account.1.display_name=”Ringlogix”               

Speed Dial on #4

  • linekey.4.type="13"
  • linekey.4.line="1"
  • linekey.4.label="Ringlogix"
  • linekey.4.value="3058008647"

Call Park on #5

  • linekey.5.type="10"
  • linekey.5.line="1"
  • linekey.5.label="Call Park"
  • linekey.5.value="701"

BLF on #5

  • linekey.2.type="16"
  • linekey.2.line="1"
  • linekey.2.label="Ringlogix"
  • linekey.2.value="101"

 


Distinctive Ring

This feature is used to differentiate ringtones based on departments. When a SIP INVITE is initiated the header is sent with the name corresponding to its’ department. The destination then knows which ringtone to play based on the Alert-Info header.

  • distinctive_ring_tones.alert_info.1.text=”Name
    • Name can be based on different departments
      • Ex. Internal, Sales, Support, Billing
  • distinctive_ring_tones.alert_info.1.ringer=”Number
    • Number is the ring type desired
    • Ex. Ring2.wav = 2



Dial Plans

To add dial rules or dial block rules, please see below.

**Note Be aware the first three dial now rules are used by the config file.

  • Dialplan.dialnow.rule.4 =”Enter#”
  • Dialplan.block_out.number.1=”Enter#”



Do Not Disturb

  • Features.dnd.on_code=”*78”
  • Features.dnd.off_code=”*79”



Disable Video
 

**Note: Only Available on certain devices (T49G/T58V)
             Video can cause issues on some phone's or carriers accepting the SIP Invite.
             To disable video you can use the following Override.
             You can also make video an option, by setting this to 2. The phone will prompt for audio or video when placing or receiving calls.

  • video.enable=”0”
  • video.enable=”2”



Installing Applications

**Note: Only Available on certain devices (T56/T58/CP960)

Autoprovisioning is the only way to install apps. Only install APKs if you know it is safe. You must host the file on a web server.

       App Permissions: If the trusted application does not fully function due to Android OS permissions.
                                    The default value for permissions is "standard". This override should be applied at the time of installation.                   

  • pm.check_permission="none"



Directed Call Pickup


For picking up incoming calls on specific extensions.

**Note: Replace ‘X’ with desired key

  • linekey.X.extension="*35"

 

Multicast Paging

1. Listen override allows devices to receive pages from other devices.

  • multicast.listen_address.1.ip_address=""
  • multicast.listen_address.1.label="page all"

 2. Linekey override allows device to send pages to other devices.

     **Note: Replace ‘X’ with desired key

  • linekey.X.type="24"
  • linekey.X.value=""
  • linekey.X.label="Page All"

 3. Receive priority prohibits interruption while a user is on the phone

  • multicast.receive_priority.priority="0"


Background Image

**Note: Only Available on certain devices. Must host image on own server.




Multiple Keys per Line

                **Note: Replace ‘X’ with desired key. Replace ‘Y’ with line desired to use.

  • linekey.X.line="Y"
  • linekey.X.type="15"
  • linekey.X.label="1000"



Headset Ringing

**Note: 0=speaker, 1=headset, 2=headset and speaker

  • work.features.ringer_device.is_use_headset="2"

Configure the Replace Rule (Used for Speed Dial)


**Notes: X ranges from 1 to 20.
                  Enabled: Enable or disable the replace rule. 0-Disabled, 1-Enabled;
                  Prefix: Specify the numbers that need replacing;
                  Replaced: Specify the alternate numbers;
                  LineID: Specify the line ID to apply the replace rule,multiple lines ID must be separated by a comma;

  • dialplan.item.X="Enabled,Prefix,Replaced,LineID"

    Example: 
    • dialplan.item.1="1,22,3059088080,1"

DSS Key Length

**Note: 0=Default, 1=Extended
  • features.config_dsskey_length="1"
This setting makes the labels next to line keys full length so that it is not cut off.

(4 vote(s))
Helpful
Not helpful

Comments (0)
Post a new comment
 
 
Full Name:
Email:
Comments:
CAPTCHA Verification 
 
Please enter the text you see in the image into the textbox below (we use this to prevent automated submissions).