revox 0.3.0 → 0.4.0

data/rbi/revox/models/phone_number_list_response.rbi

@@ -356,14 +356,6 @@ module Revox
           sig { returns(T.nilable(String)) }
           attr_accessor :email_notification_address
 
-          # The language used for the notification email content. One of "en" or "fr".
-          sig do
-            returns(
-              Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage::TaggedSymbol
-            )
-          end
-          attr_accessor :email_notification_language
-
           # Which call outcomes trigger an email notification. E.g. ["interested",
           # "completed", "none"]. Use "none" when outcome is null.
           sig do
@@ -399,8 +391,8 @@ module Revox
           sig { returns(T.nilable(String)) }
           attr_accessor :from_phone_number
 
-          # 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.
           sig do
             returns(
               T.nilable(
@@ -463,6 +455,11 @@ module Revox
           end
           attr_writer :position
 
+          # URL fetched before an inbound call is answered to resolve the assistant's prompt
+          # variables. Null when no lookup is configured.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :precall_lookup_url
+
           sig { returns(String) }
           attr_accessor :prompt
 
@@ -584,9 +581,18 @@ module Revox
           sig { returns(Float) }
           attr_accessor :thinking_sound_volume
 
-          # Phone number to transfer calls to when users request to speak to a human agent.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :transfer_phone_number
+          # Where calls can be transferred to when users ask to speak to a human. Null or
+          # empty when transfer is not configured.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::TransferDestination
+                ]
+              )
+            )
+          end
+          attr_accessor :transfer_destinations
 
           sig do
             returns(
@@ -696,6 +702,12 @@ module Revox
           end
           attr_writer :faq_items
 
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :is_inbound_receptionist
+
+          sig { params(is_inbound_receptionist: T::Boolean).void }
+          attr_writer :is_inbound_receptionist
+
           sig { returns(T.nilable(T::Boolean)) }
           attr_reader :is_realestate_assistant
 
@@ -740,8 +752,6 @@ module Revox
                   ]
                 ),
               email_notification_address: T.nilable(String),
-              email_notification_language:
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage::OrSymbol,
               email_notification_outcomes:
                 T.nilable(
                   T::Array[
@@ -775,6 +785,7 @@ module Revox
                 T.nilable(
                   Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Position::OrHash
                 ),
+              precall_lookup_url: T.nilable(String),
               prompt: String,
               prompt_flow:
                 T.nilable(
@@ -805,7 +816,12 @@ module Revox
                 ),
               thinking_sound_probability: Float,
               thinking_sound_volume: Float,
-              transfer_phone_number: T.nilable(String),
+              transfer_destinations:
+                T.nilable(
+                  T::Array[
+                    Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::TransferDestination::OrHash
+                  ]
+                ),
               type:
                 Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Type::OrSymbol,
               updated_at: T.anything,
@@ -829,6 +845,7 @@ module Revox
                 T::Array[
                   Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::FaqItem::OrHash
                 ],
+              is_inbound_receptionist: T::Boolean,
               is_realestate_assistant: T::Boolean,
               pending_faq_count: Float
             ).returns(T.attached_class)
@@ -857,8 +874,6 @@ module Revox
             # outcome. Accepts a single email or a comma-separated list (e.g. "alice@x.com,
             # bob@y.com").
             email_notification_address:,
-            # The language used for the notification email content. One of "en" or "fr".
-            email_notification_language:,
             # Which call outcomes trigger an email notification. E.g. ["interested",
             # "completed", "none"]. Use "none" when outcome is null.
             email_notification_outcomes:,
@@ -870,8 +885,8 @@ module Revox
             # Override the default outbound phone number for calls placed with this assistant.
             # When null, the organization's default phone number is used.
             from_phone_number:,
-            # 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.
             human_transfer_mode:,
             # Enable IVR navigation tools. When enabled, the assistant can send DTMF tones and
             # skip turns to navigate phone menus.
@@ -890,6 +905,9 @@ module Revox
             name:,
             organization_id:,
             position:,
+            # URL fetched before an inbound call is answered to resolve the assistant's prompt
+            # variables. Null when no lookup is configured.
+            precall_lookup_url:,
             prompt:,
             prompt_flow:,
             slack:,
@@ -921,8 +939,9 @@ module Revox
             thinking_sound_probability:,
             # Volume of the thinking sound (0 = silent, 1 = max).
             thinking_sound_volume:,
-            # Phone number to transfer calls to when users request to speak to a human agent.
-            transfer_phone_number:,
+            # Where calls can be transferred to when users ask to speak to a human. Null or
+            # empty when transfer is not configured.
+            transfer_destinations:,
             type:,
             updated_at:,
             voice:,
@@ -941,6 +960,7 @@ module Revox
             # The user who created the assistant.
             created_by: nil,
             faq_items: nil,
+            is_inbound_receptionist: nil,
             is_realestate_assistant: nil,
             pending_faq_count: nil
           )
@@ -979,8 +999,6 @@ module Revox
                     ]
                   ),
                 email_notification_address: T.nilable(String),
-                email_notification_language:
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage::TaggedSymbol,
                 email_notification_outcomes:
                   T.nilable(
                     T::Array[
@@ -1009,6 +1027,7 @@ module Revox
                   T.nilable(
                     Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Position
                   ),
+                precall_lookup_url: T.nilable(String),
                 prompt: String,
                 prompt_flow:
                   T.nilable(
@@ -1039,7 +1058,12 @@ module Revox
                   ),
                 thinking_sound_probability: Float,
                 thinking_sound_volume: Float,
-                transfer_phone_number: T.nilable(String),
+                transfer_destinations:
+                  T.nilable(
+                    T::Array[
+                      Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::TransferDestination
+                    ]
+                  ),
                 type:
                   Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Type::TaggedSymbol,
                 updated_at: T.anything,
@@ -1063,6 +1087,7 @@ module Revox
                   T::Array[
                     Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::FaqItem
                   ],
+                is_inbound_receptionist: T::Boolean,
                 is_realestate_assistant: T::Boolean,
                 pending_faq_count: Float
               }
@@ -1103,21 +1128,6 @@ module Revox
                 :requested_callback_later,
                 Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::AfterCallSMSOutcome::TaggedSymbol
               )
-            REQUESTED_CALLBACK_NEW_NUMBER =
-              T.let(
-                :requested_callback_new_number,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::AfterCallSMSOutcome::TaggedSymbol
-              )
-            DO_NOT_CONTACT =
-              T.let(
-                :do_not_contact,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::AfterCallSMSOutcome::TaggedSymbol
-              )
-            AI_AVERSE =
-              T.let(
-                :ai_averse,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::AfterCallSMSOutcome::TaggedSymbol
-              )
             NONE =
               T.let(
                 :none,
@@ -1386,7 +1396,8 @@ module Revox
               sig { returns(String) }
               attr_accessor :calling_window_start_time
 
-              # 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).
               sig { returns(Integer) }
               attr_accessor :retry_delay_seconds
 
@@ -1406,7 +1417,8 @@ module Revox
                 # timezone_override if provided). Format: 'HH:mm' (24-hour) or 'H:mma' (12-hour).
                 # Examples: '09:00', '10am'. Default: '10:00'.
                 calling_window_start_time:,
-                # 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).
                 retry_delay_seconds:
               )
               end
@@ -1793,41 +1805,6 @@ module Revox
             end
           end
 
-          # The language used for the notification email content. One of "en" or "fr".
-          module EmailNotificationLanguage
-            extend Revox::Internal::Type::Enum
-
-            TaggedSymbol =
-              T.type_alias do
-                T.all(
-                  Symbol,
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage
-                )
-              end
-            OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-            EN =
-              T.let(
-                :en,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage::TaggedSymbol
-              )
-            FR =
-              T.let(
-                :fr,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage::TaggedSymbol
-              )
-
-            sig do
-              override.returns(
-                T::Array[
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationLanguage::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
-          end
-
           module EmailNotificationOutcome
             extend Revox::Internal::Type::Enum
 
@@ -1860,21 +1837,6 @@ module Revox
                 :requested_callback_later,
                 Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationOutcome::TaggedSymbol
               )
-            REQUESTED_CALLBACK_NEW_NUMBER =
-              T.let(
-                :requested_callback_new_number,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationOutcome::TaggedSymbol
-              )
-            DO_NOT_CONTACT =
-              T.let(
-                :do_not_contact,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationOutcome::TaggedSymbol
-              )
-            AI_AVERSE =
-              T.let(
-                :ai_averse,
-                Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::EmailNotificationOutcome::TaggedSymbol
-              )
             NONE =
               T.let(
                 :none,
@@ -1931,8 +1893,8 @@ module Revox
             end
           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.
           module HumanTransferMode
             extend Revox::Internal::Type::Enum
 
@@ -2530,9 +2492,17 @@ module Revox
                 )
               end
 
-            # The Slack channel ID where the notification will be posted.
-            sig { returns(String) }
-            attr_accessor :channel_id
+            # 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.
+            sig do
+              returns(
+                T::Array[
+                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Channel
+                ]
+              )
+            end
+            attr_accessor :channels
 
             # The Nango connection ID linking the org's Slack workspace to Revox.
             sig { returns(String) }
@@ -2549,45 +2519,43 @@ module Revox
             end
             attr_accessor :outcomes
 
-            # Human-readable Slack channel name, cached for display in the UI.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :channel_name
-
             # 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.
             sig { returns(T.nilable(String)) }
             attr_accessor :template
 
             sig do
               params(
-                channel_id: String,
+                channels:
+                  T::Array[
+                    Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Channel::OrHash
+                  ],
                 connection_id: String,
                 outcomes:
                   T::Array[
                     Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Outcome::OrSymbol
                   ],
-                channel_name: T.nilable(String),
                 template: T.nilable(String)
               ).returns(T.attached_class)
             end
             def self.new(
-              # The Slack channel ID where the notification will be posted.
-              channel_id:,
+              # 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.
+              channels:,
               # The Nango connection ID linking the org's Slack workspace to Revox.
               connection_id:,
               # Which call outcomes trigger a Slack notification (e.g. ['interested', 'none']).
               # Use 'none' to notify when outcome is null.
               outcomes:,
-              # Human-readable Slack channel name, cached for display in the UI.
-              channel_name: nil,
               # 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.
               template: nil
             )
             end
@@ -2595,13 +2563,15 @@ module Revox
             sig do
               override.returns(
                 {
-                  channel_id: String,
+                  channels:
+                    T::Array[
+                      Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Channel
+                    ],
                   connection_id: String,
                   outcomes:
                     T::Array[
                       Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Outcome::TaggedSymbol
                     ],
-                  channel_name: T.nilable(String),
                   template: T.nilable(String)
                 }
               )
@@ -2609,6 +2579,43 @@ module Revox
             def to_hash
             end
 
+            class Channel < Revox::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Channel,
+                    Revox::Internal::AnyHash
+                  )
+                end
+
+              # The Slack channel ID (e.g. 'C01234567').
+              sig { returns(String) }
+              attr_accessor :id
+
+              # Human-readable Slack channel name, cached for display in the UI and given to the
+              # LLM when the agent prompt routes by channel name.
+              sig { returns(T.nilable(String)) }
+              attr_accessor :name
+
+              sig do
+                params(id: String, name: T.nilable(String)).returns(
+                  T.attached_class
+                )
+              end
+              def self.new(
+                # The Slack channel ID (e.g. 'C01234567').
+                id:,
+                # Human-readable Slack channel name, cached for display in the UI and given to the
+                # LLM when the agent prompt routes by channel name.
+                name: nil
+              )
+              end
+
+              sig { override.returns({ id: String, name: T.nilable(String) }) }
+              def to_hash
+              end
+            end
+
             module Outcome
               extend Revox::Internal::Type::Enum
 
@@ -2641,21 +2648,6 @@ module Revox
                   :requested_callback_later,
                   Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Outcome::TaggedSymbol
                 )
-              REQUESTED_CALLBACK_NEW_NUMBER =
-                T.let(
-                  :requested_callback_new_number,
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Outcome::TaggedSymbol
-                )
-              DO_NOT_CONTACT =
-                T.let(
-                  :do_not_contact,
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Outcome::TaggedSymbol
-                )
-              AI_AVERSE =
-                T.let(
-                  :ai_averse,
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Slack::Outcome::TaggedSymbol
-                )
               NONE =
                 T.let(
                   :none,
@@ -2970,6 +2962,34 @@ module Revox
             end
           end
 
+          class TransferDestination < Revox::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::TransferDestination,
+                  Revox::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :label
+
+            sig { returns(String) }
+            attr_accessor :phone_number
+
+            sig do
+              params(label: String, phone_number: String).returns(
+                T.attached_class
+              )
+            end
+            def self.new(label:, phone_number:)
+            end
+
+            sig { override.returns({ label: String, phone_number: String }) }
+            def to_hash
+            end
+          end
+
           module Type
             extend Revox::Internal::Type::Enum
 
@@ -3050,7 +3070,7 @@ module Revox
             attr_writer :model
 
             # 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.
             sig { returns(T.nilable(Float)) }
             attr_reader :speed
 
@@ -3085,7 +3105,7 @@ module Revox
               # for other providers.
               model: nil,
               # 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.
               speed: nil,
               # Volume of the voice (Cartesia only). 0.5–2.0, default 1.0. Ignored for other
               # providers.
@@ -3132,6 +3152,11 @@ module Revox
                   :elevenlabs,
                   Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Voice::Provider::TaggedSymbol
                 )
+              GRADIUM =
+                T.let(
+                  :gradium,
+                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Voice::Provider::TaggedSymbol
+                )
 
               sig do
                 override.returns(
@@ -3362,21 +3387,6 @@ module Revox
                   :requested_callback_later,
                   Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Zoho::Outcome::TaggedSymbol
                 )
-              REQUESTED_CALLBACK_NEW_NUMBER =
-                T.let(
-                  :requested_callback_new_number,
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Zoho::Outcome::TaggedSymbol
-                )
-              DO_NOT_CONTACT =
-                T.let(
-                  :do_not_contact,
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Zoho::Outcome::TaggedSymbol
-                )
-              AI_AVERSE =
-                T.let(
-                  :ai_averse,
-                  Revox::Models::PhoneNumberListResponse::PhoneNumber::InboundAssistant::Zoho::Outcome::TaggedSymbol
-                )
               NONE =
                 T.let(
                   :none,