YEALINK NETWORK TECHNOLOGY CO.,LTD.

www.yealink.com

BLF issue

 Feature mechanism:

1. Feature Description:
BLF is used to monitor a specific user for status changes on IP phones. For example, you
can configure a BLF key on a supervisor’s phone to monitor the IP phone user status
(busy or idle). When the monitored user places a call, a busy indicator on the
supervisor’s phone indicates that the user’s phone is in use.
When the monitored user is idle, the supervisor can press the BLF key to dial out the
phone number. When the monitored user receives an incoming call, the supervisor can
press the BLF key to pick up the call directly. When the monitored user is in a call, the
supervisor can press the BLF key to interrupt and set up a conference call.
Note: BLF is not applicable to SIP-T19(P) E2 IP phones.

BLF Subscribe mechanism:

IP phones support BLF using a SUBSCRIBE/NOTIFY mechanism as specified in RFC 3265.
This feature depends on support from a SIP server.
When the IP phone is configured to monitor a specific user, it sends a SUBSCRIBE
message to the server. A NOTIFY message which includes XML in the message body is
sent to the IP phone to inform the current state of monitored user.
SIP message flow:

Trace:

1
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
Example of a SUBSCRIBE message:

Example of a NOTIFY message (<state>confirmed</state> shows the call has been

established):

Note: There can be four status in NOFITY:

‘Terminated’ means the monitored Extension is in idle.
‘Confirmed’ means the monitored Extension is on a call
‘Early’ means the monitored Extension is in ringing status
‘Proceeding’ means the monitored Extension is in ringing status

2. Related parameters for BLF feature:

a) features.blf_led_mode =
#It configures the BLF LED mode and provides four kinds of definition for the BLF/BLF list key LED status.
Permitted Value: 0(default value), 1, 2, 3 or 4.

2
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
Value=0:

Value=1

Value=2

Value=3

3
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com

Value=4

WEB: Features->General Information->BLF LED Mode

b) features.pickup.blf_visual_enable=
It enables or disables the IP phone to display a visual alert when the monitored user receives an incoming
call.
0-Disabled (default value)
1- Enabled
WEB: Features->Call Pickup->Visual Alert for BLF Pickup
c) features.pickup.blf_audio_enable=
It enables or disables the IP phone to play an audio alert when the monitored user receives an incoming call.
0-Disabled (default value)
1-Enabled
WEB: Features->Call Pickup->Audio Alert for BLF Pickup
d) features.blf_call_out_by_number.enable =
It enables or disables the IP phone to dial out the monitored phone number only when you press the BLF key
on the idle screen of the phone.
0-Disabled
1-Enabled (default value)
For example:
To use this feature, you need to configure a BLF key with the value set to sip:[email protected].
If it is set to 0 (Disable), the IP phone will dial out sip:[email protected] when you press the BLF key.
If it is set to 1 (Enable), the IP phone will dial out 101 when you press the BLF key.
WEB: No WEB option
e) features.blf_pickup_only_send_code=
It enables or disables the phone to only dial out feature access code of directed pick up when preforming BLF

4
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
pickup.
0-Disabled
1-Enabled ()
If it is set to 0 (Disabled), the phone will dial out feature access code of directed pick up plus monitored
number when performing BLF pickup.
If it is set to 1(Enabled), the phone will only dial out feature access code of directed pick up when preforming
BLF pickup.
WEB: No WEB option
f) account.X.blf.subscribe_period=
It configures the period (in seconds) of the BLF subscription for account X.
The IP phone is able to successfully refresh the SUBSCRIBE before expiration of the SUBSCRIBE dialog.
Permitted Value: Integer from 30 to 2147483647 (default value=1800)
g) account.X.blf.subscribe_event=
It configures the event of the BLF subscription for account X.
0-dialog (default value)
1- presence
h) account.X.out_dialog_blf_enable=
It enables or disables the IP phone to handle NOTIFY messages out of the BLF dialog for account X.
0-Disabled (default value)
1-Enabled
i) account.X.blf.match_host.enable=
It enables or disables host match feature for BLF/BLF list feature.
0-Disabled
1-Enabled
If it is set o 1 (Enabled), the IP phone can only recognize the NOTIFY message whose host field is the same as
the one in the SUBCRIBE message.

 Issue Description:
Issue1: BLF subscribe failed.
Issue2: BLF pick failed
Issue3: BLF light delay
Issue4: Need Visual/audio notification for BLF
Issue5: BLF list configuration:

 Resolution: （Checking list）

Issue1: BLF subscribe failed
1. Firstly, following below FAQ to make sure the configuration is correct:
http://support.yealink.com/faq/faqInfo?id=264
If all the configuration are correct, then get the trace and have below basic analysis:
2. Check if the phone send out SUBSCRIBE message. If not it’s the phone issue, please
contact Yealink FAE
3. Check if the server respond NOTIFY message, if not it’s the server issue, please contact

5
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
server side.
4. Check if the status in ‘NOTIFY’ message is correct. It can only be:
‘Terminated’/‘Confirmed’/‘Early’ /‘Proceeding’, E.g:

If the state content is not correct, it’s the server issue, please contact server side.
5. Kindly check with custom which event their PBX support, if they only support ‘presence’
event, please change the event type on the phone by auto provisioning:
account.X.blf.subscribe_event=
#It configures the event of the BLF subscription for account X.
0- dialog (default value)
1- presence (Some specific PBX will support, like Ericsson, Genband)
Then the phone will send SUBSCRIBE with ‘presence’ event instead of ‘dialog’ (default
event):

6. If above solutions won’t help, you should contact Yealink with following information
provided.
a) The detailed description of BLF issue: (Step by step to reproduce your issue)
b) Any other Models (brand) works fine in the same scenario with same account?
c) How often the issue occurred?
d) How many phones the customer have? And how many of them have the issue?
e) If you can provide us some test accounts, it will be helpful for us to reproduce your
issue and fix it ASAP.
f) Please kindly provide Syslog (must be Level6)/ Trace/ config.bin files. (For how to

6
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
get these three files, please refer to:
https://support.yealink.com/en/portal/knowledge/show?id=84b84b529641f28b84
3eb445 )
Note: Please make sure the trace is with completed SIP message, e.g.:

Syslog file is in Level6: if it have <6+info> means its Level 6 syslog:

g) If any trace from OK phone will be appreciated and help to fix the issue for you.
Issue2: BLF pick failed
Please follow below FAQ:

http://support.yealink.com/faq/faqInfo?id=176

http://support.yealink.com/faq/faqInfo?id=266
Issue3: BLF light delay:
Please follow below FAQ

http://support.yealink.com/faq/faqInfo?id=216
Issue4: Visual/audio notification for BLF
You can configure visual/audio notification for BFL through:
features.pickup.blf_visual_enable
#WEB path: Features->Call Pickup->Visual Alert for BLF Pickup
It enables or disables the IP phone to display a visual alert when the monitored user receives an incoming call.
0-Disabled （default value）
1-Enabled

features.pickup.blf_audio_enable =
WEB path: Features->Call Pickup->Audio Alert for BLF Pickup
#It enables or disables the IP phone to play an audio alert when the monitored user #receives an incoming
call.
#0-Disabled （默认值）
#1-Enabled
Issue 4. BLF list configuration:
7
 YEALINK NETWORK TECHNOLOGY CO.,LTD.
www.yealink.com
Please refer to “BLF list” guide on support.yealink.com.

 Products:
All

 Firmware version:
All