late-sdk 0.0.684 → 0.0.686

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 550c3cc0463ec0c6089af0d3420e1fe04d7dfb626bdde7b1c87f9054664ff307
-  data.tar.gz: 49a3a122c78e25747c39fb4452ac951593a126e65d7bf224f6ec2c3553539437
+  metadata.gz: f4f22a8096310e1cc8f40bb4e8c383ec0e349773ef668159de65699f0542512d
+  data.tar.gz: 2772a4785d3e100f8a3b370f7bcdd12b7accbae51ab231e3c9ed16b86883b56c
 SHA512:
-  metadata.gz: 11a79538fcdf3db3151b79737d8cfcc1a4612d7ea9807a23e422c5ac7739c81d0cd773421b70b83d3a243ca5a5ef6558d6777410a8201cce3a6c8d4a8eaeeecc
-  data.tar.gz: 032edb43b2fbe1aa7a96b64f051767b7f3a3342defa6b17aee08c2371f711b82838bf334dbc192550a934a6e5412c1e6ac2ac9c1a68de5a73dae42dfab41c427
+  metadata.gz: e52482d8cb3484b6e2339788b85e51455ba117ecb6ce0a0fddb14afbf093a6268da890b8cd6d2bcd09cb2d26368762a0184758e98977a66f04e5824bff650c0f
+  data.tar.gz: 7ab9db137b6dc2e723e48f102315dcc7fe7eb869d63e8dfbe11cc9efc89150e3fb5ffe2db35c97f7ace0679d20e31ea512aad814f280bc1895b202ef785981c9

data/README.md

@@ -87,6 +87,7 @@ Class | Method | HTTP request | Description
 *Zernio::AccountsApi* | [**get_account_health**](docs/AccountsApi.md#get_account_health) | **GET** /v1/accounts/{accountId}/health | Check account health
 *Zernio::AccountsApi* | [**get_all_accounts_health**](docs/AccountsApi.md#get_all_accounts_health) | **GET** /v1/accounts/health | Check accounts health
 *Zernio::AccountsApi* | [**get_follower_stats**](docs/AccountsApi.md#get_follower_stats) | **GET** /v1/accounts/follower-stats | Get follower stats
+*Zernio::AccountsApi* | [**get_instagram_follow_status**](docs/AccountsApi.md#get_instagram_follow_status) | **GET** /v1/accounts/{accountId}/follow-status/{userId} | Check whether an Instagram user follows the account
 *Zernio::AccountsApi* | [**get_slack_settings**](docs/AccountsApi.md#get_slack_settings) | **GET** /v1/accounts/{accountId}/slack-settings | Get Slack account settings
 *Zernio::AccountsApi* | [**get_tik_tok_creator_info**](docs/AccountsApi.md#get_tik_tok_creator_info) | **GET** /v1/accounts/{accountId}/tiktok/creator-info | Get TikTok creator info
 *Zernio::AccountsApi* | [**list_accounts**](docs/AccountsApi.md#list_accounts) | **GET** /v1/accounts | List accounts
@@ -725,6 +726,8 @@ Class | Method | HTTP request | Description
  - [Zernio::CheckPhoneNumberPortabilityRequest](docs/CheckPhoneNumberPortabilityRequest.md)
  - [Zernio::CheckVerification200Response](docs/CheckVerification200Response.md)
  - [Zernio::CheckVerificationRequest](docs/CheckVerificationRequest.md)
+ - [Zernio::CommentAutomationAudience](docs/CommentAutomationAudience.md)
+ - [Zernio::CommentAutomationFollowGate](docs/CommentAutomationFollowGate.md)
  - [Zernio::CompleteGoogleBusinessVerificationRequest](docs/CompleteGoogleBusinessVerificationRequest.md)
  - [Zernio::CompleteTelegramConnect200Response](docs/CompleteTelegramConnect200Response.md)
  - [Zernio::CompleteWhatsAppPhoneSelection200Response](docs/CompleteWhatsAppPhoneSelection200Response.md)
@@ -1183,6 +1186,7 @@ Class | Method | HTTP request | Description
  - [Zernio::GetInboxVolume200ResponseTimeseriesInner](docs/GetInboxVolume200ResponseTimeseriesInner.md)
  - [Zernio::GetInboxVolume400Response](docs/GetInboxVolume400Response.md)
  - [Zernio::GetInstagramAccountInsights404Response](docs/GetInstagramAccountInsights404Response.md)
+ - [Zernio::GetInstagramFollowStatus200Response](docs/GetInstagramFollowStatus200Response.md)
  - [Zernio::GetInstagramPublishingLimit200Response](docs/GetInstagramPublishingLimit200Response.md)
  - [Zernio::GetInstagramStoryInsights200Response](docs/GetInstagramStoryInsights200Response.md)
  - [Zernio::GetInstagramStoryInsights200ResponseData](docs/GetInstagramStoryInsights200ResponseData.md)
@@ -2107,6 +2111,7 @@ Class | Method | HTTP request | Description
  - [Zernio::WebhookPayloadCommentCommentAd](docs/WebhookPayloadCommentCommentAd.md)
  - [Zernio::WebhookPayloadCommentCommentAttachment](docs/WebhookPayloadCommentCommentAttachment.md)
  - [Zernio::WebhookPayloadCommentCommentAuthor](docs/WebhookPayloadCommentCommentAuthor.md)
+ - [Zernio::WebhookPayloadCommentCommentAuthorInstagramProfile](docs/WebhookPayloadCommentCommentAuthorInstagramProfile.md)
  - [Zernio::WebhookPayloadCommentPost](docs/WebhookPayloadCommentPost.md)
  - [Zernio::WebhookPayloadConversationStarted](docs/WebhookPayloadConversationStarted.md)
  - [Zernio::WebhookPayloadConversationStartedConversation](docs/WebhookPayloadConversationStartedConversation.md)

data/docs/AccountsApi.md

@@ -8,6 +8,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**get_account_health**](AccountsApi.md#get_account_health) | **GET** /v1/accounts/{accountId}/health | Check account health |
 | [**get_all_accounts_health**](AccountsApi.md#get_all_accounts_health) | **GET** /v1/accounts/health | Check accounts health |
 | [**get_follower_stats**](AccountsApi.md#get_follower_stats) | **GET** /v1/accounts/follower-stats | Get follower stats |
+| [**get_instagram_follow_status**](AccountsApi.md#get_instagram_follow_status) | **GET** /v1/accounts/{accountId}/follow-status/{userId} | Check whether an Instagram user follows the account |
 | [**get_slack_settings**](AccountsApi.md#get_slack_settings) | **GET** /v1/accounts/{accountId}/slack-settings | Get Slack account settings |
 | [**get_tik_tok_creator_info**](AccountsApi.md#get_tik_tok_creator_info) | **GET** /v1/accounts/{accountId}/tiktok/creator-info | Get TikTok creator info |
 | [**list_accounts**](AccountsApi.md#list_accounts) | **GET** /v1/accounts | List accounts |
@@ -308,6 +309,81 @@ end
 - **Accept**: application/json
 
 
+## get_instagram_follow_status
+
+> <GetInstagramFollowStatus200Response> get_instagram_follow_status(account_id, user_id, opts)
+
+Check whether an Instagram user follows the account
+
+Resolves the follow relationship between an Instagram user and the connected account, plus their public profile counters.  `userId` is the Instagram-scoped id (IGSID) Meta gives you on a webhook: `sender.id` on `message.received`, `comment.author.id` on `comment.received`.  **Meta only answers for people who have MESSAGED the account.** Commenting grants no consent, so a commenter who has never DMed you is unresolvable - that is a platform rule, not a limitation of this endpoint. When it cannot be resolved the response is still `200` with `isFollower: null` and an `unavailableReason`, because \"unknown\" is a normal state to branch on:    * `consent_required` - the user has never messaged this account.   * `dm_access_disabled` - the account owner turned off Instagram Direct API access.   * `not_messageable` - the id is not a messaging-scoped id.   * `error` - a transient Graph API failure.  To gate a comment automation on this, use the automation's `audience` rules instead of calling this per comment - they run the same lookup only on comments that actually match a keyword, and can ask the commenter to confirm with one tap.  Answers are cached briefly per (account, user). Pass `refresh=true` right after asking someone to follow, so a follow from a moment ago is visible. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::AccountsApi.new
+account_id = 'account_id_example' # String | Instagram account ID
+user_id = 'user_id_example' # String | Instagram-scoped user id (IGSID) from a webhook payload
+opts = {
+  refresh: true # Boolean | Bypass the cache and re-query Meta
+}
+
+begin
+  # Check whether an Instagram user follows the account
+  result = api_instance.get_instagram_follow_status(account_id, user_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AccountsApi->get_instagram_follow_status: #{e}"
+end
+```
+
+#### Using the get_instagram_follow_status_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetInstagramFollowStatus200Response>, Integer, Hash)> get_instagram_follow_status_with_http_info(account_id, user_id, opts)
+
+```ruby
+begin
+  # Check whether an Instagram user follows the account
+  data, status_code, headers = api_instance.get_instagram_follow_status_with_http_info(account_id, user_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetInstagramFollowStatus200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AccountsApi->get_instagram_follow_status_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Instagram account ID |  |
+| **user_id** | **String** | Instagram-scoped user id (IGSID) from a webhook payload |  |
+| **refresh** | **Boolean** | Bypass the cache and re-query Meta | [optional] |
+
+### Return type
+
+[**GetInstagramFollowStatus200Response**](GetInstagramFollowStatus200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_slack_settings
 
 > <GetSlackSettings200Response> get_slack_settings(account_id)

data/docs/CommentAutomationAudience.md

@@ -0,0 +1,22 @@
+# Zernio::CommentAutomationAudience
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **follower_status** | **String** |  | [optional][default to 'any'] |
+| **min_follower_count** | **Integer** | Skip commenters with fewer followers than this. Omit for no size rule. | [optional] |
+| **when_unknown** | **String** | What to do when Instagram will not reveal the follow relationship.   * `send` (default) - deliver the DM anyway (fails open).   * `skip` - stay silent.   * `verify` - send `followGate.message` with a confirm button. Tapping it is a     message, which grants consent, so the re-check on the tap resolves and the     real DM (or `followGate.notFollowingMessage`) follows automatically.  | [optional][default to 'send'] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CommentAutomationAudience.new(
+  follower_status: null,
+  min_follower_count: null,
+  when_unknown: null
+)
+```
+

data/docs/CommentAutomationFollowGate.md

@@ -0,0 +1,22 @@
+# Zernio::CommentAutomationFollowGate
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **message** | **String** | Confirmation DM sent when whenUnknown=verify. | [optional] |
+| **button_label** | **String** | Confirm button label. Defaults to \"I'm following\". | [optional] |
+| **not_following_message** | **String** | Sent to a commenter we know does not follow (followerStatus=follower). Omit to stay silent on a keyword comment; a confirm tap always gets an answer. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CommentAutomationFollowGate.new(
+  message: null,
+  button_label: null,
+  not_following_message: null
+)
+```
+

data/docs/CommentAutomationsApi.md

@@ -18,7 +18,7 @@ All URIs are relative to *https://zernio.com/api*
 
 Create comment-to-DM automation
 
-Create a keyword-triggered DM automation on an Instagram or Facebook account. When someone comments a matching keyword (or, with `trigger: story_reply`, replies to your Instagram story with one), they automatically receive a DM.  Triggers (`trigger`):   * `comment` (default): fires on keyword comments on a post or reel.   * `story_reply`: fires when someone replies to your Instagram story with a keyword,     and answers them with a DM. Set `platformPostId` to a story media id to scope to     one story, or omit it to match replies to any story.  Targeting (comment trigger):   * Per-post: set `platformPostId` to scope to one specific post (only one active     per-post automation is allowed per post).   * Account-wide (\"any post\"): omit `platformPostId` (and `postId`). The automation     evaluates every comment on every post on the account. You can stack unlimited     account-wide automations, each with its own keyword set, and they all run     independently. Per-post automations take priority on their post.  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. 
+Create a keyword-triggered DM automation on an Instagram or Facebook account. When someone comments a matching keyword (or, with `trigger: story_reply`, replies to your Instagram story with one), they automatically receive a DM.  Triggers (`trigger`):   * `comment` (default): fires on keyword comments on a post or reel.   * `story_reply`: fires when someone replies to your Instagram story with a keyword,     and answers them with a DM. Set `platformPostId` to a story media id to scope to     one story, or omit it to match replies to any story.  Targeting (comment trigger):   * Per-post: set `platformPostId` to scope to one specific post (only one active     per-post automation is allowed per post).   * Account-wide (\"any post\"): omit `platformPostId` (and `postId`). The automation     evaluates every comment on every post on the account. You can stack unlimited     account-wide automations, each with its own keyword set, and they all run     independently. Per-post automations take priority on their post.  Audience (`audience`, Instagram only): restrict the automation to followers or non-followers, and/or to accounts above a follower count. Instagram only reveals the follow relationship for people who have messaged the account, so `audience.whenUnknown` decides what happens for everyone else - including `verify`, which sends a one-tap confirmation DM (`followGate`) and then delivers the real DM automatically. People we already know follow you skip the tap entirely.  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. 
 
 ### Examples
 
@@ -240,7 +240,7 @@ end
 api_instance = Zernio::CommentAutomationsApi.new
 automation_id = 'automation_id_example' # String | 
 opts = {
-  status: 'sent', # String | Filter by result status
+  status: 'pending', # String | Filter by result status
   limit: 56, # Integer | 
   skip: 56 # Integer | 
 }

data/docs/ConversionEvent.md

@@ -13,7 +13,7 @@
 | **items** | [**Array<ConversionEventItemsInner>**](ConversionEventItemsInner.md) | Item-level detail for ecommerce events. | [optional] |
 | **source_url** | **String** | URL where the conversion originated (used by Meta). | [optional] |
 | **action_source** | **String** | Where the conversion happened. Used by Meta. Google also requires an event source internally; omitting this field sends OTHER to Google. Send an explicit value for accurate origin reporting. | [optional] |
-| **platform_data** | **Hash<String, Object>** | Escape hatch for platform-specific fields we haven't normalized. Forwarded as-is. | [optional] |
+| **platform_data** | **Hash<String, Object>** | 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`.  | [optional] |
 
 ## Example
 

data/docs/ConversionEventUser.md

@@ -17,6 +17,7 @@
 | **zip** | **String** | Meta advanced matching (zp). US uses first 5 digits; hashed server-side. Meta only. | [optional] |
 | **dob** | **String** | Meta advanced matching (db). YYYYMMDD; hashed server-side. Meta only. | [optional] |
 | **gender** | **String** | Meta advanced matching (ge). 'f' or 'm'; hashed server-side. Meta only. | [optional] |
+| **lead_id** | **String** | 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.  | [optional] |
 | **click_ids** | [**ConversionEventUserClickIds**](ConversionEventUserClickIds.md) |  | [optional] |
 
 ## Example
@@ -38,6 +39,7 @@ instance = Zernio::ConversionEventUser.new(
   zip: null,
   dob: null,
   gender: null,
+  lead_id: null,
   click_ids: null
 )
 ```

data/docs/CreateCommentAutomation200ResponseAutomation.md

@@ -20,6 +20,10 @@
 | **comment_reply_variations** | **Array<String>** | Alternate public replies rotated at random with commentReply. Omitted when none. | [optional] |
 | **link_tracking** | **Boolean** |  | [optional] |
 | **click_tag** | **String** |  | [optional] |
+| **dm_delay_seconds** | **Integer** | Seconds waited after the trigger before the DM is sent. Absent when the DM goes out immediately. | [optional] |
+| **comment_reply_delay_seconds** | **Integer** | Seconds waited before the public reply is posted. Absent when it follows the DM immediately. | [optional] |
+| **audience** | [**CommentAutomationAudience**](CommentAutomationAudience.md) |  | [optional] |
+| **follow_gate** | [**CommentAutomationFollowGate**](CommentAutomationFollowGate.md) |  | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
 | **stats** | [**CreateCommentAutomation200ResponseAutomationStats**](CreateCommentAutomation200ResponseAutomationStats.md) |  | [optional] |
 | **created_at** | **Time** |  | [optional] |
@@ -46,6 +50,10 @@ instance = Zernio::CreateCommentAutomation200ResponseAutomation.new(
   comment_reply_variations: null,
   link_tracking: null,
   click_tag: null,
+  dm_delay_seconds: null,
+  comment_reply_delay_seconds: null,
+  audience: null,
+  follow_gate: null,
   is_active: null,
   stats: null,
   created_at: null

data/docs/CreateCommentAutomationRequest.md

@@ -22,6 +22,10 @@
 | **comment_reply_variations** | **Array<String>** | Optional alternate public replies, rotated at random alongside commentReply (picked independently of the DM). Up to 5. | [optional] |
 | **link_tracking** | **Boolean** | 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. | [optional][default to true] |
 | **click_tag** | **String** | Optional tag applied to a contact when they click a tracked link (requires linkTracking). Lets you segment clickers for broadcasts/sequences. | [optional] |
+| **dm_delay_seconds** | **Integer** | 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. | [optional] |
+| **comment_reply_delay_seconds** | **Integer** | 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. | [optional] |
+| **audience** | [**CommentAutomationAudience**](CommentAutomationAudience.md) |  | [optional] |
+| **follow_gate** | [**CommentAutomationFollowGate**](CommentAutomationFollowGate.md) |  | [optional] |
 
 ## Example
 
@@ -46,7 +50,11 @@ instance = Zernio::CreateCommentAutomationRequest.new(
   dm_message_variations: null,
   comment_reply_variations: null,
   link_tracking: null,
-  click_tag: null
+  click_tag: null,
+  dm_delay_seconds: null,
+  comment_reply_delay_seconds: null,
+  audience: null,
+  follow_gate: null
 )
 ```
 

data/docs/GetCommentAutomation200ResponseAutomation.md

@@ -23,6 +23,10 @@
 | **comment_reply_variations** | **Array<String>** | Alternate public replies rotated at random with commentReply. Omitted when none. | [optional] |
 | **link_tracking** | **Boolean** |  | [optional] |
 | **click_tag** | **String** |  | [optional] |
+| **dm_delay_seconds** | **Integer** | Seconds waited after the trigger before the DM is sent. Absent when the DM goes out immediately. | [optional] |
+| **comment_reply_delay_seconds** | **Integer** | Seconds waited before the public reply is posted. Absent when it follows the DM immediately. | [optional] |
+| **audience** | [**CommentAutomationAudience**](CommentAutomationAudience.md) |  | [optional] |
+| **follow_gate** | [**CommentAutomationFollowGate**](CommentAutomationFollowGate.md) |  | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
 | **stats** | [**CreateCommentAutomation200ResponseAutomationStats**](CreateCommentAutomation200ResponseAutomationStats.md) |  | [optional] |
 | **created_at** | **Time** |  | [optional] |
@@ -53,6 +57,10 @@ instance = Zernio::GetCommentAutomation200ResponseAutomation.new(
   comment_reply_variations: null,
   link_tracking: null,
   click_tag: null,
+  dm_delay_seconds: null,
+  comment_reply_delay_seconds: null,
+  audience: null,
+  follow_gate: null,
   is_active: null,
   stats: null,
   created_at: null,

data/docs/GetCommentAutomation200ResponseLogsInner.md

@@ -9,10 +9,14 @@
 | **commenter_id** | **String** |  | [optional] |
 | **commenter_name** | **String** |  | [optional] |
 | **comment_text** | **String** |  | [optional] |
-| **status** | **String** | DM outcome | [optional] |
+| **status** | **String** | 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. | [optional] |
+| **audience_outcome** | **String** | How the audience rule resolved. Absent on automations without one. | [optional] |
+| **commenter_is_follower** | **Boolean** | Follow relationship at decision time. Absent when Instagram would not tell us (the commenter never messaged the account). | [optional] |
+| **commenter_follower_count** | **Integer** |  | [optional] |
 | **error** | **String** | DM error message if status is failed | [optional] |
 | **comment_reply_status** | **String** | 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). | [optional] |
 | **comment_reply_error** | **String** | Public-reply error message if commentReplyStatus is failed | [optional] |
+| **next_due_at** | **Time** | When the next queued send fires. Present only while something is still pending. | [optional] |
 | **created_at** | **Time** |  | [optional] |
 
 ## Example
@@ -27,9 +31,13 @@ instance = Zernio::GetCommentAutomation200ResponseLogsInner.new(
   commenter_name: null,
   comment_text: null,
   status: null,
+  audience_outcome: null,
+  commenter_is_follower: null,
+  commenter_follower_count: null,
   error: null,
   comment_reply_status: null,
   comment_reply_error: null,
+  next_due_at: null,
   created_at: null
 )
 ```

data/docs/GetInstagramFollowStatus200Response.md

@@ -0,0 +1,34 @@
+# Zernio::GetInstagramFollowStatus200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **user_id** | **String** |  |  |
+| **account_id** | **String** |  |  |
+| **is_follower** | **Boolean** | The user follows this account. Null = unknown, never \"no\". |  |
+| **is_followed_by_account** | **Boolean** | This account follows the user. | [optional] |
+| **follower_count** | **Integer** |  | [optional] |
+| **is_verified** | **Boolean** |  | [optional] |
+| **username** | **String** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **unavailable_reason** | **String** | Why the follow relationship could not be resolved. Null when it was. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetInstagramFollowStatus200Response.new(
+  user_id: null,
+  account_id: null,
+  is_follower: null,
+  is_followed_by_account: null,
+  follower_count: null,
+  is_verified: null,
+  username: null,
+  name: null,
+  unavailable_reason: null
+)
+```
+

data/docs/ListCommentAutomations200ResponseAutomationsInner.md

@@ -22,6 +22,8 @@
 | **comment_reply_variations** | **Array<String>** | Alternate public replies rotated at random with commentReply. Omitted when none. | [optional] |
 | **link_tracking** | **Boolean** | Whether link buttons in the DM are wrapped in a tracked redirect to count clicks. | [optional] |
 | **click_tag** | **String** | Tag applied to a contact when they click a tracked link. | [optional] |
+| **dm_delay_seconds** | **Integer** | Seconds waited after the trigger before the DM is sent. Absent when the DM goes out immediately. | [optional] |
+| **comment_reply_delay_seconds** | **Integer** | Seconds waited before the public reply is posted. Absent when it follows the DM immediately. | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
 | **stats** | [**ListCommentAutomations200ResponseAutomationsInnerStats**](ListCommentAutomations200ResponseAutomationsInnerStats.md) |  | [optional] |
 | **created_at** | **Time** |  | [optional] |
@@ -50,6 +52,8 @@ instance = Zernio::ListCommentAutomations200ResponseAutomationsInner.new(
   comment_reply_variations: null,
   link_tracking: null,
   click_tag: null,
+  dm_delay_seconds: null,
+  comment_reply_delay_seconds: null,
   is_active: null,
   stats: null,
   created_at: null

data/docs/UpdateCommentAutomation200ResponseAutomation.md

@@ -15,6 +15,8 @@
 | **comment_reply** | **String** |  | [optional] |
 | **dm_message_variations** | **Array<String>** | Alternate DM texts rotated at random with dmMessage. Omitted when none. | [optional] |
 | **comment_reply_variations** | **Array<String>** | Alternate public replies rotated at random with commentReply. Omitted when none. | [optional] |
+| **audience** | [**CommentAutomationAudience**](CommentAutomationAudience.md) |  | [optional] |
+| **follow_gate** | [**CommentAutomationFollowGate**](CommentAutomationFollowGate.md) |  | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
 | **updated_at** | **Time** |  | [optional] |
 
@@ -35,6 +37,8 @@ instance = Zernio::UpdateCommentAutomation200ResponseAutomation.new(
   comment_reply: null,
   dm_message_variations: null,
   comment_reply_variations: null,
+  audience: null,
+  follow_gate: null,
   is_active: null,
   updated_at: null
 )

data/docs/UpdateCommentAutomationRequest.md

@@ -17,6 +17,10 @@
 | **comment_reply_variations** | **Array<String>** | Alternate public replies for random rotation. Pass [] to clear. | [optional] |
 | **link_tracking** | **Boolean** | Wrap link buttons in a tracked redirect to count clicks. Pass false to send links untouched. | [optional] |
 | **click_tag** | **String** | Tag applied to a contact when they click a tracked link (requires linkTracking). Empty string clears it. | [optional] |
+| **dm_delay_seconds** | **Integer** | Seconds to wait after the trigger before sending the DM. Send 0 to clear the delay and reply immediately. | [optional] |
+| **comment_reply_delay_seconds** | **Integer** | Seconds to wait before posting the public comment reply. Send 0 to clear it. The reply never goes out before the DM. | [optional] |
+| **audience** | [**CommentAutomationAudience**](CommentAutomationAudience.md) |  | [optional] |
+| **follow_gate** | [**CommentAutomationFollowGate**](CommentAutomationFollowGate.md) |  | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
 
 ## Example
@@ -38,6 +42,10 @@ instance = Zernio::UpdateCommentAutomationRequest.new(
   comment_reply_variations: null,
   link_tracking: null,
   click_tag: null,
+  dm_delay_seconds: null,
+  comment_reply_delay_seconds: null,
+  audience: null,
+  follow_gate: null,
   is_active: null
 )
 ```

data/docs/WebhookPayloadCommentCommentAuthor.md

@@ -8,6 +8,7 @@
 | **username** | **String** |  | [optional] |
 | **name** | **String** |  | [optional] |
 | **picture** | **String** |  | [optional] |
+| **instagram_profile** | [**WebhookPayloadCommentCommentAuthorInstagramProfile**](WebhookPayloadCommentCommentAuthorInstagramProfile.md) |  | [optional] |
 
 ## Example
 
@@ -18,7 +19,8 @@ instance = Zernio::WebhookPayloadCommentCommentAuthor.new(
   id: null,
   username: null,
   name: null,
-  picture: null
+  picture: null,
+  instagram_profile: null
 )
 ```
 

data/docs/WebhookPayloadCommentCommentAuthorInstagramProfile.md

@@ -0,0 +1,24 @@
+# Zernio::WebhookPayloadCommentCommentAuthorInstagramProfile
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **is_follower** | **Boolean** | The commenter follows this account. | [optional] |
+| **is_following** | **Boolean** | This account follows the commenter. | [optional] |
+| **follower_count** | **Integer** |  | [optional] |
+| **is_verified** | **Boolean** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::WebhookPayloadCommentCommentAuthorInstagramProfile.new(
+  is_follower: null,
+  is_following: null,
+  follower_count: null,
+  is_verified: null
+)
+```
+

data/lib/zernio-sdk/api/accounts_api.rb

@@ -295,6 +295,78 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Check whether an Instagram user follows the account
+    # Resolves the follow relationship between an Instagram user and the connected account, plus their public profile counters.  `userId` is the Instagram-scoped id (IGSID) Meta gives you on a webhook: `sender.id` on `message.received`, `comment.author.id` on `comment.received`.  **Meta only answers for people who have MESSAGED the account.** Commenting grants no consent, so a commenter who has never DMed you is unresolvable - that is a platform rule, not a limitation of this endpoint. When it cannot be resolved the response is still `200` with `isFollower: null` and an `unavailableReason`, because \"unknown\" is a normal state to branch on:    * `consent_required` - the user has never messaged this account.   * `dm_access_disabled` - the account owner turned off Instagram Direct API access.   * `not_messageable` - the id is not a messaging-scoped id.   * `error` - a transient Graph API failure.  To gate a comment automation on this, use the automation's `audience` rules instead of calling this per comment - they run the same lookup only on comments that actually match a keyword, and can ask the commenter to confirm with one tap.  Answers are cached briefly per (account, user). Pass `refresh=true` right after asking someone to follow, so a follow from a moment ago is visible. 
+    # @param account_id [String] Instagram account ID
+    # @param user_id [String] Instagram-scoped user id (IGSID) from a webhook payload
+    # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :refresh Bypass the cache and re-query Meta
+    # @return [GetInstagramFollowStatus200Response]
+    def get_instagram_follow_status(account_id, user_id, opts = {})
+      data, _status_code, _headers = get_instagram_follow_status_with_http_info(account_id, user_id, opts)
+      data
+    end
+
+    # Check whether an Instagram user follows the account
+    # Resolves the follow relationship between an Instagram user and the connected account, plus their public profile counters.  `userId` is the Instagram-scoped id (IGSID) Meta gives you on a webhook: `sender.id` on `message.received`, `comment.author.id` on `comment.received`.  **Meta only answers for people who have MESSAGED the account.** Commenting grants no consent, so a commenter who has never DMed you is unresolvable - that is a platform rule, not a limitation of this endpoint. When it cannot be resolved the response is still `200` with `isFollower: null` and an `unavailableReason`, because \"unknown\" is a normal state to branch on:    * `consent_required` - the user has never messaged this account.   * `dm_access_disabled` - the account owner turned off Instagram Direct API access.   * `not_messageable` - the id is not a messaging-scoped id.   * `error` - a transient Graph API failure.  To gate a comment automation on this, use the automation's `audience` rules instead of calling this per comment - they run the same lookup only on comments that actually match a keyword, and can ask the commenter to confirm with one tap.  Answers are cached briefly per (account, user). Pass `refresh=true` right after asking someone to follow, so a follow from a moment ago is visible. 
+    # @param account_id [String] Instagram account ID
+    # @param user_id [String] Instagram-scoped user id (IGSID) from a webhook payload
+    # @param [Hash] opts the optional parameters
+    # @option opts [Boolean] :refresh Bypass the cache and re-query Meta
+    # @return [Array<(GetInstagramFollowStatus200Response, Integer, Hash)>] GetInstagramFollowStatus200Response data, response status code and response headers
+    def get_instagram_follow_status_with_http_info(account_id, user_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AccountsApi.get_instagram_follow_status ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling AccountsApi.get_instagram_follow_status"
+      end
+      # verify the required parameter 'user_id' is set
+      if @api_client.config.client_side_validation && user_id.nil?
+        fail ArgumentError, "Missing the required parameter 'user_id' when calling AccountsApi.get_instagram_follow_status"
+      end
+      # resource path
+      local_var_path = '/v1/accounts/{accountId}/follow-status/{userId}'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s)).sub('{' + 'userId' + '}', CGI.escape(user_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'refresh'] = opts[:'refresh'] if !opts[:'refresh'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetInstagramFollowStatus200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AccountsApi.get_instagram_follow_status",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AccountsApi#get_instagram_follow_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get Slack account settings
     # Returns the connected Slack channel details and the default message identity (name and avatar shown as the author on every post, with Slack's APP badge). The identity applies to messages only; the app's own Slack profile is global and cannot be changed per workspace.
     # @param account_id [String] 

data/lib/zernio-sdk/api/comment_automations_api.rb

@@ -20,7 +20,7 @@ module Zernio
       @api_client = api_client
     end
     # Create comment-to-DM automation
-    # Create a keyword-triggered DM automation on an Instagram or Facebook account. When someone comments a matching keyword (or, with `trigger: story_reply`, replies to your Instagram story with one), they automatically receive a DM.  Triggers (`trigger`):   * `comment` (default): fires on keyword comments on a post or reel.   * `story_reply`: fires when someone replies to your Instagram story with a keyword,     and answers them with a DM. Set `platformPostId` to a story media id to scope to     one story, or omit it to match replies to any story.  Targeting (comment trigger):   * Per-post: set `platformPostId` to scope to one specific post (only one active     per-post automation is allowed per post).   * Account-wide (\"any post\"): omit `platformPostId` (and `postId`). The automation     evaluates every comment on every post on the account. You can stack unlimited     account-wide automations, each with its own keyword set, and they all run     independently. Per-post automations take priority on their post.  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. 
+    # Create a keyword-triggered DM automation on an Instagram or Facebook account. When someone comments a matching keyword (or, with `trigger: story_reply`, replies to your Instagram story with one), they automatically receive a DM.  Triggers (`trigger`):   * `comment` (default): fires on keyword comments on a post or reel.   * `story_reply`: fires when someone replies to your Instagram story with a keyword,     and answers them with a DM. Set `platformPostId` to a story media id to scope to     one story, or omit it to match replies to any story.  Targeting (comment trigger):   * Per-post: set `platformPostId` to scope to one specific post (only one active     per-post automation is allowed per post).   * Account-wide (\"any post\"): omit `platformPostId` (and `postId`). The automation     evaluates every comment on every post on the account. You can stack unlimited     account-wide automations, each with its own keyword set, and they all run     independently. Per-post automations take priority on their post.  Audience (`audience`, Instagram only): restrict the automation to followers or non-followers, and/or to accounts above a follower count. Instagram only reveals the follow relationship for people who have messaged the account, so `audience.whenUnknown` decides what happens for everyone else - including `verify`, which sends a one-tap confirmation DM (`followGate`) and then delivers the real DM automatically. People we already know follow you skip the tap entirely.  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. 
     # @param create_comment_automation_request [CreateCommentAutomationRequest] 
     # @param [Hash] opts the optional parameters
     # @return [CreateCommentAutomation200Response]
@@ -30,7 +30,7 @@ module Zernio
     end
 
     # Create comment-to-DM automation
-    # Create a keyword-triggered DM automation on an Instagram or Facebook account. When someone comments a matching keyword (or, with `trigger: story_reply`, replies to your Instagram story with one), they automatically receive a DM.  Triggers (`trigger`):   * `comment` (default): fires on keyword comments on a post or reel.   * `story_reply`: fires when someone replies to your Instagram story with a keyword,     and answers them with a DM. Set `platformPostId` to a story media id to scope to     one story, or omit it to match replies to any story.  Targeting (comment trigger):   * Per-post: set `platformPostId` to scope to one specific post (only one active     per-post automation is allowed per post).   * Account-wide (\"any post\"): omit `platformPostId` (and `postId`). The automation     evaluates every comment on every post on the account. You can stack unlimited     account-wide automations, each with its own keyword set, and they all run     independently. Per-post automations take priority on their post.  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. 
+    # Create a keyword-triggered DM automation on an Instagram or Facebook account. When someone comments a matching keyword (or, with `trigger: story_reply`, replies to your Instagram story with one), they automatically receive a DM.  Triggers (`trigger`):   * `comment` (default): fires on keyword comments on a post or reel.   * `story_reply`: fires when someone replies to your Instagram story with a keyword,     and answers them with a DM. Set `platformPostId` to a story media id to scope to     one story, or omit it to match replies to any story.  Targeting (comment trigger):   * Per-post: set `platformPostId` to scope to one specific post (only one active     per-post automation is allowed per post).   * Account-wide (\"any post\"): omit `platformPostId` (and `postId`). The automation     evaluates every comment on every post on the account. You can stack unlimited     account-wide automations, each with its own keyword set, and they all run     independently. Per-post automations take priority on their post.  Audience (`audience`, Instagram only): restrict the automation to followers or non-followers, and/or to accounts above a follower count. Instagram only reveals the follow relationship for people who have messaged the account, so `audience.whenUnknown` decides what happens for everyone else - including `verify`, which sends a one-tap confirmation DM (`followGate`) and then delivers the real DM automatically. People we already know follow you skip the tap entirely.  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. 
     # @param create_comment_automation_request [CreateCommentAutomationRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(CreateCommentAutomation200Response, Integer, Hash)>] CreateCommentAutomation200Response data, response status code and response headers
@@ -242,7 +242,7 @@ module Zernio
       if @api_client.config.client_side_validation && automation_id.nil?
         fail ArgumentError, "Missing the required parameter 'automation_id' when calling CommentAutomationsApi.list_comment_automation_logs"
       end
-      allowable_values = ["sent", "failed", "skipped"]
+      allowable_values = ["pending", "sent", "failed", "skipped", "gated"]
       if @api_client.config.client_side_validation && opts[:'status'] && !allowable_values.include?(opts[:'status'])
         fail ArgumentError, "invalid value for \"status\", must be one of #{allowable_values}"
       end