How to: Configure an Outbound-Calling Application to Use a Notification Message Queue

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Speech Server uses Microsoft Message Queuing (MSMQ) to support outbound-calling applications. Speech Server retrieves requests from the MSMQ notification message queue to make outbound calls. To configure Speech Server to run outbound-calling applications, you must specify the path of a valid MSMQ message queue.

The path of the message queue must be unique for all the applications deployed on a particular computer running Speech Server and can be specified in the following formats depending on the type of queue and its location.

Queue Type	Queue Location	Format
Private	Local	.\private$\queue_name
Private	Remote	FormatName:DIRECT=OS:computer_name\private$\queue_name
Public	Local	.\queue_name
Public	Remote	computer_name\queue_name

For more information about specifying the path of message queues, see Queue Path Names.

To successfully configure Speech Server to run outbound-calling applications, the application must be added to and enabled for the computer running Speech Server and the SIP peer must be configured for outbound calling. The message queue can be running locally on the computer running Speech Server or running on a remote computer. If there are multiple instances of an application running on multiple computers with Speech Server, all the instances can share the same message queue. In some instances, if more control of the distribution of messages among multiple instances of a single application is desired, each instance can use a separate message queue. For more information, see How to: Add or Remove a Speech Server Application and How to: Add or Remove a Trusted SIP Peer.

Configuring the Application

To configure the application to use a notification message queue

1. Open the Speech Server Administrator console.

   For more information, see How to: Start the Speech Server Administrator Console.

2. In the console tree, expand the applicable group, and then click Applications.

3. In the details pane, double-click the outbound application.

4. In the Message queue box, enter the path of the message queue, and then click Apply.

   Note

   You can also configure the notification message queue through a Windows Management Instrumentation (WMI) script. For more information, see the NotificationMessageQueue property in Application Class.

See Also

Other Resources

Walkthrough: Create a Simple Outbound Application
OutboundCalls (Managed Code Sample)