late-sdk 0.0.684 → 0.0.685

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 550c3cc0463ec0c6089af0d3420e1fe04d7dfb626bdde7b1c87f9054664ff307
-  data.tar.gz: 49a3a122c78e25747c39fb4452ac951593a126e65d7bf224f6ec2c3553539437
+  metadata.gz: 0b50a43152d2db82a260e610f7406f4f21656d252cfba4797c4a6aa71479925b
+  data.tar.gz: b8aa82d53fef8d14baf0cd9a1204a9228a9afec0a0328d110a3605b4195c847b
 SHA512:
-  metadata.gz: 11a79538fcdf3db3151b79737d8cfcc1a4612d7ea9807a23e422c5ac7739c81d0cd773421b70b83d3a243ca5a5ef6558d6777410a8201cce3a6c8d4a8eaeeecc
-  data.tar.gz: 032edb43b2fbe1aa7a96b64f051767b7f3a3342defa6b17aee08c2371f711b82838bf334dbc192550a934a6e5412c1e6ac2ac9c1a68de5a73dae42dfab41c427
+  metadata.gz: e2bbc652dc88a41a6eb9ec396c97dae836f5075dd1a685dcb9c903e2bc8481f5b6277c67939a61e51f1928286347007009bad7553d55bed1da92ced66db88819
+  data.tar.gz: 338e379aa6567330d0d7980ff8f7d0d0b77d96824862e07acf9cd876ce9da3e021c2356220f0b3a4d29c79e74175e7d3abcc25341aad2cefa66d1d6c51d711ed

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
 

data/docs/CreateCommentAutomation200ResponseAutomation.md

@@ -20,6 +20,8 @@
 | **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] |
+| **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 +48,8 @@ instance = Zernio::CreateCommentAutomation200ResponseAutomation.new(
   comment_reply_variations: null,
   link_tracking: null,
   click_tag: null,
+  audience: null,
+  follow_gate: null,
   is_active: null,
   stats: null,
   created_at: null

data/docs/CreateCommentAutomationRequest.md

@@ -22,6 +22,8 @@
 | **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] |
+| **audience** | [**CommentAutomationAudience**](CommentAutomationAudience.md) |  | [optional] |
+| **follow_gate** | [**CommentAutomationFollowGate**](CommentAutomationFollowGate.md) |  | [optional] |
 
 ## Example
 
@@ -46,7 +48,9 @@ instance = Zernio::CreateCommentAutomationRequest.new(
   dm_message_variations: null,
   comment_reply_variations: null,
   link_tracking: null,
-  click_tag: null
+  click_tag: null,
+  audience: null,
+  follow_gate: null
 )
 ```
 

data/docs/GetCommentAutomation200ResponseAutomation.md

@@ -23,6 +23,8 @@
 | **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] |
+| **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 +55,8 @@ instance = Zernio::GetCommentAutomation200ResponseAutomation.new(
   comment_reply_variations: null,
   link_tracking: null,
   click_tag: null,
+  audience: null,
+  follow_gate: null,
   is_active: null,
   stats: null,
   created_at: null,

data/docs/GetCommentAutomation200ResponseLogsInner.md

@@ -9,7 +9,10 @@
 | **commenter_id** | **String** |  | [optional] |
 | **commenter_name** | **String** |  | [optional] |
 | **comment_text** | **String** |  | [optional] |
-| **status** | **String** | DM outcome | [optional] |
+| **status** | **String** | 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. | [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] |
@@ -27,6 +30,9 @@ 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,

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/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,8 @@
 | **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] |
+| **audience** | [**CommentAutomationAudience**](CommentAutomationAudience.md) |  | [optional] |
+| **follow_gate** | [**CommentAutomationFollowGate**](CommentAutomationFollowGate.md) |  | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
 
 ## Example
@@ -38,6 +40,8 @@ instance = Zernio::UpdateCommentAutomationRequest.new(
   comment_reply_variations: null,
   link_tracking: null,
   click_tag: 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 = ["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