feat: add conversation type and dial timeout to Twilio SMS transport

Enhance the Twilio SMS chat transport with new configuration options for better call handling. Add conversation type specification and dial timeout control for SIP transfers.

Key changes:
- Add conversation_type field to TwilioSmsChatTransport with new enum type
- Add dial_timeout parameter to TransferPlan for SIP DIAL operations
- Remove X-Fern-SDK-Version header from request headers
- Add new type export for TwilioSmsChatTransportConversationType
- Update documentation and validation for new fields

🌿 Generated with Fern

Author: fern-api[bot]

changelog.md

@@ -0,0 +1,11 @@
+## 0.11.0 - 2025-11-19
+* feat: add conversation type and dial timeout to Twilio SMS transport
+* Enhance the Twilio SMS chat transport with new configuration options for better call handling. Add conversation type specification and dial timeout control for SIP transfers.
+* Key changes:
+* Add conversation_type field to TwilioSmsChatTransport with new enum type
+* Add dial_timeout parameter to TransferPlan for SIP DIAL operations
+* Remove X-Fern-SDK-Version header from request headers
+* Add new type export for TwilioSmsChatTransportConversationType
+* Update documentation and validation for new fields
+* 🌿 Generated with Fern
+

lib/requests.rb

@@ -45,7 +45,11 @@ def get_url(request_options: nil)
 
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": "Ruby", "X-Fern-SDK-Name": "vapi_server_sdk", "X-Fern-SDK-Version": "0.10.0" }
+      headers = {
+        "X-Fern-Language": "Ruby",
+        "X-Fern-SDK-Name": "vapi_server_sdk",
+        "X-Fern-SDK-Version": "0.11.0"
+      }
       headers["Authorization"] = ((@token.is_a? Method) ? @token.call : @token) unless @token.nil?
       headers
     end
@@ -90,7 +94,11 @@ def get_url(request_options: nil)
 
     # @return [Hash{String => String}]
     def get_headers
-      headers = { "X-Fern-Language": "Ruby", "X-Fern-SDK-Name": "vapi_server_sdk", "X-Fern-SDK-Version": "0.10.0" }
+      headers = {
+        "X-Fern-Language": "Ruby",
+        "X-Fern-SDK-Name": "vapi_server_sdk",
+        "X-Fern-SDK-Version": "0.11.0"
+      }
       headers["Authorization"] = ((@token.is_a? Method) ? @token.call : @token) unless @token.nil?
       headers
     end

lib/types_export.rb

@@ -790,6 +790,7 @@
 require_relative "vapi_server_sdk/types/chat_messages_item"
 require_relative "vapi_server_sdk/types/chat_output_item"
 require_relative "vapi_server_sdk/types/chat_costs_item"
+require_relative "vapi_server_sdk/types/twilio_sms_chat_transport_conversation_type"
 require_relative "vapi_server_sdk/types/twilio_sms_chat_transport_type"
 require_relative "vapi_server_sdk/types/twilio_sms_chat_transport"
 require_relative "vapi_server_sdk/types/get_chat_paginated_dto_sort_order"

lib/vapi_server_sdk/chats/client.rb

@@ -507,6 +507,7 @@ def list(assistant_id: nil, squad_id: nil, session_id: nil, previous_chat_id: ni
     #  If sessionId is provided without transport fields, uses existing session data.
     #  Cannot specify both sessionId and transport fields (phoneNumberId/customer)
     #  together.Request of type Vapi::TwilioSmsChatTransport, as a Hash
+    #   * :conversation_type (Vapi::TwilioSmsChatTransportConversationType)
     #   * :phone_number_id (String)
     #   * :customer (Hash)
     #     * :number_e_164_check_enabled (Boolean)
@@ -1140,6 +1141,7 @@ def delete(id:, request_options: nil)
     #  If sessionId is provided without transport fields, uses existing session data.
     #  Cannot specify both sessionId and transport fields (phoneNumberId/customer)
     #  together.Request of type Vapi::TwilioSmsChatTransport, as a Hash
+    #   * :conversation_type (Vapi::TwilioSmsChatTransportConversationType)
     #   * :phone_number_id (String)
     #   * :customer (Hash)
     #     * :number_e_164_check_enabled (Boolean)
@@ -1808,6 +1810,7 @@ def list(assistant_id: nil, squad_id: nil, session_id: nil, previous_chat_id: ni
     #  If sessionId is provided without transport fields, uses existing session data.
     #  Cannot specify both sessionId and transport fields (phoneNumberId/customer)
     #  together.Request of type Vapi::TwilioSmsChatTransport, as a Hash
+    #   * :conversation_type (Vapi::TwilioSmsChatTransportConversationType)
     #   * :phone_number_id (String)
     #   * :customer (Hash)
     #     * :number_e_164_check_enabled (Boolean)
@@ -2447,6 +2450,7 @@ def delete(id:, request_options: nil)
     #  If sessionId is provided without transport fields, uses existing session data.
     #  Cannot specify both sessionId and transport fields (phoneNumberId/customer)
     #  together.Request of type Vapi::TwilioSmsChatTransport, as a Hash
+    #   * :conversation_type (Vapi::TwilioSmsChatTransportConversationType)
     #   * :phone_number_id (String)
     #   * :customer (Hash)
     #     * :number_e_164_check_enabled (Boolean)

lib/vapi_server_sdk/types/transfer_plan.rb

@@ -56,6 +56,11 @@ class TransferPlan
     #  - 'bye': Ends current call with SIP BYE
     #  - 'dial': Uses SIP DIAL to transfer the call
     attr_reader :sip_verb
+    # @return [Float] This sets the timeout for the dial operation in seconds. This is the duration
+    #  the call will ring before timing out.
+    #  Only applicable when `sipVerb='dial'`. Not applicable for SIP REFER or BYE.
+    #  @default 60
+    attr_reader :dial_timeout
     # @return [String] This is the URL to an audio file played while the customer is on hold during
     #  transfer.
     #  Usage:
@@ -169,6 +174,10 @@ class TransferPlan
     #  - 'refer': Uses SIP REFER to transfer the call (default)
     #  - 'bye': Ends current call with SIP BYE
     #  - 'dial': Uses SIP DIAL to transfer the call
+    # @param dial_timeout [Float] This sets the timeout for the dial operation in seconds. This is the duration
+    #  the call will ring before timing out.
+    #  Only applicable when `sipVerb='dial'`. Not applicable for SIP REFER or BYE.
+    #  @default 60
     # @param hold_audio_url [String] This is the URL to an audio file played while the customer is on hold during
     #  transfer.
     #  Usage:
@@ -227,12 +236,13 @@ class TransferPlan
     #  will be used.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::TransferPlan]
-    def initialize(mode:, message: OMIT, timeout: OMIT, sip_verb: OMIT, hold_audio_url: OMIT,
+    def initialize(mode:, message: OMIT, timeout: OMIT, sip_verb: OMIT, dial_timeout: OMIT, hold_audio_url: OMIT,
                    transfer_complete_audio_url: OMIT, context_engineering_plan: OMIT, twiml: OMIT, summary_plan: OMIT, sip_headers_in_refer_to_enabled: OMIT, fallback_plan: OMIT, additional_properties: nil)
       @mode = mode
       @message = message if message != OMIT
       @timeout = timeout if timeout != OMIT
       @sip_verb = sip_verb if sip_verb != OMIT
+      @dial_timeout = dial_timeout if dial_timeout != OMIT
       @hold_audio_url = hold_audio_url if hold_audio_url != OMIT
       @transfer_complete_audio_url = transfer_complete_audio_url if transfer_complete_audio_url != OMIT
       @context_engineering_plan = context_engineering_plan if context_engineering_plan != OMIT
@@ -246,6 +256,7 @@ def initialize(mode:, message: OMIT, timeout: OMIT, sip_verb: OMIT, hold_audio_u
         "message": message,
         "timeout": timeout,
         "sipVerb": sip_verb,
+        "dialTimeout": dial_timeout,
         "holdAudioUrl": hold_audio_url,
         "transferCompleteAudioUrl": transfer_complete_audio_url,
         "contextEngineeringPlan": context_engineering_plan,
@@ -274,6 +285,7 @@ def self.from_json(json_object:)
       end
       timeout = parsed_json["timeout"]
       sip_verb = parsed_json["sipVerb"]
+      dial_timeout = parsed_json["dialTimeout"]
       hold_audio_url = parsed_json["holdAudioUrl"]
       transfer_complete_audio_url = parsed_json["transferCompleteAudioUrl"]
       if parsed_json["contextEngineeringPlan"].nil?
@@ -301,6 +313,7 @@ def self.from_json(json_object:)
         message: message,
         timeout: timeout,
         sip_verb: sip_verb,
+        dial_timeout: dial_timeout,
         hold_audio_url: hold_audio_url,
         transfer_complete_audio_url: transfer_complete_audio_url,
         context_engineering_plan: context_engineering_plan,
@@ -330,6 +343,7 @@ def self.validate_raw(obj:)
       obj.message.nil? || Vapi::TransferPlanMessage.validate_raw(obj: obj.message)
       obj.timeout&.is_a?(Float) != false || raise("Passed value for field obj.timeout is not the expected type, validation failed.")
       obj.sip_verb&.is_a?(Hash) != false || raise("Passed value for field obj.sip_verb is not the expected type, validation failed.")
+      obj.dial_timeout&.is_a?(Float) != false || raise("Passed value for field obj.dial_timeout is not the expected type, validation failed.")
       obj.hold_audio_url&.is_a?(String) != false || raise("Passed value for field obj.hold_audio_url is not the expected type, validation failed.")
       obj.transfer_complete_audio_url&.is_a?(String) != false || raise("Passed value for field obj.transfer_complete_audio_url is not the expected type, validation failed.")
       obj.context_engineering_plan.nil? || Vapi::TransferPlanContextEngineeringPlan.validate_raw(obj: obj.context_engineering_plan)

lib/vapi_server_sdk/types/twilio_sms_chat_transport.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
+require_relative "twilio_sms_chat_transport_conversation_type"
 require_relative "create_customer_dto"
 require_relative "twilio_sms_chat_transport_type"
 require "ostruct"
 require "json"
 
 module Vapi
   class TwilioSmsChatTransport
+    # @return [Vapi::TwilioSmsChatTransportConversationType] This is the conversation type of the call (ie, voice or chat).
+    attr_reader :conversation_type
     # @return [String] This is the phone number that will be used to send the SMS.
     #  If provided, will create a new session. If not provided, uses existing session's
     #  phoneNumberId.
@@ -33,6 +36,7 @@ class TwilioSmsChatTransport
 
     OMIT = Object.new
 
+    # @param conversation_type [Vapi::TwilioSmsChatTransportConversationType] This is the conversation type of the call (ie, voice or chat).
     # @param phone_number_id [String] This is the phone number that will be used to send the SMS.
     #  If provided, will create a new session. If not provided, uses existing session's
     #  phoneNumberId.
@@ -49,8 +53,9 @@ class TwilioSmsChatTransport
     #  Currently supports 'twilio.sms' for SMS delivery via Twilio.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [Vapi::TwilioSmsChatTransport]
-    def initialize(type:, phone_number_id: OMIT, customer: OMIT, use_llm_generated_message_for_outbound: OMIT,
-                   additional_properties: nil)
+    def initialize(type:, conversation_type: OMIT, phone_number_id: OMIT, customer: OMIT,
+                   use_llm_generated_message_for_outbound: OMIT, additional_properties: nil)
+      @conversation_type = conversation_type if conversation_type != OMIT
       @phone_number_id = phone_number_id if phone_number_id != OMIT
       @customer = customer if customer != OMIT
       if use_llm_generated_message_for_outbound != OMIT
@@ -59,6 +64,7 @@ def initialize(type:, phone_number_id: OMIT, customer: OMIT, use_llm_generated_m
       @type = type
       @additional_properties = additional_properties
       @_field_set = {
+        "conversationType": conversation_type,
         "phoneNumberId": phone_number_id,
         "customer": customer,
         "useLLMGeneratedMessageForOutbound": use_llm_generated_message_for_outbound,
@@ -75,6 +81,7 @@ def initialize(type:, phone_number_id: OMIT, customer: OMIT, use_llm_generated_m
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
+      conversation_type = parsed_json["conversationType"]
       phone_number_id = parsed_json["phoneNumberId"]
       if parsed_json["customer"].nil?
         customer = nil
@@ -85,6 +92,7 @@ def self.from_json(json_object:)
       use_llm_generated_message_for_outbound = parsed_json["useLLMGeneratedMessageForOutbound"]
       type = parsed_json["type"]
       new(
+        conversation_type: conversation_type,
         phone_number_id: phone_number_id,
         customer: customer,
         use_llm_generated_message_for_outbound: use_llm_generated_message_for_outbound,
@@ -107,6 +115,7 @@ def to_json(*_args)
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
+      obj.conversation_type&.is_a?(Vapi::TwilioSmsChatTransportConversationType) != false || raise("Passed value for field obj.conversation_type is not the expected type, validation failed.")
       obj.phone_number_id&.is_a?(String) != false || raise("Passed value for field obj.phone_number_id is not the expected type, validation failed.")
       obj.customer.nil? || Vapi::CreateCustomerDto.validate_raw(obj: obj.customer)
       obj.use_llm_generated_message_for_outbound&.is_a?(Boolean) != false || raise("Passed value for field obj.use_llm_generated_message_for_outbound is not the expected type, validation failed.")

lib/vapi_server_sdk/types/twilio_sms_chat_transport_conversation_type.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Vapi
+  # This is the conversation type of the call (ie, voice or chat).
+  class TwilioSmsChatTransportConversationType
+    CHAT = "chat"
+  end
+end

vapi_server_sdk.gemspec

@@ -4,7 +4,7 @@ require_relative "lib/gemconfig"
 
 Gem::Specification.new do |spec|
   spec.name = "vapi_server_sdk"
-  spec.version = "0.10.0"
+  spec.version = "0.11.0"
   spec.authors = Vapi::Gemconfig::AUTHORS
   spec.email = Vapi::Gemconfig::EMAIL
   spec.summary = Vapi::Gemconfig::SUMMARY