zernio-sdk 0.0.735 → 0.0.737

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad78ea19ea8742d26f513f2a82b93cab468e7c8a883d32e64718ae7bcf1cc0b0
-  data.tar.gz: ab477092fc5840a8da953e820cbe904bc1cb164a08f9fe10daa784244769f7dd
+  metadata.gz: 819d897dc076c719e4b1797ef83d1398d882c4b16471432c2df6ee07bdfd689c
+  data.tar.gz: 8a17453dbd051e363180df70e571f2b08df2157e253bd18f3231f32cd1267ea2
 SHA512:
-  metadata.gz: c39a398452c96bea78af0cb178ceed58f112f1955b350c97b764f3fa5e4d23953bed492e08de57d38fa8340169675f3ff821a54595faf4a7de6654e4d00fd7b5
-  data.tar.gz: 0ad15ea775b0b6cd57b875c0c3724a828477ed2e9de5fe3ea3a5353cd255baf2f4faf8468737302f553dab9649bbd7b0bac6984745dc58952b46e1aa26bcb619
+  metadata.gz: 18acc2df387b5373b5b33f22ebdbff93f65123a34cc9dc8927983adcba13c20dd2f9ef5998a1409c2f6973d305109ae02de7b4d9b9a07356c9b45748222843e5
+  data.tar.gz: ea17cd724391033e4e61d11ca97a12d338eb457d40c034931281c66314687a2ef99d7182f100d8a5c874677b4215cb8db1eab0ef1699e1f513126273234e62e7

data/docs/ConnectApi.md

@@ -631,7 +631,7 @@ end
 
 Connect WhatsApp via credentials
 
-Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number) 
+Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number)  Warning: connecting subscribes your own Meta app to this WABA with an override callback that redirects its webhook delivery to Zernio. This WABA's events stop reaching any callback URL you had configured before, immediately and with no overlap window. Do not unsubscribe your app from the WABA afterward: that also cuts off Zernio's delivery, and recovery requires calling this endpoint again. 
 
 ### Examples
 

data/docs/ConnectWhatsAppCredentials200Response.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **message** | **String** |  | [optional] |
 | **registration_warning** | **String** | Present when the account was created but Meta rejected the Cloud API registration. The number cannot send messages until this is resolved. | [optional] |
+| **webhook_notice** | **String** | Present when the WABA webhook subscription (with the Zernio override callback) succeeded. Explains the delivery cutover and warns against unsubscribing the app from the WABA afterward. | [optional] |
 | **account** | [**ConnectWhatsAppCredentials200ResponseAccount**](ConnectWhatsAppCredentials200ResponseAccount.md) |  | [optional] |
 
 ## Example
@@ -16,6 +17,7 @@ require 'zernio-sdk'
 instance = Zernio::ConnectWhatsAppCredentials200Response.new(
   message: null,
   registration_warning: null,
+  webhook_notice: null,
   account: null
 )
 ```

data/docs/ConnectWhatsAppCredentials200ResponseAccount.md

@@ -9,7 +9,9 @@
 | **username** | **String** | Display phone number | [optional] |
 | **display_name** | **String** | Meta-verified business name | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
-| **selected_phone_number** | **String** | The connected phone number | [optional] |
+| **phone_number** | **String** | The connected phone number | [optional] |
+| **verified_name** | **String** | Meta-verified business name for the phone number | [optional] |
+| **quality_rating** | **String** | Meta quality rating for the phone number (e.g. GREEN, YELLOW, RED, UNKNOWN) | [optional] |
 
 ## Example
 
@@ -22,7 +24,9 @@ instance = Zernio::ConnectWhatsAppCredentials200ResponseAccount.new(
   username: null,
   display_name: null,
   is_active: null,
-  selected_phone_number: null
+  phone_number: null,
+  verified_name: null,
+  quality_rating: null
 )
 ```
 

data/docs/CreateCallAdRequest.md

@@ -12,7 +12,7 @@
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
 | **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
-| **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
+| **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
 | **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it.  | [optional] |
 | **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |
 | **currency** | **String** | ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional: Zernio resolves it from the ad account when omitted. The value selects the minor-unit exponent Zernio converts budget/bid amounts by before calling Meta (most currencies are cents; zero-decimal currencies like JPY/KRW are sent as-is).  | [optional] |
@@ -30,6 +30,8 @@
 | **placements** | [**CtwaAdRequestBodyPlacements**](CtwaAdRequestBodyPlacements.md) |  | [optional] |
 | **advantage_audience** | **Integer** | Meta's Advantage+ audience expansion. `0` (default) keeps targeting strict; `1` lets Meta expand beyond the supplied targeting when its delivery system finds better matches. Always sent on CREATE (Meta requires it).  | [optional] |
 | **objective** | **String** | Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing.  | [optional] |
+| **status** | **String** | Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the newly created ad(s) after Meta accepts them.  | [optional] |
+| **campaign_status** | **String** | Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults to `ACTIVE`. `PAUSED` holds activation at the campaign so it never spends before the advertiser reviews it, while the ad set and ad still switch on (one resume call brings the whole hierarchy live). Only meaningful when a new campaign is being created; rejected with a 400 alongside `adSetId` (the attach shape reuses an existing campaign).  | [optional] |
 | **bid_strategy** | **String** | Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent.  | [optional] |
 | **bid_amount** | **Float** | Whole currency units (e.g. `5` = $5.00 on a USD account). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; rejected otherwise.  | [optional] |
 | **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [optional] |
@@ -70,6 +72,8 @@ instance = Zernio::CreateCallAdRequest.new(
   placements: null,
   advantage_audience: null,
   objective: null,
+  status: null,
+  campaign_status: null,
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,

data/docs/CreateMessagingAdRequest.md

@@ -12,7 +12,7 @@
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
 | **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
-| **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
+| **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
 | **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it.  | [optional] |
 | **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |
 | **currency** | **String** | ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional: Zernio resolves it from the ad account when omitted. The value selects the minor-unit exponent Zernio converts budget/bid amounts by before calling Meta (most currencies are cents; zero-decimal currencies like JPY/KRW are sent as-is).  | [optional] |
@@ -30,6 +30,8 @@
 | **placements** | [**CtwaAdRequestBodyPlacements**](CtwaAdRequestBodyPlacements.md) |  | [optional] |
 | **advantage_audience** | **Integer** | Meta's Advantage+ audience expansion. `0` (default) keeps targeting strict; `1` lets Meta expand beyond the supplied targeting when its delivery system finds better matches. Always sent on CREATE (Meta requires it).  | [optional] |
 | **objective** | **String** | Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing.  | [optional] |
+| **status** | **String** | Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the newly created ad(s) after Meta accepts them.  | [optional] |
+| **campaign_status** | **String** | Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults to `ACTIVE`. `PAUSED` holds activation at the campaign so it never spends before the advertiser reviews it, while the ad set and ad still switch on (one resume call brings the whole hierarchy live). Only meaningful when a new campaign is being created; rejected with a 400 alongside `adSetId` (the attach shape reuses an existing campaign).  | [optional] |
 | **bid_strategy** | **String** | Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent.  | [optional] |
 | **bid_amount** | **Float** | Whole currency units (e.g. `5` = $5.00 on a USD account). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; rejected otherwise.  | [optional] |
 | **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [optional] |
@@ -69,6 +71,8 @@ instance = Zernio::CreateMessagingAdRequest.new(
   placements: null,
   advantage_audience: null,
   objective: null,
+  status: null,
+  campaign_status: null,
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,

data/docs/CtwaAdRequestBody.md

@@ -12,7 +12,7 @@
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
 | **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
-| **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
+| **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
 | **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it.  | [optional] |
 | **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |
 | **currency** | **String** | ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional: Zernio resolves it from the ad account when omitted. The value selects the minor-unit exponent Zernio converts budget/bid amounts by before calling Meta (most currencies are cents; zero-decimal currencies like JPY/KRW are sent as-is).  | [optional] |
@@ -30,6 +30,8 @@
 | **placements** | [**CtwaAdRequestBodyPlacements**](CtwaAdRequestBodyPlacements.md) |  | [optional] |
 | **advantage_audience** | **Integer** | Meta's Advantage+ audience expansion. `0` (default) keeps targeting strict; `1` lets Meta expand beyond the supplied targeting when its delivery system finds better matches. Always sent on CREATE (Meta requires it).  | [optional] |
 | **objective** | **String** | Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing.  | [optional] |
+| **status** | **String** | Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the newly created ad(s) after Meta accepts them.  | [optional] |
+| **campaign_status** | **String** | Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults to `ACTIVE`. `PAUSED` holds activation at the campaign so it never spends before the advertiser reviews it, while the ad set and ad still switch on (one resume call brings the whole hierarchy live). Only meaningful when a new campaign is being created; rejected with a 400 alongside `adSetId` (the attach shape reuses an existing campaign).  | [optional] |
 | **bid_strategy** | **String** | Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent.  | [optional] |
 | **bid_amount** | **Float** | Whole currency units (e.g. `5` = $5.00 on a USD account). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; rejected otherwise.  | [optional] |
 | **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [optional] |
@@ -68,6 +70,8 @@ instance = Zernio::CtwaAdRequestBody.new(
   placements: null,
   advantage_audience: null,
   objective: null,
+  status: null,
+  campaign_status: null,
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,

data/docs/CtwaAdRequestBodyCreativesInnerVideo.md

@@ -4,8 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **url** | **String** |  |  |
-| **thumbnail_url** | **String** | Required by Meta for every video creative. Used as the ad thumbnail.  |  |
+| **url** | **String** | Public URL of the video to upload. Provide either `url` or `id`. | [optional] |
+| **id** | **String** | Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`. | [optional] |
+| **thumbnail_url** | **String** | OPTIONAL: when omitted, the poster is auto-generated from Meta's own preferred video thumbnail. When Meta produces no candidate the request fails with a 502 platform_error (reason: video_thumbnail_unavailable).  | [optional] |
 
 ## Example
 
@@ -14,6 +15,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CtwaAdRequestBodyCreativesInnerVideo.new(
   url: null,
+  id: null,
   thumbnail_url: null
 )
 ```

data/docs/CtwaAdRequestBodyVideo.md

@@ -4,8 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **url** | **String** |  |  |
-| **thumbnail_url** | **String** | Required by Meta for every video creative. Used as the ad thumbnail.  |  |
+| **url** | **String** | Public URL of the video to upload. Provide either `url` or `id`. | [optional] |
+| **id** | **String** | Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`. | [optional] |
+| **thumbnail_url** | **String** | OPTIONAL: when omitted, the poster is auto-generated from Meta's own preferred video thumbnail. When Meta produces no candidate the request fails with a 502 platform_error (reason: video_thumbnail_unavailable) — retry, or supply this field to control the poster frame exactly.  | [optional] |
 
 ## Example
 
@@ -14,6 +15,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CtwaAdRequestBodyVideo.new(
   url: null,
+  id: null,
   thumbnail_url: null
 )
 ```

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

@@ -594,7 +594,7 @@ module Zernio
     end
 
     # Connect WhatsApp via credentials
-    # Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number) 
+    # Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number)  Warning: connecting subscribes your own Meta app to this WABA with an override callback that redirects its webhook delivery to Zernio. This WABA's events stop reaching any callback URL you had configured before, immediately and with no overlap window. Do not unsubscribe your app from the WABA afterward: that also cuts off Zernio's delivery, and recovery requires calling this endpoint again. 
     # @param connect_whats_app_credentials_request [ConnectWhatsAppCredentialsRequest] 
     # @param [Hash] opts the optional parameters
     # @return [ConnectWhatsAppCredentials200Response]
@@ -604,7 +604,7 @@ module Zernio
     end
 
     # Connect WhatsApp via credentials
-    # Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number) 
+    # Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number)  Warning: connecting subscribes your own Meta app to this WABA with an override callback that redirects its webhook delivery to Zernio. This WABA's events stop reaching any callback URL you had configured before, immediately and with no overlap window. Do not unsubscribe your app from the WABA afterward: that also cuts off Zernio's delivery, and recovery requires calling this endpoint again. 
     # @param connect_whats_app_credentials_request [ConnectWhatsAppCredentialsRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ConnectWhatsAppCredentials200Response, Integer, Hash)>] ConnectWhatsAppCredentials200Response data, response status code and response headers

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

@@ -20,6 +20,9 @@ module Zernio
     # Present when the account was created but Meta rejected the Cloud API registration. The number cannot send messages until this is resolved.
     attr_accessor :registration_warning
 
+    # Present when the WABA webhook subscription (with the Zernio override callback) succeeded. Explains the delivery cutover and warns against unsubscribing the app from the WABA afterward.
+    attr_accessor :webhook_notice
+
     attr_accessor :account
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -27,6 +30,7 @@ module Zernio
       {
         :'message' => :'message',
         :'registration_warning' => :'registrationWarning',
+        :'webhook_notice' => :'webhookNotice',
         :'account' => :'account'
       }
     end
@@ -46,6 +50,7 @@ module Zernio
       {
         :'message' => :'String',
         :'registration_warning' => :'String',
+        :'webhook_notice' => :'String',
         :'account' => :'ConnectWhatsAppCredentials200ResponseAccount'
       }
     end
@@ -80,6 +85,10 @@ module Zernio
         self.registration_warning = attributes[:'registration_warning']
       end
 
+      if attributes.key?(:'webhook_notice')
+        self.webhook_notice = attributes[:'webhook_notice']
+      end
+
       if attributes.key?(:'account')
         self.account = attributes[:'account']
       end
@@ -107,6 +116,7 @@ module Zernio
       self.class == o.class &&
           message == o.message &&
           registration_warning == o.registration_warning &&
+          webhook_notice == o.webhook_notice &&
           account == o.account
     end
 
@@ -119,7 +129,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [message, registration_warning, account].hash
+      [message, registration_warning, webhook_notice, account].hash
     end
 
     # Builds the object from hash

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

@@ -28,7 +28,13 @@ module Zernio
     attr_accessor :is_active
 
     # The connected phone number
-    attr_accessor :selected_phone_number
+    attr_accessor :phone_number
+
+    # Meta-verified business name for the phone number
+    attr_accessor :verified_name
+
+    # Meta quality rating for the phone number (e.g. GREEN, YELLOW, RED, UNKNOWN)
+    attr_accessor :quality_rating
 
     class EnumAttributeValidator
       attr_reader :datatype
@@ -60,7 +66,9 @@ module Zernio
         :'username' => :'username',
         :'display_name' => :'displayName',
         :'is_active' => :'isActive',
-        :'selected_phone_number' => :'selectedPhoneNumber'
+        :'phone_number' => :'phoneNumber',
+        :'verified_name' => :'verifiedName',
+        :'quality_rating' => :'qualityRating'
       }
     end
 
@@ -82,7 +90,9 @@ module Zernio
         :'username' => :'String',
         :'display_name' => :'String',
         :'is_active' => :'Boolean',
-        :'selected_phone_number' => :'String'
+        :'phone_number' => :'String',
+        :'verified_name' => :'String',
+        :'quality_rating' => :'String'
       }
     end
 
@@ -128,8 +138,16 @@ module Zernio
         self.is_active = attributes[:'is_active']
       end
 
-      if attributes.key?(:'selected_phone_number')
-        self.selected_phone_number = attributes[:'selected_phone_number']
+      if attributes.key?(:'phone_number')
+        self.phone_number = attributes[:'phone_number']
+      end
+
+      if attributes.key?(:'verified_name')
+        self.verified_name = attributes[:'verified_name']
+      end
+
+      if attributes.key?(:'quality_rating')
+        self.quality_rating = attributes[:'quality_rating']
       end
     end
 
@@ -170,7 +188,9 @@ module Zernio
           username == o.username &&
           display_name == o.display_name &&
           is_active == o.is_active &&
-          selected_phone_number == o.selected_phone_number
+          phone_number == o.phone_number &&
+          verified_name == o.verified_name &&
+          quality_rating == o.quality_rating
     end
 
     # @see the `==` method
@@ -182,7 +202,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, platform, username, display_name, is_active, selected_phone_number].hash
+      [account_id, platform, username, display_name, is_active, phone_number, verified_name, quality_rating].hash
     end
 
     # Builds the object from hash

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

@@ -38,7 +38,7 @@ module Zernio
     # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
-    # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 
+    # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 
     attr_accessor :ad_set_id
 
     # Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it. 
@@ -88,6 +88,12 @@ module Zernio
     # Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing. 
     attr_accessor :objective
 
+    # Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the newly created ad(s) after Meta accepts them. 
+    attr_accessor :status
+
+    # Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults to `ACTIVE`. `PAUSED` holds activation at the campaign so it never spends before the advertiser reviews it, while the ad set and ad still switch on (one resume call brings the whole hierarchy live). Only meaningful when a new campaign is being created; rejected with a 400 alongside `adSetId` (the attach shape reuses an existing campaign). 
+    attr_accessor :campaign_status
+
     # Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent. 
     attr_accessor :bid_strategy
 
@@ -160,6 +166,8 @@ module Zernio
         :'placements' => :'placements',
         :'advantage_audience' => :'advantageAudience',
         :'objective' => :'objective',
+        :'status' => :'status',
+        :'campaign_status' => :'campaignStatus',
         :'bid_strategy' => :'bidStrategy',
         :'bid_amount' => :'bidAmount',
         :'roas_average_floor' => :'roasAverageFloor',
@@ -209,6 +217,8 @@ module Zernio
         :'placements' => :'CtwaAdRequestBodyPlacements',
         :'advantage_audience' => :'Integer',
         :'objective' => :'String',
+        :'status' => :'String',
+        :'campaign_status' => :'String',
         :'bid_strategy' => :'String',
         :'bid_amount' => :'Float',
         :'roas_average_floor' => :'Float',
@@ -374,6 +384,14 @@ module Zernio
         self.objective = attributes[:'objective']
       end
 
+      if attributes.key?(:'status')
+        self.status = attributes[:'status']
+      end
+
+      if attributes.key?(:'campaign_status')
+        self.campaign_status = attributes[:'campaign_status']
+      end
+
       if attributes.key?(:'bid_strategy')
         self.bid_strategy = attributes[:'bid_strategy']
       end
@@ -521,6 +539,10 @@ module Zernio
       return false unless advantage_audience_validator.valid?(@advantage_audience)
       objective_validator = EnumAttributeValidator.new('String', ["OUTCOME_ENGAGEMENT", "OUTCOME_SALES", "OUTCOME_LEADS"])
       return false unless objective_validator.valid?(@objective)
+      status_validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      return false unless status_validator.valid?(@status)
+      campaign_status_validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      return false unless campaign_status_validator.valid?(@campaign_status)
       bid_strategy_validator = EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
       return false unless bid_strategy_validator.valid?(@bid_strategy)
       return false if !@dsa_beneficiary.nil? && @dsa_beneficiary.to_s.length > 100
@@ -702,6 +724,26 @@ module Zernio
       @objective = objective
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] status Object to be assigned
+    def status=(status)
+      validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      unless validator.valid?(status)
+        fail ArgumentError, "invalid value for \"status\", must be one of #{validator.allowable_values}."
+      end
+      @status = status
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] campaign_status Object to be assigned
+    def campaign_status=(campaign_status)
+      validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      unless validator.valid?(campaign_status)
+        fail ArgumentError, "invalid value for \"campaign_status\", must be one of #{validator.allowable_values}."
+      end
+      @campaign_status = campaign_status
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] bid_strategy Object to be assigned
     def bid_strategy=(bid_strategy)
@@ -791,6 +833,8 @@ module Zernio
           placements == o.placements &&
           advantage_audience == o.advantage_audience &&
           objective == o.objective &&
+          status == o.status &&
+          campaign_status == o.campaign_status &&
           bid_strategy == o.bid_strategy &&
           bid_amount == o.bid_amount &&
           roas_average_floor == o.roas_average_floor &&
@@ -809,7 +853,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, phone_number, link_url].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, phone_number, link_url].hash
     end
 
     # Builds the object from hash

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

@@ -38,7 +38,7 @@ module Zernio
     # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
-    # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 
+    # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 
     attr_accessor :ad_set_id
 
     # Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it. 
@@ -88,6 +88,12 @@ module Zernio
     # Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing. 
     attr_accessor :objective
 
+    # Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the newly created ad(s) after Meta accepts them. 
+    attr_accessor :status
+
+    # Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults to `ACTIVE`. `PAUSED` holds activation at the campaign so it never spends before the advertiser reviews it, while the ad set and ad still switch on (one resume call brings the whole hierarchy live). Only meaningful when a new campaign is being created; rejected with a 400 alongside `adSetId` (the attach shape reuses an existing campaign). 
+    attr_accessor :campaign_status
+
     # Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent. 
     attr_accessor :bid_strategy
 
@@ -157,6 +163,8 @@ module Zernio
         :'placements' => :'placements',
         :'advantage_audience' => :'advantageAudience',
         :'objective' => :'objective',
+        :'status' => :'status',
+        :'campaign_status' => :'campaignStatus',
         :'bid_strategy' => :'bidStrategy',
         :'bid_amount' => :'bidAmount',
         :'roas_average_floor' => :'roasAverageFloor',
@@ -205,6 +213,8 @@ module Zernio
         :'placements' => :'CtwaAdRequestBodyPlacements',
         :'advantage_audience' => :'Integer',
         :'objective' => :'String',
+        :'status' => :'String',
+        :'campaign_status' => :'String',
         :'bid_strategy' => :'String',
         :'bid_amount' => :'Float',
         :'roas_average_floor' => :'Float',
@@ -369,6 +379,14 @@ module Zernio
         self.objective = attributes[:'objective']
       end
 
+      if attributes.key?(:'status')
+        self.status = attributes[:'status']
+      end
+
+      if attributes.key?(:'campaign_status')
+        self.campaign_status = attributes[:'campaign_status']
+      end
+
       if attributes.key?(:'bid_strategy')
         self.bid_strategy = attributes[:'bid_strategy']
       end
@@ -506,6 +524,10 @@ module Zernio
       return false unless advantage_audience_validator.valid?(@advantage_audience)
       objective_validator = EnumAttributeValidator.new('String', ["OUTCOME_ENGAGEMENT", "OUTCOME_SALES", "OUTCOME_LEADS"])
       return false unless objective_validator.valid?(@objective)
+      status_validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      return false unless status_validator.valid?(@status)
+      campaign_status_validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      return false unless campaign_status_validator.valid?(@campaign_status)
       bid_strategy_validator = EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
       return false unless bid_strategy_validator.valid?(@bid_strategy)
       return false if !@dsa_beneficiary.nil? && @dsa_beneficiary.to_s.length > 100
@@ -688,6 +710,26 @@ module Zernio
       @objective = objective
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] status Object to be assigned
+    def status=(status)
+      validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      unless validator.valid?(status)
+        fail ArgumentError, "invalid value for \"status\", must be one of #{validator.allowable_values}."
+      end
+      @status = status
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] campaign_status Object to be assigned
+    def campaign_status=(campaign_status)
+      validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      unless validator.valid?(campaign_status)
+        fail ArgumentError, "invalid value for \"campaign_status\", must be one of #{validator.allowable_values}."
+      end
+      @campaign_status = campaign_status
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] bid_strategy Object to be assigned
     def bid_strategy=(bid_strategy)
@@ -767,6 +809,8 @@ module Zernio
           placements == o.placements &&
           advantage_audience == o.advantage_audience &&
           objective == o.objective &&
+          status == o.status &&
+          campaign_status == o.campaign_status &&
           bid_strategy == o.bid_strategy &&
           bid_amount == o.bid_amount &&
           roas_average_floor == o.roas_average_floor &&
@@ -784,7 +828,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, destination].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, destination].hash
     end
 
     # Builds the object from hash

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

@@ -39,7 +39,7 @@ module Zernio
     # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
-    # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests` and `audienceId` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 
+    # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 
     attr_accessor :ad_set_id
 
     # Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it. 
@@ -89,6 +89,12 @@ module Zernio
     # Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing. 
     attr_accessor :objective
 
+    # Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the newly created ad(s) after Meta accepts them. 
+    attr_accessor :status
+
+    # Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults to `ACTIVE`. `PAUSED` holds activation at the campaign so it never spends before the advertiser reviews it, while the ad set and ad still switch on (one resume call brings the whole hierarchy live). Only meaningful when a new campaign is being created; rejected with a 400 alongside `adSetId` (the attach shape reuses an existing campaign). 
+    attr_accessor :campaign_status
+
     # Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent. 
     attr_accessor :bid_strategy
 
@@ -155,6 +161,8 @@ module Zernio
         :'placements' => :'placements',
         :'advantage_audience' => :'advantageAudience',
         :'objective' => :'objective',
+        :'status' => :'status',
+        :'campaign_status' => :'campaignStatus',
         :'bid_strategy' => :'bidStrategy',
         :'bid_amount' => :'bidAmount',
         :'roas_average_floor' => :'roasAverageFloor',
@@ -202,6 +210,8 @@ module Zernio
         :'placements' => :'CtwaAdRequestBodyPlacements',
         :'advantage_audience' => :'Integer',
         :'objective' => :'String',
+        :'status' => :'String',
+        :'campaign_status' => :'String',
         :'bid_strategy' => :'String',
         :'bid_amount' => :'Float',
         :'roas_average_floor' => :'Float',
@@ -358,6 +368,14 @@ module Zernio
         self.objective = attributes[:'objective']
       end
 
+      if attributes.key?(:'status')
+        self.status = attributes[:'status']
+      end
+
+      if attributes.key?(:'campaign_status')
+        self.campaign_status = attributes[:'campaign_status']
+      end
+
       if attributes.key?(:'bid_strategy')
         self.bid_strategy = attributes[:'bid_strategy']
       end
@@ -485,6 +503,10 @@ module Zernio
       return false unless advantage_audience_validator.valid?(@advantage_audience)
       objective_validator = EnumAttributeValidator.new('String', ["OUTCOME_ENGAGEMENT", "OUTCOME_SALES", "OUTCOME_LEADS"])
       return false unless objective_validator.valid?(@objective)
+      status_validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      return false unless status_validator.valid?(@status)
+      campaign_status_validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      return false unless campaign_status_validator.valid?(@campaign_status)
       bid_strategy_validator = EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
       return false unless bid_strategy_validator.valid?(@bid_strategy)
       return false if !@dsa_beneficiary.nil? && @dsa_beneficiary.to_s.length > 100
@@ -664,6 +686,26 @@ module Zernio
       @objective = objective
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] status Object to be assigned
+    def status=(status)
+      validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      unless validator.valid?(status)
+        fail ArgumentError, "invalid value for \"status\", must be one of #{validator.allowable_values}."
+      end
+      @status = status
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] campaign_status Object to be assigned
+    def campaign_status=(campaign_status)
+      validator = EnumAttributeValidator.new('String', ["ACTIVE", "PAUSED"])
+      unless validator.valid?(campaign_status)
+        fail ArgumentError, "invalid value for \"campaign_status\", must be one of #{validator.allowable_values}."
+      end
+      @campaign_status = campaign_status
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] bid_strategy Object to be assigned
     def bid_strategy=(bid_strategy)
@@ -733,6 +775,8 @@ module Zernio
           placements == o.placements &&
           advantage_audience == o.advantage_audience &&
           objective == o.objective &&
+          status == o.status &&
+          campaign_status == o.campaign_status &&
           bid_strategy == o.bid_strategy &&
           bid_amount == o.bid_amount &&
           roas_average_floor == o.roas_average_floor &&
@@ -749,7 +793,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor].hash
     end
 
     # Builds the object from hash

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

@@ -16,15 +16,20 @@ require 'time'
 module Zernio
   # Video creative. Mutually exclusive with this entry's `imageUrl`. Required if `imageUrl` is not supplied. 
   class CtwaAdRequestBodyCreativesInnerVideo < ApiModelBase
+    # Public URL of the video to upload. Provide either `url` or `id`.
     attr_accessor :url
 
-    # Required by Meta for every video creative. Used as the ad thumbnail. 
+    # Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`.
+    attr_accessor :id
+
+    # OPTIONAL: when omitted, the poster is auto-generated from Meta's own preferred video thumbnail. When Meta produces no candidate the request fails with a 502 platform_error (reason: video_thumbnail_unavailable). 
     attr_accessor :thumbnail_url
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'url' => :'url',
+        :'id' => :'id',
         :'thumbnail_url' => :'thumbnailUrl'
       }
     end
@@ -43,6 +48,7 @@ module Zernio
     def self.openapi_types
       {
         :'url' => :'String',
+        :'id' => :'String',
         :'thumbnail_url' => :'String'
       }
     end
@@ -71,14 +77,14 @@ module Zernio
 
       if attributes.key?(:'url')
         self.url = attributes[:'url']
-      else
-        self.url = nil
+      end
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
       end
 
       if attributes.key?(:'thumbnail_url')
         self.thumbnail_url = attributes[:'thumbnail_url']
-      else
-        self.thumbnail_url = nil
       end
     end
 
@@ -87,14 +93,6 @@ module Zernio
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @url.nil?
-        invalid_properties.push('invalid value for "url", url cannot be nil.')
-      end
-
-      if @thumbnail_url.nil?
-        invalid_properties.push('invalid value for "thumbnail_url", thumbnail_url cannot be nil.')
-      end
-
       invalid_properties
     end
 
@@ -102,37 +100,16 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @url.nil?
-      return false if @thumbnail_url.nil?
       true
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] url Value to be assigned
-    def url=(url)
-      if url.nil?
-        fail ArgumentError, 'url cannot be nil'
-      end
-
-      @url = url
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] thumbnail_url Value to be assigned
-    def thumbnail_url=(thumbnail_url)
-      if thumbnail_url.nil?
-        fail ArgumentError, 'thumbnail_url cannot be nil'
-      end
-
-      @thumbnail_url = thumbnail_url
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
           url == o.url &&
+          id == o.id &&
           thumbnail_url == o.thumbnail_url
     end
 
@@ -145,7 +122,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [url, thumbnail_url].hash
+      [url, id, thumbnail_url].hash
     end
 
     # Builds the object from hash

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

@@ -16,15 +16,20 @@ require 'time'
 module Zernio
   # Video creative for single-creative shape. Mutually exclusive with `imageUrl` and with `creatives[]`. Required on the single-creative shape if `imageUrl` is not supplied. 
   class CtwaAdRequestBodyVideo < ApiModelBase
+    # Public URL of the video to upload. Provide either `url` or `id`.
     attr_accessor :url
 
-    # Required by Meta for every video creative. Used as the ad thumbnail. 
+    # Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`.
+    attr_accessor :id
+
+    # OPTIONAL: when omitted, the poster is auto-generated from Meta's own preferred video thumbnail. When Meta produces no candidate the request fails with a 502 platform_error (reason: video_thumbnail_unavailable) — retry, or supply this field to control the poster frame exactly. 
     attr_accessor :thumbnail_url
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'url' => :'url',
+        :'id' => :'id',
         :'thumbnail_url' => :'thumbnailUrl'
       }
     end
@@ -43,6 +48,7 @@ module Zernio
     def self.openapi_types
       {
         :'url' => :'String',
+        :'id' => :'String',
         :'thumbnail_url' => :'String'
       }
     end
@@ -71,14 +77,14 @@ module Zernio
 
       if attributes.key?(:'url')
         self.url = attributes[:'url']
-      else
-        self.url = nil
+      end
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
       end
 
       if attributes.key?(:'thumbnail_url')
         self.thumbnail_url = attributes[:'thumbnail_url']
-      else
-        self.thumbnail_url = nil
       end
     end
 
@@ -87,14 +93,6 @@ module Zernio
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @url.nil?
-        invalid_properties.push('invalid value for "url", url cannot be nil.')
-      end
-
-      if @thumbnail_url.nil?
-        invalid_properties.push('invalid value for "thumbnail_url", thumbnail_url cannot be nil.')
-      end
-
       invalid_properties
     end
 
@@ -102,37 +100,16 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @url.nil?
-      return false if @thumbnail_url.nil?
       true
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] url Value to be assigned
-    def url=(url)
-      if url.nil?
-        fail ArgumentError, 'url cannot be nil'
-      end
-
-      @url = url
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] thumbnail_url Value to be assigned
-    def thumbnail_url=(thumbnail_url)
-      if thumbnail_url.nil?
-        fail ArgumentError, 'thumbnail_url cannot be nil'
-      end
-
-      @thumbnail_url = thumbnail_url
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
           url == o.url &&
+          id == o.id &&
           thumbnail_url == o.thumbnail_url
     end
 
@@ -145,7 +122,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [url, thumbnail_url].hash
+      [url, id, thumbnail_url].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.735'
+  VERSION = '0.0.737'
 end

data/openapi.yaml

@@ -825,15 +825,18 @@ components:
             single-creative shape if `video` is not supplied.
         video:
           type: object
-          required: [url, thumbnailUrl]
           properties:
-            url: { type: string, format: uri }
+            url: { type: string, format: uri, description: "Public URL of the video to upload. Provide either `url` or `id`." }
+            id: { type: string, description: "Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`." }
             thumbnailUrl:
               type: string
               format: uri
               description: |
-                Required by Meta for every video creative. Used as the
-                ad thumbnail.
+                OPTIONAL: when omitted, the poster is auto-generated from
+                Meta's own preferred video thumbnail. When Meta produces no
+                candidate the request fails with a 502 platform_error
+                (reason: video_thumbnail_unavailable) — retry, or supply
+                this field to control the poster frame exactly.
           description: |
             Video creative for single-creative shape. Mutually
             exclusive with `imageUrl` and with `creatives[]`. Required
@@ -871,15 +874,17 @@ components:
                   `video`. Required if `video` is not supplied.
               video:
                 type: object
-                required: [url, thumbnailUrl]
                 properties:
-                  url: { type: string, format: uri }
+                  url: { type: string, format: uri, description: "Public URL of the video to upload. Provide either `url` or `id`." }
+                  id: { type: string, description: "Reuse a video already uploaded to this ad account (list them with GET /v1/ads/videos) instead of re-uploading. Wins over `url`. Provide either `url` or `id`." }
                   thumbnailUrl:
                     type: string
                     format: uri
                     description: |
-                      Required by Meta for every video creative. Used
-                      as the ad thumbnail.
+                      OPTIONAL: when omitted, the poster is auto-generated
+                      from Meta's own preferred video thumbnail. When Meta
+                      produces no candidate the request fails with a 502
+                      platform_error (reason: video_thumbnail_unavailable).
                 description: |
                   Video creative. Mutually exclusive with this entry's
                   `imageUrl`. Required if `imageUrl` is not supplied.
@@ -889,9 +894,9 @@ components:
             Attach the creatives to this EXISTING messaging ad set instead of
             building a campaign, so the ad set keeps its learning phase. It then
             owns budget, targeting and schedule, so `budgetAmount`, `budgetType`,
-            `endDate`, `objective`, `countries`, `interests` and `audienceId` are
-            rejected with a 400 alongside it. Its `destination_type` must match
-            the ad's destination.
+            `endDate`, `objective`, `countries`, `interests`, `audienceId` and
+            `campaignStatus` are rejected with a 400 alongside it. Its
+            `destination_type` must match the ad's destination.
         budgetAmount:
           type: number
           exclusiveMinimum: 0
@@ -1057,6 +1062,22 @@ components:
             Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require
             additional account configuration (Dataset linked to the WABA
             for sales) and may be rejected by Meta if missing.
+        status:
+          type: string
+          enum: [ACTIVE, PAUSED]
+          description: |
+            Ad-level status. Defaults to `ACTIVE`. `PAUSED` skips activating the
+            newly created ad(s) after Meta accepts them.
+        campaignStatus:
+          type: string
+          enum: [ACTIVE, PAUSED]
+          description: |
+            Campaign-level status, same semantics as `POST /v1/ads/create`. Defaults
+            to `ACTIVE`. `PAUSED` holds activation at the campaign so it never
+            spends before the advertiser reviews it, while the ad set and ad still
+            switch on (one resume call brings the whole hierarchy live). Only
+            meaningful when a new campaign is being created; rejected with a 400
+            alongside `adSetId` (the attach shape reuses an existing campaign).
         bidStrategy:
           type: string
           enum:
@@ -20492,6 +20513,12 @@ paths:
         5. Generate a permanent access token
         6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers
         7. Get the Phone Number ID from the same page (click on the number)
+
+        Warning: connecting subscribes your own Meta app to this WABA with an override
+        callback that redirects its webhook delivery to Zernio. This WABA's events stop
+        reaching any callback URL you had configured before, immediately and with no
+        overlap window. Do not unsubscribe your app from the WABA afterward: that also
+        cuts off Zernio's delivery, and recovery requires calling this endpoint again.
       security:
         - bearerAuth: []
       requestBody:
@@ -20536,6 +20563,9 @@ paths:
                   registrationWarning:
                     type: string
                     description: 'Present when the account was created but Meta rejected the Cloud API registration. The number cannot send messages until this is resolved.'
+                  webhookNotice:
+                    type: string
+                    description: 'Present when the WABA webhook subscription (with the Zernio override callback) succeeded. Explains the delivery cutover and warns against unsubscribing the app from the WABA afterward.'
                   account:
                     type: object
                     properties:
@@ -20544,7 +20574,9 @@ paths:
                       username: { type: string, description: Display phone number }
                       displayName: { type: string, description: Meta-verified business name }
                       isActive: { type: boolean }
-                      selectedPhoneNumber: { type: string, description: The connected phone number }
+                      phoneNumber: { type: string, description: The connected phone number }
+                      verifiedName: { type: string, description: Meta-verified business name for the phone number }
+                      qualityRating: { type: string, description: 'Meta quality rating for the phone number (e.g. GREEN, YELLOW, RED, UNKNOWN)' }
               example:
                 message: "WhatsApp connected successfully"
                 account:
@@ -20553,7 +20585,9 @@ paths:
                   username: "+1 555-123-4567"
                   displayName: "Acme Corp"
                   isActive: true
-                  selectedPhoneNumber: "+1 555-123-4567"
+                  phoneNumber: "+1 555-123-4567"
+                  verifiedName: "Acme Corp"
+                  qualityRating: "GREEN"
         '400':
           description: |
             Invalid request. Missing fields, a `pin` that is not 6 digits, or the

data/spec/api/connect_api_spec.rb

@@ -139,7 +139,7 @@ describe 'ConnectApi' do
 
   # unit tests for connect_whats_app_credentials
   # Connect WhatsApp via credentials
-  # Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number) 
+  # Connect a WhatsApp Business Account by providing Meta credentials directly. This is the headless alternative to the Embedded Signup browser flow.  To get the required credentials: 1. Go to Meta Business Suite (business.facebook.com) 2. Create or select a WhatsApp Business Account 3. In Business Settings > System Users, create a System User 4. Assign it the whatsapp_business_management and whatsapp_business_messaging permissions 5. Generate a permanent access token 6. Get the WABA ID from WhatsApp Manager > Account Tools > Phone Numbers 7. Get the Phone Number ID from the same page (click on the number)  Warning: connecting subscribes your own Meta app to this WABA with an override callback that redirects its webhook delivery to Zernio. This WABA's events stop reaching any callback URL you had configured before, immediately and with no overlap window. Do not unsubscribe your app from the WABA afterward: that also cuts off Zernio's delivery, and recovery requires calling this endpoint again. 
   # @param connect_whats_app_credentials_request 
   # @param [Hash] opts the optional parameters
   # @return [ConnectWhatsAppCredentials200Response]

data/spec/models/connect_whats_app_credentials200_response_account_spec.rb

@@ -61,7 +61,19 @@ describe Zernio::ConnectWhatsAppCredentials200ResponseAccount do
     end
   end
 
-  describe 'test attribute "selected_phone_number"' do
+  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 "verified_name"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "quality_rating"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/models/connect_whats_app_credentials200_response_spec.rb

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

data/spec/models/create_call_ad_request_spec.rb

@@ -195,6 +195,26 @@ describe Zernio::CreateCallAdRequest do
     end
   end
 
+  describe 'test attribute "status"' 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', ["ACTIVE", "PAUSED"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.status = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "campaign_status"' 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', ["ACTIVE", "PAUSED"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.campaign_status = value }.not_to raise_error
+      # end
+    end
+  end
+
   describe 'test attribute "bid_strategy"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/create_messaging_ad_request_spec.rb

@@ -195,6 +195,26 @@ describe Zernio::CreateMessagingAdRequest do
     end
   end
 
+  describe 'test attribute "status"' 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', ["ACTIVE", "PAUSED"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.status = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "campaign_status"' 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', ["ACTIVE", "PAUSED"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.campaign_status = value }.not_to raise_error
+      # end
+    end
+  end
+
   describe 'test attribute "bid_strategy"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/ctwa_ad_request_body_creatives_inner_video_spec.rb

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

data/spec/models/ctwa_ad_request_body_spec.rb

@@ -195,6 +195,26 @@ describe Zernio::CtwaAdRequestBody do
     end
   end
 
+  describe 'test attribute "status"' 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', ["ACTIVE", "PAUSED"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.status = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "campaign_status"' 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', ["ACTIVE", "PAUSED"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.campaign_status = value }.not_to raise_error
+      # end
+    end
+  end
+
   describe 'test attribute "bid_strategy"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/ctwa_ad_request_body_video_spec.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.735
+  version: 0.0.737
 platform: ruby
 authors:
 - OpenAPI-Generator