Cisco Unity Connection System Administration Guide, Release 1.x
Setting Up Message Notification

Table Of Contents

Setting Up Message Notification

Setting Up SMTP Message Notifications

Setting Up SMS (SMPP) Message Notifications

Chaining Message Notification

Cascading Message Notification


Setting Up Message Notification


Cisco Unity Connection can send message notifications in the form of text messages to e-mail addresses, and also to text pagers and text-compatible cell phones. When a message arrives that matches the criteria selected in the message notification settings, the Connection Messaging System sends a text message entered by you or the user, such as "Urgent message for Technical Support."

See the following sections for a summary of the types of notifications, and information on what you need to do before you can enable text message notifications for users or offer them as options that users can set up for themselves in the Cisco Unity Assistant.

Setting Up SMTP Message Notifications

Setting Up SMS (SMPP) Message Notifications

Chaining Message Notification

Cascading Message Notification

Setting Up SMTP Message Notifications

By using SMTP, Cisco Unity Connection can send text message notification that users have received a new voice message. Text message notifications can be sent to e-mail addresses and to cell phones, text pagers, or other mobile devices that support SMTP.

In order for users to receive SMTP message notifications from Connection, your Connection server must be configured to relay messages to a smart host, and you must configure an SMTP device. Then you can enable Connection to send text message notifications by using SMTP, and users can also enable the SMTP devices for themselves on the Notification Devices page in the Cisco Unity Assistant.

Note that if a site attempts to deliver text message notifications, but has not been configured to relay messages to a smart host, the notification attempt fails and a nondelivery receipt (NDR) is sent to the Connection Messaging System and then routed, by default, to the Undeliverable Messages distribution list.

Connection can also use SMTP to send a text message notification to an e-mail address so that users receive an e-mail notification in their respective e-mail Inboxes when a new voice message arrives in their Cisco Unity Inbox. When you set up this type of notification, you can check the Include a Link to Cisco PCA in Text Message check box on the Edit Notification Device page so that a link to the Cisco PCA is automatically included in the body of the e-mail message that is sent to the user.

Do the following procedures, as applicable:

To Configure the Cisco Unity Connection Server to Relay Messages to a Smart Host

To Set Up SMTP Message Notifications for a User

To Set Up SMTP Message Notification for Multiple Users by Using a User Template

To Configure the Cisco Unity Connection Server to Relay Messages to a Smart Host


Step 1 On the Cisco Unity Connection server, on the Windows Start menu, click Programs > Administrative Tools > Internet Information Services (IIS) Manager.

Step 2 In the Internet Information Services (IIS) Manager window, in the left pane, click the Connection server.

Step 3 In the right pane, right-click the SMTP virtual server, and click Properties.

Step 4 In the SMTP Virtual Server Properties dialog box, click the Delivery tab and click Advanced.

Step 5 In the Advanced Delivery dialog box, in the Smart Host field, enter the IP address or the name of the smart host server. If you are entering an IP address, enclose the address in square brackets. Note that Connection does not verify that the IP address is valid.

Step 6 Click OK.

Step 7 In the SMTP Virtual Server Properties dialog box, click OK.

Step 8 Close the Internet Information Services window.


To Set Up SMTP Message Notifications for a User


Step 1 In Cisco Unity Connection Administration, click Users.

Step 2 On the Search Users page, in the Search Results table, click the alias of the applicable user.


Note If the user alias does not appear in the search results table, set the applicable parameters in the search fields at the top of the page, and click Find.


Step 3 On the Edit User Basics page, on the Edit menu, click Notification Devices.

Step 4 On the Notification Devices page, in the Display Name list, click SMTP.

Step 5 On the Edit Notification Device (SMTP) page, check the Enabled check box.

Step 6 In the To field, enter the e-mail address of the user text pager, mobile device, or other e-mail address.

Step 7 In the From field, enter the phone number that the user will call to check messages.

Step 8 If the notifications will be delivered to a device that supports web browsing, check the Include a Link to Cisco PCA in Text Message check box so that the user can click the link to open the Cisco PCA and listen to the message.

Step 9 Enter other settings, as applicable.

Step 10 Click Save.


To Set Up SMTP Message Notification for Multiple Users by Using a User Template

Keep in mind that the user template you set up by doing this procedure cannot be applied to currently-existing user accounts. Once you have set up the user template, use it when creating new user accounts. If you want to set up SMTP Message Notification for a currently existing user account, do the previous "To Set Up SMTP Message Notifications for a User" procedure.


Step 1 In Cisco Unity Connection Administration, expand Templates, then click User Templates.

Step 2 On the Search User Templates page, click Add New.

Step 3 On the New User Template page, in the User Template Type list, click User Template with Voice Mail.

Step 4 In the Based on Template list, click an applicable template upon which to base this new template.

Step 5 Enter an alias and display name.

Step 6 In the Phone System list, click the applicable phone system.

Step 7 Click Save.

Step 8 On the User Template Basics page, enter additional settings, as applicable. If you change any settings on the page, click Save.

Step 9 On the Edit menu, click Notification Devices.

Step 10 On the Notification Devices page, click Add New.

Step 11 On the New Notification Device page, in the Notification Device Type list, click SMTP.

Step 12 Enter a display name for the device.

Step 13 In the From field, enter the phone number that the user will call to check messages.

Step 14 If the notifications will be delivered to a device that supports web browsing, check the Include a Link to Cisco PCA in Text Message check box so that the user can click the link to open the Cisco PCA and listen to the message.

Step 15 Enter other settings, as applicable.

Step 16 Click Save.

The notification device is now set up for every user whose account you subsequently created based on this template. Note that for each user, the SMTP device must still be enabled, and you must update the To field to include the e-mail address of the user device. You can enable the device on the Notification Device page for the user account; users can also enable the device by using the Cisco Unity Assistant.


Setting Up SMS (SMPP) Message Notifications

With the services and information provided by a wireless carrier, mobile messaging service provider or similar company, Cisco Unity Connection can use the Short Message Peer-To-Peer (SMPP) protocol to send message notifications in the Short Message Service (SMS) format to cell phones and other SMS-compatible devices when users receive a new voice message. SMS is a "store and forward service," which means that messages are not sent directly to the device used by the message recipient. Instead, an application like Connection—known as an External Short Message Entity (ESME)—submits a message to the SMS Center (SMSC). The SMSC then forwards the message to the device.

Advantages Over SMTP Message Notifications

An advantage of using SMS is that the user device often receives message notifications much faster than when using SMTP. The user device does not have to be on the wireless network at the time that Connection sends the message to the SMSC, nor when the SMSC forwards it. The wireless network holds the SMS messages until the device is available; when the device is available, the delivery of the queued messages to the device takes just a few seconds. In addition, you can configure Connection so that each notification message replaces the previous one. Note that this functionality may not be supported by all mobile service providers.

SMS Message Length Limitations

An SMS message is a short text message. The acceptable message length for an SMS message varies depending on the service provider, the character set used to compose the message text, and the specific characters used in the message text. The message count (assuming users choose to include the message count) is not included in the total message length.

Character sets available include:

Default Alphabet (GSM 3.38), 7-bit characters

IA5/ASCII, 7-bit characters

Latin 1 (ISO-8859-1), 8-bit characters

Japanese (JIS), multi-byte characters

Cyrillic (ISO-8859-5), 8-bit characters

Latin/Hebrew (ISO-8859-8), 8-bit characters

Unicode (USC-2), 16-bit characters

Korean (KS C 5601), multi-byte characters

For 7-bit character sets, a maximum of 160 characters can fit into an SMS message; for 8-bit character sets, the limit is 140 characters; for 16-bit character sets, the limit is 70 characters; for multi-byte character sets, the limit is somewhere between 70 and 140 characters, depending on which characters make up the text of the message. (For multi-byte character sets, most characters are 16 bits; some of the more common characters are eight bits.)


Note Not all cell phones support all character sets; most will support the GSM 3.38 default alphabet.


Cost Considerations

When setting up SMS (SMPP) message notifications, consider that service providers typically charge for each SMS message or group of messages sent. Thus, the more SMS (SMPP) message notifications that Connection sends to user devices, the higher the costs to your organization. For this reason, you may want to restrict the use of this feature to a group of users (you can do so by assigning owners to the SMPP providers that you create), or you may want to ask users to limit the number of message notifications that they receive by message type or urgency. For example, users can specify in the Cisco Unity Assistant that Connection will send message notifications only when new urgent voice messages arrive.

Task List for Setting Up SMS (SMPP) Message Notifications

To enable SMS (SMPP) message notifications for users with SMS-compatible devices, do the following tasks:

1. Set up an account with a mobile messaging service provider that offers SMS messaging. Connection works with any service provider that supports the SMPP version 3.3 or SMPP version 3.4 protocols.

2. Gather the information needed to allow Connection to communicate with the SMPP server at the SMSC affiliated with your contracted service provider, and enter the information on the SMPP Provider page. See the "To Set Up an SMPP Provider" procedure.

3. When the Connection server is set up behind a firewall, configure the TCP port that is used by the SMPP server when connecting to Connection to allow incoming and outgoing communication between Connection and the SMPP server.

4. Set up and enable SMS (SMPP) message notification for yourself or another user, and test to see if the device receives the SMS (SMPP) notification as expected. See the "To Set Up an SMS (SMPP) Message Notification Device for a User" procedure and the "To Enable SMS (SMPP) Message Notifications for a User" procedure. If notifications are not working, confirm that you entered the settings on the SMPP Provider page as indicated in the documentation that your service provider gave you. Contact your service provider for assistance, as needed.

5. Set up and enable SMS (SMPP) message notifications for users. See the "To Set Up an SMS (SMPP) Message Notification Device for a User" procedure and the "To Enable SMS (SMPP) Message Notifications for a User" procedure. Note that after the SMS (SMPP) device is set up, users can enable SMS (SMPP) message notifications for themselves in the Cisco Unity Assistant.

To Set Up an SMPP Provider


Step 1 In Cisco Unity Connection Administration, expand System Settings > Advanced, then click SMPP Providers.

Step 2 On the Search SMPP Providers page, click Add New.

Step 3 On the New SMPP Provider page, verify that the Enable check box is checked.

Step 4 Enter a Name for the provider.

Step 5 Enter the System ID and Password given to you by your service provider.

Step 6 Enter a Host Name/Address and Port, which are the SMSC Host name or IP address given to you by your service provider, and the port number that is used by the SMSC to listen for incoming connections.

Step 7 If applicable, enter the Source Address, Service Type, Address TONs, and Address NPIs given to you by the service provider. If your provider did not specify values, leave these fields blank.

Step 8 If applicable, in the Data Coding list, select the character set that you want each SMS message converted to when the messages are sent to the SMS device. (If your provider did not specify a value, select Default Alphabet.) For multilingual systems, consider creating a separate SMPP provider for each character set that you want to offer to users.

Step 9 Set the Owner, as follows:

To restrict provider use, select a user as owner of the selected SMPP provider. Click User and then select the applicable user from the list.

To allow the SMPP provider to be used by all users with associated SMS (SMPP) notification devices at a location, select System as owner of the selected SMPP provider.

Step 10 Click Save.

Step 11 On the Edit SMPP Provider page, enter additional settings, as applicable. If you add or change any settings, click Save.


To Set Up an SMS (SMPP) Message Notification Device for a User


Step 1 In Cisco Unity Connection Administration, click Users.

Step 2 On the Search Users page, in the Search Results table, click the alias of the applicable user.


Note If the user alias does not appear in the search results table, set the applicable parameters in the search fields at the top of the page, and click Find.


Step 3 On the Edit User Basics page, on the Edit menu, click Notification Devices.

Step 4 On the Notification Devices page, if an SMS device exists, click the name of the device and skip to Step 6.

If an SMS device is not listed, click Add New, then continue with Step 5.

Step 5 On the New Notification Device page, in the Notification Device Type list, click SMS.

Step 6 Enter or modify the display name for the device, as applicable.

Step 7 In the Phone Number field, enter the phone number of the SMS-compatible device.


Note Most SMSCs require that the phone number be entered in international format, which means omitting the + and 00, but including the country code and area code. For example, in the United States, 1 206 555 1234 would be formatted correctly.


Step 8 In the SMPP Provider field, click the name of the service provider.

Step 9 Enter additional settings, as applicable.

Step 10 Click Save.

Step 11 Continue with the following "To Enable SMS (SMPP) Message Notifications for a User" procedure to enable SMS (SMPP) notifications for the user.


To Enable SMS (SMPP) Message Notifications for a User


Step 1 In Cisco Unity Connection Administration, click Users.

Step 2 On the Search Users page, in the Search Results table, click the alias of the applicable user.


Note If the user alias does not appear in the search results table, set the applicable parameters in the search fields at the top of the page, and click Find.


Step 3 On the Edit User Basics page, on the Edit menu, click Notification Devices.

Step 4 On the Notification Devices page, click the display name of the SMS Device you set up in the preceding "To Set Up an SMS (SMPP) Message Notification Device for a User" procedure.

Step 5 On the Edit Notification Device page, check the Enabled check box.

Step 6 Change other settings on the page, as applicable. For example, you may want to set parameters to control whether and how often a notification is repeated.

Step 7 Click Save.


Chaining Message Notification

Message notification can be set to "chain" to a series of notification devices if an attempt to send notification to the first selected device fails. The definition of failure to a notification device is based on the options you select for retrying a device that is not answered or is busy.

Cisco Unity Connection Administration does not allow SMTP, SMS, or pager devices to be used for chaining message notification because notification to these devices does not fail.

To Set Up Chaining Message Notification


Step 1 In Cisco Unity Connection Administration, click Users.

Step 2 On the Search Users page, in the Search Results table, click the alias of the applicable user.


Note If the user alias does not appear in the search results table, set the applicable parameters in the search fields at the top of the page, and click Find.


Step 3 On the Edit User Basics page, on the Edit menu, click Notification Devices.

Step 4 On the Notification Devices page, click the notification device that you want Connection to contact first.

Step 5 Enter settings for this device, as applicable. For On Notification Failure, click Send To, and click the device that you want Connection to notify next if notification to this device fails.

Step 6 On the Edit menu, click Notification Devices again.

Step 7 Click the device that you specified for Send To in Step 5.

Step 8 Enter settings for this device, as applicable. Note the following:

Change Notification Event to None. If you choose any other value, message notification for this device will start immediately and will not wait for the notification failure of the previous device. Your notifications will not chain, they will all trigger at once.

If you want to chain to a third device if notification to this device fails, click Send To, and click the device that you want Connection to notify next if notification to this device fails. If not, click Do Nothing.

Step 9 If you want to chain additional devices:

a. On the Edit menu, click Notification Devices again.

b. Click the device that you specified for Send To for the previous device.

c. Enter settings for that device as described in Step 8.


Cascading Message Notification

Cascading message notification allows you to set up a series of notifications to a widening circle of recipients.

For example, to create a hierarchy of message notifications for your Technical Support department, set the first message notification to be sent immediately to the pager of the front-line technical support representative. The next notification can be sent after a delay of 15 minutes to the pager of the department manager. A third notification can be sent after a delay of 30 minutes to an employee in the Problem Resolution Group.

Notifications continue to cascade according to the options you selected until the message has been saved or deleted by a recipient.

To Set Up Cascading Message Notification


Step 1 In Cisco Unity Connection Administration, click Users.

Step 2 On the Search Users page, in the Search Results table, click the alias of the applicable user.


Note If the user alias does not appear in the search results table, set the applicable parameters in the search fields at the top of the page, and click Find.


Step 3 On the Edit User Basics page, on the Edit menu, click Notification Devices.

Step 4 On the Notification Devices page, select a notification device and enter settings for it, as applicable.

Step 5 In the Delay Before First Notification Attempt field, enter the desired delay for this device, in minutes.

Typically, you will space notifications between the devices at regular intervals, such as every 15 minutes. For example, you might specify 0 as the delay for the first device, 15 as the delay for the second device, 30 for the third device, and so on.

Step 6 Repeat Step 3 through Step 5 for the second and subsequent devices.