Cisco Unity Express 3.0 IVR CLI Administrator Guide - Configuring the IVR Outgoing E-Mail Subsystem Notifications [Cisco Unity Express]

Table Of Contents

Configuring the IVR Outgoing E-Mail Subsystem Notifications

Configuring the SMTP Server

Configuring the E-Mail Default-From Address

Examples

Configuring the IVR Outgoing E-Mail Subsystem Notifications

Last Updated: November 12, 2007

Use the IVR e-mail configuration CLI commands to configure Cisco Unity Express IVR outbound e-mail notification.

This chapter describes how to configure Cisco Unity Express IVR outbound e-mail notifications. The following sections describe the procedures for configuring IVR e-mail parameters:

•Configuring the SMTP Server

•Configuring the E-Mail Default-From Address

E-mails sent from Cisco Unity Express are directed to a configurable SMTP server. The outbound e-mail Notification steps in running the script allow you to:

•Create e-mail messages

•Attach files to an outbound e-mail message

•Send e-mail messages from the Cisco Unity Express scripts

Configuring the SMTP Server

Use one of the following commands to configure the e-mail SMTP server, depending on the authentication method chosen, if authentication is required (See the Cisco Unity Express 3.0 Command Reference):

For e-mail SMTP server configuration where no SMTP server authentication is required enter:
se-10-0-0-0(config)# smtp server address {hostname | ip-address} authentication none
For e-mail SMTP server configuration where authentication of the SMTP server is required using the DNS hostname or IP address enter:
se-10-0-0-0(config)# smtp server address {hostname | ip-address} authentication username 
userid password password
For e-mail SMTP server configuration where authentication of the SMTP server is required using credential string enter:
se-10-0-0-0(config)# smtp server address {hostname | ip-address} authentication 
credentials credential-string
E-mail uses the Document script EmailMessageSent steps for loading templates documents, substituting text in the templates, and loading attachments (see the Cisco Unity Express 3.0 Guide to Writing and Editing Scripts). The templates are accessed by the CreateFileDocument step in the Script Editor to create a document. The document can then be used by the Text Substitution for Keywords step to replace keywords with dynamic parameters. The Create eMail step inserts a document into the body of an e-mail. The Attach to eMail step sends documents as e-mail attachments. A maximum of five attachments can be added to an e-mail. The Send eMail step uses properties fields to set the destination and source addresses and submits the e-mail to the SMTP server for delivery.

The Outbound eMail Notification steps uses the e-mail subsystem to send e-mail messages. The e-mail subsystem supports both synchronous and asynchronous methods of sending an e-mail.

Configuring the E-Mail Default-From Address

Use the default-from e-mail command to configure the default-from address for the e-mail application.

The default-from address is the address that your recipients see in the From field of outgoing e-mails and, if undeliverable, e-mails are returned to this address. Even though the message is being sent from Cisco Unity Express servers and e-mail domains, you can set this to read name@domain.com. The default-from address can be customized for your chosen e-mail address, meaning the e-mail can come from a specific address on your domain.

Enter a valid e-mail address string that is capable of receiving e-mail deliveries. This address must also be capable of receiving notifications of delivery failures.

The no and default form of this command removes this configuration.

SUMMARY STEPS

1. config t

2. ccn subsystem email

3. default-from email-address-string

4. default

5. end

6. exit

7. show ccn subsystem email

DETAILED STEPS

Command or Action

Purpose

Step 1

config t
Example:

se-10-0-0-0# config t

Enters global configuration mode.

Step 2

ccn subsystem email
Example:

se-10-0-0-0(config)# ccn subsystem email
se-10-0-0-0(config-email)#

Enters e-mail configuration mode.

Step 3

default-from email-address-string
Example:

se-10-0-0-0(config-email)# default-from customer25@abccomany.com

Specifies the default-from e-mail address.

Step 4

default
Example:

se-10-0-0-0(config-email)# default default-from customer25@abccomany.com

Deletes the IVR e-mail subsystem default-from e-mail address.

Step 5

end
Example:

se-10-0-0-0(config-email)# end

Saves and exits e-mail configuration mode.

Step 6

exit
Example:

se-10-0-0-0(config)# exit

Exits global configuration mode.

Step 7

show ccn subsystem email
or
show ccn subsystem email queue
Example:

se-10-0-0-0# show ccn subsystem email
or
se-10-0-0-0# show ccn subsystem email queue

Displays the e-mail default-from address or, if the e-mails are queued, those queued e-mail messages.

Examples

The following example displays the output of the show ccn subsystem email command.
se-10-0-0-0# show ccn subsystem email
Default From Address :                     customer25@abccompany.com
When generating e-mails from the Cisco Unity Express system, the e-mails can be sent synchronously or in a queued mode. If the e-mails are sent in a queued mode, the following example displays the output of the show ccn subsystem email queue command.
se-10-0-0-0# show ccn subsystem email queue
==============================================================================
Email ID       Recipient             Subject                         Scheduled
                                                                     Send Time 
==============================================================================
1196220172243  max20char@cisco.com   subject of Email - max 30 char  2007/05/30 10:52:00