Auto Provision Function Keys for Phones

Function keys allow extension users to monitor status of specific objects or quickly perform specific operations from Linkus or IP phone. This topic describes how to provision function keys for extension users' IP phones.

Supported key types

The following table lists the function keys that you can assign for an extension user:


Key type	Function
N/A	No functionality.
Line	Configure line keys.
BLF	Extension Monitor the call status of a specific extension. Monitor the DND (Do Not Disturb) presence of a specific extension. Place a call to the monitored extension. Pick up calls ringing on the monitored extension. Trunk Monitor the status of a specific trunk. Place an outbound call through the monitored trunk. Queue Monitor specific pause status of a queue agent. For more information, see Auto Provision a function key for an IP phone.
Speed Dial	Place a call to the most commonly dialed numbers or extensions.
Check Voicemail	Monitor the status of voicemail. Check voicemail messages.
Check Group Voicemail	Monitor the status of group voicemail in shared mode. Check group voicemail messages.
Park & Retrieve	Monitor the status of a specific parking number. Park a call on a specific parking number. Retrieve a parked call from a specific parking number.
Intercom	Place an intercom call to the monitored extension to make an announcement.
DTMF	Send DTMF signals directly instead of manually entering the numbers each time.
Agent Login/Logout	Monitor login status in a specific queue. Log in to or log out of a specific queue.
Agent Pause/Unpause	Monitor service status in a specific queue. Pause or unpause receiving a call from a specific queue.
LDAP Directory	Quickly access the LDAP phonebook to query contact information. Note: This key type is only available for IP phone.
Boss-Secretary Feature	For boss extensions: Monitor Secretary's Call Status. For secretary extensions: Monitor Boss's Call Status.
Call Forward	Quickly enable or disable call forwarding. Note: The key type is only available for IP phone. For more information, see Forward All Incoming Calls to Another Destination by BLF Key.
Action URL	Quickly send an HTTP GET request to a specified URL for reporting specific events. Note: The key type is only available for IP phone.

Note: If your desired function keys are not listed in the supported key types, you can create a custom Auto Provisioning template and apply the template to a provisioned IP phone.

Prerequisites

You have connected the IP phone to the PBX and associate it with an extension via auto provisioning. For more information about the configuration, see Auto Provision IP Phones.

Auto Provision a function key for an IP phone

This section use the BLF function key as an example to show how to auto provision a specific function key to an IP phone.

Set up function key.
1. Log in to PBX web portal, go to Auto Provisioning > Phones.
2. Click beside the desired phone.
  You are redirected to the setting page of the extension associated with the phone.
3. Click the Function keys tab, then configure a BLF key according to your needs.
  Monitor extension status by BLF key
  Configure a BLF key to monitor a specific extension’s status in real time, make calls to it, or pick up its incoming calls with a single press.
  
  Type: Select BLF.
  
  Value: In the drop-down list, select an extension to monitor.
  
  Label: Optional. Enter a value, which will be displayed on the phone screen.
  Monitor trunk status by BLF key
  Configure a BLF key to monitor a specific trunk's status in real time, and seize the trunk to make outbound calls with a single press.
  Note: To seize a trunk to call out by BLF key, make sure the extension has the permission to use the monitored trunk for outbound calls.
  
  Type: Select BLF.
  
  Value: Enter the name of the trunk to be monitored.
  
  Label: Optional. Enter a value, which will be displayed on the phone screen.
  Monitor agent status by BLF key
  Configure a BLF key to monitor specific pause status of a queue agent.
  
  Note: Before you set up, you need to obtain the following feature codes:
  
  Pause feature code (Path: Call Features > Feature Code > Queue > Pause/Unpause)
  
  Pause Reason feature code (Path: Call Features > Feature Code > Pause Reason)
  
  Type: Select BLF key.
  
  Value: Enter the feature codes.
  The format should be Pause feature code + extension number + * + queue number + pause reason feature code. For example, *071001*6400*01.
  
  Label: Optional. Enter a value, which will be displayed on the phone screen.
4. Click Save.

Reprovision IP phones with the extensions registered.

Go to Auto Provisioning > Phones.
Click beside the phone.

In the pop-up window, click OK.

The phone automatically applies the change, and the BLF key shows the real-time status of the monitored item.


Scenario	BLF LED
Monitor extension status by BLF key	Solid Green: The extension is being monitored, and the status is idle. Solid Red: The extension is sending a call or is in a call; or the extension presence is DND (Do Not Disturb). Note: For Fanvil IP phones that support differentiated DND status indication, the DND status is indicated by a Solid Yellow LED light. Flashing Red: The extension is ringing. LED off: The extension is not registered, or the extension has been deleted from the PBX system. Note: You can press the BLF key on the phone to achieve the followings: Place a call to the monitored extension. Pick up the monitored extension's incoming calls if the corresponding feature code is enabled on Call Features > Feature Code > Call Pickup > Extension Pickup.
Monitor trunk status by BLF key	Solid Green: The trunk is being monitored, and the status is idle. Solid Red: The trunk is busy. LED off: The BLF key configuration failed. Note: You can press the BLF key to seize the trunk, then dial a number after a dial tone to call out.
Monitor agent status by BLF key	Solid Green: The monitored agent is NOT in the specified pause status. Flashing Red: The agent is in the specified pause status. LED off: The BLF key configuration failed.

Auto Provision function keys for phones in bulk using a function key template

If you are managing many IP phones and want to simplify configuration while ensuring consistency across all phones, you can auto provision function keys in bulk using a function key template.

Add a function keys template.
1. Log in to PBX web portal, go to Extension and Trunk > Extension.
2. Click Function Keys Template.
3. Click Add to add a function key template, then configure the following settings.
  
  Note: The number of programmable keys varies by phone models. If the number of function keys you assign to an extension exceeds the number of programmable keys, the excess function keys cannot take effect. However, if the user's IP phone is connected with an expansion module, the excess function keys are automatically applied to the expansion module.
  1. In the Name field, enter a name to help you identify the template.
  2. Optional: In the Remark field, enter a short description about the template.
  3. In the function keys list, configure function keys according to your needs.
    - Type: Select a key type.
    - Value: Configure a desired value based on the key type.
    - Label: Optional. Enter a value to help extension users identify the function key.
  4. Click Save.
    The function key template is created and displayed on the list.
4. Click OK.
Apply the function keys template to extensions.
1. On the extension list, select the checkboxes of the desired extensions, then click Edit.
2. Under Function Keys tab, select the checkbox of Bulk Edit, then click Apply Function Keys Template.
3. In the pop-up window, select the function keys template, then click Apply.
4. Click Save.
Reprovision IP phones with the extensions registered.
1. Go to Auto Provisioning > Phones.
2. Select the checkboxes of the desired phones, then click Reprovision.
3. In the pop-up window, click OK.
  The phones automatically apply the changes. Check the function key status on the phones to see if the changes are applied.