zavudev 0.5.0 → 0.7.0

data/lib/zavudev/models/template_create_params.rb

@@ -8,6 +8,7 @@ module Zavudev
       include Zavudev::Internal::Type::RequestParameters
 
       # @!attribute body
+      #   Default template body. Used when no channel-specific body is set.
       #
       #   @return [String]
       required :body, String
@@ -42,6 +43,42 @@ module Zavudev
       #   @return [Integer, nil]
       optional :code_expiration_minutes, Integer, api_name: :codeExpirationMinutes
 
+      # @!attribute footer
+      #   Footer text for the template.
+      #
+      #   @return [String, nil]
+      optional :footer, String
+
+      # @!attribute header_content
+      #   Header content (text string or media URL).
+      #
+      #   @return [String, nil]
+      optional :header_content, String, api_name: :headerContent
+
+      # @!attribute header_type
+      #   Type of header for the template.
+      #
+      #   @return [Symbol, Zavudev::Models::TemplateCreateParams::HeaderType, nil]
+      optional :header_type, enum: -> { Zavudev::TemplateCreateParams::HeaderType }, api_name: :headerType
+
+      # @!attribute instagram_body
+      #   Channel-specific body for Instagram. Falls back to `body` if not set.
+      #
+      #   @return [String, nil]
+      optional :instagram_body, String, api_name: :instagramBody
+
+      # @!attribute sms_body
+      #   Channel-specific body for SMS. Falls back to `body` if not set.
+      #
+      #   @return [String, nil]
+      optional :sms_body, String, api_name: :smsBody
+
+      # @!attribute telegram_body
+      #   Channel-specific body for Telegram. Falls back to `body` if not set.
+      #
+      #   @return [String, nil]
+      optional :telegram_body, String, api_name: :telegramBody
+
       # @!attribute variables
       #
       #   @return [Array<String>, nil]
@@ -53,8 +90,8 @@ module Zavudev
       #   @return [Symbol, Zavudev::Models::WhatsappCategory, nil]
       optional :whatsapp_category, enum: -> { Zavudev::WhatsappCategory }, api_name: :whatsappCategory
 
-      # @!method initialize(body:, language:, name:, add_security_recommendation: nil, buttons: nil, code_expiration_minutes: nil, variables: nil, whatsapp_category: nil, request_options: {})
-      #   @param body [String]
+      # @!method initialize(body:, language:, name:, add_security_recommendation: nil, buttons: nil, code_expiration_minutes: nil, footer: nil, header_content: nil, header_type: nil, instagram_body: nil, sms_body: nil, telegram_body: nil, variables: nil, whatsapp_category: nil, request_options: {})
+      #   @param body [String] Default template body. Used when no channel-specific body is set.
       #
       #   @param language [String]
       #
@@ -66,6 +103,18 @@ module Zavudev
       #
       #   @param code_expiration_minutes [Integer] Code expiration time in minutes. Only for AUTHENTICATION templates.
       #
+      #   @param footer [String] Footer text for the template.
+      #
+      #   @param header_content [String] Header content (text string or media URL).
+      #
+      #   @param header_type [Symbol, Zavudev::Models::TemplateCreateParams::HeaderType] Type of header for the template.
+      #
+      #   @param instagram_body [String] Channel-specific body for Instagram. Falls back to `body` if not set.
+      #
+      #   @param sms_body [String] Channel-specific body for SMS. Falls back to `body` if not set.
+      #
+      #   @param telegram_body [String] Channel-specific body for Telegram. Falls back to `body` if not set.
+      #
       #   @param variables [Array<String>]
       #
       #   @param whatsapp_category [Symbol, Zavudev::Models::WhatsappCategory] WhatsApp template category.
@@ -157,6 +206,19 @@ module Zavudev
           #   @return [Array<Symbol>]
         end
       end
+
+      # Type of header for the template.
+      module HeaderType
+        extend Zavudev::Internal::Type::Enum
+
+        TEXT = :text
+        IMAGE = :image
+        VIDEO = :video
+        DOCUMENT = :document
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/zavudev/models.rb

@@ -93,6 +93,8 @@ module Zavudev
 
   Contact = Zavudev::Models::Contact
 
+  ContactChannel = Zavudev::Models::ContactChannel
+
   ContactListParams = Zavudev::Models::ContactListParams
 
   ContactRetrieveByPhoneParams = Zavudev::Models::ContactRetrieveByPhoneParams

data/lib/zavudev/resources/messages.rb

@@ -113,7 +113,7 @@ module Zavudev
       #
       # @param attachments [Array<Zavudev::Models::MessageSendParams::Attachment>] Body param: Email attachments. Only supported when channel is 'email'. Maximum 4
       #
-      # @param channel [Symbol, Zavudev::Models::Channel] Body param: Delivery channel. Use 'auto' for intelligent routing. If omitted wit
+      # @param channel [Symbol, Zavudev::Models::Channel] Body param: Delivery channel. Use 'auto' for intelligent routing. If omitted, ch
       #
       # @param content [Zavudev::Models::MessageContent] Body param: Additional content for non-text message types.
       #

data/lib/zavudev/resources/senders/agent/flows.rb

@@ -11,8 +11,8 @@ module Zavudev
           #
           # @param sender_id [String]
           # @param name [String]
-          # @param steps [Array<Zavudev::Models::Senders::Agent::FlowCreateParams::Step>]
-          # @param trigger [Zavudev::Models::Senders::Agent::FlowCreateParams::Trigger]
+          # @param steps [Array<Zavudev::Models::Senders::Agent::FlowStep>]
+          # @param trigger [Zavudev::Models::Senders::Agent::FlowTrigger]
           # @param description [String]
           # @param enabled [Boolean]
           # @param priority [Integer]
@@ -73,9 +73,9 @@ module Zavudev
           #
           # @param priority [Integer] Body param
           #
-          # @param steps [Array<Zavudev::Models::Senders::Agent::FlowUpdateParams::Step>] Body param
+          # @param steps [Array<Zavudev::Models::Senders::Agent::FlowStep>] Body param
           #
-          # @param trigger [Zavudev::Models::Senders::Agent::FlowUpdateParams::Trigger] Body param
+          # @param trigger [Zavudev::Models::Senders::Agent::FlowTrigger] Body param
           #
           # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
           #

data/lib/zavudev/resources/senders/agent/tools.rb

@@ -15,7 +15,7 @@ module Zavudev
           #
           # @param name [String]
           #
-          # @param parameters [Zavudev::Models::Senders::Agent::ToolCreateParams::Parameters]
+          # @param parameters [Zavudev::Models::Senders::Agent::ToolParameters]
           #
           # @param webhook_url [String] Must be HTTPS.
           #
@@ -78,7 +78,7 @@ module Zavudev
           #
           # @param name [String] Body param
           #
-          # @param parameters [Zavudev::Models::Senders::Agent::ToolUpdateParams::Parameters] Body param
+          # @param parameters [Zavudev::Models::Senders::Agent::ToolParameters] Body param
           #
           # @param webhook_secret [String, nil] Body param
           #

data/lib/zavudev/resources/templates.rb

@@ -6,9 +6,9 @@ module Zavudev
       # Create a WhatsApp message template. Note: Templates must be approved by Meta
       # before use.
       #
-      # @overload create(body:, language:, name:, add_security_recommendation: nil, buttons: nil, code_expiration_minutes: nil, variables: nil, whatsapp_category: nil, request_options: {})
+      # @overload create(body:, language:, name:, add_security_recommendation: nil, buttons: nil, code_expiration_minutes: nil, footer: nil, header_content: nil, header_type: nil, instagram_body: nil, sms_body: nil, telegram_body: nil, variables: nil, whatsapp_category: nil, request_options: {})
       #
-      # @param body [String]
+      # @param body [String] Default template body. Used when no channel-specific body is set.
       #
       # @param language [String]
       #
@@ -20,6 +20,18 @@ module Zavudev
       #
       # @param code_expiration_minutes [Integer] Code expiration time in minutes. Only for AUTHENTICATION templates.
       #
+      # @param footer [String] Footer text for the template.
+      #
+      # @param header_content [String] Header content (text string or media URL).
+      #
+      # @param header_type [Symbol, Zavudev::Models::TemplateCreateParams::HeaderType] Type of header for the template.
+      #
+      # @param instagram_body [String] Channel-specific body for Instagram. Falls back to `body` if not set.
+      #
+      # @param sms_body [String] Channel-specific body for SMS. Falls back to `body` if not set.
+      #
+      # @param telegram_body [String] Channel-specific body for Telegram. Falls back to `body` if not set.
+      #
       # @param variables [Array<String>]
       #
       # @param whatsapp_category [Symbol, Zavudev::Models::WhatsappCategory] WhatsApp template category.

data/lib/zavudev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zavudev
-  VERSION = "0.5.0"
+  VERSION = "0.7.0"
 end

data/lib/zavudev.rb

@@ -91,6 +91,7 @@ require_relative "zavudev/models/broadcast_update_params"
 require_relative "zavudev/models/broadcast_update_response"
 require_relative "zavudev/models/channel"
 require_relative "zavudev/models/contact"
+require_relative "zavudev/models/contact_channel"
 require_relative "zavudev/models/contact_list_params"
 require_relative "zavudev/models/contact_retrieve_by_phone_params"
 require_relative "zavudev/models/contact_retrieve_params"
@@ -158,6 +159,8 @@ require_relative "zavudev/models/senders/agent/flow_duplicate_response"
 require_relative "zavudev/models/senders/agent/flow_list_params"
 require_relative "zavudev/models/senders/agent/flow_retrieve_params"
 require_relative "zavudev/models/senders/agent/flow_retrieve_response"
+require_relative "zavudev/models/senders/agent/flow_step"
+require_relative "zavudev/models/senders/agent/flow_trigger"
 require_relative "zavudev/models/senders/agent/flow_update_params"
 require_relative "zavudev/models/senders/agent/flow_update_response"
 require_relative "zavudev/models/senders/agent/knowledge_base_create_params"
@@ -176,6 +179,7 @@ require_relative "zavudev/models/senders/agent/tool_create_params"
 require_relative "zavudev/models/senders/agent/tool_create_response"
 require_relative "zavudev/models/senders/agent/tool_delete_params"
 require_relative "zavudev/models/senders/agent/tool_list_params"
+require_relative "zavudev/models/senders/agent/tool_parameters"
 require_relative "zavudev/models/senders/agent/tool_retrieve_params"
 require_relative "zavudev/models/senders/agent/tool_retrieve_response"
 require_relative "zavudev/models/senders/agent/tool_test_params"

data/rbi/zavudev/models/contact.rbi

@@ -24,10 +24,10 @@ module Zavudev
       attr_accessor :verified
 
       # All communication channels for this contact.
-      sig { returns(T.nilable(T::Array[Zavudev::Contact::Channel])) }
+      sig { returns(T.nilable(T::Array[Zavudev::ContactChannel])) }
       attr_reader :channels
 
-      sig { params(channels: T::Array[Zavudev::Contact::Channel::OrHash]).void }
+      sig { params(channels: T::Array[Zavudev::ContactChannel::OrHash]).void }
       attr_writer :channels
 
       sig { returns(T.nilable(String)) }
@@ -97,7 +97,7 @@ module Zavudev
           created_at: Time,
           metadata: T::Hash[Symbol, String],
           verified: T::Boolean,
-          channels: T::Array[Zavudev::Contact::Channel::OrHash],
+          channels: T::Array[Zavudev::ContactChannel::OrHash],
           country_code: String,
           default_channel: Zavudev::Contact::DefaultChannel::OrSymbol,
           display_name: String,
@@ -146,7 +146,7 @@ module Zavudev
             created_at: Time,
             metadata: T::Hash[Symbol, String],
             verified: T::Boolean,
-            channels: T::Array[Zavudev::Contact::Channel],
+            channels: T::Array[Zavudev::ContactChannel],
             country_code: String,
             default_channel: Zavudev::Contact::DefaultChannel::TaggedSymbol,
             display_name: String,
@@ -162,237 +162,6 @@ module Zavudev
       def to_hash
       end
 
-      class Channel < Zavudev::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(Zavudev::Contact::Channel, Zavudev::Internal::AnyHash)
-          end
-
-        sig { returns(String) }
-        attr_accessor :id
-
-        # Channel type.
-        sig { returns(Zavudev::Contact::Channel::Channel::TaggedSymbol) }
-        attr_accessor :channel
-
-        sig { returns(Time) }
-        attr_accessor :created_at
-
-        # Channel identifier (phone number or email address).
-        sig { returns(String) }
-        attr_accessor :identifier
-
-        # Whether this is the primary channel for its type.
-        sig { returns(T::Boolean) }
-        attr_accessor :is_primary
-
-        # Whether this channel has been verified.
-        sig { returns(T::Boolean) }
-        attr_accessor :verified
-
-        # ISO country code for phone numbers.
-        sig { returns(T.nilable(String)) }
-        attr_reader :country_code
-
-        sig { params(country_code: String).void }
-        attr_writer :country_code
-
-        # Optional label for the channel.
-        sig { returns(T.nilable(String)) }
-        attr_reader :label
-
-        sig { params(label: String).void }
-        attr_writer :label
-
-        # Last time a message was received on this channel.
-        sig { returns(T.nilable(Time)) }
-        attr_reader :last_inbound_at
-
-        sig { params(last_inbound_at: Time).void }
-        attr_writer :last_inbound_at
-
-        sig { returns(T.nilable(T::Hash[Symbol, String])) }
-        attr_reader :metadata
-
-        sig { params(metadata: T::Hash[Symbol, String]).void }
-        attr_writer :metadata
-
-        # Delivery metrics for this channel.
-        sig { returns(T.nilable(Zavudev::Contact::Channel::Metrics)) }
-        attr_reader :metrics
-
-        sig { params(metrics: Zavudev::Contact::Channel::Metrics::OrHash).void }
-        attr_writer :metrics
-
-        sig { returns(T.nilable(Time)) }
-        attr_reader :updated_at
-
-        sig { params(updated_at: Time).void }
-        attr_writer :updated_at
-
-        # A communication channel for a contact.
-        sig do
-          params(
-            id: String,
-            channel: Zavudev::Contact::Channel::Channel::OrSymbol,
-            created_at: Time,
-            identifier: String,
-            is_primary: T::Boolean,
-            verified: T::Boolean,
-            country_code: String,
-            label: String,
-            last_inbound_at: Time,
-            metadata: T::Hash[Symbol, String],
-            metrics: Zavudev::Contact::Channel::Metrics::OrHash,
-            updated_at: Time
-          ).returns(T.attached_class)
-        end
-        def self.new(
-          id:,
-          # Channel type.
-          channel:,
-          created_at:,
-          # Channel identifier (phone number or email address).
-          identifier:,
-          # Whether this is the primary channel for its type.
-          is_primary:,
-          # Whether this channel has been verified.
-          verified:,
-          # ISO country code for phone numbers.
-          country_code: nil,
-          # Optional label for the channel.
-          label: nil,
-          # Last time a message was received on this channel.
-          last_inbound_at: nil,
-          metadata: nil,
-          # Delivery metrics for this channel.
-          metrics: nil,
-          updated_at: nil
-        )
-        end
-
-        sig do
-          override.returns(
-            {
-              id: String,
-              channel: Zavudev::Contact::Channel::Channel::TaggedSymbol,
-              created_at: Time,
-              identifier: String,
-              is_primary: T::Boolean,
-              verified: T::Boolean,
-              country_code: String,
-              label: String,
-              last_inbound_at: Time,
-              metadata: T::Hash[Symbol, String],
-              metrics: Zavudev::Contact::Channel::Metrics,
-              updated_at: Time
-            }
-          )
-        end
-        def to_hash
-        end
-
-        # Channel type.
-        module Channel
-          extend Zavudev::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias { T.all(Symbol, Zavudev::Contact::Channel::Channel) }
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          SMS = T.let(:sms, Zavudev::Contact::Channel::Channel::TaggedSymbol)
-          WHATSAPP =
-            T.let(:whatsapp, Zavudev::Contact::Channel::Channel::TaggedSymbol)
-          EMAIL =
-            T.let(:email, Zavudev::Contact::Channel::Channel::TaggedSymbol)
-          TELEGRAM =
-            T.let(:telegram, Zavudev::Contact::Channel::Channel::TaggedSymbol)
-          VOICE =
-            T.let(:voice, Zavudev::Contact::Channel::Channel::TaggedSymbol)
-
-          sig do
-            override.returns(
-              T::Array[Zavudev::Contact::Channel::Channel::TaggedSymbol]
-            )
-          end
-          def self.values
-          end
-        end
-
-        class Metrics < Zavudev::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                Zavudev::Contact::Channel::Metrics,
-                Zavudev::Internal::AnyHash
-              )
-            end
-
-          sig { returns(T.nilable(Float)) }
-          attr_reader :avg_delivery_time_ms
-
-          sig { params(avg_delivery_time_ms: Float).void }
-          attr_writer :avg_delivery_time_ms
-
-          sig { returns(T.nilable(Integer)) }
-          attr_reader :failure_count
-
-          sig { params(failure_count: Integer).void }
-          attr_writer :failure_count
-
-          sig { returns(T.nilable(Time)) }
-          attr_reader :last_success_at
-
-          sig { params(last_success_at: Time).void }
-          attr_writer :last_success_at
-
-          sig { returns(T.nilable(Integer)) }
-          attr_reader :success_count
-
-          sig { params(success_count: Integer).void }
-          attr_writer :success_count
-
-          sig { returns(T.nilable(Integer)) }
-          attr_reader :total_attempts
-
-          sig { params(total_attempts: Integer).void }
-          attr_writer :total_attempts
-
-          # Delivery metrics for this channel.
-          sig do
-            params(
-              avg_delivery_time_ms: Float,
-              failure_count: Integer,
-              last_success_at: Time,
-              success_count: Integer,
-              total_attempts: Integer
-            ).returns(T.attached_class)
-          end
-          def self.new(
-            avg_delivery_time_ms: nil,
-            failure_count: nil,
-            last_success_at: nil,
-            success_count: nil,
-            total_attempts: nil
-          )
-          end
-
-          sig do
-            override.returns(
-              {
-                avg_delivery_time_ms: Float,
-                failure_count: Integer,
-                last_success_at: Time,
-                success_count: Integer,
-                total_attempts: Integer
-              }
-            )
-          end
-          def to_hash
-          end
-        end
-      end
-
       # Preferred channel for this contact.
       module DefaultChannel
         extend Zavudev::Internal::Type::Enum