The GetSpeech command enables the Caller to respond to the application using a supported language. Unlike DTMF entry, which implicitly restricts the user to using the available buttons on the phone key pad, speech input allows for flexible audio inputs based on grammar. FreeClimb supports grammars written using GRXML compatible with the Microsoft Speech Platform. GetSpeech is only supported on a single call leg. It is not supported when there are two or more call legs connected (as in within a Conference).
| Name | Type | Description | Notes |
|---|---|---|---|
| actionUrl | URI | When the caller has finished speaking or the command has timed out, FreeClimb will make a POST request to this URL. A PerCL response is expected to continue handling the call. | |
| grammarType | GrammarType | [optional] | |
| grammarFile | String | The grammar file to use for speech recognition. If grammarType is set to URL, this attribute is specified as a download URL. | |
| grammarRule | String | The grammar rule within the specified grammar file to use for speech recognition. This attribute is optional if `grammarType` is `URL` and ignored if `grammarType` is `BUILTIN`. | [optional] |
| playBeep | Boolean | Indicates whether a beep should be played just before speech recognition is initiated so that the speaker can start to speak. | [optional] |
| prompts | List<PerclCommand> | The JSON array of PerCL commands to nest within the `GetSpeech` command. The `Say`, `Play`, and `Pause` commands can be used. The nested actions are executed while FreeClimb is waiting for input from the caller. This allows for playing menu options to the caller and to prompt for the expected input. These commands stop executing when the caller begins to input speech. | [optional] |
| noInputTimeoutMs | Integer | When recognition is started and there is no speech detected for `noInputTimeoutMs` milliseconds, the recognizer will terminate the recognition operation. | [optional] |
| recognitionTimeoutMs | Integer | When playback of prompts ends and there is no match for `recognitionTimeoutMs` milliseconds, the recognizer will terminate the recognition operation. | [optional] |
| confidenceThreshold | BigDecimal | When a recognition resource recognizes a spoken phrase, it associates a confidence level with that match. Parameter `confidenceThreshold` specifies what confidence level is considered a successful match. Values are between 0.0 and 1.0. | [optional] |
| sensitivityLevel | BigDecimal | The speech recognizer supports a variable level of sound sensitivity. The sensitivityLevel attribute allows for filtering out background noise, so it is not mistaken for speech. Values are between 0.0 and 1.0 | [optional] |
| speechCompleteTimeoutMs | Integer | Parameter `speechCompleteTimeoutMs` specifies the length of silence required following user speech before the speech recognizer finalizes a result. This timeout applies when the recognizer currently has a complete match against an active grammar. Reasonable speech complete timeout values are typically in the range of 0.3 seconds to 1.0 seconds. | [optional] |
| speechIncompleteTimeoutMs | Integer | Parameter `speechIncompleteTimeoutMs` specifies the length of silence following user speech after which a recognizer finalizes a result. This timeout applies when the speech prior to the silence is an incomplete match of all active grammars. Timeout `speechIncompleteTimeoutMs` is usually longer than `speechCompleteTimeoutMs` to allow users to pause mid-utterance. | [optional] |
| privacyMode | Boolean | Parameter privacyMode will not log the `text` as required by PCI compliance. | [optional] |