@zernio/node 0.2.124 → 0.2.126

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;
 };

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;
 };

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -1908,6 +1908,7 @@ export const deleteInboxMessage = <ThrowOnError extends boolean = false>(options
  * Show a typing indicator in a conversation. Platform support:
  * - Facebook Messenger: Shows "Page is typing..." for 20 seconds
  * - Telegram: Shows "Bot is typing..." for 5 seconds
+ * - WhatsApp: Shows "typing..." for up to 25 seconds. Requires a recent inbound message in the conversation (Meta references the inbound message id) and also marks that message as read as a side-effect.
  * - All others: Returns 200 but no-op (platform doesn't support it)
  *
  * Typing indicators are best-effort. The endpoint always returns 200 even if the platform call fails.

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;
 };