Cisco Unified Communications Manager System Guide, Release 7.0(1)
Cisco Unity Messaging Integration
Downloads: This chapterpdf (PDF - 154.0KB) The complete bookPDF (PDF - 12.14MB) | Feedback

Cisco Unity Messaging Integration

Table Of Contents

Cisco Unity Messaging Integration

System Requirements

Integration Description

Cisco Unified Communications Manager SIP Trunk Integration

Cisco Unity Cisco Unified Communications Manager Integrated Mailbox Configuration

Securing the Voice-Mail Port

Cisco Unity and Cisco Unity Connection Configuration Checklist

Where to Find More Information


Cisco Unity Messaging Integration


Cisco Unity comprises a communications solution that delivers voice messaging and unified messaging in a unified environment.

Unified messaging means that users can manage all message types from the same Inbox. Cisco Unity works in concert with an Exchange server or (for Cisco Unity 4.0 and later) a Domino server to collect and store all messages—both voice and e-mail—in one message facility. Users can then access voice and e-mail messages on a computer, through a touchtone phone, or over the Internet.

For complete, step-by-step instructions on how to integrate Cisco Unified Communications Manager with the Cisco Unity messaging system, refer to the applicable Cisco Unified Communications Manager Integration Guide for Cisco Unity.


Note For information on how to integrate Cisco Unified Communications Manager with the Cisco Unity Connection messaging system, refer to the applicable Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection or Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection.


This section covers the following topics:

System Requirements

Integration Description

Cisco Unity Cisco Unified Communications Manager Integrated Mailbox Configuration

Securing the Voice-Mail Port

Cisco Unity and Cisco Unity Connection Configuration Checklist

Where to Find More Information

System Requirements

The following lists provide requirements for your phone system and the Cisco Unity server. For specific version information, refer to the applicable Cisco Unified Communications Manager Integration Guide for Cisco Unity.

Phone System

A Cisco Unified Communications applications server that consists of Cisco Unified Communications Manager software that is running on a Cisco Media Convergence Server (MCS) or customer-provided server that meets approved Cisco configuration standards

Cisco licenses for all phone lines, IP phones, and other H.323-compliant devices or software (such as Cisco Virtual Phone and Microsoft NetMeeting clients) that will be connected to the network, as well as one license for each Cisco Unity port

IP phones for the Cisco Unified Communications Manager extensions

A LAN connection in each location where you will plug an IP phone into the network

For multiple Cisco Unified Communications Manager clusters, capability for subscribers to dial an extension on another Cisco Unified Communications Manager cluster without having to dial a trunk access code or prefix.

Cisco Unity Server

Cisco Unity system that was installed and made ready for the integration as described in the Cisco Unity Installation Guide.

The applicable Cisco Unity-Unified CM TSP installed. For more information on compatible versions of the TSP, refer to the Compatibility Matrix: Cisco Unity Connection, the Cisco Unity-Unified CM TSP, and the Cisco Unified Communications Manager Express documentation.

A license that enables the appropriate number of voice-messaging ports.

Integration Description

The integration uses the LAN to connect Cisco Unity and Cisco Unified Communications Manager. The gateway provides connections to the PSTN. Figure 32-1 shows the connections.

Figure 32-1 Connections Between the Phone System and Cisco Unity


Note The following example applies only if the caller goes through the Cisco Unity Auto-Attendant. Most other calls get routed directly to the correct voice mailbox. For example, callers who call a subscriber and get forwarded to voice-messaging system go directly to the voice mailbox and can record a voice message. Subscribers who call in to check their voice messages from their own phones go directly to their voice mailbox and can listen to voice messages.


1. When an external call arrives, the Cisco gateway sends the call over the LAN to the machine on which Cisco Unified Communications Manager is installed.

2. For Cisco Unified Communications Manager lines that are configured to route calls to Cisco Unity, Cisco Unified Communications Manager routes the call to an available Cisco Unity extension.

3. Cisco Unity answers the call and plays the opening greeting.

4. During the opening greeting, the caller enters either the name of a subscriber or an extension; for example, 1234.

5. Cisco Unity notifies Cisco Unified Communications Manager that it has a call for extension 1234.

6. At this point, the path of the call depends on whether Cisco Unity is set up to perform supervised transfers or release transfers. Refer to the applicable Cisco Unified Communications Manager Integration Guide for Cisco Unity for more information.

Cisco Unified Communications Manager SIP Trunk Integration

Cisco Unity Connection 1.1 and later support a SIP trunk integration with the Cisco Unified Communications Manager phone system when the Cisco Unified Communications Manager phone system has only phones that are running SIP. Refer to the applicable Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection for more detailed information. Cisco Unity 4.2 and later also support SIP trunk integrations. Refer to the applicable Cisco Unified Communications Manager Integration Guide for Cisco Unity for more information. The following list describes a few tips that should be performed from the Cisco Unified Communications Manager Administration side when you are integrating the Cisco Unified Communications Manager phone system with Cisco Unity Connection or Cisco Unity by a SIP trunk:

Create a SIP trunk that points to Cisco Unity and ensure that "Redirecting Number IE Delivery - Outbound" is checked. This instructs Cisco Unified Communications Manager to send the Diversion Header to Cisco Unity, so you access the correct voice mailbox. Refer to "Trunk Configuration" in the Cisco Unified Communications Manager Administration Guide.


Note Cisco Unified Communications Manager SIP trunk integration applies to MWI. When you configure the SIP trunk security profile for the SIP voice-messaging trunk, check "Accept Unsolicited Notification." This ensures that MWI will operate properly. You must enable "Accept Header Replacement" if you want to support transfers. This allows "REFER w/replaces" to be passed, which is used for Cisco Unity-initiated, supervised transfers.


Assure that your phones support DTMF Relay per RFC-2833. Cisco Unity will support both OOB and RFC-2833. For more information on compatible versions of the TSP, refer to the Compatibility Matrix: Cisco Unity Connection, the Cisco Unity-Unified CM TSP, and the Cisco Unified Communications Manager Express documentation.

Define a route pattern (for example, 7555) and point that route pattern to the SIP trunk to Cisco Unity. Refer to "Route Pattern Configuration" in the Cisco Unified Communications Manager Administration Guide.

Define a voice mail pilot (for example, 7555). Refer to "Cisco Voice-Mail Pilot Configuration" in the Cisco Unified Communications Manager Administration Guide.

Define a voice mail profile (for example, VM Profile 1) with the voice mail pilot that you defined in the previous step. Refer to "Voice-Mail Profile Configuration" in the Cisco Unified Communications Manager Administration Guide.


Note Make the voice mail profile that you defined in the preceding step the system default.


Cisco Unity Cisco Unified Communications Manager Integrated Mailbox Configuration

When Cisco Unified Communications Manager integrates with a compatible Cisco Unity version with Microsoft Exchange, Cisco Unified Communications Manager administrators can create Cisco Unity subscriber voice mailboxes, one at a time, from the Directory Number Configuration or End User Configuration windows.

Requirements

Cisco Unified Communications Manager

Compatible version of Cisco Unity with Microsoft Exchange

Cisco Unified Communications Manager Integrated Voice Mailbox asp page (installed on the Cisco Unified Communications Manager server from the Cisco Unity server)

RIS Data Collector service that is activated on Cisco Unified Communications Manager server

Restrictions

After a mailbox is created, no automatic synchronization of mailbox data happens between Cisco Unity and Cisco Unified Communications Manager. All changes get synchronized manually on both systems.

The system does not support creation of Internet, VPIM, AMIS, Bridge, or Domino subscriber mailboxes from Cisco Unified Communications Manager Administration.

The system does not support bulk or batch import of Cisco Unity mailboxes by using the Bulk Administration Tool (BAT).

Creation of Cisco Unity mailbox creates a Cisco Unity subscriber account directly in SQL, so new subscribers can be viewed and updated on the Cisco Unity Administrator when the create mailbox transaction completes.

A log file records Cisco Unity mailbox transactions that are made by using Cisco Unified Communications Manager Administration on the Cisco Unity server.

The system writes associated diagnostic logs to a log file.

Audit log and diagnostic files do not record the transmission of credentials across the network.

Securing the Voice-Mail Port

When you configure security for Cisco Unified Communications Manager voice mail ports and Cisco Unity SCCP devices, a TLS connection (handshake) opens for authenticated devices after each device accepts the certificate of the other device; likewise, the system sends SRTP streams between devices; that is, if you configure the devices for encryption.

When the device security mode equals authenticated or encrypted, the Cisco Unity-Unified CM TSP connects to Cisco Unified Communications Manager through the Cisco Unified Communications Manager TLS port. When the security mode equals non-secure, the Cisco Unity TSP connects to Cisco Unified Communications Manager through the Cisco Unified Communications Manager port. Cisco Unity Connection connects to Cisco Unified Communications Manager through the Cisco Unified Communications Manager TLS port.

For interactions, restrictions, and procedures on how to configure security, refer to the Cisco Unified Communications Manager Security Guide.

Cisco Unity and Cisco Unity Connection Configuration Checklist

Table 32-1 provides steps to configure the Cisco Unity or Cisco Unity Connection voice-messaging systems.

Table 32-1 Cisco Unity and Cisco Unity Connection Configuration Checklist 

Configuration Steps
Procedures and Related Topics

Step 1 

Ensure that you have met the system requirements for Cisco Unified Communications Manager, and Cisco Unity or Cisco Unity Connection.

System Requirements

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Step 2 

Add voice-mail ports (directory numbers) for each port that you are connecting to Cisco Unity or Cisco Unity Connection.

Cisco Voice-Mail Port Configuration, Cisco Unified Communications Manager Administration Guide

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Step 3 

Add a voice-mail pilot number for the voice-mail ports.

Cisco Voice-Mail Pilot Configuration, Cisco Unified Communications Manager Administration Guide

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Step 4 

Specify MWI and voice-mail extensions.

Service Parameters Configuration, Cisco Unified Communications Manager Administration Guide

Message Waiting Configuration, Cisco Unified Communications Manager Administration Guide

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Step 5 

Add the Voice Mail Port DNs to a line group.

Configuring a Line Group, Cisco Unified Communications Manager Administration Guide

Step 6 

Add the line group that contains the Voice Mail Port DNs to a hunt list.

Adding a Route List, Cisco Unified Communications Manager Administration Guide

Step 7 

Associate the hunt list that contains the line group with a hunt pilot.

Note The hunt pilot must match the voice-mail pilot that is configured and used by the voice-mail profiles.

Configuring a Route Pattern, Cisco Unified Communications Manager Administration Guide

Step 8 

Set up the voice-mail pilot number.

Cisco Voice-Mail Pilot Configuration, Cisco Unified Communications Manager Administration Guide

Step 9 

Set up the voice-mail profile.

Voice-Mail Profile Configuration, Cisco Unified Communications Manager Administration Guide

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Step 10 

Set up the voice-mail service parameters.

Service Parameters Configuration, Cisco Unified Communications Manager Administration Guide.

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Step 11 

Enable the DTMF relay feature in the gateways.

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Step 12 

Install, configure, and test the TAPI service provider for Cisco Unity 3.1(x).

 

Step 13 

Configure Cisco Unity for the integration for Cisco Unity 3.1(x).

For multiple clusters of Cisco Unified Communications Manager, set up MWI ports.

Create a new integration between Cisco Unity or Cisco Unity Connection, and Cisco Unified Communications Manager.

Message Waiting Configuration, Cisco Unified Communications Manager Administration Guide

Step 14 

Set up Cisco Unified Communications Manager authentication and encryption.

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager Security Guide

Step 15 

Test the integration.

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Cisco Unity Troubleshooting Guide

Refer to the installation guide for the phone system.

Step 16 

Integrate the secondary server for Cisco Unity failover (use when Cisco Unity failover is installed). This step does not apply to Cisco Unity Connection.

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unity Failover Guide

Step 17 

Configure an application user.


Note You must use the same user name and password that you defined in Cisco Unity Administrator.


Application User Configuration, Cisco Unified Communications Manager Administration Guide

Cisco Unified Communications Manager Installation Guide for Cisco Unity

Cisco Unity Connection Installation Guide

User Moves, Adds, and Changes Guide for Cisco Unity Connection

Step 18 

Choose the auto-generated Cisco Unity or Cisco Unity Connection server in the Application Server Configuration window in Cisco Unified Communications Manager Administration.


Note When selecting the application user, choose the application user that you created in Step 17.


Application Server Configuration, Cisco Unified Communications Manager Administration Guide

Step 19 

If you are using Cisco Unified Communications Manager Administration to configure voice-messaging subscribers, create a Cisco Unity voice mailbox.


Note You must configure both Cisco Unity and Cisco Unified Communications Manager Administration (for example, set up Cisco Unity voice mailbox templates, Cisco Unified Communications Manager dial plans) to create voice mailboxes.


Cisco Unified Communications Manager Installation Guide for Cisco Unity

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unity System Administration Guide

Directory Number Configuration, Cisco Unified Communications Manager Administration Guide

End User Configuration, Cisco Unified Communications Manager Administration Guide

Where to Find More Information

Additional Cisco Documentation

Cisco Voice-Mail Port Configuration, Cisco Unified Communications Manager Administration Guide

Service Parameters Configuration, Cisco Unified Communications Manager Administration Guide

Directory Number Configuration, Cisco Unified Communications Manager Administration Guide

End User Configuration, Cisco Unified Communications Manager Administration Guide

Application User Configuration, Cisco Unified Communications Manager Administration Guide

Cisco Unified Communications Manager Integration Guide for Cisco Unity

Cisco Unified Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection

Cisco Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection

Cisco Unity Installation Guide

Cisco Unity Troubleshooting Guide

Cisco Unity Connection Installation Guide

Cisco Unity Connection Troubleshooting Guide