Table Of Contents
Cisco Unified Communications Manager Integration Methods (For Cisco Unified CM Versions 4.x and 5.x)
Integrating with Cisco Unified Communications Manager Version 4.x
TIMG Configuration
PIMG Configuration
Integrating with Cisco Unified Communications Manager Version 5.x
Cisco Unified Communications Manager Integration Methods (For Cisco Unified CM Versions 4.x and 5.x)
This chapter describes the steps required to integrate Speech Connect with Cisco Unified Communications Manager (CM) (formerly known as Cisco Unified CallManager), versions 4.x and 5.x.
See the following sections:
•
Integrating with Cisco Unified Communications Manager Version 4.x
•
Integrating with Cisco Unified Communications Manager Version 5.x
Integrating with Cisco Unified Communications Manager Version 4.x
This section describes the telephony integration of Speech Connect with Cisco Unified Communications Manager version 4.x, including support for blind call transfers. For Cisco Unified CM version 4.x, which does not support SIP supplementary services, an intermediary gateway is required for integration to the Speech Connect server. The two supported methods of integration are:
•
TIMG Configuration
•
PIMG Configuration
TIMG Configuration
Description
Figure 10-1 shows an example of a TIMG integration.
Figure 10-1 TIMG Integration
In this example, Speech Connect communicates with a TIMG telephony gateway by using SIP. The telephony gateway is integrated to Cisco Unified CM by using a T1 PRI running the QSIG protocol for supplementary services, including blind transfers. QSIG path replacement is used to eliminate call hair-pinning across the T1. Call party information is transmitted across the T1 via QSIG signaling.
Components
The following components are used in the TIMG configuration:
•
Cisco Unified CM version 4.2
•
Cisco 2811 ISR with a VWIC-1MFT-T1
•
Dialogic Media Gateway DMG2030DTI (TIMG300DTI)
•
Cisco Speech Connect
Procedures
Do the following procedures in the order presented to integrate Speech Connect with Cisco Unified CM version 4.x:
•
To Configure Cisco Unified Communications Manager and the Voice Gateway for MGCP Digital T1 Integration
•
To Configure the Dialogic Media Gateway
•
To Configure the Telephony Settings on the Dialogic Gateway
To Configure Cisco Unified Communications Manager and the Voice Gateway for MGCP Digital T1 Integration
Step 1
Complete the steps outlined in the "How to Configure MGCP with Digital PRI and Cisco CallManager" document, available at http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_example09186a00801ad22f.shtml.
To Configure the Dialogic Media Gateway
Step 1
Configure the basic network settings via the console.
Step 2
Connect a serial cable to the serial connector on the rear panel of the Media Gateway unit.
Step 3
Set the workstation to the following values, by using a standard serial interface application (for example, Procomm Plus or HyperTerminal):
•
Baud Rate—115200 bps
•
Parity—None
•
Data Bits—8
•
Stop Bits—1
•
Hardware Flow Control—Off
Step 4
Press Enter repeatedly until the PIMG > prompt appears.
Step 5
At the prompt, enter pwd and press Enter.
Step 6
When prompted, enter the password for the admin user (the default is IpodAdmin) and press Enter.
Step 7
At the prompt, enter quickcfg and press Enter.
You will then be prompted to enter the following Media Gateway parameter information:
•
Client IP Address
•
Client Subnet Mask
•
Network Gateway IP
Step 8
When prompted that the parameters have been successfully configured, enter restart at the PIMG > prompt to restart the Media Gateway.
From the Web interface, you should now be able to connect to the Media Gateway by using the newly configured IP Address.
To Configure the Telephony Settings on the Dialogic Gateway
Step 1
Connect to the gateway at http://<ipaddress> with username Admin and password (the default password is IpodAdmin).
Step 2
From the menu on the left side of the screen, click Gateway. In the VoIP Endpoint ID field, enter the IP address of the Cisco Speech Connect server, and click Apply Changes.
Step 3
Click Gateway Advanced.
The required Advanced Call Routing and Audio settings are shown in Table 10-1.
Step 4
Click T1E1, and enter the applicable T1/E1 settings to match your Cisco Unified CM configuration. Signalling must be ISDN. Select the T1-ISDN Protocol tab on the top and enter the applicable line settings in the table to match the Cisco Unified CM configuration.
Step 5
Click Apply Changes.
Step 6
Click Restart.
Table 10-1 Advanced Call Routing and Audio Settings
Field
|
Value
|
Call Connect Mode
|
Instant
|
Send DNIS to VoIP Endpoint
|
Yes
|
Audio Compression
|
G711u (or G711 if Mu-law option unavailable)
|
RTP Digit Relay Mode
|
RFC2833
|
Voice Activity Detection
|
Off
|
Frame Size (G.711)
|
30
|
PIMG Configuration
Description
Figure 10-2 shows an example of a PIMG integration.
Figure 10-2 PIMG Integration
In this example, Speech Connect communicates with a PIMG telephony gateway by using SIP. The telephony gateway is integrated to Cisco Unified Communications Manager by using analog telephony ports. Call transfers are supported via hookflash operation. Due to the analog nature of this integration, an SMDI serial link is required in order for Cisco Unified CM to pass call party information.
Components
The following components are used in the PIMG configuration.
•
Cisco Unified CM 4.2
•
Cisco 2811 ISR with a VIC-4FXS
•
Dialogic Media Gateway DM1008LS (PIMG80LS)
Procedures
Do the following procedures in the order presented to integrate Speech Connect with Cisco Unified CM version 4.x:
•
To Configure the ISR Gateway for MGCP Analog Ports
•
To Configure the Dialogic Media Gateway
•
To Configure the Telephony Settings on the Dialogic Gateway
To Configure the ISR Gateway for MGCP Analog Ports
Because Speech Connect must receive both DNIS (called party) and ANI (calling party) to operate efficiently, all calls to the server must be a result of a call-forwarding situation in Cisco Unified CM. This is accomplished through the use of a restricted partition, calling search space, and CTI route point.
For example:
•
Phone A with a "Phones" calling search space dials the Speech Connect pilot number 5555.
•
Cisco Unified CM routes the call to a CTI route point that has a DN of 5555 in the "Phones" partition.
•
The CTI route point DN 5555 is set to forward all calls to 5555 by using the "PIMG" calling search space.
•
Cisco Unified CM routes the call to the route pattern 5555 in the "PIMG" partition and the call is sent to the Speech Connect server.
•
Because 5555 in the "PIMG" partition corresponds to the Voice Mail DN and Voice Mail DN Partition configured in the SMDI service parameters, Cisco Unified CM sends the SMDI information to Speech Connect along with the call.
Note
Although multiple route patterns can be routed to Speech Connect, only one number will support integration information, due to the SMDI limitations within Cisco Unified CM version 4.x. All other calls to Speech Connect will be sent without integration information and answered by the default Speech Connect application. Heuristic dialing will also not be available for these calls.
Step 1
Complete the steps outlined in the "Configuring Cisco CallManager with IOS MGCP Gateways (Analog FXO, FXS Ports)" document, available at http://www.cisco.com/en/US/products/sw/voicesw/ps556/products_tech_note09186a008009428e.shtml.
Step 2
Configure the restricted PIMG partition.
Step 3
Configure the PIMG calling search space.
Step 4
Configure the Speech Connect CTI route point.
Step 5
Configure the Speech Connect route pattern.
Step 6
Configure the SMDI service parameters.
Step 7
Configure the restricted PIMG partition:
Route Plan > Class of Control > Partition > Add a New Partition
Step 8
Enter the partition name for the PIMG route point that you will be creating and click Insert.
Step 9
Click OK. Verify that the new partition is in the resulting partition list.
Step 10
Configure the PIMG calling search space:
Route Plan > Class of Control > Calling Search Space > Add a New Calling Search Space
Step 11
Enter a name for the new calling search space. Optionally, add a description.
Step 12
In the Available Partitions field, highlight the partition that you created in Step 7, and click the Down Arrow.
Step 13
Verify that the selected partition has moved to the Selected Partitions field.
Note
There should be no other partitions added to the Selected Partitions field.
Step 14
Configure the Speech Connect CTI route point:
Device > CTI Route Point > Add a New CTI Route Point
Step 15
In the Device Name field, enter a device name.
Step 16
Select the device pool applicable to your system configuration.
Step 17
From the Calling Search Space menu, select the calling search space that you created in Step 10.
Step 18
Click Insert.
Step 19
Click OK. This will take you to the Directory Number Configuration for the CTI route point.
Step 20
In the Directory Number field, enter the DNIS for your Speech Connect server.
Step 21
From the Partition menu, select a partition that is reachable by the phones and gateways that you want to be able to dial in to Speech Connect. If you want the partition to be reachable globally, leave the partition field empty.
Note
Do not select the PIMG partition that you created in the previous steps; it will be used later.
Step 22
In the Forward All field, enter the same DNIS number that you entered in Step 20.
Step 23
Click Add.
Step 24
Click OK. You should now see the Speech Connect DNIS on the left side of the CTI Route Point Configuration window.
Step 25
Configure the Speech Connect route pattern:
Route Plan > Route/Hunt > Route Pattern > Add a New Route Pattern
Step 26
In the Route Pattern field, enter the Speech Connect DNIS number that you entered in Step 20.
Note
The system may warn you that a previous number exists in this partition. Click OK. You will be changing the partition next.
Step 27
From the Partition menu, select the PIMG partition created earlier.
Step 28
From the Gateway or Route List menu, select the PIMG route list created earlier.
Step 29
Uncheck the Provide Outside Dialtone check box.
Step 30
Click Insert.
Step 31
Configure the SMDI service parameters:
Service > Service Parameters
Step 32
From the Service menu, select Cisco Messaging Interface.
Note
If the Cisco Messaging Interface does not show up as an option, the service may need to be activated or started. See the Serviceability Guide of the Cisco Unified CM version you are configuring for more information.
Step 33
From the CallManager Name menu, select the applicable Cisco Unified CM.
Step 34
Change the Data Bits to 8.
Step 35
Modify the Output DN Format to match the length of the Speech Connect DNIS.
Note
If the Output DN Format is not configured to match the length of the Speech Connect DNIS, Speech Connect may not recognize the incoming call appropriately.
Step 36
Change Parity to none.
Step 37
In the Voice Mail DN field, enter the Speech Connect DNIS.
Step 38
From the Voice Mail Partition menu, select the PIMG partition created above.
Step 39
Click Update.
Step 40
From the Communications Manager Serviceability page, restart the Cisco Messaging Interface.
To Configure the Dialogic Media Gateway
Step 1
Configure the basic network settings via the console.
Step 2
Connect a serial cable to the serial connector on the rear panel of the Media Gateway unit.
Step 3
Set the workstation to the following values, by using a standard serial interface application (for example, Procomm Plus or HyperTerminal):
•
Baud Rate—115200 bps
•
Parity—None
•
Data Bits—8
•
Stop Bits—1
•
Hardware Flow Control—Off
Step 4
Press Enter repeatedly until the PIMG > prompt appears.
Step 5
At the prompt, enter pwd and press Enter.
Step 6
When prompted, enter the password for the admin user (the default is IpodAdmin) and press Enter.
Step 7
At the prompt, enter quickcfg and press Enter.
You will then be prompted to enter the following Media Gateway parameter information:
•
Client IP Address
•
Client Subnet Mask
•
Network Gateway IP
Step 8
When prompted that the parameters have been successfully configured, enter restart at the PIMG > prompt to restart the Media Gateway.
You should now be able to connect to the Media Gateway from the Web Interface by using the newly configured IP Address.
To Configure the Telephony Settings on the Dialogic Gateway
Step 1
Connect to the gateway at http://<ipaddress> with username Admin and password (the default password is IpodAdmin).
Step 2
From the menu on the left, click System. In the Serial Port table, configure the applicable values to match the SMDI port settings that are configured in Cisco Unified CM. Click Apply Changes.
Step 3
From the menu on the left side of the screen, click Gateway. In the VoIP Endpoint ID field, enter the IP address of the Cisco Speech Connect server, and click Apply Changes.
Step 4
Click the Gateway Advanced tab. From the Send DNIS to VoIP Endpoint menu, select Yes. Click Apply Changes.
Step 5
Click Serial Protocol. For each port that is listed under Logical Extension Number, enter the analog port SMDI number for each port that was configured in Cisco Unified CM. Click Apply Changes.
Step 6
Click Restart.
Note
This procedure assumes that Cisco Unified CM version 4.x is configured with the applicable partitions, regions, locations, and calling search spaces, which allow an endpoint to make a call to the analog port. It also assumes that a gateway is available to terminate the analog or digital lines on the Cisco Unified CM side.
Integrating with Cisco Unified Communications Manager Version 5.x
This section describes a SIP integration with Cisco Unified Communications Manager version 5.x with support for blind call transfers.
When Cisco Unified CM version 5.x supports SIP supplementary services, the Speech Connect server integrates directly to Cisco Unified CM by using a SIP trunk.
Description
Figure 10-3 shows an example of SIP integration.
Figure 10-3 SIP Integration
In this example, Speech Connect communicates directly with Cisco Unified CM via SIP. Blind transfers are performed by using the SIP REFER method. Call party information is all contained within the SIP messages.
Procedures
The following procedures are required to configure a SIP trunk on Cisco Unified CM version 5.x to integrate with a Speech Connect server. Do the following procedures in the order shown:
•
To Create a SIP Trunk Security Profile for Speech Connect
•
To Create a SIP Trunk Revised November 2008
•
To Create a Route Group/Route List and Route Pattern
To Create a SIP Trunk Security Profile for Speech Connect
Step 1
On the Cisco Unified Communications Manager administration page, click System > Security Profile > SIP Trunk Security Profile, and then click Add New.
Step 2
In the Name field, enter a name for the profile. Optionally, enter a description.
Step 3
From the Outgoing Transport Type menu, select UDP.
Step 4
Click Save.
To Create a SIP Trunk
Revised November 2008
Step 1
On the Cisco Unified Communications Manager administration page, click Device > Trunk, and then click Add New.
Step 2
From the Trunk Type menu, select SIP and then click Next.
Step 3
Select the desired Device Pool.
Step 4
Verify that the Media Termination Point Required check box is unchecked.
Step 5
In the Destination Address field, enter the Speech Connect IP address.
Step 6
From the SIP Trunk Security Profile menu, select the security profile that you configured in the previous step.
Step 7
The Rerouting Calling Search Space menu is set by default to None. If you have previously created a Calling Search Space (CSS), change the Rerouting Calling Search Space setting to the CSS name that will allow you to call the extensions that are configured in Speech Connect.
Step 8
From the SIP Profile menu, select the standard SIP profile.
Step 9
From the DTMF Signaling Method menu, select RFC 2833.
Step 10
Click Save.
Note
The recommended setting for Media Termination Point Required is off. Do not change this setting unless instructed to do so by Cisco TAC, as use of this option could potentially affect Cisco Unified CM performance.
Note
Voice Activity Detection (VAD) must be disabled. By default, this option is disabled in the default SIP Profile and must remain disabled. If VAD has been enabled in the default SIP Profile for another existing SIP trunk, then a new dedicated SIP profile without VAD enabled will need to be created for use with the Speech Connect trunk.
To Create a Route Group/Route List and Route Pattern
Step 1
On the Cisco Unified Communications Manager administration page, click Call Routing > Route/Hunt > Route Group > Add New.
Step 2
In the Route Group Name field, enter a name for the group.
Step 3
In the Device Name Contains window, select the trunk that was configured in the previous step and click Add to Route Group.
Step 4
Click Save.
Step 5
On the Cisco Unified Communications Manager administration page, click Call Routing > Route/Hunt > Route List > Add New.
Step 6
In the Name field, enter a name for the route list.
Step 7
Select the applicable Cisco Unified CM group for your system.
Step 8
Click Save.
Step 9
Click Add Route Group Member.
Step 10
From the Route Group menu, select the Route Group that you created in the previous step.
Step 11
Click Save.
Step 12
On the Cisco Unified Communications Manager administration page, click Call Routing > Route/Hunt > Route Pattern > Add New.
Step 13
In the Route Pattern field, enter an applicable pattern.
Step 14
From the Gateway/Route List menu, select the Route List that you created in the previous step.
Step 15
Uncheck the Provide Outside Dial Tone check box.
Step 16
Click Save.