late-sdk 0.0.890 → 0.0.892

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5276c61a7a83ea4f82d665041d6dd5e6d2bafdbadaa9db3ec83713b6bc68362
-  data.tar.gz: 6ce9ffb1852bf974f33503512edebe0dd3ec0c1f0cb656a4f8710e584c23d560
+  metadata.gz: f083d160652c89b9de7a411e6bf22dcd253a488b42e7b5460d6264c1b442c2ac
+  data.tar.gz: 0b168b58de20cbf909677feca0f634376f41bf2b7cd2d9d82fee9d0265bd638f
 SHA512:
-  metadata.gz: e94acf7ce1317ccc976cab938c2170a876652d47bb1af2934463d8e8a8e36efc3c080fab89c7eb4e3bee02e23ad00a2fc6dcb1dc4065c3b87049112991507c07
-  data.tar.gz: 5c90400f53199e0d595f6dc016436524bbb98f3464d1f51f20d2b7a76bdce3699453cdf6180d76bc53a13bbb27c820da22590c95d6ed40cbb128836c7051fb3c
+  metadata.gz: 231c93d8824c7abfcbc832f877dffd9a7a211c692a30afcdfd7f669791d25b93c5157ba2b6e3ae33c63cac7652ce28796499eefc2d93860f4925544eaa7cb817
+  data.tar.gz: 2924855878176b9a501c6b441878458ac40b0026098251de2c94c492ca98a6dc08b635ff19fe14069fcc72a638c53f682ec000bd3da9cb6fcea58df30439d276

data/README.md

@@ -979,7 +979,6 @@ Class | Method | HTTP request | Description
  - [Zernio::Connected](docs/Connected.md)
  - [Zernio::ConnectedAccount](docs/ConnectedAccount.md)
  - [Zernio::ConnectedApp](docs/ConnectedApp.md)
- - [Zernio::Conversation](docs/Conversation.md)
  - [Zernio::ConversionAction](docs/ConversionAction.md)
  - [Zernio::ConversionActionTagSnippetsInner](docs/ConversionActionTagSnippetsInner.md)
  - [Zernio::ConversionDestination](docs/ConversionDestination.md)
@@ -1655,6 +1654,7 @@ Class | Method | HTTP request | Description
  - [Zernio::InboxMessageEditHistoryEntry](docs/InboxMessageEditHistoryEntry.md)
  - [Zernio::InboxWebhookAccount](docs/InboxWebhookAccount.md)
  - [Zernio::InboxWebhookConversation](docs/InboxWebhookConversation.md)
+ - [Zernio::InboxWebhookConversationDetail](docs/InboxWebhookConversationDetail.md)
  - [Zernio::InboxWebhookMessage](docs/InboxWebhookMessage.md)
  - [Zernio::InboxWebhookMessageAttachmentsInner](docs/InboxWebhookMessageAttachmentsInner.md)
  - [Zernio::InboxWebhookMessageSender](docs/InboxWebhookMessageSender.md)
@@ -2569,7 +2569,6 @@ Class | Method | HTTP request | Description
  - [Zernio::WebhookPayloadConversationControlChanged](docs/WebhookPayloadConversationControlChanged.md)
  - [Zernio::WebhookPayloadConversationControlChangedControl](docs/WebhookPayloadConversationControlChangedControl.md)
  - [Zernio::WebhookPayloadConversationStarted](docs/WebhookPayloadConversationStarted.md)
- - [Zernio::WebhookPayloadConversationStartedConversation](docs/WebhookPayloadConversationStartedConversation.md)
  - [Zernio::WebhookPayloadExternalPost](docs/WebhookPayloadExternalPost.md)
  - [Zernio::WebhookPayloadLead](docs/WebhookPayloadLead.md)
  - [Zernio::WebhookPayloadLeadAccount](docs/WebhookPayloadLeadAccount.md)

data/docs/AdCampaignsApi.md

@@ -404,7 +404,7 @@ end
 
 Create a standalone ad group
 
-Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `existingAdGroupId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `adSetId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
 
 ### Examples
 
@@ -546,7 +546,7 @@ end
 
 Create standalone ad
 
-Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
+Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, Google Ads, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
 
 ### Examples
 
@@ -1717,7 +1717,7 @@ end
 
 List ad sets
 
-Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `existingAdGroupId`. Returns at most 500 rows, newest first.
+Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `adSetId` on POST /v1/ads/create. Returns at most 500 rows, newest first.
 
 ### Examples
 

data/docs/CreateStandaloneAdRequest.md

@@ -34,13 +34,13 @@
 | **descriptions** | **Array<String>** | Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`. | [optional] |
 | **call_to_action** | **String** | Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X. | [optional] |
 | **link_url** | **String** | Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description. Required for OpenAI Ads (the chat card's target_url). | [optional] |
-| **lead_gen_form_id** | **String** | Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads. | [optional] |
+| **lead_gen_form_id** | **String** | Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). `placementAssets`, `dynamicCreative` and `carouselCards` (Meta multi-card Instant-Form lead ad; `linkUrl` and per-card `linkUrl` are optional and forwarded as real destinations when sent, falling back to Meta's lead-form link when omitted) ARE supported on Meta instant-form lead ads. | [optional] |
 | **image_url** | **String** | Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627). Required for OpenAI Ads (uploaded as the chat card's image; OpenAI has no video ad format). | [optional] |
 | **images** | [**CreateStandaloneAdRequestImages**](CreateStandaloneAdRequestImages.md) |  | [optional] |
 | **video** | [**CreateStandaloneAdRequestVideo**](CreateStandaloneAdRequestVideo.md) |  | [optional] |
 | **creatives** | [**Array<CreateStandaloneAdRequestCreativesInner>**](CreateStandaloneAdRequestCreativesInner.md) | Meta-only. When present, switches to the multi-creative shape: creates 1 campaign + 1 ad set + N ads (one per entry here). Top-level `headline` / `body` / `imageUrl` / `linkUrl` / `callToAction` are ignored in this mode. Mutually exclusive with `adSetId`.  | [optional] |
-| **ad_set_id** | **String** | When present, switches to the attach shape: adds one new ad to this existing ad set without creating a new campaign. Budget, targeting, goal, schedule, AND bid strategy are inherited from the ad set on Meta, and passing `bidStrategy` in attach mode returns 400. To change an existing ad set's bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive with `creatives[]`.  The attached ad takes the full single-creative surface: `headline`/`body`/`description`/`callToAction` plus either `imageUrl`/`video` OR `placementAssets` (its own per-placement Feed/Story assets) OR `translations`/`defaultLocale` (its own per-locale asset feed, Meta only), and `leadGenFormId` when the target is a lead ad set (the parent must be ON_AD, true for ad sets created via goal `lead_generation`; Meta rejects a formless ad there, so pass the form on EVERY attached ad). This is the way to build N full ads sharing one ad set: create the first ad via the normal shape, then attach the rest one call each.  Supported on Meta (facebook, instagram), TikTok, and LinkedIn. On TikTok the `adSetId` is the ad group ID; the new ad inherits the ad group's bid + budget + targeting. On LinkedIn the `adSetId` is the LinkedIn Campaign ID (numeric); we attach a new Creative to that Campaign, so the Campaign's `platformSpecificData` bidding, targeting, budget and schedule are inherited (passing those fields returns 400).  | [optional] |
-| **existing_campaign_id** | **String** | Meta + LinkedIn. On Meta: add the new ad set under this EXISTING campaign instead of creating a new one (multi-ad-set audience testing). The new ad set's budget is matched to the campaign's mode automatically: for a CBO campaign (campaign-level budget) omit `budgetAmount`/`budgetType`, since the campaign owns the budget; for an ABO campaign pass them (they go on the new ad set). On LinkedIn: create a new Campaign (and its Creative) under this EXISTING CampaignGroup. On failure only the entities we authored are cleaned up; the pre-existing parent is left untouched and is never (re)activated. Mutually exclusive with `adSetId` and `creatives[]`.  | [optional] |
+| **ad_set_id** | **String** | When present, switches to the attach shape: adds one new ad to this existing ad set without creating a new campaign. Budget, targeting, goal, schedule, AND bid strategy are inherited from the ad set on Meta, and passing `bidStrategy` in attach mode returns 400. To change an existing ad set's bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive with `creatives[]`.  The attached ad takes the full single-creative surface: `headline`/`body`/`description`/`callToAction` plus either `imageUrl`/`video` OR `placementAssets` (its own per-placement Feed/Story assets) OR `translations`/`defaultLocale` (its own per-locale asset feed, Meta only), and `leadGenFormId` when the target is a lead ad set (the parent must be ON_AD, true for ad sets created via goal `lead_generation`; Meta rejects a formless ad there, so pass the form on EVERY attached ad). This is the way to build N full ads sharing one ad set: create the first ad via the normal shape, then attach the rest one call each.  Supported on Meta (facebook, instagram), Google Ads, TikTok, and LinkedIn. On TikTok the `adSetId` is the ad group ID; the new ad inherits the ad group's bid + budget + targeting. On LinkedIn the `adSetId` is the LinkedIn Campaign ID (numeric); we attach a new Creative to that Campaign, so the Campaign's `platformSpecificData` bidding, targeting, budget and schedule are inherited (passing those fields returns 400).  On Google Ads the `adSetId` is the AD GROUP id. `goal` is still REQUIRED even though budget and targeting are inherited from the ad group. Send `campaignType: \"search\"` to attach into a Search ad group, including one created by `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it the request is treated as Display and requires `images.landscape` + `images.square` + `businessName`, and the resulting display creative does not match a Search ad group. `budgetAmount`/`budgetType` and bidding fields (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`) return 400 on this shape; the ad group already owns them.  | [optional] |
+| **existing_campaign_id** | **String** | Meta, Google Ads, and LinkedIn. On Meta: add the new ad set under this EXISTING campaign instead of creating a new one (multi-ad-set audience testing). The new ad set's budget is matched to the campaign's mode automatically: for a CBO campaign (campaign-level budget) omit `budgetAmount`/`budgetType`, since the campaign owns the budget; for an ABO campaign pass them (they go on the new ad set). On LinkedIn: create a new Campaign (and its Creative) under this EXISTING CampaignGroup. On Google Ads: create a new ad group under this EXISTING campaign; the new ad group inherits the campaign's budget, so omit `budgetAmount`/`budgetType` (and any bidding field), or the request returns 400. On failure only the entities we authored are cleaned up; the pre-existing parent is left untouched and is never (re)activated. Mutually exclusive with `adSetId` and `creatives[]`.  | [optional] |
 | **existing_creative_id** | **String** | Meta only. Reuse an EXISTING ad creative by id instead of building a new one from the copy/media fields (which are then ignored). Combine with `existingCampaignId` to build a multi-ad-set campaign that shares one creative. Mutually exclusive with `creatives[]`, `dynamicCreative`, and `placementAssets`. The creative id used is returned as `creativeId` on the create response.  | [optional] |
 | **business_name** | **String** | Google Display only | [optional] |
 | **board_id** | **String** | Pinterest only. Board ID (auto-creates if not provided). | [optional] |
@@ -72,7 +72,7 @@
 | **start_date** | **Time** | Meta only. Ad-set start time (ISO 8601, e.g. \"2026-06-10T09:00:00Z\"), mapped to the ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already available on `POST /v1/ads/boost`.)  | [optional] |
 | **instagram_account_id** | **String** | Meta only. Override the Instagram account the ad is delivered as. Pass an Instagram Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`. When omitted we use the Instagram actor Meta already runs the Page's other ads as, falling back to the Page's page-backed Instagram account. Useful when a Page has more than one eligible IG account.  | [optional] |
 | **dynamic_creative** | [**CreateStandaloneAdRequestDynamicCreative**](CreateStandaloneAdRequestDynamicCreative.md) |  | [optional] |
-| **carousel_cards** | [**Array<CreateStandaloneAdRequestCarouselCardsInner>**](CreateStandaloneAdRequestCarouselCardsInner.md) | Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body`, `linkUrl` and `callToAction`. Those become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`), and double as the per-card fallback when a card omits its own. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal `catalog_sales`.  | [optional] |
+| **carousel_cards** | [**Array<CreateStandaloneAdRequestCarouselCardsInner>**](CreateStandaloneAdRequestCarouselCardsInner.md) | Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body` and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`), and double as the per-card fallback when a card omits its own. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId` and goal `catalog_sales`. Combines with `leadGenFormId` to build a carousel Instant-Form lead ad: `linkUrl` and per-card `linkUrl` become OPTIONAL and, when sent, are forwarded as the real card and top-level destinations; when omitted, the destination falls back to Meta's lead-form link.  | [optional] |
 | **default_locale** | **String** | Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`. | [optional] |
 | **translations** | [**Array<CreateStandaloneAdRequestTranslationsInner>**](CreateStandaloneAdRequestTranslationsInner.md) | Meta only. Multi-language ads (Dynamic Language Optimization): ONE ad carrying per-locale copy and, optionally, per-locale media: the \"Languages\" toggle in Ads Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of splitting it across one ad per language.  The ad's top-level copy is the DEFAULT shown to every locale you do NOT list, and it counts as one of the language variants.  IMPORTANT, and the opposite of what you might expect: text does NOT inherit. Every entry must carry its own `headline`, `body` AND `description`, and all of them must be DISTINCT from each other and from the ad's top-level copy. Meta deduplicates identical strings inside the asset feed, so two locales sharing a string collapse into one asset and the create fails with a misleading \"Too few ... texts provided in asset creation\" (subcode 1885817) that names a field which is actually present. We validate this before calling Meta and return a 400 naming the offending locale and field. `description` is therefore effectively required on the ad whenever `translations` is present, even though it is optional otherwise.  Do NOT list `defaultLocale` inside `translations`: Meta rejects the duplicate with \"The language asset feed includes an unsupported targeting field\" (subcode 1885985).  Media DOES inherit and is uploaded once when shared, and `linkUrl` inherits too: each locale may name its own landing page and unlisted locales fall back to the ad's top-level `linkUrl`. Meta enforces Dynamic Creative image dimensions on language feeds, so an `imageUrl` that works on a normal ad may be rejected with \"The following images have invalid dimensions for Dynamic Creative\" (subcode 1885558). Video is not affected.  Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards`, `existingCreativeId` and `creatives[]`. Meta allows one `asset_feed_spec` shape per creative.  | [optional] |
 | **placement_assets** | [**CreateStandaloneAdRequestPlacementAssets**](CreateStandaloneAdRequestPlacementAssets.md) |  | [optional] |

data/docs/CreateStandaloneAdRequestCarouselCardsInner.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **image_url** | **String** | Card image; uploaded to the ad account and referenced by hash. |  |
-| **link_url** | **String** | Card destination URL. Defaults to the top-level linkUrl. | [optional] |
+| **link_url** | **String** | Card destination URL. Defaults to the top-level linkUrl, or Meta's lead-form link when leadGenFormId is set and neither is provided. | [optional] |
 | **headline** | **String** | Card headline, shown below the card image. | [optional] |
 | **description** | **String** | Card description, shown under the headline. | [optional] |
 | **call_to_action** | **String** | Card CTA override. Defaults to the top-level callToAction; same enum. | [optional] |

data/docs/{Conversation.md → InboxWebhookConversationDetail.md}

@@ -1,4 +1,4 @@
-# Zernio::Conversation
+# Zernio::InboxWebhookConversationDetail
 
 ## Properties
 
@@ -19,7 +19,7 @@
 ```ruby
 require 'zernio-sdk'
 
-instance = Zernio::Conversation.new(
+instance = Zernio::InboxWebhookConversationDetail.new(
   id: null,
   platform: null,
   platform_conversation_id: null,

data/docs/WebhookPayloadConversationControlChanged.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** | Stable webhook event ID |  |
 | **event** | **String** |  |  |
-| **conversation** | [**WebhookPayloadConversationStartedConversation**](WebhookPayloadConversationStartedConversation.md) |  |  |
+| **conversation** | [**InboxWebhookConversationDetail**](InboxWebhookConversationDetail.md) |  |  |
 | **account** | [**InboxWebhookAccount**](InboxWebhookAccount.md) |  |  |
 | **control** | [**WebhookPayloadConversationControlChangedControl**](WebhookPayloadConversationControlChangedControl.md) |  |  |
 | **changed_at** | **Time** |  |  |

data/docs/WebhookPayloadConversationStarted.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** | Stable webhook event ID |  |
 | **event** | **String** |  |  |
-| **conversation** | [**WebhookPayloadConversationStartedConversation**](WebhookPayloadConversationStartedConversation.md) |  |  |
+| **conversation** | [**InboxWebhookConversationDetail**](InboxWebhookConversationDetail.md) |  |  |
 | **account** | [**InboxWebhookAccount**](InboxWebhookAccount.md) |  |  |
 | **started_at** | **Time** | When the conversation document was created. |  |
 | **timestamp** | **Time** | UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt. |  |

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

@@ -380,7 +380,7 @@ module Zernio
     end
 
     # Create a standalone ad group
-    # Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `existingAdGroupId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+    # Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `adSetId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
     # @param create_ad_set_request [CreateAdSetRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
@@ -391,7 +391,7 @@ module Zernio
     end
 
     # Create a standalone ad group
-    # Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `existingAdGroupId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+    # Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `adSetId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
     # @param create_ad_set_request [CreateAdSetRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
@@ -523,7 +523,7 @@ module Zernio
     end
 
     # Create standalone ad
-    # Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
+    # Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, Google Ads, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
     # @param create_standalone_ad_request [CreateStandaloneAdRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
@@ -534,7 +534,7 @@ module Zernio
     end
 
     # Create standalone ad
-    # Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
+    # Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, Google Ads, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
     # @param create_standalone_ad_request [CreateStandaloneAdRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
@@ -1789,7 +1789,7 @@ module Zernio
     end
 
     # List ad sets
-    # Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `existingAdGroupId`. Returns at most 500 rows, newest first.
+    # Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `adSetId` on POST /v1/ads/create. Returns at most 500 rows, newest first.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :account_id Account ID
     # @option opts [String] :campaign_id Platform campaign ID
@@ -1801,7 +1801,7 @@ module Zernio
     end
 
     # List ad sets
-    # Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `existingAdGroupId`. Returns at most 500 rows, newest first.
+    # Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `adSetId` on POST /v1/ads/create. Returns at most 500 rows, newest first.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :account_id Account ID
     # @option opts [String] :campaign_id Platform campaign ID

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

@@ -101,7 +101,7 @@ module Zernio
     # Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description. Required for OpenAI Ads (the chat card's target_url).
     attr_accessor :link_url
 
-    # Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads.
+    # Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). `placementAssets`, `dynamicCreative` and `carouselCards` (Meta multi-card Instant-Form lead ad; `linkUrl` and per-card `linkUrl` are optional and forwarded as real destinations when sent, falling back to Meta's lead-form link when omitted) ARE supported on Meta instant-form lead ads.
     attr_accessor :lead_gen_form_id
 
     # Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627). Required for OpenAI Ads (uploaded as the chat card's image; OpenAI has no video ad format).
@@ -114,10 +114,10 @@ module Zernio
     # Meta-only. When present, switches to the multi-creative shape: creates 1 campaign + 1 ad set + N ads (one per entry here). Top-level `headline` / `body` / `imageUrl` / `linkUrl` / `callToAction` are ignored in this mode. Mutually exclusive with `adSetId`. 
     attr_accessor :creatives
 
-    # When present, switches to the attach shape: adds one new ad to this existing ad set without creating a new campaign. Budget, targeting, goal, schedule, AND bid strategy are inherited from the ad set on Meta, and passing `bidStrategy` in attach mode returns 400. To change an existing ad set's bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive with `creatives[]`.  The attached ad takes the full single-creative surface: `headline`/`body`/`description`/`callToAction` plus either `imageUrl`/`video` OR `placementAssets` (its own per-placement Feed/Story assets) OR `translations`/`defaultLocale` (its own per-locale asset feed, Meta only), and `leadGenFormId` when the target is a lead ad set (the parent must be ON_AD, true for ad sets created via goal `lead_generation`; Meta rejects a formless ad there, so pass the form on EVERY attached ad). This is the way to build N full ads sharing one ad set: create the first ad via the normal shape, then attach the rest one call each.  Supported on Meta (facebook, instagram), TikTok, and LinkedIn. On TikTok the `adSetId` is the ad group ID; the new ad inherits the ad group's bid + budget + targeting. On LinkedIn the `adSetId` is the LinkedIn Campaign ID (numeric); we attach a new Creative to that Campaign, so the Campaign's `platformSpecificData` bidding, targeting, budget and schedule are inherited (passing those fields returns 400). 
+    # When present, switches to the attach shape: adds one new ad to this existing ad set without creating a new campaign. Budget, targeting, goal, schedule, AND bid strategy are inherited from the ad set on Meta, and passing `bidStrategy` in attach mode returns 400. To change an existing ad set's bid, use `PUT /v1/ads/ad-sets/{adSetId}`. Mutually exclusive with `creatives[]`.  The attached ad takes the full single-creative surface: `headline`/`body`/`description`/`callToAction` plus either `imageUrl`/`video` OR `placementAssets` (its own per-placement Feed/Story assets) OR `translations`/`defaultLocale` (its own per-locale asset feed, Meta only), and `leadGenFormId` when the target is a lead ad set (the parent must be ON_AD, true for ad sets created via goal `lead_generation`; Meta rejects a formless ad there, so pass the form on EVERY attached ad). This is the way to build N full ads sharing one ad set: create the first ad via the normal shape, then attach the rest one call each.  Supported on Meta (facebook, instagram), Google Ads, TikTok, and LinkedIn. On TikTok the `adSetId` is the ad group ID; the new ad inherits the ad group's bid + budget + targeting. On LinkedIn the `adSetId` is the LinkedIn Campaign ID (numeric); we attach a new Creative to that Campaign, so the Campaign's `platformSpecificData` bidding, targeting, budget and schedule are inherited (passing those fields returns 400).  On Google Ads the `adSetId` is the AD GROUP id. `goal` is still REQUIRED even though budget and targeting are inherited from the ad group. Send `campaignType: \"search\"` to attach into a Search ad group, including one created by `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it the request is treated as Display and requires `images.landscape` + `images.square` + `businessName`, and the resulting display creative does not match a Search ad group. `budgetAmount`/`budgetType` and bidding fields (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`) return 400 on this shape; the ad group already owns them. 
     attr_accessor :ad_set_id
 
-    # Meta + LinkedIn. On Meta: add the new ad set under this EXISTING campaign instead of creating a new one (multi-ad-set audience testing). The new ad set's budget is matched to the campaign's mode automatically: for a CBO campaign (campaign-level budget) omit `budgetAmount`/`budgetType`, since the campaign owns the budget; for an ABO campaign pass them (they go on the new ad set). On LinkedIn: create a new Campaign (and its Creative) under this EXISTING CampaignGroup. On failure only the entities we authored are cleaned up; the pre-existing parent is left untouched and is never (re)activated. Mutually exclusive with `adSetId` and `creatives[]`. 
+    # Meta, Google Ads, and LinkedIn. On Meta: add the new ad set under this EXISTING campaign instead of creating a new one (multi-ad-set audience testing). The new ad set's budget is matched to the campaign's mode automatically: for a CBO campaign (campaign-level budget) omit `budgetAmount`/`budgetType`, since the campaign owns the budget; for an ABO campaign pass them (they go on the new ad set). On LinkedIn: create a new Campaign (and its Creative) under this EXISTING CampaignGroup. On Google Ads: create a new ad group under this EXISTING campaign; the new ad group inherits the campaign's budget, so omit `budgetAmount`/`budgetType` (and any bidding field), or the request returns 400. On failure only the entities we authored are cleaned up; the pre-existing parent is left untouched and is never (re)activated. Mutually exclusive with `adSetId` and `creatives[]`. 
     attr_accessor :existing_campaign_id
 
     # Meta only. Reuse an EXISTING ad creative by id instead of building a new one from the copy/media fields (which are then ignored). Combine with `existingCampaignId` to build a multi-ad-set campaign that shares one creative. Mutually exclusive with `creatives[]`, `dynamicCreative`, and `placementAssets`. The creative id used is returned as `creativeId` on the create response. 
@@ -209,7 +209,7 @@ module Zernio
 
     attr_accessor :dynamic_creative
 
-    # Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body`, `linkUrl` and `callToAction`. Those become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`), and double as the per-card fallback when a card omits its own. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal `catalog_sales`. 
+    # Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body` and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`), and double as the per-card fallback when a card omits its own. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId` and goal `catalog_sales`. Combines with `leadGenFormId` to build a carousel Instant-Form lead ad: `linkUrl` and per-card `linkUrl` become OPTIONAL and, when sent, are forwarded as the real card and top-level destinations; when omitted, the destination falls back to Meta's lead-form link. 
     attr_accessor :carousel_cards
 
     # Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.

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

@@ -18,7 +18,7 @@ module Zernio
     # Card image; uploaded to the ad account and referenced by hash.
     attr_accessor :image_url
 
-    # Card destination URL. Defaults to the top-level linkUrl.
+    # Card destination URL. Defaults to the top-level linkUrl, or Meta's lead-form link when leadGenFormId is set and neither is provided.
     attr_accessor :link_url
 
     # Card headline, shown below the card image.

data/lib/zernio-sdk/models/{conversation.rb → inbox_webhook_conversation_detail.rb}

@@ -14,7 +14,8 @@ require 'date'
 require 'time'
 
 module Zernio
-  class Conversation < ApiModelBase
+  # The conversation object included in conversation lifecycle webhook payloads (conversation.started, conversation.control_changed).
+  class InboxWebhookConversationDetail < ApiModelBase
     # Internal conversation ID
     attr_accessor :id
 
@@ -109,14 +110,14 @@ module Zernio
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::Conversation` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::InboxWebhookConversationDetail` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::Conversation`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::InboxWebhookConversationDetail`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }

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

@@ -82,7 +82,7 @@ module Zernio
       {
         :'id' => :'String',
         :'event' => :'String',
-        :'conversation' => :'WebhookPayloadConversationStartedConversation',
+        :'conversation' => :'InboxWebhookConversationDetail',
         :'account' => :'InboxWebhookAccount',
         :'control' => :'WebhookPayloadConversationControlChangedControl',
         :'changed_at' => :'Time',

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

@@ -80,7 +80,7 @@ module Zernio
       {
         :'id' => :'String',
         :'event' => :'String',
-        :'conversation' => :'WebhookPayloadConversationStartedConversation',
+        :'conversation' => :'InboxWebhookConversationDetail',
         :'account' => :'InboxWebhookAccount',
         :'started_at' => :'Time',
         :'timestamp' => :'Time'

data/lib/zernio-sdk/version.rb

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

data/lib/zernio-sdk.rb

@@ -238,7 +238,6 @@ require 'zernio-sdk/models/connect_whats_app_embedded_signup_request'
 require 'zernio-sdk/models/connected'
 require 'zernio-sdk/models/connected_account'
 require 'zernio-sdk/models/connected_app'
-require 'zernio-sdk/models/conversation'
 require 'zernio-sdk/models/conversion_action'
 require 'zernio-sdk/models/conversion_action_tag_snippets_inner'
 require 'zernio-sdk/models/conversion_destination'
@@ -914,6 +913,7 @@ require 'zernio-sdk/models/inbox_message_edit_attachment'
 require 'zernio-sdk/models/inbox_message_edit_history_entry'
 require 'zernio-sdk/models/inbox_webhook_account'
 require 'zernio-sdk/models/inbox_webhook_conversation'
+require 'zernio-sdk/models/inbox_webhook_conversation_detail'
 require 'zernio-sdk/models/inbox_webhook_message'
 require 'zernio-sdk/models/inbox_webhook_message_attachments_inner'
 require 'zernio-sdk/models/inbox_webhook_message_sender'
@@ -1828,7 +1828,6 @@ require 'zernio-sdk/models/webhook_payload_comment_post'
 require 'zernio-sdk/models/webhook_payload_conversation_control_changed'
 require 'zernio-sdk/models/webhook_payload_conversation_control_changed_control'
 require 'zernio-sdk/models/webhook_payload_conversation_started'
-require 'zernio-sdk/models/webhook_payload_conversation_started_conversation'
 require 'zernio-sdk/models/webhook_payload_external_post'
 require 'zernio-sdk/models/webhook_payload_lead'
 require 'zernio-sdk/models/webhook_payload_lead_account'

data/openapi.yaml

@@ -3599,6 +3599,32 @@ components:
             integrators join any inbox webhook back to the CRM Contact without
             needing to look at the sender, which matters for outgoing and
             delivery-status events whose sender is the business.
+    InboxWebhookConversationDetail:
+      type: object
+      description: The conversation object included in conversation lifecycle webhook payloads (conversation.started, conversation.control_changed).
+      required: [id, platform, platformConversationId, participantName, status]
+      properties:
+        id: { type: string, description: Internal conversation ID }
+        platform:
+          type: string
+          enum: [instagram, facebook, telegram, whatsapp, twitter, reddit, bluesky, sms, slack]
+        platformConversationId: { type: string }
+        participantId: { type: string, description: "Contact's platform identifier (IGSID, PSID, wa_id, etc.)" }
+        participantName: { type: string }
+        participantUsername: { type: string, description: Contact's handle when the platform exposes one }
+        participantPicture: { type: string }
+        status:
+          type: string
+          enum: [active, archived]
+        contactId:
+          type: string
+          description: |
+            Zernio CRM Contact ID for the participant, when one exists. Resolved by
+            joining `participantId` to the ContactChannel collection (same join
+            used by message.*, reaction.received, and call.* webhooks). Best-effort:
+            omitted when no channel matches or `participantId` is absent. Lets
+            integrators seed the CRM straight from `conversation.started` without
+            waiting for the first `message.*` event.
     InboxWebhookAccount:
       type: object
       description: The account context included in inbox webhook payloads.
@@ -4518,30 +4544,7 @@ components:
           type: string
           enum: [conversation.started]
         conversation:
-          type: object
-          required: [id, platform, platformConversationId, participantName, status]
-          properties:
-            id: { type: string, description: Internal conversation ID }
-            platform:
-              type: string
-              enum: [instagram, facebook, telegram, whatsapp, twitter, reddit, bluesky, sms, slack]
-            platformConversationId: { type: string }
-            participantId: { type: string, description: "Contact's platform identifier (IGSID, PSID, wa_id, etc.)" }
-            participantName: { type: string }
-            participantUsername: { type: string, description: Contact's handle when the platform exposes one }
-            participantPicture: { type: string }
-            status:
-              type: string
-              enum: [active, archived]
-            contactId:
-              type: string
-              description: |
-                Zernio CRM Contact ID for the participant, when one exists. Resolved by
-                joining `participantId` to the ContactChannel collection (same join
-                used by message.*, reaction.received, and call.* webhooks). Best-effort:
-                omitted when no channel matches or `participantId` is absent. Lets
-                integrators seed the CRM straight from `conversation.started` without
-                waiting for the first `message.*` event.
+          $ref: '#/components/schemas/InboxWebhookConversationDetail'
         account:
           $ref: '#/components/schemas/InboxWebhookAccount'
         startedAt:
@@ -4564,7 +4567,7 @@ components:
           type: string
           enum: [conversation.control_changed]
         conversation:
-          $ref: '#/components/schemas/WebhookPayloadConversationStarted/properties/conversation'
+          $ref: '#/components/schemas/InboxWebhookConversationDetail'
         account:
           $ref: '#/components/schemas/InboxWebhookAccount'
         control:
@@ -43499,7 +43502,7 @@ paths:
         directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a
         newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets,
         Google only) is visible here even though it is invisible in the tree
-        until an ad joins it via `existingAdGroupId`. Returns at most 500
+        until an ad joins it via `adSetId` on POST /v1/ads/create. Returns at most 500
         rows, newest first.
       security:
         - bearerAuth: []
@@ -43546,7 +43549,7 @@ paths:
       summary: Create a standalone ad group
       description: |-
         Google Ads compliance row C.190: creates an ad group WITHOUT an ad,
-        under an existing campaign. Ads join it later via `existingAdGroupId`
+        under an existing campaign. Ads join it later via `adSetId`
         on POST /v1/ads/create. Google only; every other platform returns 501.
 
         Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad
@@ -46881,7 +46884,7 @@ paths:
 
         - Legacy single-creative shape (all platforms, the default).
         - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting.
-        - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.
+        - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, Google Ads, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.
 
         Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.
 
@@ -47020,7 +47023,7 @@ paths:
                   description: 'Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`.'
                 callToAction: { type: string, enum: [LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE, ADD_TO_CART, APPLY_NOW, BOOK_NOW, BUY_TICKETS, DONATE, DONATE_NOW, GET_DIRECTIONS, GET_SHOWTIMES, LISTEN_NOW, ORDER_NOW, PLAY_GAME, REQUEST_TIME, SEE_MENU, START_ORDER, INSTALL_MOBILE_APP, USE_APP, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, BUY_NOW], description: "Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X." }
                 linkUrl: { type: string, format: uri, description: "Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description. Required for OpenAI Ads (the chat card's target_url)." }
-                leadGenFormId: { type: string, description: "Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads." }
+                leadGenFormId: { type: string, description: "Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). `placementAssets`, `dynamicCreative` and `carouselCards` (Meta multi-card Instant-Form lead ad; `linkUrl` and per-card `linkUrl` are optional and forwarded as real destinations when sent, falling back to Meta's lead-form link when omitted) ARE supported on Meta instant-form lead ads." }
                 imageUrl: { type: string, format: uri, description: "Image creative for Meta/Google/Pinterest/LinkedIn on legacy + attach shapes (mutually exclusive with `video`). Required for LinkedIn ads unless `video` is set. Not required for Google Search campaigns. For TikTok, this field carries the VIDEO URL (the TikTok ads endpoint is video-only; the field retains the `imageUrl` name for cross-platform consistency). Ignored for X. For Google Display, treated as the landscape image (alias of `images.landscape`); supply `images.square` alongside or the request is rejected. For LinkedIn the image is uploaded to LinkedIn under the authoring Company Page (see `organizationId`); recommended ratio 1.91:1 (e.g. 1200×627). Required for OpenAI Ads (uploaded as the chat card's image; OpenAI has no video ad format)." }
                 images:
                   type: object
@@ -47084,30 +47087,46 @@ paths:
                     to build N full ads sharing one ad set: create the first ad
                     via the normal shape, then attach the rest one call each.
 
-                    Supported on Meta (facebook, instagram), TikTok, and
-                    LinkedIn. On TikTok the `adSetId` is the ad group ID; the
+                    Supported on Meta (facebook, instagram), Google Ads, TikTok,
+                    and LinkedIn. On TikTok the `adSetId` is the ad group ID; the
                     new ad inherits the ad group's bid + budget + targeting.
                     On LinkedIn the `adSetId` is the LinkedIn Campaign ID
                     (numeric); we attach a new Creative to that Campaign, so
                     the Campaign's `platformSpecificData` bidding, targeting,
                     budget and schedule are inherited (passing those fields
                     returns 400).
+
+                    On Google Ads the `adSetId` is the AD GROUP id. `goal` is
+                    still REQUIRED even though budget and targeting are
+                    inherited from the ad group. Send `campaignType: "search"`
+                    to attach into a Search ad group, including one created by
+                    `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it
+                    the request is treated as Display and requires
+                    `images.landscape` + `images.square` + `businessName`, and
+                    the resulting display creative does not match a Search ad
+                    group.
+                    `budgetAmount`/`budgetType` and bidding fields
+                    (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`)
+                    return 400 on this shape; the ad group already owns them.
                 existingCampaignId:
                   type: string
                   description: |
-                    Meta + LinkedIn. On Meta: add the new ad set under this
-                    EXISTING campaign instead of creating a new one
-                    (multi-ad-set audience testing). The new ad set's budget
-                    is matched to the campaign's mode automatically: for a
-                    CBO campaign (campaign-level budget) omit
+                    Meta, Google Ads, and LinkedIn. On Meta: add the new ad
+                    set under this EXISTING campaign instead of creating a new
+                    one (multi-ad-set audience testing). The new ad set's
+                    budget is matched to the campaign's mode automatically:
+                    for a CBO campaign (campaign-level budget) omit
                     `budgetAmount`/`budgetType`, since the campaign owns the
                     budget; for an ABO campaign pass them (they go on the new
                     ad set). On LinkedIn: create a new Campaign (and its
-                    Creative) under this EXISTING CampaignGroup. On failure
-                    only the entities we authored are cleaned up; the
-                    pre-existing parent is left untouched and is never
-                    (re)activated. Mutually exclusive with `adSetId` and
-                    `creatives[]`.
+                    Creative) under this EXISTING CampaignGroup. On Google
+                    Ads: create a new ad group under this EXISTING campaign;
+                    the new ad group inherits the campaign's budget, so omit
+                    `budgetAmount`/`budgetType` (and any bidding field), or
+                    the request returns 400. On failure only the entities we
+                    authored are cleaned up; the pre-existing parent is left
+                    untouched and is never (re)activated. Mutually exclusive
+                    with `adSetId` and `creatives[]`.
                 existingCreativeId:
                   type: string
                   description: |
@@ -47410,18 +47429,22 @@ paths:
                   description: |
                     Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
                     the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
-                    you control the card order and per-card copy/link. Requires top-level `body`,
-                    `linkUrl` and `callToAction`. Those become the ad's own Destination and
-                    button (`link_data.link` / `link_data.call_to_action`), and double as the per-card fallback when a card omits its own.
+                    you control the card order and per-card copy/link. Requires top-level `body`
+                    and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those
+                    become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`),
+                    and double as the per-card fallback when a card omits its own.
                     Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`,
-                    `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal
-                    `catalog_sales`.
+                    `placementAssets`, `existingCreativeId`, `adSetId` and goal
+                    `catalog_sales`. Combines with `leadGenFormId` to build a carousel Instant-Form
+                    lead ad: `linkUrl` and per-card `linkUrl` become OPTIONAL and, when sent, are
+                    forwarded as the real card and top-level destinations; when omitted, the
+                    destination falls back to Meta's lead-form link.
                   items:
                     type: object
                     required: [imageUrl]
                     properties:
                       imageUrl: { type: string, format: uri, description: "Card image; uploaded to the ad account and referenced by hash." }
-                      linkUrl: { type: string, format: uri, description: "Card destination URL. Defaults to the top-level linkUrl." }
+                      linkUrl: { type: string, format: uri, description: "Card destination URL. Defaults to the top-level linkUrl, or Meta's lead-form link when leadGenFormId is set and neither is provided." }
                       headline: { type: string, maxLength: 255, description: "Card headline, shown below the card image." }
                       description: { type: string, maxLength: 255, description: "Card description, shown under the headline." }
                       callToAction: { type: string, description: "Card CTA override. Defaults to the top-level callToAction; same enum." }

data/spec/api/ad_campaigns_api_spec.rb

@@ -97,7 +97,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for create_ad_set
   # Create a standalone ad group
-  # Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `existingAdGroupId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+  # Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via `adSetId` on POST /v1/ads/create. Google only; every other platform returns 501.  Created `PAUSED` unless `status: ACTIVE`. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from `ads` rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
   # @param create_ad_set_request 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
@@ -122,7 +122,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for create_standalone_ad
   # Create standalone ad
-  # Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
+  # Create a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X, LinkedIn, and OpenAI Ads (ChatGPT Ads).  Three mutually-exclusive request shapes are selected by the body:  - Legacy single-creative shape (all platforms, the default). - Meta-only multi-creative shape via the creatives array: one ad set with N ads sharing budget and targeting. - Attach shape via adSetId: adds one new ad to an existing ad set, inheriting its budget, targeting, and schedule (Meta, Google Ads, TikTok, and LinkedIn). On LinkedIn adSetId is the existing Campaign id, and the budget, schedule, targeting and bidding fields must be omitted.  Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.  LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h. 
   # @param create_standalone_ad_request 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
@@ -359,7 +359,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for list_ad_sets
   # List ad sets
-  # Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `existingAdGroupId`. Returns at most 500 rows, newest first.
+  # Ad sets (Google ad groups) synced for the connection, optionally filtered by platform and campaignId. Reads the `ad_sets` table directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets, Google only) is visible here even though it is invisible in the tree until an ad joins it via `adSetId` on POST /v1/ads/create. Returns at most 500 rows, newest first.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :account_id Account ID
   # @option opts [String] :campaign_id Platform campaign ID

data/spec/models/{conversation_spec.rb → inbox_webhook_conversation_detail_spec.rb}

@@ -14,16 +14,16 @@ require 'spec_helper'
 require 'json'
 require 'date'
 
-# Unit tests for Zernio::Conversation
+# Unit tests for Zernio::InboxWebhookConversationDetail
 # Automatically generated by openapi-generator (https://openapi-generator.tech)
 # Please update as you see appropriate
-describe Zernio::Conversation do
-  #let(:instance) { Zernio::Conversation.new }
+describe Zernio::InboxWebhookConversationDetail do
+  #let(:instance) { Zernio::InboxWebhookConversationDetail.new }
 
-  describe 'test an instance of Conversation' do
-    it 'should create an instance of Conversation' do
+  describe 'test an instance of InboxWebhookConversationDetail' do
+    it 'should create an instance of InboxWebhookConversationDetail' do
       # uncomment below to test the instance creation
-      #expect(instance).to be_instance_of(Zernio::Conversation)
+      #expect(instance).to be_instance_of(Zernio::InboxWebhookConversationDetail)
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.890
+  version: 0.0.892
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -309,7 +309,6 @@ files:
 - docs/ConnectedApp.md
 - docs/ConnectedAppsApi.md
 - docs/ContactsApi.md
-- docs/Conversation.md
 - docs/ConversionAction.md
 - docs/ConversionActionTagSnippetsInner.md
 - docs/ConversionDestination.md
@@ -997,6 +996,7 @@ files:
 - docs/InboxMessageEditHistoryEntry.md
 - docs/InboxWebhookAccount.md
 - docs/InboxWebhookConversation.md
+- docs/InboxWebhookConversationDetail.md
 - docs/InboxWebhookMessage.md
 - docs/InboxWebhookMessageAttachmentsInner.md
 - docs/InboxWebhookMessageSender.md
@@ -1938,7 +1938,6 @@ files:
 - docs/WebhookPayloadConversationControlChanged.md
 - docs/WebhookPayloadConversationControlChangedControl.md
 - docs/WebhookPayloadConversationStarted.md
-- docs/WebhookPayloadConversationStartedConversation.md
 - docs/WebhookPayloadExternalPost.md
 - docs/WebhookPayloadLead.md
 - docs/WebhookPayloadLeadAccount.md
@@ -2360,7 +2359,6 @@ files:
 - lib/zernio-sdk/models/connected.rb
 - lib/zernio-sdk/models/connected_account.rb
 - lib/zernio-sdk/models/connected_app.rb
-- lib/zernio-sdk/models/conversation.rb
 - lib/zernio-sdk/models/conversion_action.rb
 - lib/zernio-sdk/models/conversion_action_tag_snippets_inner.rb
 - lib/zernio-sdk/models/conversion_destination.rb
@@ -3036,6 +3034,7 @@ files:
 - lib/zernio-sdk/models/inbox_message_edit_history_entry.rb
 - lib/zernio-sdk/models/inbox_webhook_account.rb
 - lib/zernio-sdk/models/inbox_webhook_conversation.rb
+- lib/zernio-sdk/models/inbox_webhook_conversation_detail.rb
 - lib/zernio-sdk/models/inbox_webhook_message.rb
 - lib/zernio-sdk/models/inbox_webhook_message_attachments_inner.rb
 - lib/zernio-sdk/models/inbox_webhook_message_sender.rb
@@ -3950,7 +3949,6 @@ files:
 - lib/zernio-sdk/models/webhook_payload_conversation_control_changed.rb
 - lib/zernio-sdk/models/webhook_payload_conversation_control_changed_control.rb
 - lib/zernio-sdk/models/webhook_payload_conversation_started.rb
-- lib/zernio-sdk/models/webhook_payload_conversation_started_conversation.rb
 - lib/zernio-sdk/models/webhook_payload_external_post.rb
 - lib/zernio-sdk/models/webhook_payload_lead.rb
 - lib/zernio-sdk/models/webhook_payload_lead_account.rb
@@ -4358,7 +4356,6 @@ files:
 - spec/models/connected_account_spec.rb
 - spec/models/connected_app_spec.rb
 - spec/models/connected_spec.rb
-- spec/models/conversation_spec.rb
 - spec/models/conversion_action_spec.rb
 - spec/models/conversion_action_tag_snippets_inner_spec.rb
 - spec/models/conversion_destination_spec.rb
@@ -5033,6 +5030,7 @@ files:
 - spec/models/inbox_message_edit_attachment_spec.rb
 - spec/models/inbox_message_edit_history_entry_spec.rb
 - spec/models/inbox_webhook_account_spec.rb
+- spec/models/inbox_webhook_conversation_detail_spec.rb
 - spec/models/inbox_webhook_conversation_spec.rb
 - spec/models/inbox_webhook_message_attachments_inner_spec.rb
 - spec/models/inbox_webhook_message_sender_instagram_profile_spec.rb
@@ -5946,7 +5944,6 @@ files:
 - spec/models/webhook_payload_comment_spec.rb
 - spec/models/webhook_payload_conversation_control_changed_control_spec.rb
 - spec/models/webhook_payload_conversation_control_changed_spec.rb
-- spec/models/webhook_payload_conversation_started_conversation_spec.rb
 - spec/models/webhook_payload_conversation_started_spec.rb
 - spec/models/webhook_payload_external_post_spec.rb
 - spec/models/webhook_payload_lead_account_spec.rb
@@ -6067,7 +6064,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.890.gem
+- zernio-sdk-0.0.892.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses:
@@ -6941,7 +6938,6 @@ test_files:
 - spec/models/list_inbox_conversation_analytics200_response_spec.rb
 - spec/models/targeting_spec_excluded_locations_places_inner_spec.rb
 - spec/models/list_high_demand_periods200_response_spec.rb
-- spec/models/conversation_spec.rb
 - spec/models/create_voice_call200_response_spec.rb
 - spec/models/create_standalone_ad_request_dynamic_creative_spec.rb
 - spec/models/inbox_webhook_message_sender_instagram_profile_spec.rb
@@ -7751,6 +7747,7 @@ test_files:
 - spec/models/get_whats_app_sdk_config200_response_spec.rb
 - spec/models/whats_app_carousel_component_cards_inner_spec.rb
 - spec/models/get_inbox_conversation_messages200_response_messages_inner_attachments_inner_spec.rb
+- spec/models/inbox_webhook_conversation_detail_spec.rb
 - spec/models/validate_post_request_spec.rb
 - spec/models/list_users200_response_spec.rb
 - spec/models/ad_keyword_metrics_spec.rb
@@ -8023,7 +8020,6 @@ test_files:
 - spec/models/webhook_payload_call_received_spec.rb
 - spec/models/update_discord_settings200_response_account_spec.rb
 - spec/models/get_whats_app_business_profile200_response_spec.rb
-- spec/models/webhook_payload_conversation_started_conversation_spec.rb
 - spec/models/get_inbox_conversation_messages200_response_spec.rb
 - spec/models/get_google_business_reviews200_response_spec.rb
 - spec/models/list_whats_app_flow_versions200_response_spec.rb

data/docs/WebhookPayloadConversationStartedConversation.md

@@ -1,34 +0,0 @@
-# Zernio::WebhookPayloadConversationStartedConversation
-
-## Properties
-
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **id** | **String** | Internal conversation ID |  |
-| **platform** | **String** |  |  |
-| **platform_conversation_id** | **String** |  |  |
-| **participant_id** | **String** | Contact's platform identifier (IGSID, PSID, wa_id, etc.) | [optional] |
-| **participant_name** | **String** |  |  |
-| **participant_username** | **String** | Contact's handle when the platform exposes one | [optional] |
-| **participant_picture** | **String** |  | [optional] |
-| **status** | **String** |  |  |
-| **contact_id** | **String** | Zernio CRM Contact ID for the participant, when one exists. Resolved by joining `participantId` to the ContactChannel collection (same join used by message.*, reaction.received, and call.* webhooks). Best-effort: omitted when no channel matches or `participantId` is absent. Lets integrators seed the CRM straight from `conversation.started` without waiting for the first `message.*` event.  | [optional] |
-
-## Example
-
-```ruby
-require 'zernio-sdk'
-
-instance = Zernio::WebhookPayloadConversationStartedConversation.new(
-  id: null,
-  platform: null,
-  platform_conversation_id: null,
-  participant_id: null,
-  participant_name: null,
-  participant_username: null,
-  participant_picture: null,
-  status: null,
-  contact_id: null
-)
-```
-

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

@@ -1,334 +0,0 @@
-=begin
-#Zernio API
-
-#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
-
-The version of the OpenAPI document: 1.0.4
-Contact: support@zernio.com
-Generated by: https://openapi-generator.tech
-Generator version: 7.19.0
-
-=end
-
-require 'date'
-require 'time'
-
-module Zernio
-  class WebhookPayloadConversationStartedConversation < ApiModelBase
-    # Internal conversation ID
-    attr_accessor :id
-
-    attr_accessor :platform
-
-    attr_accessor :platform_conversation_id
-
-    # Contact's platform identifier (IGSID, PSID, wa_id, etc.)
-    attr_accessor :participant_id
-
-    attr_accessor :participant_name
-
-    # Contact's handle when the platform exposes one
-    attr_accessor :participant_username
-
-    attr_accessor :participant_picture
-
-    attr_accessor :status
-
-    # Zernio CRM Contact ID for the participant, when one exists. Resolved by joining `participantId` to the ContactChannel collection (same join used by message.*, reaction.received, and call.* webhooks). Best-effort: omitted when no channel matches or `participantId` is absent. Lets integrators seed the CRM straight from `conversation.started` without waiting for the first `message.*` event. 
-    attr_accessor :contact_id
-
-    class EnumAttributeValidator
-      attr_reader :datatype
-      attr_reader :allowable_values
-
-      def initialize(datatype, allowable_values)
-        @allowable_values = allowable_values.map do |value|
-          case datatype.to_s
-          when /Integer/i
-            value.to_i
-          when /Float/i
-            value.to_f
-          else
-            value
-          end
-        end
-      end
-
-      def valid?(value)
-        !value || allowable_values.include?(value)
-      end
-    end
-
-    # Attribute mapping from ruby-style variable name to JSON key.
-    def self.attribute_map
-      {
-        :'id' => :'id',
-        :'platform' => :'platform',
-        :'platform_conversation_id' => :'platformConversationId',
-        :'participant_id' => :'participantId',
-        :'participant_name' => :'participantName',
-        :'participant_username' => :'participantUsername',
-        :'participant_picture' => :'participantPicture',
-        :'status' => :'status',
-        :'contact_id' => :'contactId'
-      }
-    end
-
-    # Returns attribute mapping this model knows about
-    def self.acceptable_attribute_map
-      attribute_map
-    end
-
-    # Returns all the JSON keys this model knows about
-    def self.acceptable_attributes
-      acceptable_attribute_map.values
-    end
-
-    # Attribute type mapping.
-    def self.openapi_types
-      {
-        :'id' => :'String',
-        :'platform' => :'String',
-        :'platform_conversation_id' => :'String',
-        :'participant_id' => :'String',
-        :'participant_name' => :'String',
-        :'participant_username' => :'String',
-        :'participant_picture' => :'String',
-        :'status' => :'String',
-        :'contact_id' => :'String'
-      }
-    end
-
-    # List of attributes with nullable: true
-    def self.openapi_nullable
-      Set.new([
-      ])
-    end
-
-    # Initializes the object
-    # @param [Hash] attributes Model attributes in the form of hash
-    def initialize(attributes = {})
-      if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::WebhookPayloadConversationStartedConversation` initialize method"
-      end
-
-      # check to see if the attribute exists and convert string to symbol for hash key
-      acceptable_attribute_map = self.class.acceptable_attribute_map
-      attributes = attributes.each_with_object({}) { |(k, v), h|
-        if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::WebhookPayloadConversationStartedConversation`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
-        end
-        h[k.to_sym] = v
-      }
-
-      if attributes.key?(:'id')
-        self.id = attributes[:'id']
-      else
-        self.id = nil
-      end
-
-      if attributes.key?(:'platform')
-        self.platform = attributes[:'platform']
-      else
-        self.platform = nil
-      end
-
-      if attributes.key?(:'platform_conversation_id')
-        self.platform_conversation_id = attributes[:'platform_conversation_id']
-      else
-        self.platform_conversation_id = nil
-      end
-
-      if attributes.key?(:'participant_id')
-        self.participant_id = attributes[:'participant_id']
-      end
-
-      if attributes.key?(:'participant_name')
-        self.participant_name = attributes[:'participant_name']
-      else
-        self.participant_name = nil
-      end
-
-      if attributes.key?(:'participant_username')
-        self.participant_username = attributes[:'participant_username']
-      end
-
-      if attributes.key?(:'participant_picture')
-        self.participant_picture = attributes[:'participant_picture']
-      end
-
-      if attributes.key?(:'status')
-        self.status = attributes[:'status']
-      else
-        self.status = nil
-      end
-
-      if attributes.key?(:'contact_id')
-        self.contact_id = attributes[:'contact_id']
-      end
-    end
-
-    # Show invalid properties with the reasons. Usually used together with valid?
-    # @return Array for valid properties with the reasons
-    def list_invalid_properties
-      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
-      invalid_properties = Array.new
-      if @id.nil?
-        invalid_properties.push('invalid value for "id", id cannot be nil.')
-      end
-
-      if @platform.nil?
-        invalid_properties.push('invalid value for "platform", platform cannot be nil.')
-      end
-
-      if @platform_conversation_id.nil?
-        invalid_properties.push('invalid value for "platform_conversation_id", platform_conversation_id cannot be nil.')
-      end
-
-      if @participant_name.nil?
-        invalid_properties.push('invalid value for "participant_name", participant_name cannot be nil.')
-      end
-
-      if @status.nil?
-        invalid_properties.push('invalid value for "status", status cannot be nil.')
-      end
-
-      invalid_properties
-    end
-
-    # Check to see if the all the properties in the model are valid
-    # @return true if the model is valid
-    def valid?
-      warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @id.nil?
-      return false if @platform.nil?
-      platform_validator = EnumAttributeValidator.new('String', ["instagram", "facebook", "telegram", "whatsapp", "twitter", "reddit", "bluesky", "sms", "slack"])
-      return false unless platform_validator.valid?(@platform)
-      return false if @platform_conversation_id.nil?
-      return false if @participant_name.nil?
-      return false if @status.nil?
-      status_validator = EnumAttributeValidator.new('String', ["active", "archived"])
-      return false unless status_validator.valid?(@status)
-      true
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] id Value to be assigned
-    def id=(id)
-      if id.nil?
-        fail ArgumentError, 'id cannot be nil'
-      end
-
-      @id = id
-    end
-
-    # Custom attribute writer method checking allowed values (enum).
-    # @param [Object] platform Object to be assigned
-    def platform=(platform)
-      validator = EnumAttributeValidator.new('String', ["instagram", "facebook", "telegram", "whatsapp", "twitter", "reddit", "bluesky", "sms", "slack"])
-      unless validator.valid?(platform)
-        fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
-      end
-      @platform = platform
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] platform_conversation_id Value to be assigned
-    def platform_conversation_id=(platform_conversation_id)
-      if platform_conversation_id.nil?
-        fail ArgumentError, 'platform_conversation_id cannot be nil'
-      end
-
-      @platform_conversation_id = platform_conversation_id
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] participant_name Value to be assigned
-    def participant_name=(participant_name)
-      if participant_name.nil?
-        fail ArgumentError, 'participant_name cannot be nil'
-      end
-
-      @participant_name = participant_name
-    end
-
-    # Custom attribute writer method checking allowed values (enum).
-    # @param [Object] status Object to be assigned
-    def status=(status)
-      validator = EnumAttributeValidator.new('String', ["active", "archived"])
-      unless validator.valid?(status)
-        fail ArgumentError, "invalid value for \"status\", must be one of #{validator.allowable_values}."
-      end
-      @status = status
-    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 &&
-          id == o.id &&
-          platform == o.platform &&
-          platform_conversation_id == o.platform_conversation_id &&
-          participant_id == o.participant_id &&
-          participant_name == o.participant_name &&
-          participant_username == o.participant_username &&
-          participant_picture == o.participant_picture &&
-          status == o.status &&
-          contact_id == o.contact_id
-    end
-
-    # @see the `==` method
-    # @param [Object] Object to be compared
-    def eql?(o)
-      self == o
-    end
-
-    # Calculates hash code according to all attributes.
-    # @return [Integer] Hash code
-    def hash
-      [id, platform, platform_conversation_id, participant_id, participant_name, participant_username, participant_picture, status, contact_id].hash
-    end
-
-    # Builds the object from hash
-    # @param [Hash] attributes Model attributes in the form of hash
-    # @return [Object] Returns the model itself
-    def self.build_from_hash(attributes)
-      return nil unless attributes.is_a?(Hash)
-      attributes = attributes.transform_keys(&:to_sym)
-      transformed_hash = {}
-      openapi_types.each_pair do |key, type|
-        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
-          transformed_hash["#{key}"] = nil
-        elsif type =~ /\AArray<(.*)>/i
-          # check to ensure the input is an array given that the attribute
-          # is documented as an array but the input is not
-          if attributes[attribute_map[key]].is_a?(Array)
-            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
-          end
-        elsif !attributes[attribute_map[key]].nil?
-          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
-        end
-      end
-      new(transformed_hash)
-    end
-
-    # Returns the object in the form of hash
-    # @return [Hash] Returns the object in the form of hash
-    def to_hash
-      hash = {}
-      self.class.attribute_map.each_pair do |attr, param|
-        value = self.send(attr)
-        if value.nil?
-          is_nullable = self.class.openapi_nullable.include?(attr)
-          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
-        end
-
-        hash[param] = _to_hash(value)
-      end
-      hash
-    end
-
-  end
-
-end

data/spec/models/webhook_payload_conversation_started_conversation_spec.rb

@@ -1,92 +0,0 @@
-=begin
-#Zernio API
-
-#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
-
-The version of the OpenAPI document: 1.0.4
-Contact: support@zernio.com
-Generated by: https://openapi-generator.tech
-Generator version: 7.19.0
-
-=end
-
-require 'spec_helper'
-require 'json'
-require 'date'
-
-# Unit tests for Zernio::WebhookPayloadConversationStartedConversation
-# Automatically generated by openapi-generator (https://openapi-generator.tech)
-# Please update as you see appropriate
-describe Zernio::WebhookPayloadConversationStartedConversation do
-  #let(:instance) { Zernio::WebhookPayloadConversationStartedConversation.new }
-
-  describe 'test an instance of WebhookPayloadConversationStartedConversation' do
-    it 'should create an instance of WebhookPayloadConversationStartedConversation' do
-      # uncomment below to test the instance creation
-      #expect(instance).to be_instance_of(Zernio::WebhookPayloadConversationStartedConversation)
-    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 "platform"' 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', ["instagram", "facebook", "telegram", "whatsapp", "twitter", "reddit", "bluesky", "sms", "slack"])
-      # validator.allowable_values.each do |value|
-      #   expect { instance.platform = value }.not_to raise_error
-      # end
-    end
-  end
-
-  describe 'test attribute "platform_conversation_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 "participant_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 "participant_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 "participant_username"' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    end
-  end
-
-  describe 'test attribute "participant_picture"' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    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", "archived"])
-      # validator.allowable_values.each do |value|
-      #   expect { instance.status = value }.not_to raise_error
-      # end
-    end
-  end
-
-  describe 'test attribute "contact_id"' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    end
-  end
-
-end