revox 0.2.0 → 0.3.0

data/lib/revox/models/campaign_update_params.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+module Revox
+  module Models
+    # @see Revox::Resources::Campaigns#update
+    class CampaignUpdateParams < Revox::Internal::Type::BaseModel
+      extend Revox::Internal::Type::RequestParameters::Converter
+      include Revox::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute assistant_id
+      #   The ID of the assistant to use (draft only)
+      #
+      #   @return [String, nil]
+      optional :assistant_id, String
+
+      # @!attribute call_retry_config
+      #   Configuration for call retry behavior including time windows, delays, and max
+      #   iterations. If not provided, defaults will be used.
+      #
+      #   @return [Revox::Models::CampaignUpdateParams::CallRetryConfig, nil]
+      optional :call_retry_config, -> { Revox::CampaignUpdateParams::CallRetryConfig }, nil?: true
+
+      # @!attribute contacts
+      #   Replace contact list (draft only)
+      #
+      #   @return [Array<Revox::Models::CampaignUpdateParams::Contact>, nil]
+      optional :contacts, -> { Revox::Internal::Type::ArrayOf[Revox::CampaignUpdateParams::Contact] }
+
+      # @!attribute from_phone_number
+      #   The phone number to use for outbound calls (draft only)
+      #
+      #   @return [String, nil]
+      optional :from_phone_number, String, nil?: true
+
+      # @!attribute max_concurrent_calls
+      #   Maximum concurrent calls (draft only)
+      #
+      #   @return [Float, nil]
+      optional :max_concurrent_calls, Float, nil?: true
+
+      # @!attribute name
+      #   Campaign display name
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute scheduled_at
+      #   Scheduled start time (draft only)
+      #
+      #   @return [Time, Object, nil]
+      optional :scheduled_at, union: -> { Revox::CampaignUpdateParams::ScheduledAt }, nil?: true
+
+      # @!attribute type
+      #   Campaign type (draft only)
+      #
+      #   @return [Symbol, Revox::Models::CampaignUpdateParams::Type, nil]
+      optional :type, enum: -> { Revox::CampaignUpdateParams::Type }
+
+      # @!method initialize(id:, assistant_id: nil, call_retry_config: nil, contacts: nil, from_phone_number: nil, max_concurrent_calls: nil, name: nil, scheduled_at: nil, type: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Revox::Models::CampaignUpdateParams} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param assistant_id [String] The ID of the assistant to use (draft only)
+      #
+      #   @param call_retry_config [Revox::Models::CampaignUpdateParams::CallRetryConfig, nil] Configuration for call retry behavior including time windows, delays, and max it
+      #
+      #   @param contacts [Array<Revox::Models::CampaignUpdateParams::Contact>] Replace contact list (draft only)
+      #
+      #   @param from_phone_number [String, nil] The phone number to use for outbound calls (draft only)
+      #
+      #   @param max_concurrent_calls [Float, nil] Maximum concurrent calls (draft only)
+      #
+      #   @param name [String] Campaign display name
+      #
+      #   @param scheduled_at [Time, Object, nil] Scheduled start time (draft only)
+      #
+      #   @param type [Symbol, Revox::Models::CampaignUpdateParams::Type] Campaign type (draft only)
+      #
+      #   @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}]
+
+      class CallRetryConfig < Revox::Internal::Type::BaseModel
+        # @!attribute allowed_days
+        #   Days of the week when calls are allowed, in the recipient's timezone. Default:
+        #   Monday through Friday.
+        #
+        #   @return [Array<Symbol, Revox::Models::CampaignUpdateParams::CallRetryConfig::AllowedDay>]
+        required :allowed_days,
+                 -> { Revox::Internal::Type::ArrayOf[enum: Revox::CampaignUpdateParams::CallRetryConfig::AllowedDay] }
+
+        # @!attribute call_twice_in_a_row
+        #   If true and max_retry_attempts >= 2, attempt #2 fires immediately (skipping
+        #   retry_delay_seconds) when attempt #1 didn't reach a human.
+        #   Calling-window/allowed-days checks still apply. Only affects the 1→2 transition.
+        #   Default: false.
+        #
+        #   @return [Boolean]
+        required :call_twice_in_a_row, Revox::Internal::Type::Boolean
+
+        # @!attribute calling_windows
+        #
+        #   @return [Array<Revox::Models::CampaignUpdateParams::CallRetryConfig::CallingWindow>]
+        required :calling_windows,
+                 -> { Revox::Internal::Type::ArrayOf[Revox::CampaignUpdateParams::CallRetryConfig::CallingWindow] }
+
+        # @!attribute max_retry_attempts
+        #   Maximum number of call retry attempts. Default: 3.
+        #
+        #   @return [Integer]
+        required :max_retry_attempts, Integer
+
+        # @!attribute timezone
+        #   Optional IANA timezone identifier to override the automatic timezone detection
+        #   from phone number. If not provided, timezone is determined from the recipient's
+        #   phone number country code. Examples: 'America/New_York', 'Europe/Paris'.
+        #
+        #   @return [String, nil]
+        optional :timezone, String, nil?: true
+
+        # @!method initialize(allowed_days:, call_twice_in_a_row:, calling_windows:, max_retry_attempts:, timezone: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Revox::Models::CampaignUpdateParams::CallRetryConfig} for more details.
+        #
+        #   Configuration for call retry behavior including time windows, delays, and max
+        #   iterations. If not provided, defaults will be used.
+        #
+        #   @param allowed_days [Array<Symbol, Revox::Models::CampaignUpdateParams::CallRetryConfig::AllowedDay>] Days of the week when calls are allowed, in the recipient's timezone. Default: M
+        #
+        #   @param call_twice_in_a_row [Boolean] If true and max_retry_attempts >= 2, attempt #2 fires immediately (skipping retr
+        #
+        #   @param calling_windows [Array<Revox::Models::CampaignUpdateParams::CallRetryConfig::CallingWindow>]
+        #
+        #   @param max_retry_attempts [Integer] Maximum number of call retry attempts. Default: 3.
+        #
+        #   @param timezone [String, nil] Optional IANA timezone identifier to override the automatic timezone detection f
+
+        module AllowedDay
+          extend Revox::Internal::Type::Enum
+
+          MONDAY = :monday
+          TUESDAY = :tuesday
+          WEDNESDAY = :wednesday
+          THURSDAY = :thursday
+          FRIDAY = :friday
+          SATURDAY = :saturday
+          SUNDAY = :sunday
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        class CallingWindow < Revox::Internal::Type::BaseModel
+          # @!attribute calling_window_end_time
+          #   End time for the calling window in the recipient's timezone (or
+          #   timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
+          #   Examples: '17:00', '6pm'. Default: '18:00'.
+          #
+          #   @return [String]
+          required :calling_window_end_time, String
+
+          # @!attribute calling_window_start_time
+          #   Start time for the calling window in the recipient's timezone (or
+          #   timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
+          #   Examples: '09:00', '10am'. Default: '10:00'.
+          #
+          #   @return [String]
+          required :calling_window_start_time, String
+
+          # @!attribute retry_delay_seconds
+          #   Delay between retry attempts in seconds. Default: 7200 (2 hours).
+          #
+          #   @return [Integer]
+          required :retry_delay_seconds, Integer
+
+          # @!method initialize(calling_window_end_time:, calling_window_start_time:, retry_delay_seconds:)
+          #   Some parameter documentations has been truncated, see
+          #   {Revox::Models::CampaignUpdateParams::CallRetryConfig::CallingWindow} for more
+          #   details.
+          #
+          #   @param calling_window_end_time [String] End time for the calling window in the recipient's timezone (or timezone_overrid
+          #
+          #   @param calling_window_start_time [String] Start time for the calling window in the recipient's timezone (or timezone_overr
+          #
+          #   @param retry_delay_seconds [Integer] Delay between retry attempts in seconds. Default: 7200 (2 hours).
+        end
+      end
+
+      class Contact < Revox::Internal::Type::BaseModel
+        # @!attribute prompt_variables
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :prompt_variables, Revox::Internal::Type::HashOf[String]
+
+        # @!attribute to_phone_number
+        #
+        #   @return [String]
+        required :to_phone_number, String
+
+        # @!method initialize(prompt_variables:, to_phone_number:)
+        #   @param prompt_variables [Hash{Symbol=>String}]
+        #   @param to_phone_number [String]
+      end
+
+      # Scheduled start time (draft only)
+      module ScheduledAt
+        extend Revox::Internal::Type::Union
+
+        variant Time
+
+        variant Revox::Internal::Type::Unknown
+
+        # @!method self.variants
+        #   @return [Array(Time, Object)]
+      end
+
+      # Campaign type (draft only)
+      module Type
+        extend Revox::Internal::Type::Enum
+
+        REGULAR = :regular
+        JUMP_IN = :jump_in
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end