Handling Telephony Transactions

The Microsoft Speech Application SDK Version 1.1 (SASDK) provides Microsoft ASP.NET Speech Controls that support Computer Supported Telecommunications Applications (CSTA) XML messages.

Speech Control	Description
Speech AnswerCall	Use the Speech AnswerCall (AnswerCall) control to add connection logic to the Start page of an application and answer incoming calls.
Speech SmexMessage	Use the Speech SmexMessage (SmexMessage) control to send raw CSTA messages and receive CSTA events.
Speech TransferCall	Use the Speech TransferCall (TransferCall) control to transfer the current call using the CSTA SingleStepTransfer service.
Speech MakeCall	Use the Speech MakeCall (MakeCall) control to initiate a call using the CSTA MakeCall service.
Speech DisconnectCall	Use the Speech DisconnectCall (DisconnectCall) control to disconnect a call using the CSTA ClearConnection service.

Property Builders do not exist for the previous controls as they do for the Microsoft ASP.NET Application Speech Controls and the other Speech Controls. Specify properties for these CSTA controls using the Properties window of each control.

• Adding Connection Logic and Answering Incoming Calls
• Receiving Incoming Calls
• Initiating Calls
• Transferring Calls
• Terminating or Disconnecting Calls

Adding Connection Logic and Answering Incoming Calls

Use the AnswerCall control to add telephony connection logic to an application, and answer incoming calls. The AnswerCall contains the connection logic for voice-only applications, and is typically placed on the first page, or Start page, of an application.

Use the following two points as general guidelines when configuring voice-only applications.

• In a telephony deployment that includes only one application, the Start page of the application should contain the AnswerCall and its connection logic.
• In a telephony deployment that includes more than one application, create a Start page that contains logic for switching between the applications, based on the number called or some other characteristic of the call. The Start page should then invoke the first page of the appropriate application, which contains the AnswerCall and its connection logic.

When using the Speech Web Application Project Wizard to create a new voice-only speech application project in Visual Studio .NET 2003, the default.aspx page of the new project contains an AnswerCall by default. Because of this, the default.aspx page contains all of the required connection logic. No further configuration of the AnswerCall is required to implement this functionality.

Note  The Start page of an application must contain an AnswerCall in order to use Telephony Application Simulator during debugging.

To set AnswerCall properties

1. Right-click an AnswerCall control, and on the shortcut menu, click Properties.
2. Enter property values as appropriate.

Receiving Incoming Calls

Use the SmexMessage control to send raw CSTA messages and receive CSTA events.

To set SmexMessage properties

1. From the Speech Toolbox, drag a SmexMessage control onto the design canvas of an .aspx page.
2. Right-click the SmexMessage control, and in the shortcut menu, click Properties.
3. In the ClientSmexId box of the Properties window, type an ID for this control.
4. In the Message box of the Properties window, type the CSTA XML message to send.
5. If applicable, in the Settings box of the Properties window, type the ID of a SpeechControlSettingsItem to apply to this control.
6. In the Timer box of the Properties window, type the number of milliseconds indicating the time span before a time-out event is triggered.
7. Enter other property values as appropriate.

Initiating Calls

Use the MakeCall control to initiate a call using the CSTA MakeCall service.

To set MakeCall properties

1. From the Speech Toolbox, drag a MakeCall control onto the design canvas of an .aspx page.
2. Right-click the MakeCall control, and in the shortcut menu, click Properties.
3. In the CalledDirectoryNumber box of the Properties window, type the phone number to be called.
4. In the CallingDevice box of the Properties window, type the device that was used to make the outbound call.
5. If applicable, in the Settings box of the Properties window, type the ID of a SpeechControlSettingsItem to apply to this control.
6. In the Timer box of the Properties window, type the number of milliseconds indicating the time span before a time-out event is triggered.
7. Enter other property values as appropriate.

Transferring Calls

Use the TransferCall control to transfer the current call using the CSTA SingleStepTransfer service.

To set TransferCall properties

1. From the Speech Toolbox, drag a TransferCall control onto the design canvas of an .aspx page.
2. Right-click the TransferCall control, and in the shortcut menu, click Properties.
3. In the TransferredTo box of the Properties window, type the ID of the device associated with the endpoint of the transfer.
4. If applicable, in the Settings box of the Properties window, type the ID of a SpeechControlSettingsItem to apply to this control.
5. In the Timer box of the Properties window, type the number of milliseconds indicating the time span before a time-out event is triggered.
6. Enter other property values as appropriate.

Terminating or Disconnecting Calls

Use the DisconnectCall control to disconnect a call using the CSTA ClearConnection service.

To set DisconnectCall properties

1. From the Speech Toolbox, drag a DisconnectCall control onto the design canvas of an .aspx page.
2. Right-click the DisconnectCall control, and in the shortcut menu, click Properties.
3. If applicable, in the Settings box of the Properties window, type the ID of a SpeechControlSettingsItem to apply to this control.
4. In the Timer box of the Properties window, type the number of milliseconds indicating the time span before a time-out event is triggered.
5. Enter other property values as appropriate.

See Also

Creating Speech-Enabled Web Pages