telnyx 5.61.0 → 5.63.0

data/rbi/telnyx/models/whatsapp/template_create_params.rbi

@@ -15,20 +15,39 @@ module Telnyx
             )
           end
 
+        # Template category: AUTHENTICATION, UTILITY, or MARKETING.
         sig do
           returns(Telnyx::Whatsapp::TemplateCreateParams::Category::OrSymbol)
         end
         attr_accessor :category
 
-        sig { returns(T::Array[T::Hash[Symbol, T.anything]]) }
+        # Template components defining message structure. Passed through to Meta Graph
+        # API. Templates with variables must include example values. Supports HEADER,
+        # BODY, FOOTER, BUTTONS, CAROUSEL and any future Meta component types.
+        sig do
+          returns(
+            T::Array[
+              T.any(
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Header,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Body,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Footer,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel
+              )
+            ]
+          )
+        end
         attr_accessor :components
 
+        # Template language code (e.g. en_US, es, pt_BR).
         sig { returns(String) }
         attr_accessor :language
 
+        # Template name. Lowercase letters, numbers, and underscores only.
         sig { returns(String) }
         attr_accessor :name
 
+        # The WhatsApp Business Account ID.
         sig { returns(String) }
         attr_accessor :waba_id
 
@@ -36,7 +55,16 @@ module Telnyx
           params(
             category:
               Telnyx::Whatsapp::TemplateCreateParams::Category::OrSymbol,
-            components: T::Array[T::Hash[Symbol, T.anything]],
+            components:
+              T::Array[
+                T.any(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::OrHash,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Body::OrHash,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Footer::OrHash,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::OrHash,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel::OrHash
+                )
+              ],
             language: String,
             name: String,
             waba_id: String,
@@ -44,10 +72,17 @@ module Telnyx
           ).returns(T.attached_class)
         end
         def self.new(
+          # Template category: AUTHENTICATION, UTILITY, or MARKETING.
           category:,
+          # Template components defining message structure. Passed through to Meta Graph
+          # API. Templates with variables must include example values. Supports HEADER,
+          # BODY, FOOTER, BUTTONS, CAROUSEL and any future Meta component types.
           components:,
+          # Template language code (e.g. en_US, es, pt_BR).
           language:,
+          # Template name. Lowercase letters, numbers, and underscores only.
           name:,
+          # The WhatsApp Business Account ID.
           waba_id:,
           request_options: {}
         )
@@ -58,7 +93,16 @@ module Telnyx
             {
               category:
                 Telnyx::Whatsapp::TemplateCreateParams::Category::OrSymbol,
-              components: T::Array[T::Hash[Symbol, T.anything]],
+              components:
+                T::Array[
+                  T.any(
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Header,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Body,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Footer,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel
+                  )
+                ],
               language: String,
               name: String,
               waba_id: String,
@@ -69,6 +113,7 @@ module Telnyx
         def to_hash
         end
 
+        # Template category: AUTHENTICATION, UTILITY, or MARKETING.
         module Category
           extend Telnyx::Internal::Type::Enum
 
@@ -104,6 +149,849 @@ module Telnyx
           def self.values
           end
         end
+
+        # A template component. Additional Meta component types not listed here are also
+        # accepted.
+        module Component
+          extend Telnyx::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Header,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Body,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Footer,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons,
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel
+              )
+            end
+
+          class Header < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # Header format type: TEXT (supports one variable), IMAGE, VIDEO, DOCUMENT, or
+            # LOCATION.
+            sig do
+              returns(
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::OrSymbol
+              )
+            end
+            attr_accessor :file_format
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Sample values for header variables.
+            sig do
+              returns(
+                T.nilable(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Example
+                )
+              )
+            end
+            attr_reader :example
+
+            sig do
+              params(
+                example:
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Example::OrHash
+              ).void
+            end
+            attr_writer :example
+
+            # Header text. Required when format is TEXT. Supports one variable ({{1}}).
+            # Variables cannot be at the start or end.
+            sig { returns(T.nilable(String)) }
+            attr_reader :text
+
+            sig { params(text: String).void }
+            attr_writer :text
+
+            # Optional header displayed at the top of the message.
+            sig do
+              params(
+                file_format:
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::OrSymbol,
+                example:
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Example::OrHash,
+                text: String,
+                type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Header format type: TEXT (supports one variable), IMAGE, VIDEO, DOCUMENT, or
+              # LOCATION.
+              file_format:,
+              # Sample values for header variables.
+              example: nil,
+              # Header text. Required when format is TEXT. Supports one variable ({{1}}).
+              # Variables cannot be at the start or end.
+              text: nil,
+              type: :HEADER
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  file_format:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::OrSymbol,
+                  type: Symbol,
+                  example:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Example,
+                  text: String
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Header format type: TEXT (supports one variable), IMAGE, VIDEO, DOCUMENT, or
+            # LOCATION.
+            module Format
+              extend Telnyx::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              TEXT =
+                T.let(
+                  :TEXT,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::TaggedSymbol
+                )
+              IMAGE =
+                T.let(
+                  :IMAGE,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::TaggedSymbol
+                )
+              VIDEO =
+                T.let(
+                  :VIDEO,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::TaggedSymbol
+                )
+              DOCUMENT =
+                T.let(
+                  :DOCUMENT,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::TaggedSymbol
+                )
+              LOCATION =
+                T.let(
+                  :LOCATION,
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Format::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            class Example < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Header::Example,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Media handle for IMAGE, VIDEO, or DOCUMENT headers.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :header_handle
+
+              sig { params(header_handle: T::Array[String]).void }
+              attr_writer :header_handle
+
+              # Sample values for text header variables.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :header_text
+
+              sig { params(header_text: T::Array[String]).void }
+              attr_writer :header_text
+
+              # Sample values for header variables.
+              sig do
+                params(
+                  header_handle: T::Array[String],
+                  header_text: T::Array[String]
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Media handle for IMAGE, VIDEO, or DOCUMENT headers.
+                header_handle: nil,
+                # Sample values for text header variables.
+                header_text: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    header_handle: T::Array[String],
+                    header_text: T::Array[String]
+                  }
+                )
+              end
+              def to_hash
+              end
+            end
+          end
+
+          class Body < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Body,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Sample values for body variables. Required when body text contains parameters.
+            sig do
+              returns(
+                T.nilable(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Body::Example
+                )
+              )
+            end
+            attr_reader :example
+
+            sig do
+              params(
+                example:
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Body::Example::OrHash
+              ).void
+            end
+            attr_writer :example
+
+            # Body text content. Use {{1}}, {{2}}, etc. for variable placeholders. Required
+            # for MARKETING and UTILITY templates. Optional for AUTHENTICATION templates where
+            # Meta provides the built-in OTP body.
+            sig { returns(T.nilable(String)) }
+            attr_reader :text
+
+            sig { params(text: String).void }
+            attr_writer :text
+
+            # The main text content of the message. Supports multiple variable parameters
+            # ({{1}}, {{2}}, etc.). Variables cannot be at the start or end. Maximum 1024
+            # characters.
+            sig do
+              params(
+                example:
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Body::Example::OrHash,
+                text: String,
+                type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Sample values for body variables. Required when body text contains parameters.
+              example: nil,
+              # Body text content. Use {{1}}, {{2}}, etc. for variable placeholders. Required
+              # for MARKETING and UTILITY templates. Optional for AUTHENTICATION templates where
+              # Meta provides the built-in OTP body.
+              text: nil,
+              type: :BODY
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  type: Symbol,
+                  example:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Body::Example,
+                  text: String
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class Example < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Body::Example,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Array containing one array of sample values, one per variable in order.
+              sig { returns(T.nilable(T::Array[T::Array[String]])) }
+              attr_reader :body_text
+
+              sig { params(body_text: T::Array[T::Array[String]]).void }
+              attr_writer :body_text
+
+              # Sample values for body variables. Required when body text contains parameters.
+              sig do
+                params(body_text: T::Array[T::Array[String]]).returns(
+                  T.attached_class
+                )
+              end
+              def self.new(
+                # Array containing one array of sample values, one per variable in order.
+                body_text: nil
+              )
+              end
+
+              sig do
+                override.returns({ body_text: T::Array[T::Array[String]] })
+              end
+              def to_hash
+              end
+            end
+          end
+
+          class Footer < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Footer,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # OTP code expiration time in minutes. Used in AUTHENTICATION template footers
+            # instead of free-form text.
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :code_expiration_minutes
+
+            sig { params(code_expiration_minutes: Integer).void }
+            attr_writer :code_expiration_minutes
+
+            # Footer text. Maximum 60 characters. For non-authentication templates.
+            sig { returns(T.nilable(String)) }
+            attr_reader :text
+
+            sig { params(text: String).void }
+            attr_writer :text
+
+            # Optional footer displayed at the bottom of the message. Does not support
+            # variables.
+            sig do
+              params(
+                code_expiration_minutes: Integer,
+                text: String,
+                type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # OTP code expiration time in minutes. Used in AUTHENTICATION template footers
+              # instead of free-form text.
+              code_expiration_minutes: nil,
+              # Footer text. Maximum 60 characters. For non-authentication templates.
+              text: nil,
+              type: :FOOTER
+            )
+            end
+
+            sig do
+              override.returns(
+                { type: Symbol, code_expiration_minutes: Integer, text: String }
+              )
+            end
+            def to_hash
+            end
+          end
+
+          class Buttons < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # Array of button objects. Meta supports various combinations of button types.
+            sig do
+              returns(
+                T::Array[
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button
+                ]
+              )
+            end
+            attr_accessor :buttons
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Optional interactive buttons. Maximum 3 buttons per template.
+            sig do
+              params(
+                buttons:
+                  T::Array[
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OrHash
+                  ],
+                type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Array of button objects. Meta supports various combinations of button types.
+              buttons:,
+              type: :BUTTONS
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  buttons:
+                    T::Array[
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button
+                    ],
+                  type: Symbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class Button < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              sig do
+                returns(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::OrSymbol
+                )
+              end
+              attr_accessor :type
+
+              # Custom autofill button text for ONE_TAP OTP buttons.
+              sig { returns(T.nilable(String)) }
+              attr_reader :autofill_text
+
+              sig { params(autofill_text: String).void }
+              attr_writer :autofill_text
+
+              # Sample values for URL variable.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :example
+
+              sig { params(example: T::Array[String]).void }
+              attr_writer :example
+
+              # Flow action type for FLOW-type buttons.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction::OrSymbol
+                  )
+                )
+              end
+              attr_reader :flow_action
+
+              sig do
+                params(
+                  flow_action:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction::OrSymbol
+                ).void
+              end
+              attr_writer :flow_action
+
+              # Flow ID for FLOW-type buttons.
+              sig { returns(T.nilable(String)) }
+              attr_reader :flow_id
+
+              sig { params(flow_id: String).void }
+              attr_writer :flow_id
+
+              # Target screen name for FLOW buttons with navigate action.
+              sig { returns(T.nilable(String)) }
+              attr_reader :navigate_screen
+
+              sig { params(navigate_screen: String).void }
+              attr_writer :navigate_screen
+
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType::OrSymbol
+                  )
+                )
+              end
+              attr_reader :otp_type
+
+              sig do
+                params(
+                  otp_type:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType::OrSymbol
+                ).void
+              end
+              attr_writer :otp_type
+
+              # Android package name. Required for ONE_TAP OTP buttons.
+              sig { returns(T.nilable(String)) }
+              attr_reader :package_name
+
+              sig { params(package_name: String).void }
+              attr_writer :package_name
+
+              # Phone number in E.164 format.
+              sig { returns(T.nilable(String)) }
+              attr_reader :phone_number
+
+              sig { params(phone_number: String).void }
+              attr_writer :phone_number
+
+              # Android app signing key hash. Required for ONE_TAP OTP buttons.
+              sig { returns(T.nilable(String)) }
+              attr_reader :signature_hash
+
+              sig { params(signature_hash: String).void }
+              attr_writer :signature_hash
+
+              # Button label text. Maximum 25 characters. Required for URL, PHONE_NUMBER, and
+              # QUICK_REPLY buttons. Not required for OTP buttons (Meta supplies the label).
+              sig { returns(T.nilable(String)) }
+              attr_reader :text
+
+              sig { params(text: String).void }
+              attr_writer :text
+
+              # URL for URL-type buttons. Supports one variable ({{1}}).
+              sig { returns(T.nilable(String)) }
+              attr_reader :url
+
+              sig { params(url: String).void }
+              attr_writer :url
+
+              # Whether zero-tap terms have been accepted.
+              sig { returns(T.nilable(T::Boolean)) }
+              attr_reader :zero_tap_terms_accepted
+
+              sig { params(zero_tap_terms_accepted: T::Boolean).void }
+              attr_writer :zero_tap_terms_accepted
+
+              sig do
+                params(
+                  type:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::OrSymbol,
+                  autofill_text: String,
+                  example: T::Array[String],
+                  flow_action:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction::OrSymbol,
+                  flow_id: String,
+                  navigate_screen: String,
+                  otp_type:
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType::OrSymbol,
+                  package_name: String,
+                  phone_number: String,
+                  signature_hash: String,
+                  text: String,
+                  url: String,
+                  zero_tap_terms_accepted: T::Boolean
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                type:,
+                # Custom autofill button text for ONE_TAP OTP buttons.
+                autofill_text: nil,
+                # Sample values for URL variable.
+                example: nil,
+                # Flow action type for FLOW-type buttons.
+                flow_action: nil,
+                # Flow ID for FLOW-type buttons.
+                flow_id: nil,
+                # Target screen name for FLOW buttons with navigate action.
+                navigate_screen: nil,
+                otp_type: nil,
+                # Android package name. Required for ONE_TAP OTP buttons.
+                package_name: nil,
+                # Phone number in E.164 format.
+                phone_number: nil,
+                # Android app signing key hash. Required for ONE_TAP OTP buttons.
+                signature_hash: nil,
+                # Button label text. Maximum 25 characters. Required for URL, PHONE_NUMBER, and
+                # QUICK_REPLY buttons. Not required for OTP buttons (Meta supplies the label).
+                text: nil,
+                # URL for URL-type buttons. Supports one variable ({{1}}).
+                url: nil,
+                # Whether zero-tap terms have been accepted.
+                zero_tap_terms_accepted: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    type:
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::OrSymbol,
+                    autofill_text: String,
+                    example: T::Array[String],
+                    flow_action:
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction::OrSymbol,
+                    flow_id: String,
+                    navigate_screen: String,
+                    otp_type:
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType::OrSymbol,
+                    package_name: String,
+                    phone_number: String,
+                    signature_hash: String,
+                    text: String,
+                    url: String,
+                    zero_tap_terms_accepted: T::Boolean
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              module Type
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                URL =
+                  T.let(
+                    :URL,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::TaggedSymbol
+                  )
+                PHONE_NUMBER =
+                  T.let(
+                    :PHONE_NUMBER,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::TaggedSymbol
+                  )
+                QUICK_REPLY =
+                  T.let(
+                    :QUICK_REPLY,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::TaggedSymbol
+                  )
+                OTP =
+                  T.let(
+                    :OTP,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::TaggedSymbol
+                  )
+                COPY_CODE =
+                  T.let(
+                    :COPY_CODE,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::TaggedSymbol
+                  )
+                FLOW =
+                  T.let(
+                    :FLOW,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::Type::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+
+              # Flow action type for FLOW-type buttons.
+              module FlowAction
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                NAVIGATE =
+                  T.let(
+                    :navigate,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction::TaggedSymbol
+                  )
+                DATA_EXCHANGE =
+                  T.let(
+                    :data_exchange,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::FlowAction::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+
+              module OtpType
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                COPY_CODE =
+                  T.let(
+                    :COPY_CODE,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType::TaggedSymbol
+                  )
+                ONE_TAP =
+                  T.let(
+                    :ONE_TAP,
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Buttons::Button::OtpType::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+          end
+
+          class Carousel < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # Array of card objects, each with its own components.
+            sig do
+              returns(
+                T::Array[
+                  Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel::Card
+                ]
+              )
+            end
+            attr_accessor :cards
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Carousel component for multi-card templates. Each card can contain its own
+            # header, body, and buttons.
+            sig do
+              params(
+                cards:
+                  T::Array[
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel::Card::OrHash
+                  ],
+                type: Symbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Array of card objects, each with its own components.
+              cards:,
+              type: :CAROUSEL
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  cards:
+                    T::Array[
+                      Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel::Card
+                    ],
+                  type: Symbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class Card < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::Whatsapp::TemplateCreateParams::Component::Carousel::Card,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              sig { returns(T.nilable(T::Array[T::Hash[Symbol, T.anything]])) }
+              attr_reader :components
+
+              sig do
+                params(components: T::Array[T::Hash[Symbol, T.anything]]).void
+              end
+              attr_writer :components
+
+              sig do
+                params(
+                  components: T::Array[T::Hash[Symbol, T.anything]]
+                ).returns(T.attached_class)
+              end
+              def self.new(components: nil)
+              end
+
+              sig do
+                override.returns(
+                  { components: T::Array[T::Hash[Symbol, T.anything]] }
+                )
+              end
+              def to_hash
+              end
+            end
+          end
+
+          sig do
+            override.returns(
+              T::Array[
+                Telnyx::Whatsapp::TemplateCreateParams::Component::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
       end
     end
   end