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 

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.

• Install: app.install_url="http://webaddress/appname.apk"
• Uninstall: uninstall="appname.apk"

       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.

• phone_setting.backgrounds="Config:Filename"
• wallpaper_upload.url=http://yourdomain.com/ Filename

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"

**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"

• features.config_dsskey_length="1"