late-sdk 0.0.699 → 0.0.701

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

@@ -25,6 +25,9 @@ module Zernio
 
     attr_accessor :comment_text
 
+    # Which door triggered this send. Absent on rows written before this field existed (all of those are comment-triggered).
+    attr_accessor :source
+
     # 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.
     attr_accessor :status
 
@@ -80,6 +83,7 @@ module Zernio
         :'commenter_id' => :'commenterId',
         :'commenter_name' => :'commenterName',
         :'comment_text' => :'commentText',
+        :'source' => :'source',
         :'status' => :'status',
         :'audience_outcome' => :'audienceOutcome',
         :'commenter_is_follower' => :'commenterIsFollower',
@@ -110,6 +114,7 @@ module Zernio
         :'commenter_id' => :'String',
         :'commenter_name' => :'String',
         :'comment_text' => :'String',
+        :'source' => :'String',
         :'status' => :'String',
         :'audience_outcome' => :'String',
         :'commenter_is_follower' => :'Boolean',
@@ -164,6 +169,10 @@ module Zernio
         self.comment_text = attributes[:'comment_text']
       end
 
+      if attributes.key?(:'source')
+        self.source = attributes[:'source']
+      end
+
       if attributes.key?(:'status')
         self.status = attributes[:'status']
       end
@@ -213,6 +222,8 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      source_validator = EnumAttributeValidator.new('String', ["comment", "story_reply", "dm"])
+      return false unless source_validator.valid?(@source)
       status_validator = EnumAttributeValidator.new('String', ["pending", "sent", "failed", "skipped", "gated"])
       return false unless status_validator.valid?(@status)
       audience_outcome_validator = EnumAttributeValidator.new('String', ["passed", "blocked", "gate_sent", "gate_passed", "gate_failed"])
@@ -222,6 +233,16 @@ module Zernio
       true
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] source Object to be assigned
+    def source=(source)
+      validator = EnumAttributeValidator.new('String', ["comment", "story_reply", "dm"])
+      unless validator.valid?(source)
+        fail ArgumentError, "invalid value for \"source\", must be one of #{validator.allowable_values}."
+      end
+      @source = source
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] status Object to be assigned
     def status=(status)
@@ -262,6 +283,7 @@ module Zernio
           commenter_id == o.commenter_id &&
           commenter_name == o.commenter_name &&
           comment_text == o.comment_text &&
+          source == o.source &&
           status == o.status &&
           audience_outcome == o.audience_outcome &&
           commenter_is_follower == o.commenter_is_follower &&
@@ -282,7 +304,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, comment_id, commenter_id, commenter_name, comment_text, status, audience_outcome, commenter_is_follower, commenter_follower_count, error, comment_reply_status, comment_reply_error, next_due_at, created_at].hash
+      [id, comment_id, commenter_id, commenter_name, comment_text, source, status, audience_outcome, commenter_is_follower, commenter_follower_count, error, comment_reply_status, comment_reply_error, next_due_at, created_at].hash
     end
 
     # Builds the object from hash

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

@@ -19,8 +19,12 @@ module Zernio
 
     attr_accessor :type
 
+    # Direct media link. On Instagram and Facebook this is a signed Meta CDN url that EXPIRES: use it now, do not store it. Persist `refreshUrl` instead.
     attr_accessor :url
 
+    # Instagram and Facebook only. Endpoint that resolves this attachment to a working url every time, re-minting it from Meta when the stored one has expired. Safe to store and render indefinitely.
+    attr_accessor :refresh_url
+
     attr_accessor :filename
 
     attr_accessor :preview_url
@@ -53,6 +57,7 @@ module Zernio
         :'id' => :'id',
         :'type' => :'type',
         :'url' => :'url',
+        :'refresh_url' => :'refreshUrl',
         :'filename' => :'filename',
         :'preview_url' => :'previewUrl'
       }
@@ -74,6 +79,7 @@ module Zernio
         :'id' => :'String',
         :'type' => :'String',
         :'url' => :'String',
+        :'refresh_url' => :'String',
         :'filename' => :'String',
         :'preview_url' => :'String'
       }
@@ -82,6 +88,7 @@ module Zernio
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'refresh_url',
         :'filename',
         :'preview_url'
       ])
@@ -115,6 +122,10 @@ module Zernio
         self.url = attributes[:'url']
       end
 
+      if attributes.key?(:'refresh_url')
+        self.refresh_url = attributes[:'refresh_url']
+      end
+
       if attributes.key?(:'filename')
         self.filename = attributes[:'filename']
       end
@@ -159,6 +170,7 @@ module Zernio
           id == o.id &&
           type == o.type &&
           url == o.url &&
+          refresh_url == o.refresh_url &&
           filename == o.filename &&
           preview_url == o.preview_url
     end
@@ -172,7 +184,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, type, url, filename, preview_url].hash
+      [id, type, url, refresh_url, filename, preview_url].hash
     end
 
     # Builds the object from hash

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

@@ -0,0 +1,167 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class GetMessageAttachment200Response < ApiModelBase
+    attr_accessor :status
+
+    # Live media url. Short-lived; re-request this endpoint rather than storing it.
+    attr_accessor :url
+
+    # True when the stored url had expired and was re-minted from the platform.
+    attr_accessor :refreshed
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'status' => :'status',
+        :'url' => :'url',
+        :'refreshed' => :'refreshed'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'status' => :'String',
+        :'url' => :'String',
+        :'refreshed' => :'Boolean'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::GetMessageAttachment200Response` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::GetMessageAttachment200Response`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'status')
+        self.status = attributes[:'status']
+      end
+
+      if attributes.key?(:'url')
+        self.url = attributes[:'url']
+      end
+
+      if attributes.key?(:'refreshed')
+        self.refreshed = attributes[:'refreshed']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          status == o.status &&
+          url == o.url &&
+          refreshed == o.refreshed
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [status, url, refreshed].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

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

@@ -67,6 +67,9 @@ module Zernio
     # Seconds waited before the public reply is posted. Absent when it follows the DM immediately.
     attr_accessor :comment_reply_delay_seconds
 
+    # Whether these keywords also fire on a plain inbound DM.
+    attr_accessor :also_match_in_dms
+
     attr_accessor :is_active
 
     attr_accessor :stats
@@ -119,6 +122,7 @@ module Zernio
         :'click_tag' => :'clickTag',
         :'dm_delay_seconds' => :'dmDelaySeconds',
         :'comment_reply_delay_seconds' => :'commentReplyDelaySeconds',
+        :'also_match_in_dms' => :'alsoMatchInDms',
         :'is_active' => :'isActive',
         :'stats' => :'stats',
         :'created_at' => :'createdAt'
@@ -159,6 +163,7 @@ module Zernio
         :'click_tag' => :'String',
         :'dm_delay_seconds' => :'Integer',
         :'comment_reply_delay_seconds' => :'Integer',
+        :'also_match_in_dms' => :'Boolean',
         :'is_active' => :'Boolean',
         :'stats' => :'ListCommentAutomations200ResponseAutomationsInnerStats',
         :'created_at' => :'Time'
@@ -281,6 +286,10 @@ module Zernio
         self.comment_reply_delay_seconds = attributes[:'comment_reply_delay_seconds']
       end
 
+      if attributes.key?(:'also_match_in_dms')
+        self.also_match_in_dms = attributes[:'also_match_in_dms']
+      end
+
       if attributes.key?(:'is_active')
         self.is_active = attributes[:'is_active']
       end
@@ -371,6 +380,7 @@ module Zernio
           click_tag == o.click_tag &&
           dm_delay_seconds == o.dm_delay_seconds &&
           comment_reply_delay_seconds == o.comment_reply_delay_seconds &&
+          also_match_in_dms == o.also_match_in_dms &&
           is_active == o.is_active &&
           stats == o.stats &&
           created_at == o.created_at
@@ -385,7 +395,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, name, platform, trigger, account_id, platform_post_id, post_title, keywords, match_mode, exclude_keywords, typo_tolerance, dm_message, buttons, template, comment_reply, dm_message_variations, comment_reply_variations, link_tracking, click_tag, dm_delay_seconds, comment_reply_delay_seconds, is_active, stats, created_at].hash
+      [id, name, platform, trigger, account_id, platform_post_id, post_title, keywords, match_mode, exclude_keywords, typo_tolerance, dm_message, buttons, template, comment_reply, dm_message_variations, comment_reply_variations, link_tracking, click_tag, dm_delay_seconds, comment_reply_delay_seconds, also_match_in_dms, is_active, stats, created_at].hash
     end
 
     # Builds the object from hash

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

@@ -49,6 +49,9 @@ module Zernio
 
     attr_accessor :follow_gate
 
+    # Whether these keywords also fire on a plain inbound DM.
+    attr_accessor :also_match_in_dms
+
     attr_accessor :is_active
 
     attr_accessor :updated_at
@@ -92,6 +95,7 @@ module Zernio
         :'comment_reply_variations' => :'commentReplyVariations',
         :'audience' => :'audience',
         :'follow_gate' => :'followGate',
+        :'also_match_in_dms' => :'alsoMatchInDms',
         :'is_active' => :'isActive',
         :'updated_at' => :'updatedAt'
       }
@@ -124,6 +128,7 @@ module Zernio
         :'comment_reply_variations' => :'Array<String>',
         :'audience' => :'CommentAutomationAudience',
         :'follow_gate' => :'CommentAutomationFollowGate',
+        :'also_match_in_dms' => :'Boolean',
         :'is_active' => :'Boolean',
         :'updated_at' => :'Time'
       }
@@ -218,6 +223,10 @@ module Zernio
         self.follow_gate = attributes[:'follow_gate']
       end
 
+      if attributes.key?(:'also_match_in_dms')
+        self.also_match_in_dms = attributes[:'also_match_in_dms']
+      end
+
       if attributes.key?(:'is_active')
         self.is_active = attributes[:'is_active']
       end
@@ -273,6 +282,7 @@ module Zernio
           comment_reply_variations == o.comment_reply_variations &&
           audience == o.audience &&
           follow_gate == o.follow_gate &&
+          also_match_in_dms == o.also_match_in_dms &&
           is_active == o.is_active &&
           updated_at == o.updated_at
     end
@@ -286,7 +296,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, name, keywords, match_mode, exclude_keywords, typo_tolerance, dm_message, buttons, template, comment_reply, dm_message_variations, comment_reply_variations, audience, follow_gate, is_active, updated_at].hash
+      [id, name, keywords, match_mode, exclude_keywords, typo_tolerance, dm_message, buttons, template, comment_reply, dm_message_variations, comment_reply_variations, audience, follow_gate, also_match_in_dms, is_active, updated_at].hash
     end
 
     # Builds the object from hash

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

@@ -52,6 +52,9 @@ module Zernio
     # Tag applied to a contact when they click a tracked link (requires linkTracking). Empty string clears it.
     attr_accessor :click_tag
 
+    # Also fire these keywords on a plain inbound DM. Enabling it requires the automation to end up with at least one keyword (this request's keywords if you send them, otherwise the stored ones) and is rejected on story_reply automations.
+    attr_accessor :also_match_in_dms
+
     # Seconds to wait after the trigger before sending the DM. Send 0 to clear the delay and reply immediately.
     attr_accessor :dm_delay_seconds
 
@@ -103,6 +106,7 @@ module Zernio
         :'comment_reply_variations' => :'commentReplyVariations',
         :'link_tracking' => :'linkTracking',
         :'click_tag' => :'clickTag',
+        :'also_match_in_dms' => :'alsoMatchInDms',
         :'dm_delay_seconds' => :'dmDelaySeconds',
         :'comment_reply_delay_seconds' => :'commentReplyDelaySeconds',
         :'audience' => :'audience',
@@ -138,6 +142,7 @@ module Zernio
         :'comment_reply_variations' => :'Array<String>',
         :'link_tracking' => :'Boolean',
         :'click_tag' => :'String',
+        :'also_match_in_dms' => :'Boolean',
         :'dm_delay_seconds' => :'Integer',
         :'comment_reply_delay_seconds' => :'Integer',
         :'audience' => :'CommentAutomationAudience',
@@ -235,6 +240,10 @@ module Zernio
         self.click_tag = attributes[:'click_tag']
       end
 
+      if attributes.key?(:'also_match_in_dms')
+        self.also_match_in_dms = attributes[:'also_match_in_dms']
+      end
+
       if attributes.key?(:'dm_delay_seconds')
         self.dm_delay_seconds = attributes[:'dm_delay_seconds']
       end
@@ -427,6 +436,7 @@ module Zernio
           comment_reply_variations == o.comment_reply_variations &&
           link_tracking == o.link_tracking &&
           click_tag == o.click_tag &&
+          also_match_in_dms == o.also_match_in_dms &&
           dm_delay_seconds == o.dm_delay_seconds &&
           comment_reply_delay_seconds == o.comment_reply_delay_seconds &&
           audience == o.audience &&
@@ -443,7 +453,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, template, 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
+      [name, trigger, keywords, match_mode, exclude_keywords, typo_tolerance, dm_message, buttons, template, comment_reply, dm_message_variations, comment_reply_variations, link_tracking, click_tag, also_match_in_dms, 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.699'
+  VERSION = '0.0.701'
 end

data/lib/zernio-sdk.rb

@@ -629,6 +629,7 @@ require 'zernio-sdk/models/get_linked_in_supply_forecast_request'
 require 'zernio-sdk/models/get_linked_in_supply_forecast_request_competing_bid'
 require 'zernio-sdk/models/get_media_presigned_url200_response'
 require 'zernio-sdk/models/get_media_presigned_url_request'
+require 'zernio-sdk/models/get_message_attachment200_response'
 require 'zernio-sdk/models/get_messenger_menu200_response'
 require 'zernio-sdk/models/get_pending_o_auth_data200_response'
 require 'zernio-sdk/models/get_pending_o_auth_data200_response_organizations_inner'

data/openapi.yaml

@@ -24390,7 +24390,12 @@ paths:
                             properties:
                               id: { type: string }
                               type: { type: string, enum: [image, video, audio, file, sticker, share] }
-                              url: { type: string }
+                              url:
+                                type: string
+                                description: 'Direct media link. On Instagram and Facebook this is a signed Meta CDN url that EXPIRES: use it now, do not store it. Persist `refreshUrl` instead.'
+                              refreshUrl:
+                                type: [string, "null"]
+                                description: 'Instagram and Facebook only. Endpoint that resolves this attachment to a working url every time, re-minting it from Meta when the stored one has expired. Safe to store and render indefinitely.'
                               filename: { type: [string, "null"] }
                               previewUrl: { type: [string, "null"] }
                         subject: { type: [string, "null"], description: Reddit message subject }
@@ -25660,6 +25665,77 @@ paths:
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
+  /v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}:
+    get:
+      x-resource-group: "messages"
+      operationId: getMessageAttachment
+      summary: Resolve message attachment
+      description: |
+        Resolve one attachment on a message to a media url that works right now.
+
+        Instagram and Facebook sign DM media urls per request and expire them, so
+        the `url` on a message is a snapshot: it works when you read the message
+        and stops working later. This endpoint checks the stored url and, when it
+        has gone stale, re-mints the message's media from Meta and persists it
+        before answering. The message id never expires, so this URL is the one to
+        store — it is returned on each attachment as `refreshUrl`.
+
+        By default it responds `302` to the live media url, so it can be used
+        directly as an `<img src>` on a browser session. API-key integrators
+        should pass `?format=json` and read `url` off the body, since a browser
+        cannot attach an Authorization header to an image request.
+
+        Only Instagram and Facebook media can be re-minted. On other platforms
+        the stored url is returned as-is when it still resolves, and `404`
+        otherwise.
+      tags: [Messages]
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - name: conversationId
+          in: path
+          required: true
+          schema: { type: string }
+          description: 'The conversation ID (Zernio id or platform conversation id)'
+        - name: messageId
+          in: path
+          required: true
+          schema: { type: string }
+          description: 'The message id as returned by the list-messages endpoint (the platform message id)'
+        - name: index
+          in: path
+          required: true
+          schema: { type: integer, minimum: 0 }
+          description: 'Zero-based position of the attachment in the message''s attachments array'
+        - name: accountId
+          in: query
+          required: true
+          schema: { type: string }
+          description: Social account ID
+        - name: format
+          in: query
+          required: false
+          schema: { type: string, enum: [redirect, json], default: redirect }
+          description: '`redirect` (default) answers 302 to the media; `json` returns the url in the body'
+      responses:
+        '200':
+          description: 'Resolved url (only when format=json)'
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status: { type: string, example: success }
+                  url: { type: string, description: 'Live media url. Short-lived; re-request this endpoint rather than storing it.' }
+                  refreshed: { type: boolean, description: True when the stored url had expired and was re-minted from the platform. }
+        '302':
+          description: Redirect to the live media url
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: Inbox addon required
+        '404':
+          description: 'Account, conversation, message or attachment not found, or the platform no longer serves the media'
+
   /v1/inbox/comments:
     get:
       x-resource-group: "engagement"
@@ -36147,6 +36223,7 @@ paths:
                         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." }
+                        alsoMatchInDms: { type: boolean, description: "Whether these keywords also fire on a plain inbound DM." }
                         isActive: { type: boolean }
                         stats:
                           type: object
@@ -36194,6 +36271,12 @@ paths:
         confirmation DM (`followGate`) and then delivers the real DM automatically. People we
         already know follow you skip the tap entirely.
 
+        Set `alsoMatchInDms: true` on a `comment` automation to also answer people who send
+        a keyword as a direct message instead of commenting it. One automation then covers
+        both doors, and each door is deduplicated separately (someone who already got the DM
+        from their comment still gets it if they later DM the keyword). Requires at least one
+        keyword.
+
         Links in the DM's buttons can be click-tracked (`linkTracking`, on by default) and
         clickers optionally tagged (`clickTag`) for segmentation. Stats returned include
         delivered, read, and link clicks.
@@ -36245,6 +36328,7 @@ paths:
                 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." }
+                alsoMatchInDms: { type: boolean, default: false, description: "Also fire these keywords on a plain inbound DM, so the automation answers people who message the keyword instead of commenting it. Requires at least one keyword (an empty keyword list means 'match anything', which would answer every inbound message) and is rejected on story_reply automations, which already trigger on DMs. Dedup is per door: a contact who already received the DM from their comment can still receive it from a DM." }
                 audience: { $ref: '#/components/schemas/CommentAutomationAudience' }
                 followGate: { $ref: '#/components/schemas/CommentAutomationFollowGate' }
       responses:
@@ -36284,6 +36368,7 @@ paths:
                       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' }
+                      alsoMatchInDms: { type: boolean, description: "Whether these keywords also fire on a plain inbound DM." }
                       isActive: { type: boolean }
                       stats: { type: object, properties: { totalTriggered: { type: integer }, totalSent: { type: integer }, totalFailed: { type: integer } } }
                       createdAt: { type: string, format: date-time }
@@ -36342,6 +36427,7 @@ paths:
                       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' }
+                      alsoMatchInDms: { type: boolean, description: "Whether these keywords also fire on a plain inbound DM." }
                       isActive: { type: boolean }
                       stats: { type: object, properties: { totalTriggered: { type: integer }, totalSent: { type: integer }, totalFailed: { type: integer } } }
                       createdAt: { type: string, format: date-time }
@@ -36356,6 +36442,7 @@ paths:
                         commenterId: { type: string }
                         commenterName: { type: string }
                         commentText: { type: string }
+                        source: { type: string, enum: [comment, story_reply, dm], description: "Which door triggered this send. Absent on rows written before this field existed (all of those are comment-triggered)." }
                         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)." }
@@ -36416,6 +36503,7 @@ 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." }
+                alsoMatchInDms: { type: boolean, description: "Also fire these keywords on a plain inbound DM. Enabling it requires the automation to end up with at least one keyword (this request's keywords if you send them, otherwise the stored ones) and is rejected on story_reply automations." }
                 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' }
@@ -36451,6 +36539,7 @@ paths:
                       commentReplyVariations: { type: array, items: { type: string }, description: "Alternate public replies rotated at random with commentReply. Omitted when none." }
                       audience: { $ref: '#/components/schemas/CommentAutomationAudience' }
                       followGate: { $ref: '#/components/schemas/CommentAutomationFollowGate' }
+                      alsoMatchInDms: { type: boolean, description: "Whether these keywords also fire on a plain inbound DM." }
                       isActive: { type: boolean }
                       updatedAt: { type: string, format: date-time }
         '401': { $ref: '#/components/responses/Unauthorized' }
@@ -36503,6 +36592,7 @@ paths:
                         commenterId: { type: string }
                         commenterName: { type: string }
                         commentText: { type: string }
+                        source: { type: string, enum: [comment, story_reply, dm], description: "Which door triggered this send. Absent on rows written before this field existed (all of those are comment-triggered)." }
                         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)." }