late-sdk 0.0.918 → 0.0.920

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c41c1ead10e971f4dd02dbf56c68f6d75bb0d071875692a05f9abb921feb41bd
-  data.tar.gz: 072dbafe9be58d137f7eacc1b03eb550dcde4d73e91a886230d00a14bad2481e
+  metadata.gz: 40e2044e5a7296ed3c98b27ebbe305a8774a0ea47146a6f679d3e31127b2fa11
+  data.tar.gz: dad4e1e52cd622362f1409fd7f4cf66923e9e45edfd7140d77d05372df23d33b
 SHA512:
-  metadata.gz: 19d9fcf30d159cf8af989d3d5bf5966f18e9c4767f607467d6c39a6d61083adcea16797c855da7e9a563daeff5da86f6982cca5d7130d7f99f6fefe44056d15c
-  data.tar.gz: cc921d1d2b527c61922c43e6a406e3e03d3d6bdadc0964eef3494d20f1ea7c37003b878e0891bf4c910a67426dc1c50fa9ba7b7f988e5500867eb1936d348c27
+  metadata.gz: 96c3456acb147bca85978b4f2ca9ac4d9d6003d57f586ffd75f86ca20ae7e7291af33a688efc45e084a876a26eea3031701db20206d4b6172ce11976da4b544d
+  data.tar.gz: 742671702d09b3f84b24be024bd2563289b3ea4c6a6b5951010aa210522882eb50d5dc216c6acc02847f267c3f13ee2447597e052608b548fe3b5de52bd03e86

data/docs/AnalyticsApi.md

@@ -62,7 +62,7 @@ opts = {
   to_date: Date.parse('2013-10-20'), # Date | Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted.
   limit: 56, # Integer | Page size (default 50)
   page: 56, # Integer | Page number (default 1)
-  sort_by: 'date', # String | Sort by date, engagement, or a specific metric. Instagram-only metrics (follows, reposts, reels_skip_rate, ig_reels_*) sort a null value as 0.
+  sort_by: 'date', # String | Sort by date, engagement, or a specific metric. Platform-specific metrics (follows, reposts, reels_skip_rate, ig_reels_*, completion_rate, profile_views) sort a null value as 0.
   order: 'asc' # String | Sort order
 }
 
@@ -106,7 +106,7 @@ end
 | **to_date** | **Date** | Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted. | [optional] |
 | **limit** | **Integer** | Page size (default 50) | [optional][default to 50] |
 | **page** | **Integer** | Page number (default 1) | [optional][default to 1] |
-| **sort_by** | **String** | Sort by date, engagement, or a specific metric. Instagram-only metrics (follows, reposts, reels_skip_rate, ig_reels_*) sort a null value as 0. | [optional][default to 'date'] |
+| **sort_by** | **String** | Sort by date, engagement, or a specific metric. Platform-specific metrics (follows, reposts, reels_skip_rate, ig_reels_*, completion_rate, profile_views) sort a null value as 0. | [optional][default to 'date'] |
 | **order** | **String** | Sort order | [optional][default to 'desc'] |
 
 ### Return type

data/docs/AnalyticsDeltaEntryMetrics.md

@@ -18,6 +18,8 @@
 | **ig_reels_video_view_total_time** | **Integer** | Instagram Reels total watch time, in milliseconds |  |
 | **reposts** | **Integer** |  |  |
 | **reels_skip_rate** | **Float** | Instagram Reels skip rate, 0 to 1 |  |
+| **completion_rate** | **Float** | TikTok business lane: share of viewers who watched to the end, 0 to 1 |  |
+| **profile_views** | **Integer** | TikTok business lane: profile views attributed to the post |  |
 
 ## Example
 
@@ -38,7 +40,9 @@ instance = Zernio::AnalyticsDeltaEntryMetrics.new(
   ig_reels_avg_watch_time: null,
   ig_reels_video_view_total_time: null,
   reposts: null,
-  reels_skip_rate: null
+  reels_skip_rate: null,
+  completion_rate: null,
+  profile_views: null
 )
 ```
 

data/docs/PhoneNumbersApi.md

@@ -1149,7 +1149,7 @@ end
 
 Purchase phone number
 
-Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
 
 ### Examples
 
@@ -1569,7 +1569,7 @@ end
 
 Search available numbers
 
-Search the provider's inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass `sms=true` to only see numbers that can also text (SMS support is per-number, not per-country). 
+Search the provider's inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass `sms=true` to only see numbers that can also text (SMS support is per-number, not per-country). Numbers a purchase would refuse are left out, and any result's `phoneNumber` can be bought exactly by passing it to POST /v1/phone-numbers/purchase. 
 
 ### Examples
 

data/docs/PostAnalytics.md

@@ -16,6 +16,8 @@
 | **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] |
 | **reels_skip_rate** | **Float** | Instagram Reels only: percentage (0-100) of initial views that skipped the reel within its first 3 seconds, as reported by Meta. Meta labels the metric estimated and in development, so it can move between syncs. 0 for non-Reels media and other platforms. When a post is published to several accounts, the aggregate is weighted by views. | [optional] |
+| **completion_rate** | **Float** | TikTok accounts connected through the TikTok for Business app only: share of viewers who watched the video to the end, 0 to 1, as TikTok reports it (T+24-48h, only for posts active in the last 7 days). 0 for other platforms. When a post is published to several accounts, the aggregate is weighted by views. | [optional] |
+| **profile_views** | **Integer** | TikTok accounts connected through the TikTok for Business app only: profile views from users who reached the profile through this post (T+24-48h). 0 for other platforms. | [optional] |
 | **reposts** | **Integer** | Instagram accounts connected with Facebook Login only: reposts of the media by other users, minus deleted reposts, on feed posts, reels and stories. Meta does not expose this metric for accounts connected with Instagram Login, so those always report 0. 0 for other platforms, including Threads, where reposts are counted in shares instead. | [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** | 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] |
@@ -39,6 +41,8 @@ instance = Zernio::PostAnalytics.new(
   ig_reels_avg_watch_time: 0,
   ig_reels_video_view_total_time: 0,
   reels_skip_rate: 48.8,
+  completion_rate: 0,
+  profile_views: 0,
   reposts: 0,
   video_duration_seconds: 30,
   engagement_rate: 6.59,

data/docs/PurchasePhoneNumberRequest.md

@@ -8,6 +8,7 @@
 | **country** | **String** | ISO 3166-1 alpha-2 country for the number (default US). International numbers require usage-based billing. Tier 3/4 countries return 202 { status: \"kyc_required\", kycUrl }. The customer must complete KYC at that URL before the number is ordered. See GET /v1/phone-numbers/countries.  | [optional][default to 'US'] |
 | **number_type** | **String** | Which of the country's offered number types to order (see `types[]` on GET /v1/phone-numbers/countries). Omitted = the country's default type, which is always the WhatsApp-safe choice. Capabilities, price, and KYC requirements are per (country, type): toll_free can never connect WhatsApp (400 when combined with connectWhatsapp:true), and wantsSms:true requires an SMS-capable type.  | [optional] |
 | **area_code** | **String** | Area code (national destination code, e.g. 11 for Sao Paulo) the number must be in. Hard constraint: when the area has no deliverable inventory the purchase fails with 409 code AREA_CODE_UNAVAILABLE instead of assigning a number from another area, and later replacements stay in this area too. Omit for any area. Get live options from GET /v1/phone-numbers/availability (areaOptions).  | [optional] |
+| **phone_number** | **String** | One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Hard constraint: when it is no longer available (bought by someone else, or WhatsApp's buy-time check rejects it) the purchase fails with 409 code PHONE_NUMBER_UNAVAILABLE instead of assigning another number; search again and pick another. Only for countries and types that activate instantly: a regulated one (202 kyc_required) returns 400 when phoneNumber is set.  | [optional] |
 | **connect_whatsapp** | **Boolean** | A phone number is the unit; WhatsApp is one optional feature. Pass false to buy a STANDALONE number (Calls/SMS only): provisioning skips the Meta pre-verify/OTP steps and the number activates immediately. Omitted defaults to the WhatsApp provisioning path. WhatsApp can be connected to a standalone number later from the connect flow.  | [optional][default to true] |
 | **wants_sms** | **Boolean** | SMS capability is per-number, not per-country. Pass true to provision from the SMS-capable inventory pool so the number can actually text (see also GET /v1/phone-numbers/available with sms=true, and smsAvailable on GET /v1/phone-numbers/countries).  | [optional][default to false] |
 | **wants_whatsapp** | **Boolean** | Declare WhatsApp intent on a STANDALONE purchase (connectWhatsapp:false). The number still activates and bills immediately, but if WhatsApp's buy-time check rejects the assigned number, it is automatically swapped for a WhatsApp-eligible one during the purchase instead of being delivered with WhatsApp unavailable. Ignored on the WhatsApp provisioning path (connectWhatsapp omitted or true), which always delivers a WhatsApp-verified number.  | [optional][default to false] |
@@ -24,6 +25,7 @@ instance = Zernio::PurchasePhoneNumberRequest.new(
   country: null,
   number_type: null,
   area_code: null,
+  phone_number: null,
   connect_whatsapp: null,
   wants_sms: null,
   wants_whatsapp: null,

data/docs/PurchaseWhatsAppPhoneNumberRequest.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **profile_id** | **String** | Profile to associate the number with |  |
 | **country** | **String** | ISO 3166-1 alpha-2 country for the number (default US). International numbers require usage-based billing. Tier 3/4 countries return 202 { status: \"kyc_required\", kycUrl }. The customer must complete KYC at that URL before the number is ordered. See GET /v1/whatsapp/phone-numbers/countries.  | [optional][default to 'US'] |
+| **phone_number** | **String** | One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Fails with 409 code PHONE_NUMBER_UNAVAILABLE when it is no longer available.  | [optional] |
 | **purchase_intent_id** | **String** | Optional idempotency key. Send the same value when retrying a purchase: if a number was already bought under this key, the API returns { status: \"already_purchased\", numberId, phoneNumber } instead of provisioning a second number. Generate a fresh key for each genuinely new purchase.  | [optional] |
 | **allow_multiple** | **Boolean** | Any second purchase within 10 minutes of a previous one is rejected with 409 code PURCHASE_VELOCITY as duplicate protection. Pass true to confirm the additional purchase is intentional (e.g. bulk provisioning).  | [optional][default to false] |
 
@@ -17,6 +18,7 @@ require 'zernio-sdk'
 instance = Zernio::PurchaseWhatsAppPhoneNumberRequest.new(
   profile_id: null,
   country: null,
+  phone_number: null,
   purchase_intent_id: null,
   allow_multiple: null
 )

data/docs/SearchAvailablePhoneNumbers200ResponseNumbersInner.md

@@ -4,8 +4,10 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **phone_number** | **String** |  | [optional] |
+| **phone_number** | **String** | E.164. Pass it as `phoneNumber` on POST /v1/phone-numbers/purchase to buy this exact number. | [optional] |
 | **features** | **Array<String>** | Provider capability list for this number (e.g. voice, sms, mms). | [optional] |
+| **locality** | **String** | Town or rate center the number belongs to, as the carrier names it (e.g. WACO). | [optional] |
+| **best_effort** | **Boolean** | true when the carrier added this number because too few matched your filters, so it may be outside the requested prefix or locality. | [optional] |
 
 ## Example
 
@@ -14,7 +16,9 @@ require 'zernio-sdk'
 
 instance = Zernio::SearchAvailablePhoneNumbers200ResponseNumbersInner.new(
   phone_number: null,
-  features: null
+  features: null,
+  locality: null,
+  best_effort: null
 )
 ```
 

data/docs/SearchAvailableWhatsAppNumbers200ResponseNumbersInner.md

@@ -5,6 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **phone_number** | **String** |  | [optional] |
+| **locality** | **String** |  | [optional] |
+| **best_effort** | **Boolean** |  | [optional] |
 
 ## Example
 
@@ -12,7 +14,9 @@
 require 'zernio-sdk'
 
 instance = Zernio::SearchAvailableWhatsAppNumbers200ResponseNumbersInner.new(
-  phone_number: null
+  phone_number: null,
+  locality: null,
+  best_effort: null
 )
 ```
 

data/docs/WhatsAppPhoneNumbersApi.md

@@ -660,7 +660,7 @@ end
 
 Purchase phone number
 
-Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
 
 ### Examples
 

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

@@ -31,7 +31,7 @@ module Zernio
     # @option opts [Date] :to_date Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted.
     # @option opts [Integer] :limit Page size (default 50) (default to 50)
     # @option opts [Integer] :page Page number (default 1) (default to 1)
-    # @option opts [String] :sort_by Sort by date, engagement, or a specific metric. Instagram-only metrics (follows, reposts, reels_skip_rate, ig_reels_*) sort a null value as 0. (default to 'date')
+    # @option opts [String] :sort_by Sort by date, engagement, or a specific metric. Platform-specific metrics (follows, reposts, reels_skip_rate, ig_reels_*, completion_rate, profile_views) sort a null value as 0. (default to 'date')
     # @option opts [String] :order Sort order (default to 'desc')
     # @return [GetAnalytics200Response]
     def get_analytics(opts = {})
@@ -51,7 +51,7 @@ module Zernio
     # @option opts [Date] :to_date Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted.
     # @option opts [Integer] :limit Page size (default 50) (default to 50)
     # @option opts [Integer] :page Page number (default 1) (default to 1)
-    # @option opts [String] :sort_by Sort by date, engagement, or a specific metric. Instagram-only metrics (follows, reposts, reels_skip_rate, ig_reels_*) sort a null value as 0. (default to 'date')
+    # @option opts [String] :sort_by Sort by date, engagement, or a specific metric. Platform-specific metrics (follows, reposts, reels_skip_rate, ig_reels_*, completion_rate, profile_views) sort a null value as 0. (default to 'date')
     # @option opts [String] :order Sort order (default to 'desc')
     # @return [Array<(GetAnalytics200Response, Integer, Hash)>] GetAnalytics200Response data, response status code and response headers
     def get_analytics_with_http_info(opts = {})
@@ -74,7 +74,7 @@ module Zernio
         fail ArgumentError, 'invalid value for "opts[:"page"]" when calling AnalyticsApi.get_analytics, must be greater than or equal to 1.'
       end
 
-      allowable_values = ["date", "engagement", "impressions", "reach", "likes", "comments", "shares", "saves", "clicks", "views", "follows", "ig_reels_avg_watch_time", "ig_reels_video_view_total_time", "reposts", "reels_skip_rate"]
+      allowable_values = ["date", "engagement", "impressions", "reach", "likes", "comments", "shares", "saves", "clicks", "views", "follows", "ig_reels_avg_watch_time", "ig_reels_video_view_total_time", "reposts", "reels_skip_rate", "completion_rate", "profile_views"]
       if @api_client.config.client_side_validation && opts[:'sort_by'] && !allowable_values.include?(opts[:'sort_by'])
         fail ArgumentError, "invalid value for \"sort_by\", must be one of #{allowable_values}"
       end

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

@@ -1065,7 +1065,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_phone_number_request [PurchasePhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PurchasePhoneNumber200Response]
@@ -1075,7 +1075,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_phone_number_request [PurchasePhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchasePhoneNumber200Response, Integer, Hash)>] PurchasePhoneNumber200Response data, response status code and response headers
@@ -1486,7 +1486,7 @@ module Zernio
     end
 
     # Search available numbers
-    # Search the provider's inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass `sms=true` to only see numbers that can also text (SMS support is per-number, not per-country). 
+    # Search the provider's inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass `sms=true` to only see numbers that can also text (SMS support is per-number, not per-country). Numbers a purchase would refuse are left out, and any result's `phoneNumber` can be bought exactly by passing it to POST /v1/phone-numbers/purchase. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :country  (default to 'US')
     # @option opts [String] :type Number type; defaults to the country&#39;s WhatsApp-safe type
@@ -1502,7 +1502,7 @@ module Zernio
     end
 
     # Search available numbers
-    # Search the provider&#39;s inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass &#x60;sms&#x3D;true&#x60; to only see numbers that can also text (SMS support is per-number, not per-country). 
+    # Search the provider&#39;s inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass &#x60;sms&#x3D;true&#x60; to only see numbers that can also text (SMS support is per-number, not per-country). Numbers a purchase would refuse are left out, and any result&#39;s &#x60;phoneNumber&#x60; can be bought exactly by passing it to POST /v1/phone-numbers/purchase. 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :country  (default to 'US')
     # @option opts [String] :type Number type; defaults to the country&#39;s WhatsApp-safe type

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

@@ -621,7 +621,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_whats_app_phone_number_request [PurchaseWhatsAppPhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [PurchaseWhatsAppPhoneNumber200Response]
@@ -631,7 +631,7 @@ module Zernio
     end
 
     # Purchase phone number
-    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+    # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
     # @param purchase_whats_app_phone_number_request [PurchaseWhatsAppPhoneNumberRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchaseWhatsAppPhoneNumber200Response, Integer, Hash)>] PurchaseWhatsAppPhoneNumber200Response data, response status code and response headers

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

@@ -48,6 +48,12 @@ module Zernio
     # Instagram Reels skip rate, 0 to 1
     attr_accessor :reels_skip_rate
 
+    # TikTok business lane: share of viewers who watched to the end, 0 to 1
+    attr_accessor :completion_rate
+
+    # TikTok business lane: profile views attributed to the post
+    attr_accessor :profile_views
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -64,7 +70,9 @@ module Zernio
         :'ig_reels_avg_watch_time' => :'igReelsAvgWatchTime',
         :'ig_reels_video_view_total_time' => :'igReelsVideoViewTotalTime',
         :'reposts' => :'reposts',
-        :'reels_skip_rate' => :'reelsSkipRate'
+        :'reels_skip_rate' => :'reelsSkipRate',
+        :'completion_rate' => :'completionRate',
+        :'profile_views' => :'profileViews'
       }
     end
 
@@ -94,7 +102,9 @@ module Zernio
         :'ig_reels_avg_watch_time' => :'Integer',
         :'ig_reels_video_view_total_time' => :'Integer',
         :'reposts' => :'Integer',
-        :'reels_skip_rate' => :'Float'
+        :'reels_skip_rate' => :'Float',
+        :'completion_rate' => :'Float',
+        :'profile_views' => :'Integer'
       }
     end
 
@@ -203,6 +213,18 @@ module Zernio
       else
         self.reels_skip_rate = nil
       end
+
+      if attributes.key?(:'completion_rate')
+        self.completion_rate = attributes[:'completion_rate']
+      else
+        self.completion_rate = nil
+      end
+
+      if attributes.key?(:'profile_views')
+        self.profile_views = attributes[:'profile_views']
+      else
+        self.profile_views = nil
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -266,6 +288,14 @@ module Zernio
         invalid_properties.push('invalid value for "reels_skip_rate", reels_skip_rate cannot be nil.')
       end
 
+      if @completion_rate.nil?
+        invalid_properties.push('invalid value for "completion_rate", completion_rate cannot be nil.')
+      end
+
+      if @profile_views.nil?
+        invalid_properties.push('invalid value for "profile_views", profile_views cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -287,6 +317,8 @@ module Zernio
       return false if @ig_reels_video_view_total_time.nil?
       return false if @reposts.nil?
       return false if @reels_skip_rate.nil?
+      return false if @completion_rate.nil?
+      return false if @profile_views.nil?
       true
     end
 
@@ -430,6 +462,26 @@ module Zernio
       @reels_skip_rate = reels_skip_rate
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] completion_rate Value to be assigned
+    def completion_rate=(completion_rate)
+      if completion_rate.nil?
+        fail ArgumentError, 'completion_rate cannot be nil'
+      end
+
+      @completion_rate = completion_rate
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] profile_views Value to be assigned
+    def profile_views=(profile_views)
+      if profile_views.nil?
+        fail ArgumentError, 'profile_views cannot be nil'
+      end
+
+      @profile_views = profile_views
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -448,7 +500,9 @@ module Zernio
           ig_reels_avg_watch_time == o.ig_reels_avg_watch_time &&
           ig_reels_video_view_total_time == o.ig_reels_video_view_total_time &&
           reposts == o.reposts &&
-          reels_skip_rate == o.reels_skip_rate
+          reels_skip_rate == o.reels_skip_rate &&
+          completion_rate == o.completion_rate &&
+          profile_views == o.profile_views
     end
 
     # @see the `==` method
@@ -460,7 +514,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [impressions, reach, likes, comments, shares, saves, sends, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reposts, reels_skip_rate].hash
+      [impressions, reach, likes, comments, shares, saves, sends, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reposts, reels_skip_rate, completion_rate, profile_views].hash
     end
 
     # Builds the object from hash

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

@@ -44,6 +44,12 @@ module Zernio
     # Instagram Reels only: percentage (0-100) of initial views that skipped the reel within its first 3 seconds, as reported by Meta. Meta labels the metric estimated and in development, so it can move between syncs. 0 for non-Reels media and other platforms. When a post is published to several accounts, the aggregate is weighted by views.
     attr_accessor :reels_skip_rate
 
+    # TikTok accounts connected through the TikTok for Business app only: share of viewers who watched the video to the end, 0 to 1, as TikTok reports it (T+24-48h, only for posts active in the last 7 days). 0 for other platforms. When a post is published to several accounts, the aggregate is weighted by views.
+    attr_accessor :completion_rate
+
+    # TikTok accounts connected through the TikTok for Business app only: profile views from users who reached the profile through this post (T+24-48h). 0 for other platforms.
+    attr_accessor :profile_views
+
     # Instagram accounts connected with Facebook Login only: reposts of the media by other users, minus deleted reposts, on feed posts, reels and stories. Meta does not expose this metric for accounts connected with Instagram Login, so those always report 0. 0 for other platforms, including Threads, where reposts are counted in shares instead.
     attr_accessor :reposts
 
@@ -70,6 +76,8 @@ module Zernio
         :'ig_reels_avg_watch_time' => :'igReelsAvgWatchTime',
         :'ig_reels_video_view_total_time' => :'igReelsVideoViewTotalTime',
         :'reels_skip_rate' => :'reelsSkipRate',
+        :'completion_rate' => :'completionRate',
+        :'profile_views' => :'profileViews',
         :'reposts' => :'reposts',
         :'video_duration_seconds' => :'videoDurationSeconds',
         :'engagement_rate' => :'engagementRate',
@@ -102,6 +110,8 @@ module Zernio
         :'ig_reels_avg_watch_time' => :'Integer',
         :'ig_reels_video_view_total_time' => :'Integer',
         :'reels_skip_rate' => :'Float',
+        :'completion_rate' => :'Float',
+        :'profile_views' => :'Integer',
         :'reposts' => :'Integer',
         :'video_duration_seconds' => :'Integer',
         :'engagement_rate' => :'Float',
@@ -181,6 +191,14 @@ module Zernio
         self.reels_skip_rate = attributes[:'reels_skip_rate']
       end
 
+      if attributes.key?(:'completion_rate')
+        self.completion_rate = attributes[:'completion_rate']
+      end
+
+      if attributes.key?(:'profile_views')
+        self.profile_views = attributes[:'profile_views']
+      end
+
       if attributes.key?(:'reposts')
         self.reposts = attributes[:'reposts']
       end
@@ -230,6 +248,8 @@ module Zernio
           ig_reels_avg_watch_time == o.ig_reels_avg_watch_time &&
           ig_reels_video_view_total_time == o.ig_reels_video_view_total_time &&
           reels_skip_rate == o.reels_skip_rate &&
+          completion_rate == o.completion_rate &&
+          profile_views == o.profile_views &&
           reposts == o.reposts &&
           video_duration_seconds == o.video_duration_seconds &&
           engagement_rate == o.engagement_rate &&
@@ -245,7 +265,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [impressions, reach, likes, comments, shares, saves, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reels_skip_rate, reposts, video_duration_seconds, engagement_rate, last_updated].hash
+      [impressions, reach, likes, comments, shares, saves, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reels_skip_rate, completion_rate, profile_views, reposts, video_duration_seconds, engagement_rate, last_updated].hash
     end
 
     # Builds the object from hash

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

@@ -110,7 +110,7 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      code_validator = EnumAttributeValidator.new('String', ["PURCHASE_VELOCITY", "AREA_CODE_UNAVAILABLE"])
+      code_validator = EnumAttributeValidator.new('String', ["PURCHASE_VELOCITY", "AREA_CODE_UNAVAILABLE", "PHONE_NUMBER_UNAVAILABLE"])
       return false unless code_validator.valid?(@code)
       true
     end
@@ -118,7 +118,7 @@ module Zernio
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] code Object to be assigned
     def code=(code)
-      validator = EnumAttributeValidator.new('String', ["PURCHASE_VELOCITY", "AREA_CODE_UNAVAILABLE"])
+      validator = EnumAttributeValidator.new('String', ["PURCHASE_VELOCITY", "AREA_CODE_UNAVAILABLE", "PHONE_NUMBER_UNAVAILABLE"])
       unless validator.valid?(code)
         fail ArgumentError, "invalid value for \"code\", must be one of #{validator.allowable_values}."
       end

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

@@ -27,6 +27,9 @@ module Zernio
     # Area code (national destination code, e.g. 11 for Sao Paulo) the number must be in. Hard constraint: when the area has no deliverable inventory the purchase fails with 409 code AREA_CODE_UNAVAILABLE instead of assigning a number from another area, and later replacements stay in this area too. Omit for any area. Get live options from GET /v1/phone-numbers/availability (areaOptions). 
     attr_accessor :area_code
 
+    # One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Hard constraint: when it is no longer available (bought by someone else, or WhatsApp's buy-time check rejects it) the purchase fails with 409 code PHONE_NUMBER_UNAVAILABLE instead of assigning another number; search again and pick another. Only for countries and types that activate instantly: a regulated one (202 kyc_required) returns 400 when phoneNumber is set. 
+    attr_accessor :phone_number
+
     # A phone number is the unit; WhatsApp is one optional feature. Pass false to buy a STANDALONE number (Calls/SMS only): provisioning skips the Meta pre-verify/OTP steps and the number activates immediately. Omitted defaults to the WhatsApp provisioning path. WhatsApp can be connected to a standalone number later from the connect flow. 
     attr_accessor :connect_whatsapp
 
@@ -71,6 +74,7 @@ module Zernio
         :'country' => :'country',
         :'number_type' => :'numberType',
         :'area_code' => :'areaCode',
+        :'phone_number' => :'phoneNumber',
         :'connect_whatsapp' => :'connectWhatsapp',
         :'wants_sms' => :'wantsSms',
         :'wants_whatsapp' => :'wantsWhatsapp',
@@ -96,6 +100,7 @@ module Zernio
         :'country' => :'String',
         :'number_type' => :'String',
         :'area_code' => :'String',
+        :'phone_number' => :'String',
         :'connect_whatsapp' => :'Boolean',
         :'wants_sms' => :'Boolean',
         :'wants_whatsapp' => :'Boolean',
@@ -146,6 +151,10 @@ module Zernio
         self.area_code = attributes[:'area_code']
       end
 
+      if attributes.key?(:'phone_number')
+        self.phone_number = attributes[:'phone_number']
+      end
+
       if attributes.key?(:'connect_whatsapp')
         self.connect_whatsapp = attributes[:'connect_whatsapp']
       else
@@ -189,6 +198,11 @@ module Zernio
         invalid_properties.push("invalid value for \"area_code\", must conform to the pattern #{pattern}.")
       end
 
+      pattern = Regexp.new(/^\+[1-9]\d{6,14}$/)
+      if !@phone_number.nil? && @phone_number !~ pattern
+        invalid_properties.push("invalid value for \"phone_number\", must conform to the pattern #{pattern}.")
+      end
+
       if !@purchase_intent_id.nil? && @purchase_intent_id.to_s.length > 100
         invalid_properties.push('invalid value for "purchase_intent_id", the character length must be smaller than or equal to 100.')
       end
@@ -204,6 +218,7 @@ module Zernio
       number_type_validator = EnumAttributeValidator.new('String', ["local", "mobile", "national", "toll_free"])
       return false unless number_type_validator.valid?(@number_type)
       return false if !@area_code.nil? && @area_code !~ Regexp.new(/^\d{1,4}$/)
+      return false if !@phone_number.nil? && @phone_number !~ Regexp.new(/^\+[1-9]\d{6,14}$/)
       return false if !@purchase_intent_id.nil? && @purchase_intent_id.to_s.length > 100
       true
     end
@@ -243,6 +258,21 @@ module Zernio
       @area_code = area_code
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] phone_number Value to be assigned
+    def phone_number=(phone_number)
+      if phone_number.nil?
+        fail ArgumentError, 'phone_number cannot be nil'
+      end
+
+      pattern = Regexp.new(/^\+[1-9]\d{6,14}$/)
+      if phone_number !~ pattern
+        fail ArgumentError, "invalid value for \"phone_number\", must conform to the pattern #{pattern}."
+      end
+
+      @phone_number = phone_number
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] purchase_intent_id Value to be assigned
     def purchase_intent_id=(purchase_intent_id)
@@ -266,6 +296,7 @@ module Zernio
           country == o.country &&
           number_type == o.number_type &&
           area_code == o.area_code &&
+          phone_number == o.phone_number &&
           connect_whatsapp == o.connect_whatsapp &&
           wants_sms == o.wants_sms &&
           wants_whatsapp == o.wants_whatsapp &&
@@ -282,7 +313,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [profile_id, country, number_type, area_code, connect_whatsapp, wants_sms, wants_whatsapp, purchase_intent_id, allow_multiple].hash
+      [profile_id, country, number_type, area_code, phone_number, connect_whatsapp, wants_sms, wants_whatsapp, purchase_intent_id, allow_multiple].hash
     end
 
     # Builds the object from hash

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

@@ -21,6 +21,9 @@ module Zernio
     # ISO 3166-1 alpha-2 country for the number (default US). International numbers require usage-based billing. Tier 3/4 countries return 202 { status: \"kyc_required\", kycUrl }. The customer must complete KYC at that URL before the number is ordered. See GET /v1/whatsapp/phone-numbers/countries. 
     attr_accessor :country
 
+    # One exact number to buy, in E.164, taken from GET /v1/phone-numbers/available. Fails with 409 code PHONE_NUMBER_UNAVAILABLE when it is no longer available. 
+    attr_accessor :phone_number
+
     # Optional idempotency key. Send the same value when retrying a purchase: if a number was already bought under this key, the API returns { status: \"already_purchased\", numberId, phoneNumber } instead of provisioning a second number. Generate a fresh key for each genuinely new purchase. 
     attr_accessor :purchase_intent_id
 
@@ -32,6 +35,7 @@ module Zernio
       {
         :'profile_id' => :'profileId',
         :'country' => :'country',
+        :'phone_number' => :'phoneNumber',
         :'purchase_intent_id' => :'purchaseIntentId',
         :'allow_multiple' => :'allowMultiple'
       }
@@ -52,6 +56,7 @@ module Zernio
       {
         :'profile_id' => :'String',
         :'country' => :'String',
+        :'phone_number' => :'String',
         :'purchase_intent_id' => :'String',
         :'allow_multiple' => :'Boolean'
       }
@@ -91,6 +96,10 @@ module Zernio
         self.country = 'US'
       end
 
+      if attributes.key?(:'phone_number')
+        self.phone_number = attributes[:'phone_number']
+      end
+
       if attributes.key?(:'purchase_intent_id')
         self.purchase_intent_id = attributes[:'purchase_intent_id']
       end
@@ -111,6 +120,11 @@ module Zernio
         invalid_properties.push('invalid value for "profile_id", profile_id cannot be nil.')
       end
 
+      pattern = Regexp.new(/^\+[1-9]\d{6,14}$/)
+      if !@phone_number.nil? && @phone_number !~ pattern
+        invalid_properties.push("invalid value for \"phone_number\", must conform to the pattern #{pattern}.")
+      end
+
       if !@purchase_intent_id.nil? && @purchase_intent_id.to_s.length > 100
         invalid_properties.push('invalid value for "purchase_intent_id", the character length must be smaller than or equal to 100.')
       end
@@ -123,6 +137,7 @@ module Zernio
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @profile_id.nil?
+      return false if !@phone_number.nil? && @phone_number !~ Regexp.new(/^\+[1-9]\d{6,14}$/)
       return false if !@purchase_intent_id.nil? && @purchase_intent_id.to_s.length > 100
       true
     end
@@ -137,6 +152,21 @@ module Zernio
       @profile_id = profile_id
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] phone_number Value to be assigned
+    def phone_number=(phone_number)
+      if phone_number.nil?
+        fail ArgumentError, 'phone_number cannot be nil'
+      end
+
+      pattern = Regexp.new(/^\+[1-9]\d{6,14}$/)
+      if phone_number !~ pattern
+        fail ArgumentError, "invalid value for \"phone_number\", must conform to the pattern #{pattern}."
+      end
+
+      @phone_number = phone_number
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] purchase_intent_id Value to be assigned
     def purchase_intent_id=(purchase_intent_id)
@@ -158,6 +188,7 @@ module Zernio
       self.class == o.class &&
           profile_id == o.profile_id &&
           country == o.country &&
+          phone_number == o.phone_number &&
           purchase_intent_id == o.purchase_intent_id &&
           allow_multiple == o.allow_multiple
     end
@@ -171,7 +202,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [profile_id, country, purchase_intent_id, allow_multiple].hash
+      [profile_id, country, phone_number, purchase_intent_id, allow_multiple].hash
     end
 
     # Builds the object from hash

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

@@ -15,16 +15,25 @@ require 'time'
 
 module Zernio
   class SearchAvailablePhoneNumbers200ResponseNumbersInner < ApiModelBase
+    # E.164. Pass it as `phoneNumber` on POST /v1/phone-numbers/purchase to buy this exact number.
     attr_accessor :phone_number
 
     # Provider capability list for this number (e.g. voice, sms, mms).
     attr_accessor :features
 
+    # Town or rate center the number belongs to, as the carrier names it (e.g. WACO).
+    attr_accessor :locality
+
+    # true when the carrier added this number because too few matched your filters, so it may be outside the requested prefix or locality.
+    attr_accessor :best_effort
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'phone_number' => :'phoneNumber',
-        :'features' => :'features'
+        :'features' => :'features',
+        :'locality' => :'locality',
+        :'best_effort' => :'bestEffort'
       }
     end
 
@@ -42,7 +51,9 @@ module Zernio
     def self.openapi_types
       {
         :'phone_number' => :'String',
-        :'features' => :'Array<String>'
+        :'features' => :'Array<String>',
+        :'locality' => :'String',
+        :'best_effort' => :'Boolean'
       }
     end
 
@@ -77,6 +88,14 @@ module Zernio
           self.features = value
         end
       end
+
+      if attributes.key?(:'locality')
+        self.locality = attributes[:'locality']
+      end
+
+      if attributes.key?(:'best_effort')
+        self.best_effort = attributes[:'best_effort']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -100,7 +119,9 @@ module Zernio
       return true if self.equal?(o)
       self.class == o.class &&
           phone_number == o.phone_number &&
-          features == o.features
+          features == o.features &&
+          locality == o.locality &&
+          best_effort == o.best_effort
     end
 
     # @see the `==` method
@@ -112,7 +133,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [phone_number, features].hash
+      [phone_number, features, locality, best_effort].hash
     end
 
     # Builds the object from hash

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

@@ -17,10 +17,16 @@ module Zernio
   class SearchAvailableWhatsAppNumbers200ResponseNumbersInner < ApiModelBase
     attr_accessor :phone_number
 
+    attr_accessor :locality
+
+    attr_accessor :best_effort
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'phone_number' => :'phoneNumber'
+        :'phone_number' => :'phoneNumber',
+        :'locality' => :'locality',
+        :'best_effort' => :'bestEffort'
       }
     end
 
@@ -37,7 +43,9 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'phone_number' => :'String'
+        :'phone_number' => :'String',
+        :'locality' => :'String',
+        :'best_effort' => :'Boolean'
       }
     end
 
@@ -66,6 +74,14 @@ module Zernio
       if attributes.key?(:'phone_number')
         self.phone_number = attributes[:'phone_number']
       end
+
+      if attributes.key?(:'locality')
+        self.locality = attributes[:'locality']
+      end
+
+      if attributes.key?(:'best_effort')
+        self.best_effort = attributes[:'best_effort']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -88,7 +104,9 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          phone_number == o.phone_number
+          phone_number == o.phone_number &&
+          locality == o.locality &&
+          best_effort == o.best_effort
     end
 
     # @see the `==` method
@@ -100,7 +118,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [phone_number].hash
+      [phone_number, locality, best_effort].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -7781,6 +7781,8 @@ components:
         igReelsAvgWatchTime: { type: integer, example: 0, description: 'Instagram Reels only: average watch time per play, in milliseconds. 0 for non-Reels media and other platforms.' }
         igReelsVideoViewTotalTime: { type: integer, example: 0, description: 'Instagram Reels only: total watch time including replays, in milliseconds. 0 for non-Reels media and other platforms.' }
         reelsSkipRate: { type: number, example: 48.8, description: 'Instagram Reels only: percentage (0-100) of initial views that skipped the reel within its first 3 seconds, as reported by Meta. Meta labels the metric estimated and in development, so it can move between syncs. 0 for non-Reels media and other platforms. When a post is published to several accounts, the aggregate is weighted by views.' }
+        completionRate: { type: number, example: 0, description: 'TikTok accounts connected through the TikTok for Business app only: share of viewers who watched the video to the end, 0 to 1, as TikTok reports it (T+24-48h, only for posts active in the last 7 days). 0 for other platforms. When a post is published to several accounts, the aggregate is weighted by views.' }
+        profileViews: { type: integer, example: 0, description: 'TikTok accounts connected through the TikTok for Business app only: profile views from users who reached the profile through this post (T+24-48h). 0 for other platforms.' }
         reposts: { type: integer, example: 0, description: 'Instagram accounts connected with Facebook Login only: reposts of the media by other users, minus deleted reposts, on feed posts, reels and stories. Meta does not expose this metric for accounts connected with Instagram Login, so those always report 0. 0 for other platforms, including Threads, where reposts are counted in shares instead.' }
         videoDurationSeconds: { type: [integer, "null"], example: 30, description: '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).' }
         engagementRate: { type: number, example: 6.59, description: '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.' }
@@ -7976,7 +7978,7 @@ components:
         metrics:
           type: object
           description: 'Metrics a platform does not report are 0, not absent.'
-          required: [impressions, reach, likes, comments, shares, saves, sends, clicks, views, follows, igReelsAvgWatchTime, igReelsVideoViewTotalTime, reposts, reelsSkipRate]
+          required: [impressions, reach, likes, comments, shares, saves, sends, clicks, views, follows, igReelsAvgWatchTime, igReelsVideoViewTotalTime, reposts, reelsSkipRate, completionRate, profileViews]
           properties:
             impressions: { type: integer }
             reach: { type: integer }
@@ -7992,6 +7994,8 @@ components:
             igReelsVideoViewTotalTime: { type: integer, description: 'Instagram Reels total watch time, in milliseconds' }
             reposts: { type: integer }
             reelsSkipRate: { type: number, description: 'Instagram Reels skip rate, 0 to 1' }
+            completionRate: { type: number, description: 'TikTok business lane: share of viewers who watched to the end, 0 to 1' }
+            profileViews: { type: integer, description: 'TikTok business lane: profile views attributed to the post' }
     AnalyticsDeltaResponse:
       type: object
       required: [data, nextCursor, hasMore]
@@ -12187,8 +12191,8 @@ paths:
           description: Page number (default 1)
         - name: sortBy
           in: query
-          schema: { type: string, enum: [date, engagement, impressions, reach, likes, comments, shares, saves, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reposts, reels_skip_rate], default: date }
-          description: 'Sort by date, engagement, or a specific metric. Instagram-only metrics (follows, reposts, reels_skip_rate, ig_reels_*) sort a null value as 0.'
+          schema: { type: string, enum: [date, engagement, impressions, reach, likes, comments, shares, saves, clicks, views, follows, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reposts, reels_skip_rate, completion_rate, profile_views], default: date }
+          description: 'Sort by date, engagement, or a specific metric. Platform-specific metrics (follows, reposts, reels_skip_rate, ig_reels_*, completion_rate, profile_views) sort a null value as 0.'
         - name: order
           in: query
           schema: { type: string, enum: [asc, desc], default: desc }
@@ -12498,6 +12502,8 @@ paths:
                           igReelsVideoViewTotalTime: 0
                           reposts: 0
                           reelsSkipRate: 0
+                          completionRate: 0
+                          profileViews: 0
                     nextCursor: "v1.WyIyMDI2LTA5LTAxIDE3OjEyOjA0IiwiNjVmMWMwYTllMmI1YWYwMDEyYWIzNGNkIl0"
                     hasMore: true
         '400': { $ref: '#/components/responses/BadRequest' }
@@ -36373,8 +36379,9 @@ paths:
       tags: [Phone Numbers]
       summary: Purchase phone number
       description: |
-        Payment-first: you do not pick a specific number, the system provisions one and
-        auto-assigns it. With usage-based billing active and a payment method on file, the
+        Payment-first: the system provisions a number and auto-assigns it, unless you pass
+        `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With
+        usage-based billing active and a payment method on file, the
         number provisions inline and bills per month on your usage-based invoice (there is
         no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
         a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
@@ -36436,6 +36443,18 @@ paths:
                     number from another area, and later replacements stay in
                     this area too. Omit for any area. Get live options from
                     GET /v1/phone-numbers/availability (areaOptions).
+                phoneNumber:
+                  type: string
+                  pattern: '^\+[1-9]\d{6,14}$'
+                  description: >
+                    One exact number to buy, in E.164, taken from GET
+                    /v1/phone-numbers/available. Hard constraint: when it is no
+                    longer available (bought by someone else, or WhatsApp's
+                    buy-time check rejects it) the purchase fails with 409 code
+                    PHONE_NUMBER_UNAVAILABLE instead of assigning another number;
+                    search again and pick another. Only for countries and types
+                    that activate instantly: a regulated one (202 kyc_required)
+                    returns 400 when phoneNumber is set.
                 connectWhatsapp:
                   type: boolean
                   default: true
@@ -36534,14 +36553,14 @@ paths:
             another number was purchased within the last 10 minutes; retry
             with allowMultiple: true to confirm), or the requested areaCode
             has no deliverable inventory right now (code
-            AREA_CODE_UNAVAILABLE: pick another area or omit areaCode).
+            AREA_CODE_UNAVAILABLE: pick another area or omit areaCode; PHONE_NUMBER_UNAVAILABLE: search again and pick another number).
           content:
             application/json:
               schema:
                 type: object
                 properties:
                   error: { type: string }
-                  code: { type: string, enum: [PURCHASE_VELOCITY, AREA_CODE_UNAVAILABLE] }
+                  code: { type: string, enum: [PURCHASE_VELOCITY, AREA_CODE_UNAVAILABLE, PHONE_NUMBER_UNAVAILABLE] }
         '202':
           description: Country requires end-user KYC before the number can be ordered.
           content:
@@ -36627,7 +36646,9 @@ paths:
         country (default US). Optional filters narrow the results. The country
         must be offerable (see GET /v1/phone-numbers/countries). Voice
         capability is always required; pass `sms=true` to only see numbers that
-        can also text (SMS support is per-number, not per-country).
+        can also text (SMS support is per-number, not per-country). Numbers a
+        purchase would refuse are left out, and any result's `phoneNumber` can
+        be bought exactly by passing it to POST /v1/phone-numbers/purchase.
       security:
         - bearerAuth: []
       parameters:
@@ -36654,8 +36675,10 @@ paths:
                     items:
                       type: object
                       properties:
-                        phoneNumber: { type: string }
+                        phoneNumber: { type: string, description: "E.164. Pass it as `phoneNumber` on POST /v1/phone-numbers/purchase to buy this exact number." }
                         features: { type: array, items: { type: string }, description: "Provider capability list for this number (e.g. voice, sms, mms)." }
+                        locality: { type: string, description: "Town or rate center the number belongs to, as the carrier names it (e.g. WACO)." }
+                        bestEffort: { type: boolean, description: "true when the carrier added this number because too few matched your filters, so it may be outside the requested prefix or locality." }
         '400': { description: Country not available }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
@@ -36841,8 +36864,9 @@ paths:
         Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New
         integrations should use that path.
 
-        Payment-first: you do not pick a specific number, the system provisions one and
-        auto-assigns it. With usage-based billing active and a payment method on file, the
+        Payment-first: the system provisions a number and auto-assigns it, unless you pass
+        `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With
+        usage-based billing active and a payment method on file, the
         number provisions inline and bills per month on your usage-based invoice (there is
         no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
         a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
@@ -36876,6 +36900,13 @@ paths:
                     The customer must complete KYC at that URL before the number
                     is ordered. See GET /v1/whatsapp/phone-numbers/countries.
                   default: US
+                phoneNumber:
+                  type: string
+                  pattern: '^\+[1-9]\d{6,14}$'
+                  description: >
+                    One exact number to buy, in E.164, taken from GET
+                    /v1/phone-numbers/available. Fails with 409 code
+                    PHONE_NUMBER_UNAVAILABLE when it is no longer available.
                 purchaseIntentId:
                   type: string
                   maxLength: 100
@@ -36940,14 +36971,14 @@ paths:
             another number was purchased within the last 10 minutes; retry
             with allowMultiple: true to confirm), or the requested areaCode
             has no deliverable inventory right now (code
-            AREA_CODE_UNAVAILABLE: pick another area or omit areaCode).
+            AREA_CODE_UNAVAILABLE: pick another area or omit areaCode; PHONE_NUMBER_UNAVAILABLE: search again and pick another number).
           content:
             application/json:
               schema:
                 type: object
                 properties:
                   error: { type: string }
-                  code: { type: string, enum: [PURCHASE_VELOCITY, AREA_CODE_UNAVAILABLE] }
+                  code: { type: string, enum: [PURCHASE_VELOCITY, AREA_CODE_UNAVAILABLE, PHONE_NUMBER_UNAVAILABLE] }
         '202':
           description: Country requires end-user KYC before the number can be ordered.
           content:
@@ -37038,6 +37069,8 @@ paths:
                       type: object
                       properties:
                         phoneNumber: { type: string }
+                        locality: { type: string }
+                        bestEffort: { type: boolean }
         '400': { description: Country not available }
         '401': { $ref: '#/components/responses/Unauthorized' }
 

data/spec/api/analytics_api_spec.rb

@@ -45,7 +45,7 @@ describe 'AnalyticsApi' do
   # @option opts [Date] :to_date Inclusive upper bound (YYYY-MM-DD). Defaults to today if omitted.
   # @option opts [Integer] :limit Page size (default 50)
   # @option opts [Integer] :page Page number (default 1)
-  # @option opts [String] :sort_by Sort by date, engagement, or a specific metric. Instagram-only metrics (follows, reposts, reels_skip_rate, ig_reels_*) sort a null value as 0.
+  # @option opts [String] :sort_by Sort by date, engagement, or a specific metric. Platform-specific metrics (follows, reposts, reels_skip_rate, ig_reels_*, completion_rate, profile_views) sort a null value as 0.
   # @option opts [String] :order Sort order
   # @return [GetAnalytics200Response]
   describe 'get_analytics test' do

data/spec/api/phone_numbers_api_spec.rb

@@ -226,7 +226,7 @@ describe 'PhoneNumbersApi' do
 
   # unit tests for purchase_phone_number
   # Purchase phone number
-  # Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+  # Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
   # @param purchase_phone_number_request 
   # @param [Hash] opts the optional parameters
   # @return [PurchasePhoneNumber200Response]
@@ -301,7 +301,7 @@ describe 'PhoneNumbersApi' do
 
   # unit tests for search_available_phone_numbers
   # Search available numbers
-  # Search the provider's inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass `sms=true` to only see numbers that can also text (SMS support is per-number, not per-country). 
+  # Search the provider's inventory for numbers available to purchase in a country (default US). Optional filters narrow the results. The country must be offerable (see GET /v1/phone-numbers/countries). Voice capability is always required; pass `sms=true` to only see numbers that can also text (SMS support is per-number, not per-country). Numbers a purchase would refuse are left out, and any result's `phoneNumber` can be bought exactly by passing it to POST /v1/phone-numbers/purchase. 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :country 
   # @option opts [String] :type Number type; defaults to the country's WhatsApp-safe type

data/spec/api/whats_app_phone_numbers_api_spec.rb

@@ -146,7 +146,7 @@ describe 'WhatsAppPhoneNumbersApi' do
 
   # unit tests for purchase_whats_app_phone_number
   # Purchase phone number
-  # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: you do not pick a specific number, the system provisions one and auto-assigns it. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
+  # Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New integrations should use that path.  Payment-first: the system provisions a number and auto-assigns it, unless you pass `phoneNumber` to buy one exact number from `GET /v1/phone-numbers/available`. With usage-based billing active and a payment method on file, the number provisions inline and bills per month on your usage-based invoice (there is no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`; a regulated country returns `202` with `status: \"kyc_required\"` and a `kycUrl`.  The monthly price is the one `GET /v1/phone-numbers/countries` quotes for that country and `numberType` at the time of purchase, and it is stamped on the number: later rate-card changes never move a number you already own.  Requires usage-based billing (the Usage plan). The maximum number of phone numbers is determined by the user's plan. 
   # @param purchase_whats_app_phone_number_request 
   # @param [Hash] opts the optional parameters
   # @return [PurchaseWhatsAppPhoneNumber200Response]

data/spec/models/analytics_delta_entry_metrics_spec.rb

@@ -111,4 +111,16 @@ describe Zernio::AnalyticsDeltaEntryMetrics do
     end
   end
 
+  describe 'test attribute "completion_rate"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "profile_views"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/post_analytics_spec.rb

@@ -99,6 +99,18 @@ describe Zernio::PostAnalytics do
     end
   end
 
+  describe 'test attribute "completion_rate"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "profile_views"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "reposts"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/purchase_phone_number409_response_spec.rb

@@ -36,7 +36,7 @@ describe Zernio::PurchasePhoneNumber409Response do
   describe 'test attribute "code"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["PURCHASE_VELOCITY", "AREA_CODE_UNAVAILABLE"])
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["PURCHASE_VELOCITY", "AREA_CODE_UNAVAILABLE", "PHONE_NUMBER_UNAVAILABLE"])
       # validator.allowable_values.each do |value|
       #   expect { instance.code = value }.not_to raise_error
       # end

data/spec/models/purchase_phone_number_request_spec.rb

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

data/spec/models/purchase_whats_app_phone_number_request_spec.rb

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

data/spec/models/search_available_phone_numbers200_response_numbers_inner_spec.rb

@@ -39,4 +39,16 @@ describe Zernio::SearchAvailablePhoneNumbers200ResponseNumbersInner do
     end
   end
 
+  describe 'test attribute "locality"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "best_effort"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/spec/models/search_available_whats_app_numbers200_response_numbers_inner_spec.rb

@@ -33,4 +33,16 @@ describe Zernio::SearchAvailableWhatsAppNumbers200ResponseNumbersInner do
     end
   end
 
+  describe 'test attribute "locality"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "best_effort"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.918
+  version: 0.0.920
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -6355,7 +6355,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.918.gem
+- zernio-sdk-0.0.920.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: