@zernio/node 0.2.123 → 0.2.125

package/dist/index.d.mts

@@ -3882,11 +3882,17 @@ type WebhookPayloadMessage = {
          */
         isStoryMention?: boolean;
         /**
-         * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
-         * only on the FIRST inbound message after a user reaches the
-         * business via a CTWA ad. Forwarded verbatim from Meta's referral
-         * envelope so it can be replayed to the Conversions API for
-         * Business Messaging. Attribution window is 7 days from click.
+         * Ad-click attribution forwarded verbatim from Meta. Populated only on
+         * the FIRST inbound message after the click; absent on subsequent
+         * messages of the same conversation.
+         *
+         * The populated subset identifies the source platform:
+         * - `ctwa_clid` and `source_*` fields: WhatsApp CTWA
+         * (Click-to-WhatsApp). Attribution window is 7 days from click.
+         * Forward to Meta Conversions API for Business Messaging replay.
+         * - `ad_id` and `ads_context_data`: Facebook Messenger CTM
+         * (Click-to-Message) or Instagram CTD (Click-to-Direct). Use
+         * `ad_id` to attribute the conversation to a specific ad.
          *
          */
         referral?: {
@@ -3903,7 +3909,44 @@ type WebhookPayloadMessage = {
             image_url?: string;
             video_url?: string;
             thumbnail_url?: string;
-        };
+            /**
+             * Facebook Messenger CTM / Instagram CTD only. The Meta ad ID the
+             * user clicked to start the conversation.
+             *
+             */
+            ad_id?: string;
+            /**
+             * Optional `ref` parameter passed through from the Meta ad
+             * creative. Facebook Messenger CTM / Instagram CTD only.
+             *
+             */
+            ref?: string;
+            /**
+             * Meta-supplied source identifier (e.g. `ADS`). Facebook Messenger
+             * CTM / Instagram CTD only.
+             *
+             */
+            source?: string;
+            /**
+             * Meta-supplied referral type (e.g. `OPEN_THREAD`). Facebook
+             * Messenger CTM / Instagram CTD only.
+             *
+             */
+            type?: string;
+            /**
+             * Snapshot of the ad's public context at click time. Facebook
+             * Messenger CTM / Instagram CTD only.
+             *
+             */
+            ads_context_data?: {
+                ad_title?: string;
+                photo_url?: string;
+                video_url?: string;
+                post_id?: string;
+                product_id?: string;
+                flow_id?: string;
+            };
+        } | null;
     } | null;
     timestamp: string;
 };
@@ -14641,20 +14684,16 @@ type AddConversionAssociationsError = (unknown | {
     error?: string;
 });
 type RemoveConversionAssociationsData = {
-    body?: {
-        adAccountId?: string;
-        campaignIds?: Array<(string)>;
-    };
     path: {
         accountId: string;
         destinationId: string;
     };
-    query?: {
-        adAccountId?: string;
+    query: {
+        adAccountId: string;
         /**
-         * Comma-separated list.
+         * Comma-separated list of campaign IDs.
          */
-        campaignIds?: string;
+        campaignIds: string;
     };
 };
 type RemoveConversionAssociationsResponse = ({

package/dist/index.d.ts

@@ -3882,11 +3882,17 @@ type WebhookPayloadMessage = {
          */
         isStoryMention?: boolean;
         /**
-         * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
-         * only on the FIRST inbound message after a user reaches the
-         * business via a CTWA ad. Forwarded verbatim from Meta's referral
-         * envelope so it can be replayed to the Conversions API for
-         * Business Messaging. Attribution window is 7 days from click.
+         * Ad-click attribution forwarded verbatim from Meta. Populated only on
+         * the FIRST inbound message after the click; absent on subsequent
+         * messages of the same conversation.
+         *
+         * The populated subset identifies the source platform:
+         * - `ctwa_clid` and `source_*` fields: WhatsApp CTWA
+         * (Click-to-WhatsApp). Attribution window is 7 days from click.
+         * Forward to Meta Conversions API for Business Messaging replay.
+         * - `ad_id` and `ads_context_data`: Facebook Messenger CTM
+         * (Click-to-Message) or Instagram CTD (Click-to-Direct). Use
+         * `ad_id` to attribute the conversation to a specific ad.
          *
          */
         referral?: {
@@ -3903,7 +3909,44 @@ type WebhookPayloadMessage = {
             image_url?: string;
             video_url?: string;
             thumbnail_url?: string;
-        };
+            /**
+             * Facebook Messenger CTM / Instagram CTD only. The Meta ad ID the
+             * user clicked to start the conversation.
+             *
+             */
+            ad_id?: string;
+            /**
+             * Optional `ref` parameter passed through from the Meta ad
+             * creative. Facebook Messenger CTM / Instagram CTD only.
+             *
+             */
+            ref?: string;
+            /**
+             * Meta-supplied source identifier (e.g. `ADS`). Facebook Messenger
+             * CTM / Instagram CTD only.
+             *
+             */
+            source?: string;
+            /**
+             * Meta-supplied referral type (e.g. `OPEN_THREAD`). Facebook
+             * Messenger CTM / Instagram CTD only.
+             *
+             */
+            type?: string;
+            /**
+             * Snapshot of the ad's public context at click time. Facebook
+             * Messenger CTM / Instagram CTD only.
+             *
+             */
+            ads_context_data?: {
+                ad_title?: string;
+                photo_url?: string;
+                video_url?: string;
+                post_id?: string;
+                product_id?: string;
+                flow_id?: string;
+            };
+        } | null;
     } | null;
     timestamp: string;
 };
@@ -14641,20 +14684,16 @@ type AddConversionAssociationsError = (unknown | {
     error?: string;
 });
 type RemoveConversionAssociationsData = {
-    body?: {
-        adAccountId?: string;
-        campaignIds?: Array<(string)>;
-    };
     path: {
         accountId: string;
         destinationId: string;
     };
-    query?: {
-        adAccountId?: string;
+    query: {
+        adAccountId: string;
         /**
-         * Comma-separated list.
+         * Comma-separated list of campaign IDs.
          */
-        campaignIds?: string;
+        campaignIds: string;
     };
 };
 type RemoveConversionAssociationsResponse = ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.123",
+  "version": "0.2.125",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -3811,9 +3811,12 @@ export const addConversionAssociations = <ThrowOnError extends boolean = false>(
 /**
  * Remove campaign↔conversion associations
  * Remove one or more campaign associations from this conversion rule.
- * Accepts `adAccountId` and `campaignIds` either as query parameters
- * (campaignIds comma-separated) or as a JSON body, for clients that
- * can't send DELETE bodies.
+ * Pass `adAccountId` and `campaignIds` as query parameters
+ * (`campaignIds` is comma-separated). The route also accepts a JSON
+ * body with the same fields for clients that prefer DELETE-with-body,
+ * but the documented surface is query-only because some SDK code
+ * generators (e.g. Python) collapse query + body parameters with the
+ * same name into a single kwarg.
  *
  */
 export const removeConversionAssociations = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveConversionAssociationsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -3412,11 +3412,17 @@ export type WebhookPayloadMessage = {
          */
         isStoryMention?: boolean;
         /**
-         * WhatsApp only. Click-to-WhatsApp (CTWA) ad attribution. Present
-         * only on the FIRST inbound message after a user reaches the
-         * business via a CTWA ad. Forwarded verbatim from Meta's referral
-         * envelope so it can be replayed to the Conversions API for
-         * Business Messaging. Attribution window is 7 days from click.
+         * Ad-click attribution forwarded verbatim from Meta. Populated only on
+         * the FIRST inbound message after the click; absent on subsequent
+         * messages of the same conversation.
+         *
+         * The populated subset identifies the source platform:
+         * - `ctwa_clid` and `source_*` fields: WhatsApp CTWA
+         * (Click-to-WhatsApp). Attribution window is 7 days from click.
+         * Forward to Meta Conversions API for Business Messaging replay.
+         * - `ad_id` and `ads_context_data`: Facebook Messenger CTM
+         * (Click-to-Message) or Instagram CTD (Click-to-Direct). Use
+         * `ad_id` to attribute the conversation to a specific ad.
          *
          */
         referral?: {
@@ -3433,7 +3439,44 @@ export type WebhookPayloadMessage = {
             image_url?: string;
             video_url?: string;
             thumbnail_url?: string;
-        };
+            /**
+             * Facebook Messenger CTM / Instagram CTD only. The Meta ad ID the
+             * user clicked to start the conversation.
+             *
+             */
+            ad_id?: string;
+            /**
+             * Optional `ref` parameter passed through from the Meta ad
+             * creative. Facebook Messenger CTM / Instagram CTD only.
+             *
+             */
+            ref?: string;
+            /**
+             * Meta-supplied source identifier (e.g. `ADS`). Facebook Messenger
+             * CTM / Instagram CTD only.
+             *
+             */
+            source?: string;
+            /**
+             * Meta-supplied referral type (e.g. `OPEN_THREAD`). Facebook
+             * Messenger CTM / Instagram CTD only.
+             *
+             */
+            type?: string;
+            /**
+             * Snapshot of the ad's public context at click time. Facebook
+             * Messenger CTM / Instagram CTD only.
+             *
+             */
+            ads_context_data?: {
+                ad_title?: string;
+                photo_url?: string;
+                video_url?: string;
+                post_id?: string;
+                product_id?: string;
+                flow_id?: string;
+            };
+        } | null;
     } | null;
     timestamp: string;
 };
@@ -15028,20 +15071,16 @@ export type AddConversionAssociationsError = (unknown | {
 });
 
 export type RemoveConversionAssociationsData = {
-    body?: {
-        adAccountId?: string;
-        campaignIds?: Array<(string)>;
-    };
     path: {
         accountId: string;
         destinationId: string;
     };
-    query?: {
-        adAccountId?: string;
+    query: {
+        adAccountId: string;
         /**
-         * Comma-separated list.
+         * Comma-separated list of campaign IDs.
          */
-        campaignIds?: string;
+        campaignIds: string;
     };
 };