Skip to content

Advanced auto-provisioning settings

Last updated View as Markdown (opens in a new tab)

Ready-made Yealink configuration lines for extra accounts, BLF keys, phonebooks, ringtones and transfer behaviour.

When a Yealink phone is auto-provisioned, you can push extra settings to it from the PBX. This saves configuring each phone by hand, and the settings come back after a factory reset.

Where to enter settings

Section titled “Where to enter settings”
  1. Go to PBX › Devices and select the phone’s SIP device.
  2. Expand Yealink settings and type your lines in Advanced CFG configuration.
  3. Click Save, then Apply configuration.
  4. Restart the phone so it downloads the new settings.

Write one setting per line, as parameter = value. Replace everything in angle brackets, such as <label>, with your own value and remove the brackets.

Add a second SIP account to one phone

Section titled “Add a second SIP account to one phone”

Use this when one person handles two lines, for example two brands with different numbers. Each line shows separately on the phone, so the person can choose which caller ID to call out with.

  1. Create a second SIP device in PBX › Devices and add it to a user. It needs its own device licence.
  2. Open the second device and expand Yealink settings.
  3. Choose the same Yealink device model and enter the same Yealink MAC address as the first device.
  4. Click Save, then Apply configuration, and restart the phone.

The PBX puts every SIP device with the same MAC address on the phone as a separate account, with the right server, port and transport. For a third account, repeat with another SIP device.

BLF and speed dial keys

Section titled “BLF and speed dial keys”

A BLF key shows whether a colleague is free (green) or on a call (red), and calls them with one press. A speed dial key calls a saved number.

linekey.1.type = <16 for BLF, 13 for speed dial>
linekey.1.value = <internal number, or the phone number for speed dial>
linekey.1.label = <text shown next to the key>
linekey.1.line = 1
linekey.1.extension =

Change linekey.1 to the key you want to set. For a BLF key, use the user’s internal number from their User settings. To set keys by hand instead, see BLF and speed dial keys.

Make transfers blind instead of attended

Section titled “Make transfers blind instead of attended”

By default, an auto-provisioned phone uses an attended transfer: you talk to the colleague before handing the call over. Some teams prefer a blind transfer, which sends the call straight through.

transfer.tran_others_after_conf_enable = 0
transfer.dsskey_deal_type = 2
transfer.on_hook_trans_enable = 0
transfer.blind_tran_on_hook_enable = 1
transfer.semi_attend_tran_enable = 0

See Transfer calls on a Yealink phone for how each transfer type works.

Load a shared phonebook

Section titled “Load a shared phonebook”

Show a phonebook from the PBX in the phone’s Directory.

The first phonebook selected in the person’s User settings is added to the phone automatically. Use these lines only for extra phonebooks.

  1. In PBX › Phonebooks, open the phonebook, click URLs, then XML Yealink URL. Copy the web address that opens.
  2. Add these lines:
remote_phonebook.data.2.url = <XML Yealink URL>
remote_phonebook.data.2.name = <name shown on the phone>
features.remote_phonebook.enable = 1
features.remote_phonebook.flash_time = 3600
directory_setting.remote_phone_book.enable = 1

Start at data.2: the PBX uses data.1 for the user’s phonebook and overwrites it. For another phonebook, add a url and name pair with data.3, and so on. Desk phones work best with no more than 4 phonebooks. flash_time is how often the phone refreshes the phonebook, in seconds (3600 is hourly).

A different ringtone for some calls

Section titled “A different ringtone for some calls”

Use a distinctive ringtone so people know which number or menu option a call came from, or whether it’s internal.

  1. Add a Caller ID prefix object to the call path, and enter some text in Alert info, for example Line 1.
  2. Find the ringtone name in the phone’s web interface. Built-in tones have names such as Ring1.wav; the list differs by model.
  3. Add these lines to the phone’s SIP device:
distinctive_ring_tones.alert_info.1.text = <the Alert info text>
distinctive_ring_tones.alert_info.1.ringer = <ringtone, for example Ring8.wav>

If people call each other with BLF keys, point those keys at an Internal number that passes through the Caller ID prefix, so internal calls get the tone too.

Show the caller’s number on transferred and parked calls

Section titled “Show the caller’s number on transferred and parked calls”

By default, a transferred or parked call shows the colleague who transferred it. To show the original caller instead, add the line below for each account (account.1, account.2 and so on):

account.1.cid_source = 3

The value 3 is RPID-PAI-FROM. See Caller ID on transferred calls for the limits and the other step that’s needed.

Change NAT traversal

Section titled “Change NAT traversal”

Auto-provisioning turns NAT traversal (STUN) on for each account. If phones drop their registration behind your router, turning it off for the account can help:

account.1.nat.nat_traversal = 0

0 is off and 1 is on.

Hide “Q.850” error text on failed calls

Section titled “Hide “Q.850” error text on failed calls”
sip.call_fail_use_reason.enable = 0

See Yealink common issues.

Section titled “Custom wallpaper or logo”

See Logo and wallpaper for the file formats and the lines to add.

Find other settings

Section titled “Find other settings”

Yealink publishes an administrator guide for each model with every parameter you can set. On Yealink’s support site, choose your model and open the administrator guide that matches your firmware. Use the parameters from that guide in Advanced CFG configuration.

Section titled “Related”