revox 0.3.0 → 0.4.0

data/lib/revox/models/phone_number_update_response.rb

@@ -209,13 +209,6 @@ module Revox
           #   @return [String, nil]
           required :email_notification_address, String, nil?: true
 
-          # @!attribute email_notification_language
-          #   The language used for the notification email content. One of "en" or "fr".
-          #
-          #   @return [Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage]
-          required :email_notification_language,
-                   enum: -> { Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage }
-
           # @!attribute email_notification_outcomes
           #   Which call outcomes trigger an email notification. E.g. ["interested",
           #   "completed", "none"]. Use "none" when outcome is null.
@@ -255,8 +248,8 @@ module Revox
           required :from_phone_number, String, nil?: true
 
           # @!attribute human_transfer_mode
-          #   Warm or cold transfer when transfer_phone_number is set; null when transfer is
-          #   not configured.
+          #   Warm or cold transfer when transfer_destinations is non-empty; null when
+          #   transfer is not configured.
           #
           #   @return [Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::HumanTransferMode, nil]
           required :human_transfer_mode,
@@ -315,6 +308,13 @@ module Revox
                    -> { Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Position },
                    nil?: true
 
+          # @!attribute precall_lookup_url
+          #   URL fetched before an inbound call is answered to resolve the assistant's prompt
+          #   variables. Null when no lookup is configured.
+          #
+          #   @return [String, nil]
+          required :precall_lookup_url, String, nil?: true
+
           # @!attribute prompt
           #
           #   @return [String]
@@ -405,11 +405,14 @@ module Revox
           #   @return [Float]
           required :thinking_sound_volume, Float
 
-          # @!attribute transfer_phone_number
-          #   Phone number to transfer calls to when users request to speak to a human agent.
+          # @!attribute transfer_destinations
+          #   Where calls can be transferred to when users ask to speak to a human. Null or
+          #   empty when transfer is not configured.
           #
-          #   @return [String, nil]
-          required :transfer_phone_number, String, nil?: true
+          #   @return [Array<Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::TransferDestination>, nil]
+          required :transfer_destinations,
+                   -> { Revox::Internal::Type::ArrayOf[Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::TransferDestination] },
+                   nil?: true
 
           # @!attribute type
           #
@@ -476,6 +479,11 @@ module Revox
           optional :faq_items,
                    -> { Revox::Internal::Type::ArrayOf[Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::FaqItem] }
 
+          # @!attribute is_inbound_receptionist
+          #
+          #   @return [Boolean, nil]
+          optional :is_inbound_receptionist, Revox::Internal::Type::Boolean
+
           # @!attribute is_realestate_assistant
           #
           #   @return [Boolean, nil]
@@ -486,7 +494,7 @@ module Revox
           #   @return [Float, nil]
           optional :pending_faq_count, Float
 
-          # @!method initialize(id:, after_call_sms_outcomes:, after_call_sms_prompt:, background_sound:, background_sound_volume:, calendly:, call_retry_config:, cartesia_dictionary_pronunciation_id:, created_at:, custom_tools:, email_notification_address:, email_notification_language:, email_notification_outcomes:, end_of_call_sentence:, first_sentence:, first_sentence_delay_ms:, first_sentence_mode:, from_phone_number:, human_transfer_mode:, ivr_navigation_enabled:, llm_model:, logo_url:, max_call_duration_secs:, max_duration_end_message:, name:, organization_id:, position:, prompt:, prompt_flow:, slack:, sms_enabled:, sms_template:, structured_output_config:, structured_output_prompt:, stt_context:, stt_model:, thinking_sound:, thinking_sound_probability:, thinking_sound_volume:, transfer_phone_number:, type:, updated_at:, voice:, voicemail_message:, voicemail_sms_prompt:, warm_transfer_summary_instructions:, webhook_url:, zoho:, created_by: nil, faq_items: nil, is_realestate_assistant: nil, pending_faq_count: nil)
+          # @!method initialize(id:, after_call_sms_outcomes:, after_call_sms_prompt:, background_sound:, background_sound_volume:, calendly:, call_retry_config:, cartesia_dictionary_pronunciation_id:, created_at:, custom_tools:, email_notification_address:, email_notification_outcomes:, end_of_call_sentence:, first_sentence:, first_sentence_delay_ms:, first_sentence_mode:, from_phone_number:, human_transfer_mode:, ivr_navigation_enabled:, llm_model:, logo_url:, max_call_duration_secs:, max_duration_end_message:, name:, organization_id:, position:, precall_lookup_url:, prompt:, prompt_flow:, slack:, sms_enabled:, sms_template:, structured_output_config:, structured_output_prompt:, stt_context:, stt_model:, thinking_sound:, thinking_sound_probability:, thinking_sound_volume:, transfer_destinations:, type:, updated_at:, voice:, voicemail_message:, voicemail_sms_prompt:, warm_transfer_summary_instructions:, webhook_url:, zoho:, created_by: nil, faq_items: nil, is_inbound_receptionist: nil, is_realestate_assistant: nil, pending_faq_count: nil)
           #   Some parameter documentations has been truncated, see
           #   {Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant} for
           #   more details.
@@ -513,8 +521,6 @@ module Revox
           #
           #   @param email_notification_address [String, nil] Email address(es) to receive notifications when a call ends with a matching outc
           #
-          #   @param email_notification_language [Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage] The language used for the notification email content. One of "en" or "fr".
-          #
           #   @param email_notification_outcomes [Array<Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::EmailNotificationOutcome>, nil] Which call outcomes trigger an email notification. E.g. ["interested", "complete
           #
           #   @param end_of_call_sentence [String, nil]
@@ -527,7 +533,7 @@ module Revox
           #
           #   @param from_phone_number [String, nil] Override the default outbound phone number for calls placed with this assistant.
           #
-          #   @param human_transfer_mode [Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::HumanTransferMode, nil] Warm or cold transfer when transfer_phone_number is set; null when transfer is n
+          #   @param human_transfer_mode [Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::HumanTransferMode, nil] Warm or cold transfer when transfer_destinations is non-empty; null when transfe
           #
           #   @param ivr_navigation_enabled [Boolean] Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
           #
@@ -545,6 +551,8 @@ module Revox
           #
           #   @param position [Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Position, nil]
           #
+          #   @param precall_lookup_url [String, nil] URL fetched before an inbound call is answered to resolve the assistant's prompt
+          #
           #   @param prompt [String]
           #
           #   @param prompt_flow [Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::PromptFlow, nil]
@@ -569,7 +577,7 @@ module Revox
           #
           #   @param thinking_sound_volume [Float] Volume of the thinking sound (0 = silent, 1 = max).
           #
-          #   @param transfer_phone_number [String, nil] Phone number to transfer calls to when users request to speak to a human agent.
+          #   @param transfer_destinations [Array<Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::TransferDestination>, nil] Where calls can be transferred to when users ask to speak to a human. Null or em
           #
           #   @param type [Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Type]
           #
@@ -591,6 +599,8 @@ module Revox
           #
           #   @param faq_items [Array<Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::FaqItem>]
           #
+          #   @param is_inbound_receptionist [Boolean]
+          #
           #   @param is_realestate_assistant [Boolean]
           #
           #   @param pending_faq_count [Float]
@@ -602,9 +612,6 @@ module Revox
             INTERESTED = :interested
             COMPLETED = :completed
             REQUESTED_CALLBACK_LATER = :requested_callback_later
-            REQUESTED_CALLBACK_NEW_NUMBER = :requested_callback_new_number
-            DO_NOT_CONTACT = :do_not_contact
-            AI_AVERSE = :ai_averse
             NONE = :none
 
             # @!method self.values
@@ -738,7 +745,8 @@ module Revox
               required :calling_window_start_time, String
 
               # @!attribute retry_delay_seconds
-              #   Delay between retry attempts in seconds. Default: 7200 (2 hours).
+              #   Delay between retry attempts in seconds. 0 retries as soon as the calling window
+              #   allows. Default: 7200 (2 hours).
               #
               #   @return [Integer]
               required :retry_delay_seconds, Integer
@@ -752,7 +760,7 @@ module Revox
               #
               #   @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).
+              #   @param retry_delay_seconds [Integer] Delay between retry attempts in seconds. 0 retries as soon as the calling window
             end
           end
 
@@ -935,19 +943,6 @@ module Revox
             end
           end
 
-          # The language used for the notification email content. One of "en" or "fr".
-          #
-          # @see Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant#email_notification_language
-          module EmailNotificationLanguage
-            extend Revox::Internal::Type::Enum
-
-            EN = :en
-            FR = :fr
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-
           module EmailNotificationOutcome
             extend Revox::Internal::Type::Enum
 
@@ -955,9 +950,6 @@ module Revox
             INTERESTED = :interested
             COMPLETED = :completed
             REQUESTED_CALLBACK_LATER = :requested_callback_later
-            REQUESTED_CALLBACK_NEW_NUMBER = :requested_callback_new_number
-            DO_NOT_CONTACT = :do_not_contact
-            AI_AVERSE = :ai_averse
             NONE = :none
 
             # @!method self.values
@@ -976,8 +968,8 @@ module Revox
             #   @return [Array<Symbol>]
           end
 
-          # Warm or cold transfer when transfer_phone_number is set; null when transfer is
-          # not configured.
+          # Warm or cold transfer when transfer_destinations is non-empty; null when
+          # transfer is not configured.
           #
           # @see Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant#human_transfer_mode
           module HumanTransferMode
@@ -1269,11 +1261,14 @@ module Revox
 
           # @see Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant#slack
           class Slack < Revox::Internal::Type::BaseModel
-            # @!attribute channel_id
-            #   The Slack channel ID where the notification will be posted.
+            # @!attribute channels
+            #   The Slack channels eligible to receive the notification. When more than one is
+            #   configured, the agent prompt may define routing rules to narrow it down per
+            #   call; with no such rules every channel here is notified.
             #
-            #   @return [String]
-            required :channel_id, String
+            #   @return [Array<Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Slack::Channel>]
+            required :channels,
+                     -> { Revox::Internal::Type::ArrayOf[Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Slack::Channel] }
 
             # @!attribute connection_id
             #   The Nango connection ID linking the org's Slack workspace to Revox.
@@ -1289,38 +1284,54 @@ module Revox
             required :outcomes,
                      -> { Revox::Internal::Type::ArrayOf[enum: Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Slack::Outcome] }
 
-            # @!attribute channel_name
-            #   Human-readable Slack channel name, cached for display in the UI.
-            #
-            #   @return [String, nil]
-            optional :channel_name, String, nil?: true
-
             # @!attribute template
             #   Optional message template. Supports {{summary}}, {{outcome}}, {{phone}},
             #   {{call_url}}, {{assistant_name}}, {{campaign_name}}, {{first_name}},
-            #   {{last_name}}, {{email}}, {{company}}, {{contact_name}}, {{contact_line}}, plus
-            #   prompt_variables and structured_output keys. When null/empty a default template
-            #   is used.
+            #   {{last_name}}, {{email}}, {{company}}, {{job_title}}, {{contact_name}},
+            #   {{contact_line}}, plus prompt_variables and structured_output keys. When
+            #   null/empty a default template is used.
             #
             #   @return [String, nil]
             optional :template, String, nil?: true
 
-            # @!method initialize(channel_id:, connection_id:, outcomes:, channel_name: nil, template: nil)
+            # @!method initialize(channels:, connection_id:, outcomes:, template: nil)
             #   Some parameter documentations has been truncated, see
             #   {Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Slack}
             #   for more details.
             #
-            #   @param channel_id [String] The Slack channel ID where the notification will be posted.
+            #   @param channels [Array<Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Slack::Channel>] The Slack channels eligible to receive the notification. When more than one is c
             #
             #   @param connection_id [String] The Nango connection ID linking the org's Slack workspace to Revox.
             #
             #   @param outcomes [Array<Symbol, Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Slack::Outcome>] Which call outcomes trigger a Slack notification (e.g. ['interested', 'none']).
             #
-            #   @param channel_name [String, nil] Human-readable Slack channel name, cached for display in the UI.
-            #
             #   @param template [String, nil] Optional message template. Supports {{summary}}, {{outcome}}, {{phone}},
             #   {{call\_
 
+            class Channel < Revox::Internal::Type::BaseModel
+              # @!attribute id
+              #   The Slack channel ID (e.g. 'C01234567').
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute name
+              #   Human-readable Slack channel name, cached for display in the UI and given to the
+              #   LLM when the agent prompt routes by channel name.
+              #
+              #   @return [String, nil]
+              optional :name, String, nil?: true
+
+              # @!method initialize(id:, name: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant::Slack::Channel}
+              #   for more details.
+              #
+              #   @param id [String] The Slack channel ID (e.g. 'C01234567').
+              #
+              #   @param name [String, nil] Human-readable Slack channel name, cached for display in the UI and given to the
+            end
+
             module Outcome
               extend Revox::Internal::Type::Enum
 
@@ -1328,9 +1339,6 @@ module Revox
               INTERESTED = :interested
               COMPLETED = :completed
               REQUESTED_CALLBACK_LATER = :requested_callback_later
-              REQUESTED_CALLBACK_NEW_NUMBER = :requested_callback_new_number
-              DO_NOT_CONTACT = :do_not_contact
-              AI_AVERSE = :ai_averse
               NONE = :none
 
               # @!method self.values
@@ -1458,6 +1466,22 @@ module Revox
             #   @return [Array<Symbol>]
           end
 
+          class TransferDestination < Revox::Internal::Type::BaseModel
+            # @!attribute label
+            #
+            #   @return [String]
+            required :label, String
+
+            # @!attribute phone_number
+            #
+            #   @return [String]
+            required :phone_number, String
+
+            # @!method initialize(label:, phone_number:)
+            #   @param label [String]
+            #   @param phone_number [String]
+          end
+
           # @see Revox::Models::PhoneNumberUpdateResponse::PhoneNumber::InboundAssistant#type
           module Type
             extend Revox::Internal::Type::Enum
@@ -1495,7 +1519,7 @@ module Revox
 
             # @!attribute speed
             #   The speed of the voice. Range depends on provider: Cartesia 0.6–1.5, ElevenLabs
-            #   0.7–1.2. Default is 1.0.
+            #   0.7–1.2, Gradium 0.6–1.5. Default is 1.0.
             #
             #   @return [Float, nil]
             optional :speed, Float
@@ -1530,6 +1554,7 @@ module Revox
 
               CARTESIA = :cartesia
               ELEVENLABS = :elevenlabs
+              GRADIUM = :gradium
 
               # @!method self.values
               #   @return [Array<Symbol>]
@@ -1645,9 +1670,6 @@ module Revox
               INTERESTED = :interested
               COMPLETED = :completed
               REQUESTED_CALLBACK_LATER = :requested_callback_later
-              REQUESTED_CALLBACK_NEW_NUMBER = :requested_callback_new_number
-              DO_NOT_CONTACT = :do_not_contact
-              AI_AVERSE = :ai_averse
               NONE = :none
 
               # @!method self.values

data/lib/revox/models/voice_list_response.rb

@@ -120,6 +120,7 @@ module Revox
 
           CARTESIA = :cartesia
           ELEVENLABS = :elevenlabs
+          GRADIUM = :gradium
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/revox/models/voice_preview_params.rb

@@ -68,6 +68,7 @@ module Revox
 
         CARTESIA = :cartesia
         ELEVENLABS = :elevenlabs
+        GRADIUM = :gradium
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/revox/models/voice_retrieve_params.rb

@@ -27,6 +27,7 @@ module Revox
 
         CARTESIA = :cartesia
         ELEVENLABS = :elevenlabs
+        GRADIUM = :gradium
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/revox/models.rb

@@ -79,8 +79,6 @@ module Revox
 
   CampaignGetRowsParams = Revox::Models::CampaignGetRowsParams
 
-  CampaignLaunchParams = Revox::Models::CampaignLaunchParams
-
   CampaignListParams = Revox::Models::CampaignListParams
 
   CampaignPauseParams = Revox::Models::CampaignPauseParams

data/lib/revox/resources/assistants.rb

@@ -12,7 +12,7 @@ module Revox
       # voice provider and voice ID (Cartesia or ElevenLabs), and end-of-call behavior.
       # Once created, reference the assistant by its ID when placing calls.
       #
-      # @overload create(name:, prompt:, after_call_sms_outcomes: nil, after_call_sms_prompt: nil, background_sound: nil, background_sound_volume: nil, calendly: nil, call_retry_config: nil, cartesia_dictionary_pronunciation_id: nil, custom_tools: nil, email_notification_address: nil, email_notification_language: nil, email_notification_outcomes: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, from_phone_number: nil, human_transfer_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, logo_url: nil, max_call_duration_secs: nil, max_duration_end_message: nil, position: nil, prompt_flow: nil, slack: nil, sms_enabled: nil, sms_template: nil, structured_output_config: nil, structured_output_prompt: nil, stt_context: nil, stt_model: nil, thinking_sound: nil, thinking_sound_probability: nil, thinking_sound_volume: nil, transfer_phone_number: nil, type: nil, voice: nil, voicemail_message: nil, voicemail_sms_prompt: nil, warm_transfer_summary_instructions: nil, webhook_url: nil, zoho: nil, request_options: {})
+      # @overload create(name:, prompt:, after_call_sms_outcomes: nil, after_call_sms_prompt: nil, background_sound: nil, background_sound_volume: nil, calendly: nil, call_retry_config: nil, cartesia_dictionary_pronunciation_id: nil, custom_tools: nil, email_notification_address: nil, email_notification_outcomes: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, from_phone_number: nil, human_transfer_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, logo_url: nil, max_call_duration_secs: nil, max_duration_end_message: nil, position: nil, precall_lookup_url: nil, prompt_flow: nil, slack: nil, sms_enabled: nil, sms_template: nil, structured_output_config: nil, structured_output_prompt: nil, stt_context: nil, stt_model: nil, thinking_sound: nil, thinking_sound_probability: nil, thinking_sound_volume: nil, transfer_destinations: nil, type: nil, voice: nil, voicemail_message: nil, voicemail_sms_prompt: nil, warm_transfer_summary_instructions: nil, webhook_url: nil, zoho: nil, request_options: {})
       #
       # @param name [String]
       #
@@ -36,8 +36,6 @@ module Revox
       #
       # @param email_notification_address [String, nil] Email address(es) to receive notifications when a call ends with a matching outc
       #
-      # @param email_notification_language [Symbol, Revox::Models::AssistantCreateParams::EmailNotificationLanguage] The language used for the notification email content. One of "en" or "fr". Defau
-      #
       # @param email_notification_outcomes [Array<Symbol, Revox::Models::AssistantCreateParams::EmailNotificationOutcome>, nil] Which call outcomes trigger an email notification. E.g. ["interested", "complete
       #
       # @param end_of_call_sentence [String] Optional message to say when the agent decides to end the call.
@@ -52,7 +50,7 @@ module Revox
       #
       # @param from_phone_number [String, nil] Override the default outbound phone number for calls placed with this assistant.
       #
-      # @param human_transfer_mode [Symbol, Revox::Models::AssistantCreateParams::HumanTransferMode, nil] When transfer_phone_number is set: "warm" (AI bridges) or "cold" (SIP REFER; tru
+      # @param human_transfer_mode [Symbol, Revox::Models::AssistantCreateParams::HumanTransferMode, nil] When transfer_destinations is non-empty: "warm" (AI bridges) or "cold" (SIP REFE
       #
       # @param ivr_navigation_enabled [Boolean] Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
       #
@@ -66,6 +64,8 @@ module Revox
       #
       # @param position [Revox::Models::AssistantCreateParams::Position, nil] Canvas position of this assistant's node in its multi-step flow editor.
       #
+      # @param precall_lookup_url [String, nil] Inbound calls only. URL fetched over HTTP GET right before the call is answered,
+      #
       # @param prompt_flow [Revox::Models::AssistantCreateParams::PromptFlow, nil] Visual prompt constructor data (nodes, edges, positions). Used by the UI to re-o
       #
       # @param slack [Revox::Models::AssistantCreateParams::Slack, nil] Slack notification config. When set, posts a message to the chosen channel after
@@ -88,7 +88,7 @@ module Revox
       #
       # @param thinking_sound_volume [Float] Volume of the thinking sound (0 = silent, 1 = max).
       #
-      # @param transfer_phone_number [String, nil] Phone number to transfer calls to when users request to speak to a human agent i
+      # @param transfer_destinations [Array<Revox::Models::AssistantCreateParams::TransferDestination>, nil] Where calls can be transferred to when users ask to speak to a human. With a sin
       #
       # @param type [Symbol, Revox::Models::AssistantCreateParams::Type] Assistant kind. 'standalone' (default) is a normal assistant, 'multi-step' orche
       #
@@ -150,7 +150,7 @@ module Revox
       # the prompt, voice, first sentence, name, or any other assistant property without
       # affecting the rest of the configuration.
       #
-      # @overload update(id, after_call_sms_outcomes: nil, after_call_sms_prompt: nil, background_sound: nil, background_sound_volume: nil, calendly: nil, call_retry_config: nil, cartesia_dictionary_pronunciation_id: nil, custom_tools: nil, email_notification_address: nil, email_notification_language: nil, email_notification_outcomes: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, from_phone_number: nil, human_transfer_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, logo_url: nil, max_call_duration_secs: nil, max_duration_end_message: nil, name: nil, position: nil, prompt: nil, prompt_flow: nil, slack: nil, sms_enabled: nil, sms_template: nil, structured_output_config: nil, structured_output_prompt: nil, stt_context: nil, stt_model: nil, thinking_sound: nil, thinking_sound_probability: nil, thinking_sound_volume: nil, transfer_phone_number: nil, type: nil, voice: nil, voicemail_message: nil, voicemail_sms_prompt: nil, warm_transfer_summary_instructions: nil, webhook_url: nil, zoho: nil, request_options: {})
+      # @overload update(id, after_call_sms_outcomes: nil, after_call_sms_prompt: nil, background_sound: nil, background_sound_volume: nil, calendly: nil, call_retry_config: nil, cartesia_dictionary_pronunciation_id: nil, custom_tools: nil, email_notification_address: nil, email_notification_outcomes: nil, end_of_call_sentence: nil, faq_items: nil, first_sentence: nil, first_sentence_delay_ms: nil, first_sentence_mode: nil, from_phone_number: nil, human_transfer_mode: nil, ivr_navigation_enabled: nil, llm_model: nil, logo_url: nil, max_call_duration_secs: nil, max_duration_end_message: nil, name: nil, position: nil, precall_lookup_url: nil, prompt: nil, prompt_flow: nil, slack: nil, sms_enabled: nil, sms_template: nil, structured_output_config: nil, structured_output_prompt: nil, stt_context: nil, stt_model: nil, thinking_sound: nil, thinking_sound_probability: nil, thinking_sound_volume: nil, transfer_destinations: nil, type: nil, voice: nil, voicemail_message: nil, voicemail_sms_prompt: nil, warm_transfer_summary_instructions: nil, webhook_url: nil, zoho: nil, request_options: {})
       #
       # @param id [String]
       #
@@ -172,8 +172,6 @@ module Revox
       #
       # @param email_notification_address [String, nil] Email address(es) to receive notifications when a call ends with a matching outc
       #
-      # @param email_notification_language [Symbol, Revox::Models::AssistantUpdateParams::EmailNotificationLanguage] The language used for the notification email content. One of "en" or "fr". Defau
-      #
       # @param email_notification_outcomes [Array<Symbol, Revox::Models::AssistantUpdateParams::EmailNotificationOutcome>, nil] Which call outcomes trigger an email notification. E.g. ["interested", "complete
       #
       # @param end_of_call_sentence [String] Optional message to say when the agent decides to end the call.
@@ -188,7 +186,7 @@ module Revox
       #
       # @param from_phone_number [String, nil] Override the default outbound phone number for calls placed with this assistant.
       #
-      # @param human_transfer_mode [Symbol, Revox::Models::AssistantUpdateParams::HumanTransferMode, nil] When transfer_phone_number is set: "warm" (AI bridges) or "cold" (SIP REFER; tru
+      # @param human_transfer_mode [Symbol, Revox::Models::AssistantUpdateParams::HumanTransferMode, nil] When transfer_destinations is non-empty: "warm" (AI bridges) or "cold" (SIP REFE
       #
       # @param ivr_navigation_enabled [Boolean] Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
       #
@@ -204,6 +202,8 @@ module Revox
       #
       # @param position [Revox::Models::AssistantUpdateParams::Position, nil] Canvas position of this assistant's node in its multi-step flow editor.
       #
+      # @param precall_lookup_url [String, nil] Inbound calls only. URL fetched over HTTP GET right before the call is answered,
+      #
       # @param prompt [String] The prompt to use for the call. This will be given to the LLM (gpt-4.1)
       #
       # @param prompt_flow [Revox::Models::AssistantUpdateParams::PromptFlow, nil] Visual prompt constructor data (nodes, edges, positions). Used by the UI to re-o
@@ -228,7 +228,7 @@ module Revox
       #
       # @param thinking_sound_volume [Float] Volume of the thinking sound (0 = silent, 1 = max).
       #
-      # @param transfer_phone_number [String, nil] Phone number to transfer calls to when users request to speak to a human agent i
+      # @param transfer_destinations [Array<Revox::Models::AssistantUpdateParams::TransferDestination>, nil] Where calls can be transferred to when users ask to speak to a human. With a sin
       #
       # @param type [Symbol, Revox::Models::AssistantUpdateParams::Type] Assistant kind. 'standalone' (default) is a normal assistant, 'multi-step' orche
       #

data/lib/revox/resources/call.rb

@@ -13,7 +13,7 @@ module Revox
       # detected. You can also set concurrency limits and pass prompt variables for
       # dynamic personalization.
       #
-      # @overload create(phone_number:, assistant: nil, assistant_id: nil, concurrency: nil, force_now: nil, from_phone_number: nil, metadata: nil, prompt_variables: nil, scheduled_at: nil, request_options: {})
+      # @overload create(phone_number:, assistant: nil, assistant_id: nil, concurrency: nil, from_phone_number: nil, metadata: nil, prompt_variables: nil, scheduled_at: nil, skip_calling_window: nil, request_options: {})
       #
       # @param phone_number [String] The phone number to call in the E.164 format. Example: +1234567890
       #
@@ -21,9 +21,7 @@ module Revox
       #
       # @param assistant_id [String] The ID of the assistant to use for this call.
       #
-      # @param concurrency [Revox::Models::CallCreateParams::Concurrency] Limit the number of concurrent calls for a given concurrency key.
-      #
-      # @param force_now [Boolean] The prompt to use for the call. This will be given to the LLM (gpt-4.1)
+      # @param concurrency [Revox::Models::CallCreateParams::Concurrency] Limit the number of concurrent calls for a given concurrency key. The limit itse
       #
       # @param from_phone_number [String] The phone number to use for making the call (e.g., +1234567890). If not provided
       #
@@ -33,6 +31,8 @@ module Revox
       #
       # @param scheduled_at [Time, Object] Schedule the call to start at a specific date and time (ISO 8601 format). If not
       #
+      # @param skip_calling_window [Boolean] Bypass the calling-window check for this call so it dials even outside the assis
+      #
       # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Revox::Models::CallCreateResponse]

data/lib/revox/resources/campaigns.rb

@@ -6,29 +6,24 @@ module Revox
       # Some parameter documentations has been truncated, see
       # {Revox::Models::CampaignCreateParams} for more details.
       #
-      # Create a new outbound calling campaign. By default the campaign launches
-      # immediately. Set launch to false to save as a draft for later review.
+      # Create a new outbound calling campaign. Every contact is materialized as a call
+      # in the `not_launched` status — nothing is dialed. Use POST
+      # /campaigns/:id/launch-calls to send them.
       #
-      # @overload create(assistant_id:, contacts:, launch:, name:, type:, call_retry_config: nil, from_phone_number: nil, max_concurrent_calls: nil, scheduled_at: nil, request_options: {})
+      # @overload create(assistant_id:, contacts:, name:, call_retry_config: nil, from_phone_number: nil, max_concurrent_calls: nil, request_options: {})
       #
       # @param assistant_id [String] The ID of the assistant to use
       #
       # @param contacts [Array<Revox::Models::CampaignCreateParams::Contact>] The list of contacts to call
       #
-      # @param launch [Boolean] Whether to launch the campaign immediately. Set to false to save as a draft.
-      #
       # @param name [String] The name of the campaign
       #
-      # @param type [Symbol, Revox::Models::CampaignCreateParams::Type] Campaign type. 'jump_in' campaigns only dial while someone is on the campaign pa
-      #
       # @param call_retry_config [Revox::Models::CampaignCreateParams::CallRetryConfig] Override retry configuration for calls in this campaign. If not provided, uses t
       #
       # @param from_phone_number [String] The phone number to use for outbound calls (E.164 format, e.g., +1234567890)
       #
       # @param max_concurrent_calls [Float] Maximum number of concurrent calls allowed for this campaign
       #
-      # @param scheduled_at [Time, Object] Schedule all calls in this campaign to start at a specific date and time (ISO 86
-      #
       # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Revox::Models::CampaignCreateResponse]
@@ -68,30 +63,24 @@ module Revox
       # Some parameter documentations has been truncated, see
       # {Revox::Models::CampaignUpdateParams} for more details.
       #
-      # Update editable fields on a campaign. Draft campaigns support updating all
-      # fields including assistant, contacts, and settings. Non-draft campaigns only
-      # support renaming.
+      # Update a campaign's name, outbound number, retry configuration (calling hours,
+      # retry delay, max attempts) and concurrency cap. Changes are applied to the
+      # campaign's calls that have not completed yet. The assistant is fixed at
+      # creation; add contacts with POST /campaigns/:id/rows, and choose when calls go
+      # out with POST /campaigns/:id/launch-calls.
       #
-      # @overload update(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: {})
+      # @overload update(id, call_retry_config: nil, from_phone_number: nil, max_concurrent_calls: nil, name: nil, request_options: {})
       #
       # @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 from_phone_number [String, nil] The phone number to use for outbound calls. Editable after launch; applied to th
       #
-      # @param max_concurrent_calls [Float, nil] Maximum concurrent calls (draft only)
+      # @param max_concurrent_calls [Float, nil] Maximum concurrent calls. Editable after launch.
       #
       # @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}, nil]
       #
       # @return [Revox::Models::CampaignUpdateResponse]
@@ -188,8 +177,7 @@ module Revox
         )
       end
 
-      # Retrieve all contact rows for a campaign. Useful for loading draft campaign data
-      # for editing.
+      # Retrieve all contact rows for a campaign.
       #
       # @overload get_rows(id, request_options: {})
       #
@@ -208,26 +196,6 @@ module Revox
         )
       end
 
-      # Launch a previously saved draft campaign. This starts all calls immediately (or
-      # queues them if scheduled_at is set). The campaign must be in draft status.
-      #
-      # @overload launch(id, request_options: {})
-      #
-      # @param id [String]
-      # @param request_options [Revox::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Revox::Models::CampaignLaunchResponse]
-      #
-      # @see Revox::Models::CampaignLaunchParams
-      def launch(id, params = {})
-        @client.request(
-          method: :post,
-          path: ["campaigns/%1$s/launch", id],
-          model: Revox::Models::CampaignLaunchResponse,
-          options: params[:request_options]
-        )
-      end
-
       # Pause a running campaign so no further calls are placed. In-progress calls are
       # allowed to finish; pending and scheduled calls are held until the campaign is
       # resumed. Scheduled retry timers keep counting down, so a call resumed before its

data/lib/revox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Revox
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/revox.rb

@@ -92,8 +92,6 @@ require_relative "revox/models/campaign_export_rows_params"
 require_relative "revox/models/campaign_export_rows_response"
 require_relative "revox/models/campaign_get_rows_params"
 require_relative "revox/models/campaign_get_rows_response"
-require_relative "revox/models/campaign_launch_params"
-require_relative "revox/models/campaign_launch_response"
 require_relative "revox/models/campaign_list_params"
 require_relative "revox/models/campaign_list_response"
 require_relative "revox/models/campaign_pause_params"