How to Assign Cisco IP Phone Line Keys to Voice Office Shortcuts with the Application Gateway

Summary

This article describes how to assign Voice Office functions to IP phone line keys.

Background

You can configure IP phone line keys so that users of Cisco IP phones with multiple line keys (such as 7940/41, 7960/61, and 7970/71) can access a Voice Office application or page a particular zone by pressing a line key
You associate a URL with a line key through the Cisco CallManager Administration interface, as described in the “Configuring a Phone Button in Cisco CallManager for Multiple Phones” section of the Application Gateway Administration Guide
You can also include these URLs on an XML page

Procedure

The following table lists the URLs associated with various Voice Office functions.

Note: When using these URLs, replace <ag_ip> with the Application Gateway IP address.

URLs that reference a directory or zone number must be copied from the Administration Tool as described in the following procedure:

In the Application Gateway Administration Tool, go to Operation > Voice Office.
To find and copy the URL for a directory:
Click the Directory tab.
Choose a directory number from Configure Source. The directory name appears in the Directory Title field.
Right-click the link labeled Copy URL.
Click Copy Shortcut (in Internet Explorer) or Copy Link Location (in Firefox). The copied link is what you paste into Cisco CallManager.
To find and copy the URL for a zone:
Click the Paging tab.
Beside the zone name, right-click the link labeled Copy URL.
Click Copy Shortcut (in Internet Explorer) or Copy Link Location (in Firefox). The copied link is what you will paste into Cisco CallManager.

Configuring a phone button in Cisco CallManager for multiple phones:

Use the Cisco CallManager Administration interface to add a service and associate that service with a line or speed dial key on all phones that use a particular phone button template. Use the following procedure:

Edit or add a phone button template.
Add an IP phone service.
Subscribe each phone to the service.
Apply the template to the phone.
Add the Service URL to the phone.

To assign a Service URL to a phone button template:

In the Cisco CallManager Administration interface, go to Device > Device Settings > Phone Button Template.
Select the phone button template that you want to configure. If the template is read-only, you must edit a copy of the button template. Each Device Pool is associated with a phone button template. You might need to refer to the Device Pool settings to determine which phone button templates require changes.
On the Phone Button Configuration page, enable one or more keys as a Service URL and specify a label for the key.
Enter a name for the template.
Select Service URL for the line keys or speed dial keys that you want to use.
Click Insert and then click Update.
If the template is already used by devices, click Restart Devices.

To add a service:

In the Cisco CallManager Administration interface, go to Feature > Cisco IP Phones Services.
Click Add a New IP Phone Service and enter a name for the service.
Enter a URL from the table above as the Service URL.
Click Insert and then click Update Subscriptions.

To subscribe the phones to the phone service:

Use the Cisco Bulk Administration Tool (BAT) to subscribe the phones to the newly created services.
Go to Configure > Phones.
Click Update Phones and click Next.
Change the query as needed.
Enter the Service URL. You can enter two URLs at a time.
Click Update and then click OK.

To choose the button template that a phone should use:

In the Cisco CallManager Administration interface, go to Device > Phone.
Select the phone to configure.
Under Phone Button Template Information, select phone button template that the phone is to use.
Click Update and then click Reset Phone.

Note: If you use auto-registration, you can associate a phone button template with a device type as follows:

Go to System > Device Defaults.
For each device type that you want to change, select the phone button template name from the Phone Template menu across from the device type name and click Update.
Restart the phones.

To add a Service URL button to an IP phone:

In the Cisco CallManager Administration interface, go to Device > Phone and search for the phone.
Select the phones and then click Subscribe/Unsubscribe Services.
From the Select a Service menu, choose the service created for accessing a Voice Office application.
Click Continue and then click Subscribe and Update.
Close the window.
Click Add/Update Service URL Buttons.
Select the URL service from Button Service menu and specify a label for it.
Click Update and Close and then click Reset Phone.