@zernio/node 0.2.117 → 0.2.119

package/dist/index.d.mts

@@ -2876,9 +2876,9 @@ type SnapchatPlatformData = {
  */
 type contentType3 = 'story' | 'saved_story' | 'spotlight';
 type SocialAccount = {
-    _id?: string;
-    platform?: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
-    profileId?: (string | Profile);
+    _id: string;
+    platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
+    profileId: (string | Profile);
     username?: string;
     displayName?: string;
     /**
@@ -2889,7 +2889,7 @@ type SocialAccount = {
      * Full profile URL for the connected account on its platform.
      */
     profileUrl?: string;
-    isActive?: boolean;
+    isActive: boolean;
     /**
      * Follower count (only included if user has analytics add-on)
      */
@@ -5950,11 +5950,11 @@ type ListAccountsData = {
     };
 };
 type ListAccountsResponse = ({
-    accounts?: Array<SocialAccount>;
+    accounts: Array<SocialAccount>;
     /**
      * Whether user has analytics add-on access
      */
-    hasAnalyticsAccess?: boolean;
+    hasAnalyticsAccess: boolean;
     /**
      * Only present when page/limit params are provided
      */
@@ -10468,7 +10468,10 @@ type SendPrivateReplyToCommentData = {
         message: string;
         /**
          * Optional quick-reply chips appended to the message. Visible only in the
-         * Instagram and Messenger apps (not on web). Maximum 13 entries.
+         * Instagram and Messenger apps (not on web). Maximum 13 entries. Mutually
+         * exclusive with `buttons`. Note: chips do NOT render in the Instagram
+         * Message Requests folder where DMs from non-followers land — use `buttons`
+         * instead for cold reach.
          *
          */
         quickReplies?: Array<{
@@ -10485,6 +10488,43 @@ type SendPrivateReplyToCommentData = {
              */
             imageUrl?: string;
         }>;
+        /**
+         * Optional 1-3 inline buttons rendered as part of the same message bubble
+         * via Meta's button_template. Visible in the Instagram Message Requests
+         * folder (unlike quick replies). Mutually exclusive with `quickReplies`.
+         *
+         */
+        buttons?: Array<({
+            type: 'url';
+            /**
+             * Label shown on the button.
+             */
+            title: string;
+            /**
+             * URL opened when the button is tapped.
+             */
+            url: string;
+        } | {
+            type: 'postback';
+            /**
+             * Label shown on the button.
+             */
+            title: string;
+            /**
+             * Opaque value returned in the inbound webhook when the user taps the button.
+             */
+            payload: string;
+        } | {
+            type: 'phone';
+            /**
+             * Label shown on the button. Facebook only.
+             */
+            title: string;
+            /**
+             * E.164 phone number dialed when tapped. Facebook only.
+             */
+            phone: string;
+        })>;
     };
     path: {
         /**

package/dist/index.d.ts

@@ -2876,9 +2876,9 @@ type SnapchatPlatformData = {
  */
 type contentType3 = 'story' | 'saved_story' | 'spotlight';
 type SocialAccount = {
-    _id?: string;
-    platform?: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
-    profileId?: (string | Profile);
+    _id: string;
+    platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
+    profileId: (string | Profile);
     username?: string;
     displayName?: string;
     /**
@@ -2889,7 +2889,7 @@ type SocialAccount = {
      * Full profile URL for the connected account on its platform.
      */
     profileUrl?: string;
-    isActive?: boolean;
+    isActive: boolean;
     /**
      * Follower count (only included if user has analytics add-on)
      */
@@ -5950,11 +5950,11 @@ type ListAccountsData = {
     };
 };
 type ListAccountsResponse = ({
-    accounts?: Array<SocialAccount>;
+    accounts: Array<SocialAccount>;
     /**
      * Whether user has analytics add-on access
      */
-    hasAnalyticsAccess?: boolean;
+    hasAnalyticsAccess: boolean;
     /**
      * Only present when page/limit params are provided
      */
@@ -10468,7 +10468,10 @@ type SendPrivateReplyToCommentData = {
         message: string;
         /**
          * Optional quick-reply chips appended to the message. Visible only in the
-         * Instagram and Messenger apps (not on web). Maximum 13 entries.
+         * Instagram and Messenger apps (not on web). Maximum 13 entries. Mutually
+         * exclusive with `buttons`. Note: chips do NOT render in the Instagram
+         * Message Requests folder where DMs from non-followers land — use `buttons`
+         * instead for cold reach.
          *
          */
         quickReplies?: Array<{
@@ -10485,6 +10488,43 @@ type SendPrivateReplyToCommentData = {
              */
             imageUrl?: string;
         }>;
+        /**
+         * Optional 1-3 inline buttons rendered as part of the same message bubble
+         * via Meta's button_template. Visible in the Instagram Message Requests
+         * folder (unlike quick replies). Mutually exclusive with `quickReplies`.
+         *
+         */
+        buttons?: Array<({
+            type: 'url';
+            /**
+             * Label shown on the button.
+             */
+            title: string;
+            /**
+             * URL opened when the button is tapped.
+             */
+            url: string;
+        } | {
+            type: 'postback';
+            /**
+             * Label shown on the button.
+             */
+            title: string;
+            /**
+             * Opaque value returned in the inbound webhook when the user taps the button.
+             */
+            payload: string;
+        } | {
+            type: 'phone';
+            /**
+             * Label shown on the button. Facebook only.
+             */
+            title: string;
+            /**
+             * E.164 phone number dialed when tapped. Facebook only.
+             */
+            phone: string;
+        })>;
     };
     path: {
         /**

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -2174,9 +2174,11 @@ export const unlikeInboxComment = <ThrowOnError extends boolean = false>(options
 /**
  * Send private reply
  * Send a private message to the author of a comment. Supported on Instagram and Facebook only.
- * One reply per comment, must be sent within 7 days. Optionally include up to 13 quick-reply
- * chips (`quickReplies`) on the same first message — useful for comment-to-DM automations
- * that want to capture intent in a single round-trip.
+ * One reply per comment, must be sent within 7 days. Optionally attach interactive elements:
+ * `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url
+ * buttons rendered in the same bubble via Meta's button_template). Buttons are recommended
+ * for cold reach since chips do not render in the Instagram Message Requests folder.
+ * `quickReplies` and `buttons` are mutually exclusive.
  *
  */
 export const sendPrivateReplyToComment = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SendPrivateReplyToCommentData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -2378,9 +2378,9 @@ export type SnapchatPlatformData = {
 export type contentType3 = 'story' | 'saved_story' | 'spotlight';
 
 export type SocialAccount = {
-    _id?: string;
-    platform?: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
-    profileId?: (string | Profile);
+    _id: string;
+    platform: 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads';
+    profileId: (string | Profile);
     username?: string;
     displayName?: string;
     /**
@@ -2391,7 +2391,7 @@ export type SocialAccount = {
      * Full profile URL for the connected account on its platform.
      */
     profileUrl?: string;
-    isActive?: boolean;
+    isActive: boolean;
     /**
      * Follower count (only included if user has analytics add-on)
      */
@@ -5659,11 +5659,11 @@ export type ListAccountsData = {
 };
 
 export type ListAccountsResponse = ({
-    accounts?: Array<SocialAccount>;
+    accounts: Array<SocialAccount>;
     /**
      * Whether user has analytics add-on access
      */
-    hasAnalyticsAccess?: boolean;
+    hasAnalyticsAccess: boolean;
     /**
      * Only present when page/limit params are provided
      */
@@ -10507,7 +10507,10 @@ export type SendPrivateReplyToCommentData = {
         message: string;
         /**
          * Optional quick-reply chips appended to the message. Visible only in the
-         * Instagram and Messenger apps (not on web). Maximum 13 entries.
+         * Instagram and Messenger apps (not on web). Maximum 13 entries. Mutually
+         * exclusive with `buttons`. Note: chips do NOT render in the Instagram
+         * Message Requests folder where DMs from non-followers land — use `buttons`
+         * instead for cold reach.
          *
          */
         quickReplies?: Array<{
@@ -10524,6 +10527,43 @@ export type SendPrivateReplyToCommentData = {
              */
             imageUrl?: string;
         }>;
+        /**
+         * Optional 1-3 inline buttons rendered as part of the same message bubble
+         * via Meta's button_template. Visible in the Instagram Message Requests
+         * folder (unlike quick replies). Mutually exclusive with `quickReplies`.
+         *
+         */
+        buttons?: Array<({
+    type: 'url';
+    /**
+     * Label shown on the button.
+     */
+    title: string;
+    /**
+     * URL opened when the button is tapped.
+     */
+    url: string;
+} | {
+    type: 'postback';
+    /**
+     * Label shown on the button.
+     */
+    title: string;
+    /**
+     * Opaque value returned in the inbound webhook when the user taps the button.
+     */
+    payload: string;
+} | {
+    type: 'phone';
+    /**
+     * Label shown on the button. Facebook only.
+     */
+    title: string;
+    /**
+     * E.164 phone number dialed when tapped. Facebook only.
+     */
+    phone: string;
+})>;
     };
     path: {
         /**