late-sdk 0.0.685 → 0.0.686

data/lib/zernio-sdk/models/update_comment_automation_request.rb

@@ -50,6 +50,12 @@ module Zernio
     # Tag applied to a contact when they click a tracked link (requires linkTracking). Empty string clears it.
     attr_accessor :click_tag
 
+    # Seconds to wait after the trigger before sending the DM. Send 0 to clear the delay and reply immediately.
+    attr_accessor :dm_delay_seconds
+
+    # Seconds to wait before posting the public comment reply. Send 0 to clear it. The reply never goes out before the DM.
+    attr_accessor :comment_reply_delay_seconds
+
     attr_accessor :audience
 
     attr_accessor :follow_gate
@@ -94,6 +100,8 @@ module Zernio
         :'comment_reply_variations' => :'commentReplyVariations',
         :'link_tracking' => :'linkTracking',
         :'click_tag' => :'clickTag',
+        :'dm_delay_seconds' => :'dmDelaySeconds',
+        :'comment_reply_delay_seconds' => :'commentReplyDelaySeconds',
         :'audience' => :'audience',
         :'follow_gate' => :'followGate',
         :'is_active' => :'isActive'
@@ -126,6 +134,8 @@ module Zernio
         :'comment_reply_variations' => :'Array<String>',
         :'link_tracking' => :'Boolean',
         :'click_tag' => :'String',
+        :'dm_delay_seconds' => :'Integer',
+        :'comment_reply_delay_seconds' => :'Integer',
         :'audience' => :'CommentAutomationAudience',
         :'follow_gate' => :'CommentAutomationFollowGate',
         :'is_active' => :'Boolean'
@@ -216,6 +226,14 @@ module Zernio
         self.click_tag = attributes[:'click_tag']
       end
 
+      if attributes.key?(:'dm_delay_seconds')
+        self.dm_delay_seconds = attributes[:'dm_delay_seconds']
+      end
+
+      if attributes.key?(:'comment_reply_delay_seconds')
+        self.comment_reply_delay_seconds = attributes[:'comment_reply_delay_seconds']
+      end
+
       if attributes.key?(:'audience')
         self.audience = attributes[:'audience']
       end
@@ -246,6 +264,22 @@ module Zernio
         invalid_properties.push('invalid value for "comment_reply_variations", number of items must be less than or equal to 5.')
       end
 
+      if !@dm_delay_seconds.nil? && @dm_delay_seconds > 86400
+        invalid_properties.push('invalid value for "dm_delay_seconds", must be smaller than or equal to 86400.')
+      end
+
+      if !@dm_delay_seconds.nil? && @dm_delay_seconds < 0
+        invalid_properties.push('invalid value for "dm_delay_seconds", must be greater than or equal to 0.')
+      end
+
+      if !@comment_reply_delay_seconds.nil? && @comment_reply_delay_seconds > 86400
+        invalid_properties.push('invalid value for "comment_reply_delay_seconds", must be smaller than or equal to 86400.')
+      end
+
+      if !@comment_reply_delay_seconds.nil? && @comment_reply_delay_seconds < 0
+        invalid_properties.push('invalid value for "comment_reply_delay_seconds", must be greater than or equal to 0.')
+      end
+
       invalid_properties
     end
 
@@ -260,6 +294,10 @@ module Zernio
       return false if !@buttons.nil? && @buttons.length > 3
       return false if !@dm_message_variations.nil? && @dm_message_variations.length > 5
       return false if !@comment_reply_variations.nil? && @comment_reply_variations.length > 5
+      return false if !@dm_delay_seconds.nil? && @dm_delay_seconds > 86400
+      return false if !@dm_delay_seconds.nil? && @dm_delay_seconds < 0
+      return false if !@comment_reply_delay_seconds.nil? && @comment_reply_delay_seconds > 86400
+      return false if !@comment_reply_delay_seconds.nil? && @comment_reply_delay_seconds < 0
       true
     end
 
@@ -325,6 +363,42 @@ module Zernio
       @comment_reply_variations = comment_reply_variations
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] dm_delay_seconds Value to be assigned
+    def dm_delay_seconds=(dm_delay_seconds)
+      if dm_delay_seconds.nil?
+        fail ArgumentError, 'dm_delay_seconds cannot be nil'
+      end
+
+      if dm_delay_seconds > 86400
+        fail ArgumentError, 'invalid value for "dm_delay_seconds", must be smaller than or equal to 86400.'
+      end
+
+      if dm_delay_seconds < 0
+        fail ArgumentError, 'invalid value for "dm_delay_seconds", must be greater than or equal to 0.'
+      end
+
+      @dm_delay_seconds = dm_delay_seconds
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] comment_reply_delay_seconds Value to be assigned
+    def comment_reply_delay_seconds=(comment_reply_delay_seconds)
+      if comment_reply_delay_seconds.nil?
+        fail ArgumentError, 'comment_reply_delay_seconds cannot be nil'
+      end
+
+      if comment_reply_delay_seconds > 86400
+        fail ArgumentError, 'invalid value for "comment_reply_delay_seconds", must be smaller than or equal to 86400.'
+      end
+
+      if comment_reply_delay_seconds < 0
+        fail ArgumentError, 'invalid value for "comment_reply_delay_seconds", must be greater than or equal to 0.'
+      end
+
+      @comment_reply_delay_seconds = comment_reply_delay_seconds
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -343,6 +417,8 @@ module Zernio
           comment_reply_variations == o.comment_reply_variations &&
           link_tracking == o.link_tracking &&
           click_tag == o.click_tag &&
+          dm_delay_seconds == o.dm_delay_seconds &&
+          comment_reply_delay_seconds == o.comment_reply_delay_seconds &&
           audience == o.audience &&
           follow_gate == o.follow_gate &&
           is_active == o.is_active
@@ -357,7 +433,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [name, trigger, keywords, match_mode, exclude_keywords, typo_tolerance, dm_message, buttons, comment_reply, dm_message_variations, comment_reply_variations, link_tracking, click_tag, audience, follow_gate, is_active].hash
+      [name, trigger, keywords, match_mode, exclude_keywords, typo_tolerance, dm_message, buttons, comment_reply, dm_message_variations, comment_reply_variations, link_tracking, click_tag, dm_delay_seconds, comment_reply_delay_seconds, audience, follow_gate, is_active].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.685'
+  VERSION = '0.0.686'
 end

data/openapi.yaml

@@ -7686,6 +7686,14 @@ components:
             zip: { type: string, description: "Meta advanced matching (zp). US uses first 5 digits; hashed server-side. Meta only." }
             dob: { type: string, description: "Meta advanced matching (db). YYYYMMDD; hashed server-side. Meta only." }
             gender: { type: string, description: "Meta advanced matching (ge). 'f' or 'm'; hashed server-side. Meta only." }
+            leadId:
+              type: string
+              description: |
+                Meta lead ID from a Lead Ad submission, as a string. Required
+                for Conversion Leads CRM events: send it with
+                `actionSource: 'crm'` and
+                `platformData: { event_source: 'crm', lead_event_source: '<CRM name>' }`.
+                Forwarded unhashed to Meta's `user_data.lead_id`. Meta only.
             clickIds:
               type: object
               description: Platform click identifiers captured from the originating ad click.
@@ -7726,7 +7734,13 @@ components:
         platformData:
           type: object
           additionalProperties: true
-          description: Escape hatch for platform-specific fields we haven't normalized. Forwarded as-is.
+          description: |
+            Escape hatch for platform-specific fields we haven't normalized.
+            On Meta, keys are shallow-merged into `custom_data` only: fields
+            Zernio already builds (`value`, `currency`, `contents`,
+            `num_items`) always win on collision, and `user_data` (hashed
+            match keys) is never touched. Use first-class fields (e.g.
+            `user.leadId`) for anything that must reach `user_data`.
 
     ConversionDestination:
       type: object
@@ -35856,6 +35870,8 @@ paths:
                         commentReplyVariations: { type: array, items: { type: string }, description: "Alternate public replies rotated at random with commentReply. Omitted when none." }
                         linkTracking: { type: boolean, description: "Whether link buttons in the DM are wrapped in a tracked redirect to count clicks." }
                         clickTag: { type: string, description: "Tag applied to a contact when they click a tracked link." }
+                        dmDelaySeconds: { type: integer, description: "Seconds waited after the trigger before the DM is sent. Absent when the DM goes out immediately." }
+                        commentReplyDelaySeconds: { type: integer, description: "Seconds waited before the public reply is posted. Absent when it follows the DM immediately." }
                         isActive: { type: boolean }
                         stats:
                           type: object
@@ -35949,6 +35965,8 @@ paths:
                   description: "Optional alternate public replies, rotated at random alongside commentReply (picked independently of the DM). Up to 5."
                 linkTracking: { type: boolean, default: true, description: "Wrap link buttons in the DM in a tracked redirect so clicks are counted (Link Clicks / CTR). Pass false to send links exactly as written. Defaults to on." }
                 clickTag: { type: string, description: "Optional tag applied to a contact when they click a tracked link (requires linkTracking). Lets you segment clickers for broadcasts/sequences." }
+                dmDelaySeconds: { type: integer, minimum: 0, maximum: 86400, description: "Seconds to wait after the trigger before sending the DM. Omit or send 0 to reply immediately (the default). Max 86400 (24h). The trigger is still matched and deduplicated the moment the comment arrives, so a delay only moves when the response is sent." }
+                commentReplyDelaySeconds: { type: integer, minimum: 0, maximum: 86400, description: "Seconds to wait before posting the public comment reply. Omit or send 0 to post it right after the DM (the default). The reply never goes out before the DM, so a value below dmDelaySeconds is raised to it. Ignored when trigger=story_reply, which has no public reply." }
                 audience: { $ref: '#/components/schemas/CommentAutomationAudience' }
                 followGate: { $ref: '#/components/schemas/CommentAutomationFollowGate' }
       responses:
@@ -35982,6 +36000,8 @@ paths:
                       commentReplyVariations: { type: array, items: { type: string }, description: "Alternate public replies rotated at random with commentReply. Omitted when none." }
                       linkTracking: { type: boolean }
                       clickTag: { type: string }
+                      dmDelaySeconds: { type: integer, description: "Seconds waited after the trigger before the DM is sent. Absent when the DM goes out immediately." }
+                      commentReplyDelaySeconds: { type: integer, description: "Seconds waited before the public reply is posted. Absent when it follows the DM immediately." }
                       audience: { $ref: '#/components/schemas/CommentAutomationAudience' }
                       followGate: { $ref: '#/components/schemas/CommentAutomationFollowGate' }
                       isActive: { type: boolean }
@@ -36036,6 +36056,8 @@ paths:
                       commentReplyVariations: { type: array, items: { type: string }, description: "Alternate public replies rotated at random with commentReply. Omitted when none." }
                       linkTracking: { type: boolean }
                       clickTag: { type: string }
+                      dmDelaySeconds: { type: integer, description: "Seconds waited after the trigger before the DM is sent. Absent when the DM goes out immediately." }
+                      commentReplyDelaySeconds: { type: integer, description: "Seconds waited before the public reply is posted. Absent when it follows the DM immediately." }
                       audience: { $ref: '#/components/schemas/CommentAutomationAudience' }
                       followGate: { $ref: '#/components/schemas/CommentAutomationFollowGate' }
                       isActive: { type: boolean }
@@ -36052,13 +36074,14 @@ paths:
                         commenterId: { type: string }
                         commenterName: { type: string }
                         commentText: { type: string }
-                        status: { type: string, enum: [sent, failed, skipped, gated], description: "DM outcome. 'gated' = the follow-gate confirmation DM went out and we are waiting for the tap; it flips to 'sent' or 'skipped' when they tap." }
+                        status: { type: string, enum: [pending, sent, failed, skipped, gated], description: "DM outcome. 'pending' = the automation has a dmDelaySeconds and the response is queued but not sent yet. 'gated' = the follow-gate confirmation DM went out and we are waiting for the tap; it flips to 'sent' or 'skipped' when they tap." }
                         audienceOutcome: { type: string, enum: [passed, blocked, gate_sent, gate_passed, gate_failed], description: "How the audience rule resolved. Absent on automations without one." }
                         commenterIsFollower: { type: boolean, description: "Follow relationship at decision time. Absent when Instagram would not tell us (the commenter never messaged the account)." }
                         commenterFollowerCount: { type: integer }
                         error: { type: string, description: DM error message if status is failed }
                         commentReplyStatus: { type: string, enum: [sent, failed, skipped], description: "Outcome of the optional public reply on the triggering comment. 'skipped' if no commentReply was configured or if the DM failed (the public reply is not attempted in that case)." }
                         commentReplyError: { type: string, description: Public-reply error message if commentReplyStatus is failed }
+                        nextDueAt: { type: string, format: date-time, description: "When the next queued send fires. Present only while something is still pending." }
                         createdAt: { type: string, format: date-time }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
@@ -36106,6 +36129,8 @@ paths:
                   description: "Alternate public replies for random rotation. Pass [] to clear."
                 linkTracking: { type: boolean, description: "Wrap link buttons in a tracked redirect to count clicks. Pass false to send links untouched." }
                 clickTag: { type: string, description: "Tag applied to a contact when they click a tracked link (requires linkTracking). Empty string clears it." }
+                dmDelaySeconds: { type: integer, minimum: 0, maximum: 86400, description: "Seconds to wait after the trigger before sending the DM. Send 0 to clear the delay and reply immediately." }
+                commentReplyDelaySeconds: { type: integer, minimum: 0, maximum: 86400, description: "Seconds to wait before posting the public comment reply. Send 0 to clear it. The reply never goes out before the DM." }
                 audience: { $ref: '#/components/schemas/CommentAutomationAudience' }
                 followGate: { $ref: '#/components/schemas/CommentAutomationFollowGate' }
                 isActive: { type: boolean }
@@ -36167,7 +36192,7 @@ paths:
         - bearerAuth: []
       parameters:
         - { name: automationId, in: path, required: true, schema: { type: string } }
-        - { name: status, in: query, schema: { type: string, enum: [sent, failed, skipped, gated] }, description: Filter by result status }
+        - { name: status, in: query, schema: { type: string, enum: [pending, sent, failed, skipped, gated] }, description: Filter by result status }
         - { name: limit, in: query, schema: { type: integer, default: 50, minimum: 1, maximum: 200 } }
         - { name: skip, in: query, schema: { type: integer, default: 0, minimum: 0 } }
       responses:
@@ -36189,13 +36214,14 @@ paths:
                         commenterId: { type: string }
                         commenterName: { type: string }
                         commentText: { type: string }
-                        status: { type: string, enum: [sent, failed, skipped, gated], description: "DM outcome. 'gated' = the follow-gate confirmation DM went out and we are waiting for the tap; it flips to 'sent' or 'skipped' when they tap." }
+                        status: { type: string, enum: [pending, sent, failed, skipped, gated], description: "DM outcome. 'pending' = the automation has a dmDelaySeconds and the response is queued but not sent yet. 'gated' = the follow-gate confirmation DM went out and we are waiting for the tap; it flips to 'sent' or 'skipped' when they tap." }
                         audienceOutcome: { type: string, enum: [passed, blocked, gate_sent, gate_passed, gate_failed], description: "How the audience rule resolved. Absent on automations without one." }
                         commenterIsFollower: { type: boolean, description: "Follow relationship at decision time. Absent when Instagram would not tell us (the commenter never messaged the account)." }
                         commenterFollowerCount: { type: integer }
                         error: { type: string, description: DM error message if status is failed }
                         commentReplyStatus: { type: string, enum: [sent, failed, skipped], description: "Outcome of the optional public reply on the triggering comment. 'skipped' if no commentReply was configured or if the DM failed (the public reply is not attempted in that case)." }
                         commentReplyError: { type: string, description: Public-reply error message if commentReplyStatus is failed }
+                        nextDueAt: { type: string, format: date-time, description: "When the next queued send fires. Present only while something is still pending." }
                         createdAt: { type: string, format: date-time }
                   pagination:
                     type: object

data/spec/models/conversion_event_user_spec.rb

@@ -105,6 +105,12 @@ describe Zernio::ConversionEventUser do
     end
   end
 
+  describe 'test attribute "lead_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "click_ids"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/create_comment_automation200_response_automation_spec.rb

@@ -131,6 +131,18 @@ describe Zernio::CreateCommentAutomation200ResponseAutomation do
     end
   end
 
+  describe 'test attribute "dm_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "comment_reply_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "audience"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/create_comment_automation_request_spec.rb

@@ -143,6 +143,18 @@ describe Zernio::CreateCommentAutomationRequest do
     end
   end
 
+  describe 'test attribute "dm_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "comment_reply_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "audience"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/get_comment_automation200_response_automation_spec.rb

@@ -149,6 +149,18 @@ describe Zernio::GetCommentAutomation200ResponseAutomation do
     end
   end
 
+  describe 'test attribute "dm_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "comment_reply_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "audience"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/get_comment_automation200_response_logs_inner_spec.rb

@@ -60,7 +60,7 @@ describe Zernio::GetCommentAutomation200ResponseLogsInner do
   describe 'test attribute "status"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["sent", "failed", "skipped", "gated"])
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["pending", "sent", "failed", "skipped", "gated"])
       # validator.allowable_values.each do |value|
       #   expect { instance.status = value }.not_to raise_error
       # end
@@ -111,6 +111,12 @@ describe Zernio::GetCommentAutomation200ResponseLogsInner do
     end
   end
 
+  describe 'test attribute "next_due_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "created_at"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/list_comment_automations200_response_automations_inner_spec.rb

@@ -147,6 +147,18 @@ describe Zernio::ListCommentAutomations200ResponseAutomationsInner do
     end
   end
 
+  describe 'test attribute "dm_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "comment_reply_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "is_active"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/update_comment_automation_request_spec.rb

@@ -113,6 +113,18 @@ describe Zernio::UpdateCommentAutomationRequest do
     end
   end
 
+  describe 'test attribute "dm_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "comment_reply_delay_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "audience"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/