Handling Telephony Transactions
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 provides 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 to answer incoming calls. |
Speech SmexMessage |
Use the Speech SmexMessage (SmexMessage) control to send raw CSTA messages and to 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 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 to answer incoming calls. The AnswerCall control 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 control 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 control and its connection logic.
When using the Voice Response Workflow Application Project Wizard to create a new voice-only speech application project in Visual Studio 2005, the Default.aspx page of the new project contains an AnswerCall control. Because of this, the Default.aspx page contains all the required connection logic. No further configuration of the AnswerCall control is required to implement this functionality.
To set AnswerCall properties
Right-click an AnswerCall control, and then click Properties.
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
In the Toolbox, drag a SmexMessage control onto the design canvas of an .aspx page.
Right-click the SmexMessage control, and then click Properties.
In the ClientSmexId box, type an ID for this control.
In the Message box, type the CSTA XML message to send.
If applicable, in the Settings box, type the ID of a SpeechControlSettingsItem control to apply to this control.
In the Timer box, type the number of milliseconds before a time-out event is triggered.
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
In the Toolbox, drag a MakeCall control onto the design canvas of an .aspx page.
Right-click the MakeCall control, and then click Properties.
In the CalledDirectoryNumber box, type the phone number to be called.
In the CallingDevice box, type the device that was used to make the outbound call.
If applicable, in the Settings box, type the ID of a SpeechControlSettingsItem control to apply to this control.
In the Timer box, type the number of milliseconds before a time-out event is triggered.
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
In the Toolbox, drag a TransferCall control onto the design canvas of an .aspx page.
Right-click the TransferCall control, and then click Properties.
In the TransferredTo box, type the ID of the device associated with the endpoint of the transfer.
If applicable, in the Settings box, type the ID of a SpeechControlSettingsItem control to apply to this control.
In the Timer box, type the number of milliseconds before a time-out event is triggered.
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
In the Toolbox, drag a DisconnectCall control onto the design canvas of an .aspx page.
Right-click the DisconnectCall control, and then click Properties.
If applicable, in the Settings box, type the ID of a SpeechControlSettingsItem control to apply to this control.
In the Timer box, type the number of milliseconds indicating the time span before a time-out event is triggered.
Enter other property values as appropriate.