modules:customfield

Custom Field

Function

In cases where Fuse's built-in input modules are insufficient for the type of input a user wishes to allow, it is necessary to build a Custom Field.

For example, a user might want to collect alpha-numeric input or reference a dynamically generated custom grammar on a web server. To accomplish this, users need to fill in the Grammar section using an SRGS+XML grammar.
When the 'Custom Field' ( ) module executes, Fuse fetches and compiles the grammar. To minimize delays before the prompt begins playing for end-users, best practice is to restrict the total grammar size to 1,000 or fewer options.

To access the result of the input in subsequent modules, use the module name as the variable.


For more details on SRGS+XML grammars, please refer to the Plum Dev docs.

Important Note: Grammars can define either DTMF or Speech input rules. \\At present, Fuse does not support custom fields with grammars that include both input types at this time.


Module Settings

Barge-In
This setting allows callers to interrupt a prompt before it finishes playing.
When enabled, DTMF input interrupts the prompt and progresses the call forward in the call-flow. If speech recognition is enabled on the ensuing module in the call-flow, then end-users can also interrupt the prompt with a spoken utterance, too. Disabling barge-in forces callers to listen to the entire prompt.

A barge-in enabled module will have a dashed line on top of the text box. See example here.

Note: This setting is enabled by default.


Enable Speech Input (Menu)
This setting enables Automatic Speech Recognition (ASR) for the menu module.
A green microphone ( ) icon appears in the module when this is enabled.

Enabling speech recognition generates an additional column in the module called ‘Utterance’.
Each option line includes a DTMF input, a speech utterance, and a corresponding value.
The DTMF and speech inputs can be different, as the system expects the utterance as speech input, but the menu variable will carry the actual value.



With the example above, if the user press 1 or says “Eastern”, the sample_voice_menu variable will carry the value “est”.

Note: Utterance is required to be filled when expecting any speech input. Even if the utterance is the same as value, the utterance field cannot be blank.
For accepting multiple utterances for a selection, a new, separate choice needs to be created and they can both branch into the same module, or have the same value.

The audio manager auto-generates prompts for these options in the format of “For <value>, Press <DTMF> or say <utterance>”.

To set the utterance for other languages in the application, the corresponding language tab in audio manager will have an utterance entry for each choice, along with an utterance icon ( ) in the left and the primary language text underneath for identification.

Private
This setting controls the logging function of a module.
Enabling the 'Private' setting instructs the module to not record, report, or retain the information input to that module for reporting or any other purposes. When enabled any information entered into a module during a call will be lost immediately when the call terminates.
The 'Private' setting is critical for businesses that need to maintain PCI-DSS or HIPAA compliance.

The module icon, in the upper left-hand corner, becomes grayed-out when this setting is enabled. See more details here.

Show Custom Errors
Enabling this setting overrides the default, global error options set in the Application Settings > User Input Settings.
This allows users to establish custom error handling in order to act on errors in a specific way in that module.
Instead of progressing to the next module in the call-flow, custom error handling allows users to re-prompt the same module, to provide a custom error message, to re-direct the call based on the error, or any other desired behavior.



Adding multiple errors ( ) to a module functions behave the same way as a counter.
The first error follows the path for the first error listed, if a second error occurs in the same module it follows the second listed error, and so on until all errors are exhausted or an error directs the end-user away from that module.

No Input occurs when the caller does not provide an input based on the timeout settings.
This is based on the “Initial input timeout” in User Input Settings

No Match occurs when the caller input does not match the module's criteria for the input module.

Advanced Settings: Advanced Fuse users may want to use shadow variables that are available with input modules. For more information on this functionality, please visit the Shadow Variables page.

modules/customfield.txt · Last modified: 2018/08/28 15:22 by admin