RubyGems - late-sdk - Versions diffs - 0.0.716 → 0.0.718 - Mend

late-sdk 0.0.716 → 0.0.718

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (475) hide show

data/docs/ListLocalServicesLeadConversations200ResponseDataInner.md ADDED Viewed

@@ -0,0 +1,28 @@
+# Zernio::ListLocalServicesLeadConversations200ResponseDataInner
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **channel** | **String** | PHONE_CALL / MESSAGE / SMS / EMAIL / WHATSAPP / ADS_API. | [optional] |
+| **participant_type** | **String** | ADVERTISER or CONSUMER. | [optional] |
+| **event_date_time** | **String** |  | [optional] |
+| **phone_call** | [**ListLocalServicesLeadConversations200ResponseDataInnerPhoneCall**](ListLocalServicesLeadConversations200ResponseDataInnerPhoneCall.md) |  | [optional] |
+| **message** | [**ListLocalServicesLeadConversations200ResponseDataInnerMessage**](ListLocalServicesLeadConversations200ResponseDataInnerMessage.md) |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListLocalServicesLeadConversations200ResponseDataInner.new(
+  id: null,
+  channel: null,
+  participant_type: null,
+  event_date_time: null,
+  phone_call: null,
+  message: null
+)
+```

data/docs/ListLocalServicesLeadConversations200ResponseDataInnerMessage.md ADDED Viewed

@@ -0,0 +1,20 @@
+# Zernio::ListLocalServicesLeadConversations200ResponseDataInnerMessage
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **text** | **String** |  | [optional] |
+| **attachment_urls** | **Array&lt;String&gt;** |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListLocalServicesLeadConversations200ResponseDataInnerMessage.new(
+  text: null,
+  attachment_urls: null
+)
+```

data/docs/ListLocalServicesLeadConversations200ResponseDataInnerPhoneCall.md ADDED Viewed

@@ -0,0 +1,20 @@
+# Zernio::ListLocalServicesLeadConversations200ResponseDataInnerPhoneCall
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **call_duration_millis** | **Integer** |  | [optional] |
+| **call_recording_url** | **String** |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListLocalServicesLeadConversations200ResponseDataInnerPhoneCall.new(
+  call_duration_millis: null,
+  call_recording_url: null
+)
+```

data/docs/ListLocalServicesLeads200Response.md ADDED Viewed

@@ -0,0 +1,22 @@
+# Zernio::ListLocalServicesLeads200Response
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_id** | **String** |  | [optional] |
+| **data** | [**Array&lt;ListLocalServicesLeads200ResponseDataInner&gt;**](ListLocalServicesLeads200ResponseDataInner.md) |  | [optional] |
+| **paging** | [**GetAdsSearchTerms200ResponsePaging**](GetAdsSearchTerms200ResponsePaging.md) |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListLocalServicesLeads200Response.new(
+  customer_id: null,
+  data: null,
+  paging: null
+)
+```

data/docs/ListLocalServicesLeads200ResponseDataInner.md ADDED Viewed

@@ -0,0 +1,38 @@
+# Zernio::ListLocalServicesLeads200ResponseDataInner
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Lead id; pass to /v1/ads/local-services/leads/{leadId}/conversations. | [optional] |
+| **lead_type** | **String** | PHONE_CALL / MESSAGE / BOOKING. | [optional] |
+| **category_id** | **String** |  | [optional] |
+| **service_id** | **String** |  | [optional] |
+| **contact** | [**ListLocalServicesLeads200ResponseDataInnerContact**](ListLocalServicesLeads200ResponseDataInnerContact.md) |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **created_time** | **String** | Google datetime in the customer&#39;s timezone (YYYY-MM-DD HH:MM:SS). | [optional] |
+| **locale** | **String** |  | [optional] |
+| **charged** | **Boolean** |  | [optional] |
+| **credit_state** | **String** |  | [optional] |
+| **credit_state_last_update** | **String** |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListLocalServicesLeads200ResponseDataInner.new(
+  id: null,
+  lead_type: null,
+  category_id: null,
+  service_id: null,
+  contact: null,
+  status: null,
+  created_time: null,
+  locale: null,
+  charged: null,
+  credit_state: null,
+  credit_state_last_update: null
+)
+```

data/docs/ListLocalServicesLeads200ResponseDataInnerContact.md ADDED Viewed

@@ -0,0 +1,22 @@
+# Zernio::ListLocalServicesLeads200ResponseDataInnerContact
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **consumer_name** | **String** |  | [optional] |
+| **email** | **String** |  | [optional] |
+| **phone_number** | **String** |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListLocalServicesLeads200ResponseDataInnerContact.new(
+  consumer_name: null,
+  email: null,
+  phone_number: null
+)
+```

data/docs/ListPhoneNumbers200ResponseConnectedInner.md CHANGED Viewed

@@ -9,6 +9,7 @@
 | **display_name** | **String** |  | [optional] |
 | **profile_id** | **String** |  | [optional] |
 | **connected_at** | **Time** |  | [optional] |
+| **calling_enabled** | **Boolean** | Whether WhatsApp Business Calling is enabled on this number. | [optional] |
 ## Example
@@ -20,7 +21,8 @@ instance = Zernio::ListPhoneNumbers200ResponseConnectedInner.new(
   phone_number: null,
   display_name: null,
   profile_id: null,
-  connected_at: null
+  connected_at: null,
+  calling_enabled: null
 )
 ```

data/docs/ListPhoneNumbers200ResponseNumbersInner.md CHANGED Viewed

@@ -20,6 +20,7 @@
 | **end_user_first_name** | **String** |  | [optional] |
 | **end_user_last_name** | **String** |  | [optional] |
 | **regulatory_decline_reason** | **String** | Reviewer rejection reason when status is regulatory_declined. | [optional] |
+| **calling_enabled** | **Boolean** | Whether WhatsApp Business Calling is enabled on this number (manage via /v1/whatsapp/phone-numbers/{id}/calling). | [optional] |
 | **created_at** | **Time** |  | [optional] |
 ## Example
@@ -44,6 +45,7 @@ instance = Zernio::ListPhoneNumbers200ResponseNumbersInner.new(
   end_user_first_name: null,
   end_user_last_name: null,
   regulatory_decline_reason: null,
+  calling_enabled: null,
   created_at: null
 )
 ```

data/docs/ListWhatsAppAccountEvents200Response.md ADDED Viewed

@@ -0,0 +1,18 @@
+# Zernio::ListWhatsAppAccountEvents200Response
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **events** | [**Array&lt;ListWhatsAppAccountEvents200ResponseEventsInner&gt;**](ListWhatsAppAccountEvents200ResponseEventsInner.md) |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListWhatsAppAccountEvents200Response.new(
+  events: null
+)
+```

data/docs/ListWhatsAppAccountEvents200ResponseEventsInner.md ADDED Viewed

@@ -0,0 +1,28 @@
+# Zernio::ListWhatsAppAccountEvents200ResponseEventsInner
+## Properties
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+| **type** | **String** | Event kind, e.g. template_approved, template_rejected, account_restricted, account_disconnected | [optional] |
+| **severity** | **String** |  | [optional] |
+| **title** | **String** |  | [optional] |
+| **detail** | **String** |  | [optional] |
+| **created_at** | **Time** |  | [optional] |
+## Example
+```ruby
+require 'zernio-sdk'
+instance = Zernio::ListWhatsAppAccountEvents200ResponseEventsInner.new(
+  id: null,
+  type: null,
+  severity: null,
+  title: null,
+  detail: null,
+  created_at: null
+)
+```

data/docs/MessagesApi.md CHANGED Viewed

@@ -404,7 +404,7 @@ conversation_id = 'conversation_id_example' # String | The conversation ID (id f
 account_id = 'account_id_example' # String | Social account ID
 opts = {
   limit: 56, # Integer | Number of messages to return per page. Default 100, max 100.
-  cursor: 'cursor_example', # String | Opaque pagination cursor. Pass `pagination.nextCursor` from a prior response.
+  cursor: 'cursor_example', # String | Opaque pagination cursor. Pass `pagination.nextCursor` from a prior response verbatim: a cursor we cannot parse returns 400 rather than silently restarting from the first page.
   sort_order: 'asc' # String | Order of returned messages. Default `asc` (oldest first, chat style). Twitter, Instagram, Telegram, WhatsApp and Reddit honor this order across cursor pages. For Facebook and Bluesky, only intra-page ordering is affected — pages always walk newest→oldest. See `sortOrderApplied` in the response.
 }
@@ -442,7 +442,7 @@ end
 | **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
 | **account_id** | **String** | Social account ID |  |
 | **limit** | **Integer** | Number of messages to return per page. Default 100, max 100. | [optional][default to 100] |
-| **cursor** | **String** | Opaque pagination cursor. Pass &#x60;pagination.nextCursor&#x60; from a prior response. | [optional] |
+| **cursor** | **String** | Opaque pagination cursor. Pass &#x60;pagination.nextCursor&#x60; from a prior response verbatim: a cursor we cannot parse returns 400 rather than silently restarting from the first page. | [optional] |
 | **sort_order** | **String** | Order of returned messages. Default &#x60;asc&#x60; (oldest first, chat style). Twitter, Instagram, Telegram, WhatsApp and Reddit honor this order across cursor pages. For Facebook and Bluesky, only intra-page ordering is affected — pages always walk newest→oldest. See &#x60;sortOrderApplied&#x60; in the response.  | [optional][default to &#39;asc&#39;] |
 ### Return type
@@ -792,7 +792,7 @@ opts = {
   platform: 'facebook', # String | Filter by platform (searchable platforms only)
   account_id: 'account_id_example', # String | Filter by specific social account ID
   limit: 56, # Integer | Maximum number of conversations to return
-  cursor: 'cursor_example' # String | Pagination cursor for next page
+  cursor: 'cursor_example' # String | Opaque pagination cursor. Pass back pagination.nextCursor verbatim; do not construct one.
 }
 begin
@@ -832,7 +832,7 @@ end
 | **platform** | **String** | Filter by platform (searchable platforms only) | [optional] |
 | **account_id** | **String** | Filter by specific social account ID | [optional] |
 | **limit** | **Integer** | Maximum number of conversations to return | [optional][default to 20] |
-| **cursor** | **String** | Pagination cursor for next page | [optional] |
+| **cursor** | **String** | Opaque pagination cursor. Pass back pagination.nextCursor verbatim; do not construct one. | [optional] |
 ### Return type

data/docs/OnVerificationApprovedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **verification** | [**OnVerificationApprovedRequestVerification**](OnVerificationApprovedRequestVerification.md) |  | [optional] |
 ## Example

data/docs/OnVerificationFailedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **verification** | [**OnVerificationFailedRequestVerification**](OnVerificationFailedRequestVerification.md) |  | [optional] |
 | **reason** | **String** |  | [optional] |

data/docs/OnWhatsAppAutomaticEventRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **account_id** | **String** | SocialAccount id of the WhatsApp number whose conversation was flagged. | [optional] |
 | **conversation_id** | **String** | Zernio conversation id, when the thread could be resolved. | [optional] |
 | **platform_message_id** | **String** | The wamid of the message Meta&#39;s analysis flagged. | [optional] |

data/docs/OnWhatsAppNumberActionRequiredRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **reason** | **String** |  | [optional] |
 | **number** | [**OnWhatsAppNumberDeclinedRequestNumber**](OnWhatsAppNumberDeclinedRequestNumber.md) |  | [optional] |

data/docs/OnWhatsAppNumberActivatedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **number** | [**OnWhatsAppNumberActivatedRequestNumber**](OnWhatsAppNumberActivatedRequestNumber.md) |  | [optional] |
 ## Example

data/docs/OnWhatsAppNumberDeclinedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **number** | [**OnWhatsAppNumberDeclinedRequestNumber**](OnWhatsAppNumberDeclinedRequestNumber.md) |  | [optional] |
 | **reason** | **String** |  | [optional] |

data/docs/OnWhatsAppNumberKycSubmittedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **number** | [**OnWhatsAppNumberDeclinedRequestNumber**](OnWhatsAppNumberDeclinedRequestNumber.md) |  | [optional] |
 ## Example

data/docs/OnWhatsAppNumberReactivatedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **number** | [**OnWhatsAppNumberDeclinedRequestNumber**](OnWhatsAppNumberDeclinedRequestNumber.md) |  | [optional] |
 ## Example

data/docs/OnWhatsAppNumberReleasedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **number** | [**OnWhatsAppNumberDeclinedRequestNumber**](OnWhatsAppNumberDeclinedRequestNumber.md) |  | [optional] |
 | **reason** | **String** |  | [optional] |

data/docs/OnWhatsAppNumberSuspendedRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **number** | [**OnWhatsAppNumberDeclinedRequestNumber**](OnWhatsAppNumberDeclinedRequestNumber.md) |  | [optional] |
 | **reason** | **String** |  | [optional] |

data/docs/OnWhatsAppNumberVerificationRequiredRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **event** | **String** |  | [optional] |
-| **timestamp** | **Time** |  | [optional] |
+| **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. | [optional] |
 | **number** | [**OnWhatsAppNumberDeclinedRequestNumber**](OnWhatsAppNumberDeclinedRequestNumber.md) |  | [optional] |
 | **verification_url** | **String** |  | [optional] |

data/docs/PlatformTarget.md CHANGED Viewed

@@ -12,13 +12,13 @@
 | **platform_specific_data** | [**PlatformTargetPlatformSpecificData**](PlatformTargetPlatformSpecificData.md) |  | [optional] |
 | **status** | **String** | Platform-specific status: pending, publishing, published, failed | [optional] |
 | **platform_post_id** | **String** | The native post ID on the platform (populated after successful publish) | [optional] |
-| **platform_post_url** | **String** | Public URL of the published post. Included in the response for immediate posts; for scheduled posts, fetch via GET /v1/posts/{postId} after publish time. | [optional] |
+| **platform_post_url** | **String** | Public URL of the published post. Included in the response for immediate posts; for scheduled posts, fetch via GET /v1/posts/{postId} after publish time. Empty when the platform confirmed the publish without returning an id a permalink can be built from (TikTok returns a publish id for some uploads); the TikTok reconcile cron backfills it later. | [optional] |
 | **published_at** | **Time** | Timestamp when the post was published to this platform | [optional] |
 | **removed_from_platform_at** | **Time** | Set when a post that was successfully published later disappears from the platform (deleted on-platform or taken down by the platform). status stays \&quot;published\&quot; (it reflects the publish outcome); poll this field to detect post-publish removals. Absent while the post is live, and cleared if the post reappears. Detection runs with the analytics sync, so expect up to a few hours of lag. | [optional] |
 | **is_trial_reel** | **Boolean** | Present and true only when this Instagram reel was launched as a Trial through Zernio (created with platformSpecificData.trialParams). Use it to segment trial reels in analytics. Note: Instagram&#39;s Graph API exposes no readable trial field, so this reflects creation-time intent only. It indicates the reel STARTED as a trial, not whether or when it graduated. | [optional] |
 | **trial_graduation_strategy** | **String** | Graduation strategy the trial reel was launched with. Present only when isTrialReel is true. | [optional] |
 | **error_message** | **String** | Human-readable error message when status is failed. Contains platform-specific error details explaining why the publish failed. | [optional] |
-| **error_category** | **String** | Error category for programmatic handling: auth_expired (token expired/revoked), user_content (wrong format/too long), user_abuse (rate limits/spam), account_issue (config problems), platform_rejected (policy violation), platform_error (5xx/maintenance), system_error (Zernio infra), unknown | [optional] |
+| **error_category** | **String** | Error category for programmatic handling: auth_expired (token expired/revoked), user_content (wrong format/too long), user_abuse (rate limits/spam), account_issue (config problems), platform_rejected (policy violation), platform_error (5xx/maintenance), platform_rate_limit (platform throttling, retried automatically), quota_exhausted (shared daily API quota empty, resumes at the platform&#39;s reset), system_error (Zernio infra), unknown | [optional] |
 | **error_source** | **String** | Who caused the error: user (fix content/reconnect), platform (outage/API change), system (Zernio issue, rare) | [optional] |
 ## Example

data/docs/PostAnalytics.md CHANGED Viewed

@@ -9,14 +9,14 @@
 | **likes** | **Integer** |  | [optional] |
 | **comments** | **Integer** |  | [optional] |
 | **shares** | **Integer** |  | [optional] |
-| **saves** | **Integer** | Number of saves/bookmarks (Instagram, Pinterest) | [optional] |
+| **saves** | **Integer** | Number of saves/bookmarks (Instagram, Pinterest, X/Twitter) | [optional] |
 | **clicks** | **Integer** |  | [optional] |
 | **views** | **Integer** |  | [optional] |
 | **follows** | **Integer** | Instagram feed posts and stories only: organic accounts that started following from this post. 0 for reels and other platforms. | [optional] |
 | **ig_reels_avg_watch_time** | **Integer** | Instagram Reels only: average watch time per play, in milliseconds. 0 for non-Reels media and other platforms. | [optional] |
 | **ig_reels_video_view_total_time** | **Integer** | Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms. | [optional] |
 | **video_duration_seconds** | **Integer** | Video length in seconds. Currently Instagram Reels only; combine with igReelsAvgWatchTime (ms) to estimate retention. Null when unknown (other platforms, non-video media, or when Instagram does not expose the media URL, e.g. reels with copyrighted audio). | [optional] |
-| **engagement_rate** | **Float** |  | [optional] |
+| **engagement_rate** | **Float** | Percentage, rounded to 2 decimals: (likes + comments + shares + saves) / (impressions or reach or views) * 100. Clicks and follows are never counted. The denominator is the FIRST of impressions, reach, views that is non-zero, so it is not the same basis on every post: a post with impressions divides by impressions, one without falls back to reach, then to views. If you need a single consistent basis (e.g. interactions / reach), compute it from the raw fields above. The engagementRate on the LinkedIn account endpoints is a different formula. | [optional] |
 | **last_updated** | **Time** |  | [optional] |
 ## Example
@@ -37,7 +37,7 @@ instance = Zernio::PostAnalytics.new(
   ig_reels_avg_watch_time: 0,
   ig_reels_video_view_total_time: 0,
   video_duration_seconds: 30,
-  engagement_rate: 0,
+  engagement_rate: 6.59,
   last_updated: null
 )
 ```

data/docs/PostsApi.md CHANGED Viewed

@@ -95,7 +95,7 @@ end
 Create post
-Create and optionally publish a post. Immediate posts (`publishNow: true`) include `platformPostUrl` in the response. Content is optional when media is attached or all platforms have `customContent`. See each platform's schema for media constraints.  ## Idempotency  Two layers of duplicate-protection apply, so safe-to-retry callers (network blips, n8n / Zapier retries, etc.) don't accidentally double-post.  **1. Same-request idempotency (5-minute window).** Pass an `x-request-id` header to mark a logical request. If a second request arrives with the same `x-request-id` while the first is in-flight (or within ~5 minutes of completion), we return **HTTP 200** with the original post in the `existingPost` field — no new post is created. The official Zernio SDKs auto-generate a unique `x-request-id` per call. If you're using a generic HTTP client (curl, n8n's HTTP node, Zapier, custom code), either: - Set a unique `x-request-id` per logical call (recommended — UUIDv4 is fine) - Or simply omit the header — we'll treat each request as new  **Common pitfall**: if your workflow tool uses a single execution-level request ID and reuses it across multiple HTTP nodes (e.g. one ID for the whole run, shared across 6 different platform calls), every call after the first will look like a retry of the first and return its post. Generate a fresh ID per node.  **2. Content-hash dedup (24-hour window).** Independently, we hash `(platform, accountId, content + media URLs)` and reject duplicates within 24 hours with **HTTP 409**. This catches genuine \"same content posted twice to the same account\" cases regardless of `x-request-id`. Returns `error`, `accountId`, `platform`, and `existingPostId` so you can find the original. To intentionally re-post identical content within 24h, change something (the caption, the media, the account) — the dedup is keyed on the full content fingerprint.  Order: same-`x-request-id` retries (200) are checked first; if no idempotency match, the content-hash dedup (409) runs.
+Create and optionally publish a post. Immediate posts (`publishNow: true`) include `platformPostUrl` in the response. Content is optional when media is attached, all platforms have `customContent`, every platform entry is an X Article (`platformSpecificData.article`), or every platform entry is a LinkedIn plain repost (`platformSpecificData.reshareUrl` with no text). See each platform's schema for media constraints.  ## Idempotency  Two layers of duplicate-protection apply, so safe-to-retry callers (network blips, n8n / Zapier retries, etc.) don't accidentally double-post.  **1. Same-request idempotency (5-minute window).** Pass an `x-request-id` header to mark a logical request. If a second request arrives with the same `x-request-id` while the first is in-flight (or within ~5 minutes of completion), we return **HTTP 200** with the original post in the `existingPost` field — no new post is created. The official Zernio SDKs auto-generate a unique `x-request-id` per call. If you're using a generic HTTP client (curl, n8n's HTTP node, Zapier, custom code), either: - Set a unique `x-request-id` per logical call (recommended — UUIDv4 is fine) - Or simply omit the header — we'll treat each request as new  **Common pitfall**: if your workflow tool uses a single execution-level request ID and reuses it across multiple HTTP nodes (e.g. one ID for the whole run, shared across 6 different platform calls), every call after the first will look like a retry of the first and return its post. Generate a fresh ID per node.  **2. Content-hash dedup (24-hour window).** Independently, we hash `(platform, accountId, content + media URLs)` and reject duplicates within 24 hours with **HTTP 409**. This catches genuine \"same content posted twice to the same account\" cases regardless of `x-request-id`. Returns `error`, `accountId`, `platform`, and `existingPostId` so you can find the original. To intentionally re-post identical content within 24h, change something (the caption, the media, the account) — the dedup is keyed on the full content fingerprint.  Order: same-`x-request-id` retries (200) are checked first; if no idempotency match, the content-hash dedup (409) runs.
 ### Examples

data/docs/SMSApi.md CHANGED Viewed

@@ -1141,7 +1141,7 @@ end
 Send an SMS/MMS
-Sends an SMS (or MMS when `mediaUrls` is set) from one of your SMS-enabled numbers. At least one of `text` / `mediaUrls` is required. Both numbers are normalized to E.164, so `from` matches regardless of formatting and replies thread into the same inbox conversation.  US numbers must have an approved carrier registration (`/v1/sms/registrations`) before messages deliver.  **Idempotency:** send an `Idempotency-Key` header to make retries safe: same key + same body replays the original response instead of sending a second message; same key + different body returns 422; a key still in flight returns 409.
+Sends an SMS (or MMS when `mediaUrls` is set) from one of your SMS-enabled numbers. At least one of `text` / `mediaUrls` is required. Both numbers are normalized to E.164, so `from` matches regardless of formatting and replies thread into the same inbox conversation.  US numbers must have an approved carrier registration (`/v1/sms/registrations`) before messages deliver.  **Replies and delivery status arrive as webhooks**, not by polling: an inbound reply fires `message.received` with `platform: \"sms\"`, the first message of a new thread also fires `conversation.started`, and this message's own outcome fires `message.delivered` or `message.failed` (the latter carrying the carrier's error code).  **Opted-out recipients:** a send to a number that replied STOP is refused with `409`, never silently dropped.  **Idempotency:** send an `Idempotency-Key` header to make retries safe: same key + same body replays the original response instead of sending a second message; same key + different body returns 422; a key still in flight returns 409.
 ### Examples

data/docs/SearchAdTargeting200ResponseResultsInner.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** | The platform&#39;s opaque id. Use as a geo &#x60;key&#x60; (regions/cities/zips/metros) or an entity &#x60;id&#x60; (interests/behaviors) in TargetingSpec. |  |
 | **name** | **String** | Human-readable label. |  |
-| **type** | **String** | What the result is (e.g. city, region, country, zip, metro, interest, behavior, income). |  |
+| **type** | **String** | What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income). |  |
 | **path** | **Array&lt;String&gt;** | Optional breadcrumb of parent labels (e.g. [&#39;United States&#39;, &#39;California&#39;, &#39;Los Angeles&#39;]). Disambiguates same-named results. | [optional] |
 | **audience_size** | **Integer** | Optional estimated reachable users for this option, when the platform returns it. | [optional] |

data/docs/SendInboxMessageRequest.md CHANGED Viewed

@@ -6,13 +6,14 @@
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Social account ID |  |
 | **message** | **String** | Message text | [optional] |
-| **attachment_url** | **String** | URL of the attachment to send (image, video, audio, or file). The URL must be publicly accessible. For binary file uploads, use multipart/form-data instead. | [optional] |
+| **attachment_url** | **String** | URL of the attachment to send (image, video, audio, or file). The URL must be publicly accessible. For binary file uploads, use multipart/form-data instead. On WhatsApp, combining an image, video, or file with &#x60;buttons&#x60; renders the media as the header of one interactive reply-button message; audio cannot be combined with buttons. | [optional] |
 | **category** | **String** | WhatsApp only (Meta Direct Send). Sends this message as a business-initiated UTILITY message without an approved template, for example outside the 24-hour customer service window; Meta matches or auto-creates a template asynchronously. The WhatsApp Business Account must be eligible for Direct Send, otherwise the send fails with an error telling you to use an approved message template instead. Supported only for text messages (link preview ok) and interactive messages (reply buttons, CTA URL buttons, voice-call button, header of text/image/video/document). Cannot be combined with template, attachments, location, or contacts. Utility messages only; marketing content is not allowed under this category. Accepted on the JSON body only, not on multipart requests. | [optional] |
+| **link_preview** | **Boolean** | WhatsApp only. Set false to send the message without a link-preview thumbnail for the first URL in the text. Defaults to true, which is how every WhatsApp text has been sent to date. Ignored on other platforms. Accepted on the JSON body only, not on multipart requests. | [optional][default to true] |
 | **attachment_type** | **String** | Type of attachment. Defaults to file if not specified. | [optional] |
 | **attachment_name** | **String** | WhatsApp only. Display name for a document sent via attachmentUrl with attachmentType: file (e.g. \&quot;Report.pdf\&quot;). Maps to the recipient&#39;s file name; without it WhatsApp derives the name from the URL and shows \&quot;Untitled\&quot;. Ignored for image/video/audio and for binary uploads (which use the uploaded file&#39;s name). | [optional] |
 | **voice_note** | **Boolean** | WhatsApp only. When &#x60;true&#x60; on an audio attachment, the message is sent as a voice message (PTT) — the recipient sees the waveform + voice-note UI instead of a basic audio attachment. The audio file MUST be &#x60;.ogg&#x60; encoded with the OPUS codec (mono) per Meta&#39;s voice-message contract; other formats are rejected by WhatsApp. Ignored for non-audio attachments.  | [optional] |
 | **quick_replies** | [**Array&lt;SendInboxMessageRequestQuickRepliesInner&gt;**](SendInboxMessageRequestQuickRepliesInner.md) | Quick reply buttons. Mutually exclusive with buttons. Max 13 items. | [optional] |
-| **buttons** | [**Array&lt;SendInboxMessageRequestButtonsInner&gt;**](SendInboxMessageRequestButtonsInner.md) | Action buttons. Mutually exclusive with quickReplies. Max 3 items.  Instagram / Facebook: also mutually exclusive with &#x60;template&#x60;. A Meta message carries one body shape, so sending both is a 400 rather than a silent drop of the buttons.  WhatsApp: buttons always render as interactive reply buttons. Only &#x60;title&#x60; and &#x60;payload&#x60; are used — &#x60;type&#x60;, &#x60;url&#x60;, and &#x60;phone&#x60; are ignored (WhatsApp has no URL/phone button in this field; use the &#x60;interactive&#x60; field with &#x60;type: cta_url&#x60; for a link button). &#x60;payload&#x60; becomes the button reply ID delivered on the &#x60;message.received&#x60; webhook when the user taps. To send a simple reply-button message, provide &#x60;title&#x60; + &#x60;payload&#x60; and set &#x60;type: postback&#x60;, e.g. &#x60;{ \&quot;type\&quot;: \&quot;postback\&quot;, \&quot;title\&quot;: \&quot;Yes\&quot;, \&quot;payload\&quot;: \&quot;yes\&quot; }&#x60;.  | [optional] |
+| **buttons** | [**Array&lt;SendInboxMessageRequestButtonsInner&gt;**](SendInboxMessageRequestButtonsInner.md) | Action buttons. Mutually exclusive with quickReplies. Max 3 items.  Instagram / Facebook: also mutually exclusive with &#x60;template&#x60;. A Meta message carries one body shape, so sending both is a 400 rather than a silent drop of the buttons.  WhatsApp: buttons always render as interactive reply buttons. Only &#x60;title&#x60; and &#x60;payload&#x60; are used — &#x60;type&#x60;, &#x60;url&#x60;, and &#x60;phone&#x60; are ignored (WhatsApp has no URL/phone button in this field; use the &#x60;interactive&#x60; field with &#x60;type: cta_url&#x60; for a link button). &#x60;payload&#x60; becomes the button reply ID delivered on the &#x60;message.received&#x60; webhook when the user taps. To send a simple reply-button message, provide &#x60;title&#x60; + &#x60;payload&#x60; and set &#x60;type: postback&#x60;, e.g. &#x60;{ \&quot;type\&quot;: \&quot;postback\&quot;, \&quot;title\&quot;: \&quot;Yes\&quot;, \&quot;payload\&quot;: \&quot;yes\&quot; }&#x60;.  Combine &#x60;buttons&#x60; with &#x60;attachmentUrl&#x60; and &#x60;attachmentType&#x60; &#x60;image&#x60;, &#x60;video&#x60;, or &#x60;file&#x60; to render one WhatsApp message with a media header, body text, and reply buttons. Audio is not a supported interactive header and returns 400 when combined with buttons.  | [optional] |
 | **template** | [**SendInboxMessageRequestTemplate**](SendInboxMessageRequestTemplate.md) |  | [optional] |
 | **interactive** | [**SendInboxMessageRequestInteractive**](SendInboxMessageRequestInteractive.md) |  | [optional] |
 | **reply_markup** | [**SendInboxMessageRequestReplyMarkup**](SendInboxMessageRequestReplyMarkup.md) |  | [optional] |
@@ -32,6 +33,7 @@ instance = Zernio::SendInboxMessageRequest.new(
   message: null,
   attachment_url: null,
   category: null,
+  link_preview: null,
   attachment_type: null,
   attachment_name: null,
   voice_note: null,

data/docs/SubmitPhoneNumberKycRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **profile_id** | **String** |  |  |
 | **country** | **String** |  |  |
-| **submission_id** | **String** | Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. | [optional] |
+| **submission_id** | **String** | Idempotency token for this submission attempt. Once the number has been ordered, a retry with the same token returns that same number instead of ordering another. A submission that fails before the number is ordered releases the token, so you can correct your details and re-submit with it. Omit it and every call provisions a new number. | [optional] |
 | **quantity** | **Integer** | Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort). With &#x60;areaCode&#x60;, a quantity above that area&#39;s live stock is rejected with a 400. | [optional][default to 1] |
 | **reuse** | **Boolean** | Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). | [optional] |
 | **reuse_option_id** | **String** | Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted &#x3D; the approved default. No match &#x3D; 409. | [optional] |

data/docs/SubmitPhoneNumberKycRequestAddress.md CHANGED Viewed

@@ -10,6 +10,7 @@
 | **first_name** | **String** |  | [optional] |
 | **last_name** | **String** |  | [optional] |
 | **street_address** | **String** |  | [optional] |
+| **extended_address** | **String** | Address complement: apartment, suite, unit, or the quadra/lote used in some countries. Optional. Does not substitute for a building number on street_address. | [optional] |
 | **locality** | **String** |  | [optional] |
 | **administrative_area** | **String** |  | [optional] |
 | **postal_code** | **String** |  | [optional] |
@@ -26,6 +27,7 @@ instance = Zernio::SubmitPhoneNumberKycRequestAddress.new(
   first_name: null,
   last_name: null,
   street_address: null,
+  extended_address: null,
   locality: null,
   administrative_area: null,
   postal_code: null

data/docs/SubmitWhatsAppNumberKycRequest.md CHANGED Viewed

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **profile_id** | **String** |  |  |
 | **country** | **String** |  |  |
-| **submission_id** | **String** | Idempotency token for this submission attempt. A retry/double-submit with the same token returns the same number; omit and each call creates a new number. | [optional] |
+| **submission_id** | **String** | Idempotency token for this submission attempt. Once the number has been ordered, a retry with the same token returns that same number instead of ordering another. A submission that fails before the number is ordered releases the token, so you can correct your details and re-submit with it. Omit it and every call provisions a new number. | [optional] |
 | **quantity** | **Integer** | Provision several same-country numbers from one submission (1-5). The single verification covers all of them; each number is billed only when it activates. Numbers that fail to order are skipped (best-effort). With &#x60;areaCode&#x60;, a quantity above that area&#39;s live stock is rejected with a 400. | [optional][default to 1] |
 | **reuse** | **Boolean** | Reuse a prior approved verification for this country (skips document/field collection; places the order immediately). | [optional] |
 | **reuse_option_id** | **String** | Which reusable verification to use (GET reusable.options[].id). The unambiguous selection key. Omitted &#x3D; the approved default. No match &#x3D; 409. | [optional] |

data/docs/TwitterPlatformData.md CHANGED Viewed

@@ -4,6 +4,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
+| **article** | [**XArticle**](XArticle.md) |  | [optional] |
 | **reply_to_tweet_id** | **String** | ID of an existing tweet to reply to. The published tweet will appear as a reply in that tweet&#39;s thread. For threads, only the first tweet replies to the target; subsequent tweets chain normally. X only permits replying to your own posts or posts you are mentioned in; replying to an arbitrary other account&#39;s post is rejected by X. | [optional] |
 | **quote_tweet_id** | **String** | ID (or full status URL) of an existing tweet to quote-repost. The published tweet becomes a quote tweet of the target. Mutually exclusive with media and poll. X only permits quoting your own posts or posts you are mentioned in / part of the conversation thread of; quoting an arbitrary other account&#39;s post is rejected by X. Billed at the standard create rate ($0.015), unlike pasting a tweet URL into the text which is billed at the URL rate ($0.20). For threads, applies to the first tweet only. | [optional] |
 | **reply_settings** | **String** | Controls who can reply to the tweet. \&quot;following\&quot; allows only people you follow, \&quot;mentionedUsers\&quot; allows only mentioned users, \&quot;subscribers\&quot; allows only subscribers, \&quot;verified\&quot; allows only verified users. Omit for default (everyone can reply). For threads, applies to the first tweet only. Cannot be combined with replyToTweetId. | [optional] |
@@ -21,6 +22,7 @@
 require 'zernio-sdk'
 instance = Zernio::TwitterPlatformData.new(
+  article: null,
   reply_to_tweet_id: null,
   quote_tweet_id: null,
   reply_settings: null,

data/docs/UpdateAdCampaignStatus200Response.md CHANGED Viewed

@@ -4,10 +4,10 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **updated** | **Integer** | Number of ads updated | [optional] |
-| **skipped** | **Integer** | Number of ads skipped | [optional] |
-| **skipped_reasons** | **Array&lt;String&gt;** |  | [optional] |
-| **message** | **String** | Human-readable summary (present when no ads were actionable) | [optional] |
+| **status** | **String** | The status written to the campaign | [optional] |
+| **updated** | **Integer** | Number of ads whose own stored status changed too. 0 is normal on a resume whose ads are all awaiting the platform. | [optional] |
+| **skipped** | **Integer** | Number of ads whose own status was left as it was | [optional] |
+| **skipped_reasons** | **Array&lt;String&gt;** | Why each group of ads was skipped | [optional] |
 ## Example
@@ -15,10 +15,10 @@
 require 'zernio-sdk'
 instance = Zernio::UpdateAdCampaignStatus200Response.new(
+  status: null,
   updated: null,
   skipped: null,
-  skipped_reasons: null,
-  message: null
+  skipped_reasons: null
 )
 ```

data/docs/UpdateAdSet200Response.md CHANGED Viewed

@@ -6,9 +6,11 @@
 | ---- | ---- | ----------- | ----- |
 | **budget** | [**AdBudget**](AdBudget.md) |  | [optional] |
 | **budget_level** | **String** |  | [optional] |
-| **status** | **String** |  | [optional] |
-| **status_updated** | **Integer** |  | [optional] |
-| **status_skipped** | **Integer** |  | [optional] |
+| **status** | **String** | The status written to the ad set. Absent when nothing was written (see statusMessage). | [optional] |
+| **status_updated** | **Integer** | Number of ads whose own stored status changed alongside the ad set switch | [optional] |
+| **status_skipped** | **Integer** | Number of ads whose own status was left as it was | [optional] |
+| **status_skipped_reasons** | **Array&lt;String&gt;** | Why each group of ads was skipped | [optional] |
+| **status_message** | **String** | Present only where the platform has no ad-set switch and no child ad was actionable; &#x60;status&#x60; is then absent because nothing was written | [optional] |
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |
 | **bid_amount** | **Float** |  | [optional] |
 | **roas_average_floor** | **Float** |  | [optional] |
@@ -25,6 +27,8 @@ instance = Zernio::UpdateAdSet200Response.new(
   status: null,
   status_updated: null,
   status_skipped: null,
+  status_skipped_reasons: null,
+  status_message: null,
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,