telnyx 5.174.0 → 5.175.0

data/lib/telnyx/models/ai/privacy_settings.rb

@@ -16,18 +16,32 @@ module Telnyx
         optional :data_retention, Telnyx::Internal::Type::Boolean
 
         # @!attribute in_transit_data_locality
-        #   Requires every model call made for a web chat turn to be received and served
-        #   inside your organization's data-locality region, rather than only stored there.
-        #   Applies to web chat only — voice and messaging assistants are unaffected.
-        #   Enabling it requires a data-locality region with in-region inference (USA, EU,
-        #   AUS, UAE; see
-        #   [Inference regions](https://developers.telnyx.com/docs/inference/models/regions))
-        #   and Telnyx-hosted models for the assistant, its fallback, and any
-        #   conversation-flow node that overrides the model; the request is rejected
-        #   otherwise. Once enabled, send chat requests to your region's API hostname: a
-        #   request entering the platform in another region is rejected rather than
+        #   Requires this assistant's conversations to be processed inside your
+        #   organization's data-locality region, rather than only stored there, on every
+        #   channel: for web chat, every model call of a turn; for voice, the call's model
+        #   calls and the Telnyx-hosted speech services it uses; for SMS and WhatsApp, the
+        #   model calls of each turn (how messages travel through carriers is not covered).
+        #   Covered processing that cannot be handled in region fails rather than being
+        #   served elsewhere. Enabling it requires a data-locality region with in-region
+        #   inference (USA, EU, AUS, UAE; see
+        #   [Inference regions](https://developers.telnyx.com/docs/inference/models/regions)),
+        #   models for the assistant, its fallback, and any conversation-flow node that
+        #   overrides the model that are either Telnyx-hosted or a customer-provided
+        #   `external_llm` endpoint (third-party model providers are refused), and, when
+        #   `insight_settings.model` is set, an insight model available in that region; the
+        #   request is rejected otherwise. A voice call fails when it starts if its STT
+        #   model or TTS voice is not self-hosted by Telnyx, if the assistant uses a
+        #   speech-to-speech model, or if the call's media is anchored outside the region.
+        #   URLs Telnyx is configured to call — an `external_llm` endpoint, webhook tools,
+        #   Voice API callbacks, or a recording storage destination — are followed as-is:
+        #   Telnyx cannot verify where a customer-supplied URL processes requests, and
+        #   keeping those steps in your region is your responsibility. Once enabled, send
+        #   web chat requests and WebSocket or WebRTC conversations to your region's API
+        #   hostname: one entering the platform in another region is refused rather than
         #   forwarded, because forwarding it would already have moved the content across the
-        #   border. Defaults to false.
+        #   border. See
+        #   [Data residency](https://developers.telnyx.com/docs/inference/data-residency#in-region-processing-for-ai-assistants).
+        #   Defaults to false.
         #
         #   @return [Boolean, nil]
         optional :in_transit_data_locality, Telnyx::Internal::Type::Boolean
@@ -67,7 +81,7 @@ module Telnyx
         #
         #   @param data_retention [Boolean] If true, conversation history and insights will be stored. If false, they will n
         #
-        #   @param in_transit_data_locality [Boolean] Requires every model call made for a web chat turn to be received and served ins
+        #   @param in_transit_data_locality [Boolean] Requires this assistant's conversations to be processed inside your organization
         #
         #   @param pii_redaction [Symbol, Telnyx::Models::AI::PrivacySettings::PiiRedaction] Controls redaction of personally identifiable information (PII) from the convers
 

data/lib/telnyx/models/ai/start_speaking_plan.rb

@@ -8,13 +8,20 @@ module Telnyx
         #   Endpointing thresholds used to decide when the user has finished speaking.
         #   Applies to non turn-taking transcription models. For `deepgram/flux`, use
         #   `transcription.settings.eot_threshold` / `eot_timeout_ms` /
-        #   `eager_eot_threshold`.
+        #   `eager_eot_threshold`. Evaluated per turn, on each caller transcript, only while
+        #   `start_speaking_plan` is present: the tier whose suffix matches the transcript
+        #   tail is applied (a transcript with no terminal punctuation or number falls
+        #   through to `on_no_punctuation_seconds`); with no tiers configured (or a null
+        #   nested plan), the per-turn wait stays on `start_speaking_plan.wait_seconds`.
         #
         #   @return [Telnyx::Models::AI::TranscriptionEndpointingPlan, nil]
-        optional :transcription_endpointing_plan, -> { Telnyx::AI::TranscriptionEndpointingPlan }
+        optional :transcription_endpointing_plan, -> { Telnyx::AI::TranscriptionEndpointingPlan }, nil?: true
 
         # @!attribute wait_seconds
-        #   Minimum seconds to wait before the assistant starts speaking.
+        #   Wait used when per-turn endpointing does not select a tier. While the plan is
+        #   present this applies on every turn without a matching tier (including when
+        #   `transcription_endpointing_plan` is unset); a matching tier replaces it for that
+        #   turn, and a tier may be shorter or longer than this value.
         #
         #   @return [Float, nil]
         optional :wait_seconds, Float
@@ -28,9 +35,21 @@ module Telnyx
         #   turn-taking models like `deepgram/flux`, end-of-turn detection is driven by the
         #   transcription end-of-turn settings under `transcription.settings` instead.
         #
-        #   @param transcription_endpointing_plan [Telnyx::Models::AI::TranscriptionEndpointingPlan] Endpointing thresholds used to decide when the user has finished speaking. Appli
+        #   Sending any `start_speaking_plan` object — an empty `{}` included (the stored
+        #   config fills in field defaults) — engages per-turn transcript matching: on each
+        #   turn the transcript tail is evaluated against the configured
+        #   `transcription_endpointing_plan` tiers, and the wait is set to the matching
+        #   tier's seconds. When the transcript ends without terminal punctuation or a
+        #   number and `transcription_endpointing_plan` is set, its
+        #   `on_no_punctuation_seconds` tier applies. Only when no tier matches
+        #   (`transcription_endpointing_plan` unset or null) does the wait stay on
+        #   `wait_seconds`. Setting `start_speaking_plan` to `null` (or omitting it) turns
+        #   per-turn matching off entirely, and the assistant starts speaking as soon as
+        #   silence is detected.
         #
-        #   @param wait_seconds [Float] Minimum seconds to wait before the assistant starts speaking.
+        #   @param transcription_endpointing_plan [Telnyx::Models::AI::TranscriptionEndpointingPlan, nil] Endpointing thresholds used to decide when the user has finished speaking. Appli
+        #
+        #   @param wait_seconds [Float] Wait used when per-turn endpointing does not select a tier. While the plan is pr
       end
     end
   end

data/lib/telnyx/models/ai/telephony_settings.rb

@@ -42,6 +42,16 @@ module Telnyx
         #   @return [String, nil]
         optional :fallback_destination, String
 
+        # @!attribute greeting_delay_ms
+        #   Milliseconds to wait after an inbound call is answered before the assistant
+        #   starts and speaks its greeting. Increase it if the beginning of the greeting is
+        #   cut off on some connections (for example, WebRTC calls). When unset (`null`),
+        #   the platform default of 250 ms is used. Set to `0` to start without a delay.
+        #   Maximum 2000.
+        #
+        #   @return [Integer, nil]
+        optional :greeting_delay_ms, Integer, nil?: true
+
         # @!attribute noise_suppression
         #   The noise suppression engine to use. 'aicoustics' is STT-optimized and
         #   recommended for AI assistants (configure through noise_suppression_config). Use
@@ -137,7 +147,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::TelephonySettings::VoicemailDetection, nil]
         optional :voicemail_detection, -> { Telnyx::AI::TelephonySettings::VoicemailDetection }
 
-        # @!method initialize(conversation_ended_full_history: nil, default_texml_app_id: nil, disable_dtmf: nil, fallback_destination: nil, noise_suppression: nil, noise_suppression_config: nil, recording_settings: nil, send_message_history_updates: nil, supports_unauthenticated_web_calls: nil, time_limit_secs: nil, user_idle_reply_secs: nil, user_idle_timeout_secs: nil, voicemail_detection: nil)
+        # @!method initialize(conversation_ended_full_history: nil, default_texml_app_id: nil, disable_dtmf: nil, fallback_destination: nil, greeting_delay_ms: nil, noise_suppression: nil, noise_suppression_config: nil, recording_settings: nil, send_message_history_updates: nil, supports_unauthenticated_web_calls: nil, time_limit_secs: nil, user_idle_reply_secs: nil, user_idle_timeout_secs: nil, voicemail_detection: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::TelephonySettings} for more details.
         #
@@ -149,6 +159,8 @@ module Telnyx
         #
         #   @param fallback_destination [String] Destination number or SIP URI to transfer the caller to when the AI conversation
         #
+        #   @param greeting_delay_ms [Integer, nil] Milliseconds to wait after an inbound call is answered before the assistant star
+        #
         #   @param noise_suppression [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppression] The noise suppression engine to use. 'aicoustics' is STT-optimized and recommend
         #
         #   @param noise_suppression_config [Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig] Configuration for noise suppression. Applicable fields depend on the engine: 'at

data/lib/telnyx/models/ai/tests/test_framework/v1_retrieve_personalities_response.rb

@@ -62,8 +62,10 @@ module Telnyx
 
             # @!attribute generation_config
             #
-            #   @return [Object, nil]
-            optional :generation_config, Telnyx::Internal::Type::Unknown, nil?: true
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :generation_config,
+                     Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+                     nil?: true
 
             # @!attribute interruption_level
             #   How aggressively the personality interrupts the assistant.
@@ -74,13 +76,17 @@ module Telnyx
             # @!attribute message_plan
             #   Idle-timeout plan for messages during a call.
             #
-            #   @return [Object, nil]
-            optional :message_plan, Telnyx::Internal::Type::Unknown, nil?: true
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :message_plan,
+                     Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+                     nil?: true
 
             # @!attribute network_simulation
             #
-            #   @return [Object, nil]
-            optional :network_simulation, Telnyx::Internal::Type::Unknown, nil?: true
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :network_simulation,
+                     Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+                     nil?: true
 
             # @!attribute organization
             #
@@ -101,15 +107,17 @@ module Telnyx
 
             # @!attribute start_speaking_plan
             #
-            #   @return [Float, Object, nil]
+            #   @return [Float, Hash{Symbol=>Object}, nil]
             optional :start_speaking_plan,
                      union: -> { Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::StartSpeakingPlan },
                      nil?: true
 
             # @!attribute stop_speaking_plan
             #
-            #   @return [Object, nil]
-            optional :stop_speaking_plan, Telnyx::Internal::Type::Unknown, nil?: true
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :stop_speaking_plan,
+                     Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+                     nil?: true
 
             # @!attribute voice_volume
             #
@@ -137,13 +145,13 @@ module Telnyx
             #
             #   @param forked_from [Integer, nil] ID of the personality this one was forked from.
             #
-            #   @param generation_config [Object, nil]
+            #   @param generation_config [Hash{Symbol=>Object}, nil]
             #
             #   @param interruption_level [String, nil] How aggressively the personality interrupts the assistant.
             #
-            #   @param message_plan [Object, nil] Idle-timeout plan for messages during a call.
+            #   @param message_plan [Hash{Symbol=>Object}, nil] Idle-timeout plan for messages during a call.
             #
-            #   @param network_simulation [Object, nil]
+            #   @param network_simulation [Hash{Symbol=>Object}, nil]
             #
             #   @param organization [Integer, nil]
             #
@@ -151,9 +159,9 @@ module Telnyx
             #
             #   @param speed [Float, String, nil]
             #
-            #   @param start_speaking_plan [Float, Object, nil]
+            #   @param start_speaking_plan [Float, Hash{Symbol=>Object}, nil]
             #
-            #   @param stop_speaking_plan [Object, nil]
+            #   @param stop_speaking_plan [Hash{Symbol=>Object}, nil]
             #
             #   @param voice_volume [Float, nil]
 
@@ -175,10 +183,13 @@ module Telnyx
 
               variant Float
 
-              variant Telnyx::Internal::Type::Unknown
+              variant -> { Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::StartSpeakingPlan::StartSpeakingPlanObjectMap }
 
               # @!method self.variants
-              #   @return [Array(Float, Object)]
+              #   @return [Array(Float, Hash{Symbol=>Object})]
+
+              # @type [Telnyx::Internal::Type::Converter]
+              StartSpeakingPlanObjectMap = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
             end
           end
 

data/lib/telnyx/models/ai/transcription_endpointing_plan.rb

@@ -26,7 +26,11 @@ module Telnyx
         #   Endpointing thresholds used to decide when the user has finished speaking.
         #   Applies to non turn-taking transcription models. For `deepgram/flux`, use
         #   `transcription.settings.eot_threshold` / `eot_timeout_ms` /
-        #   `eager_eot_threshold`.
+        #   `eager_eot_threshold`. Evaluated per turn, on each caller transcript, only while
+        #   `start_speaking_plan` is present: the tier whose suffix matches the transcript
+        #   tail is applied (a transcript with no terminal punctuation or number falls
+        #   through to `on_no_punctuation_seconds`); with no tiers configured (or a null
+        #   nested plan), the per-turn wait stays on `start_speaking_plan.wait_seconds`.
         #
         #   @param on_no_punctuation_seconds [Float] Seconds to wait after the transcript ends without punctuation.
         #

data/lib/telnyx/models/ai/transcription_settings_config.rb

@@ -33,7 +33,8 @@ module Telnyx
         optional :enable_endpoint_detection, Telnyx::Internal::Type::Boolean
 
         # @!attribute end_of_turn_confidence_threshold
-        #   @deprecated
+        #   @deprecated Ignored. Configure AssemblyAI turn detection with min_turn_silence and
+        #   max_turn_silence instead.
         #
         #   Deprecated and ignored. Accepted for backwards compatibility. AssemblyAI turn
         #   detection is configured with min_turn_silence and max_turn_silence.

data/lib/telnyx/models/browser_session_create_params.rb

@@ -28,8 +28,8 @@ module Telnyx
       # @!attribute metadata
       #   Arbitrary key-value metadata.
       #
-      #   @return [Object, nil]
-      optional :metadata, Telnyx::Internal::Type::Unknown
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
 
       # @!method initialize(policy:, idempotency_key: nil, limits: nil, metadata: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
@@ -41,7 +41,7 @@ module Telnyx
       #
       #   @param limits [Telnyx::Models::BrowserSessionCreateParams::Limits]
       #
-      #   @param metadata [Object] Arbitrary key-value metadata.
+      #   @param metadata [Hash{Symbol=>Object}] Arbitrary key-value metadata.
       #
       #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/telnyx/models/browser_sessions/action_response.rb

@@ -35,8 +35,8 @@ module Telnyx
         #   Normalized request metadata; defaults may be materialized and fill values are
         #   redacted as {redacted: true, length: number}, including inside batch actions.
         #
-        #   @return [Object]
-        required :request, Telnyx::Internal::Type::Unknown
+        #   @return [Hash{Symbol=>Object}]
+        required :request, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
 
         # @!attribute result
         #
@@ -84,7 +84,7 @@ module Telnyx
         #
         #   @param error [Telnyx::Models::BrowserSessions::ActionResponse::Error, nil] Null unless an execution failure is recorded. Action failures (policy_denied, st
         #
-        #   @param request [Object] Normalized request metadata; defaults may be materialized and fill values are re
+        #   @param request [Hash{Symbol=>Object}] Normalized request metadata; defaults may be materialized and fill values are re
         #
         #   @param result [Telnyx::Models::BrowserSessions::ActionResponse::Result, nil]
         #
@@ -142,8 +142,9 @@ module Telnyx
           # @!attribute results
           #   Present only for batch actions.
           #
-          #   @return [Array<Object>, nil]
-          optional :results, Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+          #   @return [Array<Hash{Symbol=>Object}>, nil]
+          optional :results,
+                   Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]]
 
           # @!attribute title
           #
@@ -163,7 +164,7 @@ module Telnyx
           #
           #   @param observation [Telnyx::Models::BrowserSessions::ActionResponse::Result::Observation] Full tree and refs are delivered only in the original successful POST response w
           #
-          #   @param results [Array<Object>] Present only for batch actions.
+          #   @param results [Array<Hash{Symbol=>Object}>] Present only for batch actions.
           #
           #   @param title [String]
           #
@@ -208,8 +209,8 @@ module Telnyx
 
             # @!attribute refs
             #
-            #   @return [Object, nil]
-            optional :refs, Telnyx::Internal::Type::Unknown
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :refs, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
 
             # @!attribute title
             #
@@ -245,7 +246,7 @@ module Telnyx
             #
             #   @param ref_count [Integer] Number of refs in the original observation, present on stored observation metada
             #
-            #   @param refs [Object]
+            #   @param refs [Hash{Symbol=>Object}]
             #
             #   @param title [String]
             #

data/lib/telnyx/models/browser_sessions/wait_for_action.rb

@@ -6,7 +6,7 @@ module Telnyx
       class WaitForAction < Telnyx::Internal::Type::BaseModel
         # @!attribute condition
         #
-        #   @return [Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember0, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember1, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember2, Telnyx::Models::BrowserSessions::WaitForAction::Condition::Kind]
+        #   @return [Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember0, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember1, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember2, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember3]
         required :condition, union: -> { Telnyx::BrowserSessions::WaitForAction::Condition }
 
         # @!attribute type
@@ -32,7 +32,7 @@ module Telnyx
         # @!method initialize(condition:, idempotency_key: nil, include_observation: nil, timeout_ms: nil, type: :wait_for)
         #   Wait for a condition before continuing.
         #
-        #   @param condition [Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember0, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember1, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember2, Telnyx::Models::BrowserSessions::WaitForAction::Condition::Kind]
+        #   @param condition [Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember0, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember1, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember2, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember3]
         #   @param idempotency_key [String]
         #   @param include_observation [Boolean]
         #   @param timeout_ms [Integer]
@@ -48,7 +48,7 @@ module Telnyx
 
           variant -> { Telnyx::BrowserSessions::WaitForAction::Condition::UnionMember2 }
 
-          variant -> { Telnyx::BrowserSessions::WaitForAction::Condition::Kind }
+          variant -> { Telnyx::BrowserSessions::WaitForAction::Condition::UnionMember3 }
 
           class UnionMember0 < Telnyx::Internal::Type::BaseModel
             # @!attribute kind
@@ -104,7 +104,7 @@ module Telnyx
             #   @param kind [Symbol, :text]
           end
 
-          class Kind < Telnyx::Internal::Type::BaseModel
+          class UnionMember3 < Telnyx::Internal::Type::BaseModel
             # @!attribute kind
             #
             #   @return [Symbol, :dom_stable]
@@ -115,7 +115,7 @@ module Telnyx
           end
 
           # @!method self.variants
-          #   @return [Array(Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember0, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember1, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember2, Telnyx::Models::BrowserSessions::WaitForAction::Condition::Kind)]
+          #   @return [Array(Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember0, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember1, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember2, Telnyx::Models::BrowserSessions::WaitForAction::Condition::UnionMember3)]
         end
       end
     end

data/lib/telnyx/models/calendar_connection.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class CalendarConnection < Telnyx::Internal::Type::BaseModel
+      # @!attribute id
+      #   Calendar connection ID.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute auto_join_policy
+      #   all_meetings joins eligible events; external_organizer_excluded requires the
+      #   connected user to be the organizer; per_meeting requires an explicit opt-in.
+      #
+      #   @return [Symbol, Telnyx::Models::CalendarConnection::AutoJoinPolicy]
+      required :auto_join_policy, enum: -> { Telnyx::CalendarConnection::AutoJoinPolicy }
+
+      # @!attribute bot_name
+      #   Bot display name; null clears the override.
+      #
+      #   @return [String, nil]
+      required :bot_name, String, nil?: true
+
+      # @!attribute created_at
+      #   Creation time.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute default_assistant
+      #
+      #   @return [Telnyx::Models::MeetingSessionAssistant, nil]
+      required :default_assistant, -> { Telnyx::MeetingSessionAssistant }, nil?: true
+
+      # @!attribute default_barge_in
+      #   Default manual speech interruption. Cannot be true with default_assistant.
+      #
+      #   @return [Boolean, nil]
+      required :default_barge_in, Telnyx::Internal::Type::Boolean, nil?: true
+
+      # @!attribute default_recording
+      #   Google Meet and Teams recording intent. When null, recording is enabled only if
+      #   a destination is set. True requires default_recording_export; false cannot be
+      #   combined with a destination.
+      #
+      #   @return [Boolean, nil]
+      required :default_recording, Telnyx::Internal::Type::Boolean, nil?: true
+
+      # @!attribute default_recording_export
+      #   Customer-owned Telnyx Storage destination for recording exports. Uses the
+      #   authenticated organization and user; do not supply credentials, region,
+      #   organization ID or object key.
+      #
+      #   @return [Telnyx::Models::MeetingSessionRecordingDestination, nil]
+      required :default_recording_export, -> { Telnyx::MeetingSessionRecordingDestination }, nil?: true
+
+      # @!attribute default_summarize_on_end
+      #   Generate a summary when each future session transcript finalizes.
+      #
+      #   @return [Boolean, nil]
+      required :default_summarize_on_end, Telnyx::Internal::Type::Boolean, nil?: true
+
+      # @!attribute default_voice
+      #   Manual-speech voice; must be null when default_assistant is set.
+      #
+      #   @return [String, nil]
+      required :default_voice, String, nil?: true
+
+      # @!attribute default_webhook_url
+      #   HTTPS destination for future session webhooks. Null clears the default. A
+      #   non-null update returns webhook_secret once; save it to verify signatures for
+      #   sessions created with this default. Existing sessions retain their original
+      #   signing secret.
+      #
+      #   @return [String, nil]
+      required :default_webhook_url, String, nil?: true
+
+      # @!attribute platform
+      #   Calendar provider: Google Calendar or Microsoft Outlook.
+      #
+      #   @return [Symbol, Telnyx::Models::CalendarConnection::Platform]
+      required :platform, enum: -> { Telnyx::CalendarConnection::Platform }
+
+      # @!attribute platform_email
+      #   Connected calendar email address.
+      #
+      #   @return [String, nil]
+      required :platform_email, String, nil?: true
+
+      # @!attribute status
+      #   Connection status.
+      #
+      #   @return [Symbol, Telnyx::Models::CalendarConnection::Status]
+      required :status, enum: -> { Telnyx::CalendarConnection::Status }
+
+      # @!attribute status_detail
+      #   Additional connection status detail.
+      #
+      #   @return [String, nil]
+      required :status_detail, String, nil?: true
+
+      # @!attribute updated_at
+      #   Last update time.
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!method initialize(id:, auto_join_policy:, bot_name:, created_at:, default_assistant:, default_barge_in:, default_recording:, default_recording_export:, default_summarize_on_end:, default_voice:, default_webhook_url:, platform:, platform_email:, status:, status_detail:, updated_at:)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::CalendarConnection} for more details.
+      #
+      #   @param id [String] Calendar connection ID.
+      #
+      #   @param auto_join_policy [Symbol, Telnyx::Models::CalendarConnection::AutoJoinPolicy] all_meetings joins eligible events; external_organizer_excluded requires the con
+      #
+      #   @param bot_name [String, nil] Bot display name; null clears the override.
+      #
+      #   @param created_at [Time] Creation time.
+      #
+      #   @param default_assistant [Telnyx::Models::MeetingSessionAssistant, nil]
+      #
+      #   @param default_barge_in [Boolean, nil] Default manual speech interruption. Cannot be true with default_assistant.
+      #
+      #   @param default_recording [Boolean, nil] Google Meet and Teams recording intent. When null, recording is enabled only if
+      #
+      #   @param default_recording_export [Telnyx::Models::MeetingSessionRecordingDestination, nil] Customer-owned Telnyx Storage destination for recording exports. Uses the authen
+      #
+      #   @param default_summarize_on_end [Boolean, nil] Generate a summary when each future session transcript finalizes.
+      #
+      #   @param default_voice [String, nil] Manual-speech voice; must be null when default_assistant is set.
+      #
+      #   @param default_webhook_url [String, nil] HTTPS destination for future session webhooks. Null clears the default. A non-nu
+      #
+      #   @param platform [Symbol, Telnyx::Models::CalendarConnection::Platform] Calendar provider: Google Calendar or Microsoft Outlook.
+      #
+      #   @param platform_email [String, nil] Connected calendar email address.
+      #
+      #   @param status [Symbol, Telnyx::Models::CalendarConnection::Status] Connection status.
+      #
+      #   @param status_detail [String, nil] Additional connection status detail.
+      #
+      #   @param updated_at [Time] Last update time.
+
+      # all_meetings joins eligible events; external_organizer_excluded requires the
+      # connected user to be the organizer; per_meeting requires an explicit opt-in.
+      #
+      # @see Telnyx::Models::CalendarConnection#auto_join_policy
+      module AutoJoinPolicy
+        extend Telnyx::Internal::Type::Enum
+
+        ALL_MEETINGS = :all_meetings
+        EXTERNAL_ORGANIZER_EXCLUDED = :external_organizer_excluded
+        PER_MEETING = :per_meeting
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Calendar provider: Google Calendar or Microsoft Outlook.
+      #
+      # @see Telnyx::Models::CalendarConnection#platform
+      module Platform
+        extend Telnyx::Internal::Type::Enum
+
+        GOOGLE_CALENDAR = :google_calendar
+        MICROSOFT_OUTLOOK = :microsoft_outlook
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Connection status.
+      #
+      # @see Telnyx::Models::CalendarConnection#status
+      module Status
+        extend Telnyx::Internal::Type::Enum
+
+        CONNECTED = :connected
+        DISCONNECTED = :disconnected
+        ERROR = :error
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/calendar_connection_create_params.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::CalendarConnections#create
+    class CalendarConnectionCreateParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute platform
+      #   Calendar provider: Google Calendar or Microsoft Outlook.
+      #
+      #   @return [Symbol, Telnyx::Models::CalendarConnectionCreateParams::Platform]
+      required :platform, enum: -> { Telnyx::CalendarConnectionCreateParams::Platform }
+
+      # @!method initialize(platform:, request_options: {})
+      #   @param platform [Symbol, Telnyx::Models::CalendarConnectionCreateParams::Platform] Calendar provider: Google Calendar or Microsoft Outlook.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+      # Calendar provider: Google Calendar or Microsoft Outlook.
+      module Platform
+        extend Telnyx::Internal::Type::Enum
+
+        GOOGLE_CALENDAR = :google_calendar
+        MICROSOFT_OUTLOOK = :microsoft_outlook
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end