revox 0.3.0 → 0.4.0

data/lib/revox/models/phone_number_list_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::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage]
-          required :email_notification_language,
-                   enum: -> { Revox::Models::PhoneNumberListResponse::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::PhoneNumberListResponse::PhoneNumber::InboundAssistant::HumanTransferMode, nil]
           required :human_transfer_mode,
@@ -315,6 +308,13 @@ module Revox
                    -> { Revox::Models::PhoneNumberListResponse::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::PhoneNumberListResponse::PhoneNumber::InboundAssistant::TransferDestination>, nil]
+          required :transfer_destinations,
+                   -> { Revox::Internal::Type::ArrayOf[Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::TransferDestination] },
+                   nil?: true
 
           # @!attribute type
           #
@@ -476,6 +479,11 @@ module Revox
           optional :faq_items,
                    -> { Revox::Internal::Type::ArrayOf[Revox::Models::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage] The language used for the notification email content. One of "en" or "fr".
-          #
           #   @param email_notification_outcomes [Array<Symbol, Revox::Models::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Type]
           #
@@ -591,6 +599,8 @@ module Revox
           #
           #   @param faq_items [Array<Revox::Models::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::PhoneNumber::InboundAssistant#human_transfer_mode
           module HumanTransferMode
@@ -1269,11 +1261,14 @@ module Revox
 
           # @see Revox::Models::PhoneNumberListResponse::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::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Channel>]
+            required :channels,
+                     -> { Revox::Internal::Type::ArrayOf[Revox::Models::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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::PhoneNumberListResponse::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