Class: Telnyx::Models::Calls::ActionStartRecordingParams

Inherits:

Internal::Type::BaseModel

• Object
• Internal::Type::BaseModel
• Telnyx::Models::Calls::ActionStartRecordingParams

Extended by:

Internal::Type::RequestParameters::Converter

Includes:

Internal::Type::RequestParameters

Defined in:

lib/telnyx/models/calls/action_start_recording_params.rb

Overview

See Also:

• Resources::Calls::Actions#start_recording

Defined Under Namespace

Modules: Channels, Format, RecordingTrack, TranscriptionEngine, TranscriptionLanguage, Trim

Instance Attribute Summary

• #call_control_id ⇒ String
• #channels ⇒ Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Channels

  When ‘dual`, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

• #client_state ⇒ String^?

  Use this field to add state to every subsequent webhook.

• #command_id ⇒ String^?

  Use this field to avoid duplicate commands.

• #custom_file_name ⇒ String^?

  The custom recording file name to be used instead of the default ‘call_leg_id`.

• #format_ ⇒ Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Format

  The audio file format used when storing the call recording.

• #max_length ⇒ Integer^?

  Defines the maximum length for the recording in seconds.

• #play_beep ⇒ Boolean^?

  If enabled, a beep sound will be played at the start of a recording.

• #recording_track ⇒ Symbol, ...

  The audio track to be recorded.

• #timeout_secs ⇒ Integer^?

  The number of seconds that Telnyx will wait for the recording to be stopped if silence is detected.

• #transcription ⇒ Boolean^?

  Enable post recording transcription.

• #transcription_engine ⇒ Symbol, ...

  Engine to use for speech recognition.

• #transcription_language ⇒ Symbol, ...

  Language code for transcription.

• #transcription_max_speaker_count ⇒ Integer^?

  Defines maximum number of speakers in the conversation.

• #transcription_min_speaker_count ⇒ Integer^?

  Defines minimum number of speakers in the conversation.

• #transcription_profanity_filter ⇒ Boolean^?

  Enables profanity_filter.

• #transcription_speaker_diarization ⇒ Boolean^?

  Enables speaker diarization.

• #trim ⇒ Symbol, ...

  When set to ‘trim-silence`, silence will be removed from the beginning and end of the recording.

Attributes included from Internal::Type::RequestParameters

#request_options

Class Method Summary

• .values ⇒ Array<Symbol>

Instance Method Summary

• #initialize(call_control_id:, channels:, format_:, client_state: nil, command_id: nil, custom_file_name: nil, max_length: nil, play_beep: nil, recording_track: nil, timeout_secs: nil, transcription: nil, transcription_engine: nil, transcription_language: nil, transcription_max_speaker_count: nil, transcription_min_speaker_count: nil, transcription_profanity_filter: nil, transcription_speaker_diarization: nil, trim: nil, request_options: {}) ⇒ Object constructor

  Some parameter documentations has been truncated, see ActionStartRecordingParams for more details.

Methods included from Internal::Type::RequestParameters::Converter

dump_request

Methods included from Internal::Type::RequestParameters

included

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, #inspect, inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(call_control_id:, channels:, format_:, client_state: nil, command_id: nil, custom_file_name: nil, max_length: nil, play_beep: nil, recording_track: nil, timeout_secs: nil, transcription: nil, transcription_engine: nil, transcription_language: nil, transcription_max_speaker_count: nil, transcription_min_speaker_count: nil, transcription_profanity_filter: nil, transcription_speaker_diarization: nil, trim: nil, request_options: {}) ⇒ Object

Some parameter documentations has been truncated, see Telnyx::Models::Calls::ActionStartRecordingParams for more details.

Parameters:

• call_control_id (String)
• channels (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Channels) —

  When ‘dual`, final audio file will be stereo recorded with the first leg on chan

• format_ (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Format) —

  The audio file format used when storing the call recording. Can be either ‘mp3`

• client_state (String) (defaults to: nil) —

  Use this field to add state to every subsequent webhook. It must be a valid Base

• command_id (String) (defaults to: nil) —

  Use this field to avoid duplicate commands. Telnyx will ignore any command with

• custom_file_name (String) (defaults to: nil) —

  The custom recording file name to be used instead of the default ‘call_leg_id`.

• max_length (Integer) (defaults to: nil) —

  Defines the maximum length for the recording in seconds. The minimum value is 0.

• play_beep (Boolean) (defaults to: nil) —

  If enabled, a beep sound will be played at the start of a recording.

• recording_track (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::RecordingTrack) (defaults to: nil) —

  The audio track to be recorded. Can be either ‘both`, `inbound` or `outbound`. I

• timeout_secs (Integer) (defaults to: nil) —

  The number of seconds that Telnyx will wait for the recording to be stopped if s

• transcription (Boolean) (defaults to: nil) —

  Enable post recording transcription. The default value is false.

• transcription_engine (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::TranscriptionEngine) (defaults to: nil) —

  Engine to use for speech recognition. ‘A` - `Google`, `B` - `Telnyx`, `deepgram/

• transcription_language (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::TranscriptionLanguage) (defaults to: nil) —

  Language code for transcription. Note: Not all languages are supported by all tr

• transcription_max_speaker_count (Integer) (defaults to: nil) —

  Defines maximum number of speakers in the conversation. Applies to ‘google` engi

• transcription_min_speaker_count (Integer) (defaults to: nil) —

  Defines minimum number of speakers in the conversation. Applies to ‘google` engi

• transcription_profanity_filter (Boolean) (defaults to: nil) —

  Enables profanity_filter. Applies to ‘google` engine only.

• transcription_speaker_diarization (Boolean) (defaults to: nil) —

  Enables speaker diarization. Applies to ‘google` engine only.

• trim (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Trim) (defaults to: nil) —

  When set to ‘trim-silence`, silence will be removed from the beginning and end o

• request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}) (defaults to: {})

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 138

Instance Attribute Details

#call_control_id ⇒ String

Returns:

• (String)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 14

required :call_control_id, String

#channels ⇒ Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Channels

When ‘dual`, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

Returns:

• (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Channels)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 21

required :channels, enum: -> { Telnyx::Calls::ActionStartRecordingParams::Channels }

#client_state ⇒ String^?

Use this field to add state to every subsequent webhook. It must be a valid Base-64 encoded string.

Returns:

• (String, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 35

optional :client_state, String

#command_id ⇒ String^?

Use this field to avoid duplicate commands. Telnyx will ignore any command with the same ‘command_id` for the same `call_control_id`.

Returns:

• (String, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 42

optional :command_id, String

#custom_file_name ⇒ String^?

The custom recording file name to be used instead of the default ‘call_leg_id`. Telnyx will still add a Unix timestamp suffix.

Returns:

• (String, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 49

optional :custom_file_name, String

#format_ ⇒ Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Format

The audio file format used when storing the call recording. Can be either ‘mp3` or `wav`.

Returns:

• (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Format)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 28

required :format_, enum: -> { Telnyx::Calls::ActionStartRecordingParams::Format }, api_name: :format

#max_length ⇒ Integer^?

Defines the maximum length for the recording in seconds. The minimum value is 0. The maximum value is 14400. The default value is 0 (infinite)

Returns:

• (Integer, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 56

optional :max_length, Integer

#play_beep ⇒ Boolean^?

If enabled, a beep sound will be played at the start of a recording.

Returns:

• (Boolean, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 62

optional :play_beep, Telnyx::Internal::Type::Boolean

#recording_track ⇒ Symbol, ...

The audio track to be recorded. Can be either ‘both`, `inbound` or `outbound`. If only single track is specified (`inbound`, `outbound`), `channels` configuration is ignored and it will be recorded as mono (single channel).

Returns:

• (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::RecordingTrack, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 70

optional :recording_track, enum: -> { Telnyx::Calls::ActionStartRecordingParams::RecordingTrack }

#timeout_secs ⇒ Integer^?

The number of seconds that Telnyx will wait for the recording to be stopped if silence is detected. The timer only starts when the speech is detected. Please note that call transcription is used to detect silence and the related charge will be applied. The minimum value is 0. The default value is 0 (infinite)

Returns:

• (Integer, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 79

optional :timeout_secs, Integer

#transcription ⇒ Boolean^?

Enable post recording transcription. The default value is false.

Returns:

• (Boolean, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 85

optional :transcription, Telnyx::Internal::Type::Boolean

#transcription_engine ⇒ Symbol, ...

Engine to use for speech recognition. ‘A` - `Google`, `B` - `Telnyx`, `deepgram/nova-3` - `Deepgram Nova-3`. Note: `deepgram/nova-3` supports only `en` and `en-Region` languages.

Returns:

• (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::TranscriptionEngine, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 93

optional :transcription_engine,
enum: -> { Telnyx::Calls::ActionStartRecordingParams::TranscriptionEngine }

#transcription_language ⇒ Symbol, ...

Language code for transcription. Note: Not all languages are supported by all transcription engines (google, telnyx, deepgram). See engine-specific documentation for supported values.

Returns:

• (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::TranscriptionLanguage, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 102

optional :transcription_language,
enum: -> { Telnyx::Calls::ActionStartRecordingParams::TranscriptionLanguage }

#transcription_max_speaker_count ⇒ Integer^?

Defines maximum number of speakers in the conversation. Applies to ‘google` engine only.

Returns:

• (Integer, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 110

optional :transcription_max_speaker_count, Integer

#transcription_min_speaker_count ⇒ Integer^?

Defines minimum number of speakers in the conversation. Applies to ‘google` engine only.

Returns:

• (Integer, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 117

optional :transcription_min_speaker_count, Integer

#transcription_profanity_filter ⇒ Boolean^?

Enables profanity_filter. Applies to ‘google` engine only.

Returns:

• (Boolean, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 123

optional :transcription_profanity_filter, Telnyx::Internal::Type::Boolean

#transcription_speaker_diarization ⇒ Boolean^?

Enables speaker diarization. Applies to ‘google` engine only.

Returns:

• (Boolean, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 129

optional :transcription_speaker_diarization, Telnyx::Internal::Type::Boolean

#trim ⇒ Symbol, ...

When set to ‘trim-silence`, silence will be removed from the beginning and end of the recording.

Returns:

• (Symbol, Telnyx::Models::Calls::ActionStartRecordingParams::Trim, nil)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 136

optional :trim, enum: -> { Telnyx::Calls::ActionStartRecordingParams::Trim }

Class Method Details

.values ⇒ Array<Symbol>

Returns:

• (Array<Symbol>)

# File 'lib/telnyx/models/calls/action_start_recording_params.rb', line 188