@zernio/node 0.2.185 → 0.2.187

package/dist/index.d.mts

@@ -2191,6 +2191,16 @@ type InboxWebhookConversation = {
     participantUsername?: string;
     participantPicture?: string;
     status: 'active' | 'archived';
+    /**
+     * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+     * joining `participantId` to the ContactChannel collection. Best-effort:
+     * omitted when no channel matches or `participantId` is absent. Lets
+     * 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.
+     *
+     */
+    contactId?: string;
 };
 type status3 = 'active' | 'archived';
 /**
@@ -4311,6 +4321,16 @@ type WebhookPayloadConversationStarted = {
         participantUsername?: string;
         participantPicture?: string;
         status: 'active' | 'archived';
+        /**
+         * 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.
+         *
+         */
+        contactId?: string;
     };
     account: InboxWebhookAccount;
     /**
@@ -4498,24 +4518,8 @@ type WebhookPayloadMessage = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     /**
      * Interactive message metadata (present when message is a quick reply tap, postback button tap, or inline keyboard callback)
      */
@@ -4827,24 +4831,8 @@ type WebhookPayloadMessageSent = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event12 = 'message.sent';
@@ -4992,24 +4980,8 @@ type WebhookPayloadReaction = {
         };
         reactedAt: string;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event15 = 'reaction.received';

package/dist/index.d.ts

@@ -2191,6 +2191,16 @@ type InboxWebhookConversation = {
     participantUsername?: string;
     participantPicture?: string;
     status: 'active' | 'archived';
+    /**
+     * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+     * joining `participantId` to the ContactChannel collection. Best-effort:
+     * omitted when no channel matches or `participantId` is absent. Lets
+     * 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.
+     *
+     */
+    contactId?: string;
 };
 type status3 = 'active' | 'archived';
 /**
@@ -4311,6 +4321,16 @@ type WebhookPayloadConversationStarted = {
         participantUsername?: string;
         participantPicture?: string;
         status: 'active' | 'archived';
+        /**
+         * 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.
+         *
+         */
+        contactId?: string;
     };
     account: InboxWebhookAccount;
     /**
@@ -4498,24 +4518,8 @@ type WebhookPayloadMessage = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     /**
      * Interactive message metadata (present when message is a quick reply tap, postback button tap, or inline keyboard callback)
      */
@@ -4827,24 +4831,8 @@ type WebhookPayloadMessageSent = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event12 = 'message.sent';
@@ -4992,24 +4980,8 @@ type WebhookPayloadReaction = {
         };
         reactedAt: string;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event15 = 'reaction.received';

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.185",
+  version: "0.2.187",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.185",
+  version: "0.2.187",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -4345,10 +4345,14 @@ export const listWhatsAppConversions = <ThrowOnError extends boolean = false>(op
  * the conversation and replays it on every event so Meta can attribute
  * the conversion back to the Click-to-WhatsApp ad that drove the chat.
  *
- * Configuration prerequisites on the WhatsApp account metadata:
- * - `metaCapiDatasetId`: the Meta Pixel/Dataset ID linked to the WABA.
- * - `connectedFacebookPageId`: the Facebook Page paired with the
- * WhatsApp Business number.
+ * Configuration prerequisite on the WhatsApp account metadata:
+ * - `metaCapiDatasetId`: the Meta dataset ID linked to the WABA.
+ * Provision one with `POST /v1/whatsapp/dataset`.
+ *
+ * The WABA ID (already set automatically at connect time) is forwarded as
+ * `user_data.whatsapp_business_account_id`, which is the per-channel
+ * attribution identifier Meta requires for WhatsApp events. No Facebook
+ * Page ID is needed (that field is the Messenger-branch identifier).
  *
  * Identify the conversation by either `conversationId` (preferred) or
  * `phoneE164` (digits only, no `+`). At least one is required. If the

package/src/generated/types.gen.ts

@@ -1574,6 +1574,16 @@ export type InboxWebhookConversation = {
     participantUsername?: string;
     participantPicture?: string;
     status: 'active' | 'archived';
+    /**
+     * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+     * joining `participantId` to the ContactChannel collection. Best-effort:
+     * omitted when no channel matches or `participantId` is absent. Lets
+     * 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.
+     *
+     */
+    contactId?: string;
 };
 
 export type status3 = 'active' | 'archived';
@@ -3803,6 +3813,16 @@ export type WebhookPayloadConversationStarted = {
         participantUsername?: string;
         participantPicture?: string;
         status: 'active' | 'archived';
+        /**
+         * 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.
+         *
+         */
+        contactId?: string;
     };
     account: InboxWebhookAccount;
     /**
@@ -3996,24 +4016,8 @@ export type WebhookPayloadMessage = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     /**
      * Interactive message metadata (present when message is a quick reply tap, postback button tap, or inline keyboard callback)
      */
@@ -4334,24 +4338,8 @@ export type WebhookPayloadMessageSent = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 
@@ -4505,24 +4493,8 @@ export type WebhookPayloadReaction = {
         };
         reactedAt: string;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };