RECORD_CHANNEL_START

echo_cancel

Specifies how and if echo cancellation is to be used. No echo cancellation is used when this parameter is set to RECORDSTART_NO_ECHO_CANCEL. When this parameter is set to RECORDSTART_USE_ECHO_CANCEL, Blueworx Voice Response uses the value of the SV231, (System : Echo Cancellation system variable) in the associated channel process to decide if echo cancellation can be used.

compression_type

Indicates whether the voice data should be returned in compressed (COMPRESSED_VOICE) or uncompressed (UNCOMPRESSED_VOICE) format. The only valid value is UNCOMPRESSED_VOICE.

trigger_event

This event determines when the channel starts recording data after the call is made. The trigger events listed below let you start recording on different events:

RECORDSTART_TRIGGER_IMMEDIATELY: Start recording immediately.
RECORDSTART_TRIGGER_ON_VOICE_DETECT: Start recording when the input voice threshold, controlled by system variable SV218, is exceeded.
RECORDSTART_TRIGGER_ON_DTMF: Start recording if any valid DTMF keys are detected.
Note: You cannot use CA_Simulate_Keys() to simulate this DTMF key.
RECORDSTART_TRIGGER_ON_BEEP: Start recording if the application plays a beep. Note that if the caller speaks before the beep, that voice data is not recorded.
RECORDSTART_TRIGGER_ON_PLAY: Start recording when the application starts to play voice or start immediately if the application is currently playing voice.
Note: If you are using echo cancellation, the echo from a Play or Dial action can cause recording to start unexpectedly.

historics

Allows voice data spoken before the event is triggered to be saved and passed to the custom server. The increments are in 20 millisecond intervals with a range of 0 to +50 (up to 1 second).

This parameter is used only when the trigger_event is set to RECORDSTART_TRIGGER_ON_VOICE_DETECT. For all other values of trigger_event, set historics to 0.

dtmf_filter

Specifies if DTMF tones are filtered out of the voice data stream. The values are:

RECORDSTART_DTMF_FILTER_OFF: All DTMF tones will be left in the voice data stream
RECORDSTART_DTMF_FILTER_ON: All DTMF tones will be filtered out of the voice data stream

record_stop_on_dtmf

Specifies which DTMF keys stop recording. Settings in this parameter are independent of those defined in the state table and relate only to the record channel. A recording cannot be stopped before the start is triggered.

You can define the DTMF keys yourself or use predefined arrays. The predefined arrays are:

RECORDSTOP_IGNORE_DTMF: Do not stop recording when a DTMF tone is detected.
RECORDSTOP_STE_KEYS: Stop recording on detecting the key specified in CA_STOP_KEY as well as the alternate stop keys defined in the state table system variable SV183.
RECORDSTOP_ANY_DTMF_KEY: Stop recording on any detected DTMF tone.

To define which DTMF keys are to stop recording, use a 16-character array. Valid DTMF keys are 0-9, A, B, C, D, *, # (hash). The DTMF keys are specified as elements of the array, the final element in the array must be a NULL character. For example, if you want to specify four keys, specify them as ‘125A’ in the first four elements of the array; the fifth element of the array must be a NULL character.

RECORD_CHANNEL_START_ST