How to: Specify the Called Party Address for a Speech Server Application

  • Article

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.

To route calls to an application in Speech Server, specify the called party addresses for the application to handle. These addresses usually take the form of the telephone numbers that callers dial. The following example illustrates how a call reaches the application:

  1. The caller dials a number, for example 425-555-0100.
  2. The call reaches the SIP peer trusted by the computer (with Speech Server installed) running the application.
  3. The SIP peer determines the dialed number using an information service available on digital telephony connections, such as Dialed Number Identification Service (DNIS).
  4. The SIP peer forwards the dialed number in a SIP message to Speech Server on a dedicated listening port.
  5. Speech Server receives the message and matches the dialed number to an application that is configured to receive calls to that number.
  6. After the call is redirected to another port (thereby freeing the listening port), the application answers the call.

Specifying Multiple Addresses

The called party addresses specified for an application can use regular expressions to represent one or more numbers in the telephone number string. Therefore, an asterisk (*) by itself matches every call received by the trusted SIP peer, whereas 425* matches only those calls that begin with 425. Speech Server supports any valid regular expression allowed in the .NET Framework.

By default, all new applications have an asterisk (*) in the Called Party Address box. To route calls more specifically, you must specify the phone numbers that you want the application to receive. The Called Party Address box can contain one or more phone numbers or patterns. The numbers are matched in the order in which they appear.

In cases in which the called party addresses, in more than one enabled application on a computer running Speech Server, match the same phone numbers, you can specify the priority order for applications to receive those calls. For more information, see How to: Set Call Answering Precedence for Speech Server.

Telephony Interface Manager Connector and Analog Telephony

Speech Server ignores the value specified in the Called Party Address box when you use Telephony Interface Manager Connector (TIMC) and an analog telephony board. If you have one deployed application, all calls are routed to that application (you should specify an asterisk (*) in the Called Party Address box). If you have multiple applications deployed on the same computer running Speech Server, you need to develop a separate application or script that routes incoming calls to the correct deployed voice response application.

TIMC identifies incoming analog calls in the SIP message header by the board, trunk, or port number on which the call is received. The routing application needs to read the board, trunk, or port number of the incoming call and invoke the correct application to handle the call. To find out which calls are being routed to each port on the analog board, ask the administrator for the PBX switch that receives the calls. The switch administrator should be able to identify the phone numbers that the switch routes to the physical telephony lines connected to the board.

Specifying Called Party Addresses for an Application

To specify the called party address for an application

  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 applicable application, and then do one of the following in the Called Party Address box:

    • To add a new address, click Add, type the address, and then click OK.
    • To edit an existing address, click Edit, change the address, and then click OK.
    • To remove an existing address, click Remove.

  4. Click OK.

    Note

    You can also specify the called party addresses with a Windows Management Instrumentation (WMI) script. For more information, see the DNIS property in Application Class.