@zernio/node 0.2.729 → 0.2.730

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1820,6 +1820,10 @@ type Ad = {
1820
1820
  * Destination URL
1821
1821
  */
1822
1822
  linkUrl?: string;
1823
+ /**
1824
+ * Explicit E.164 WhatsApp number supplied when creating a Meta boost or messaging ad. Absent when omitted by the caller or on older records.
1825
+ */
1826
+ whatsappPhoneNumber?: string;
1823
1827
  pinterestImageUrl?: string;
1824
1828
  pinterestTitle?: string;
1825
1829
  pinterestDescription?: string;
@@ -4211,7 +4215,7 @@ type CtwaAdRequestBody = {
4211
4215
  */
4212
4216
  objectStoryId?: string;
4213
4217
  /**
4214
- * WhatsApp only. Optional E.164 number already paired with the Facebook Page. Omit to let Meta select the paired number. Sent to the creative CTA and, when creating a new ad set, its promoted_object. Attach requests do not change the existing ad set.
4218
+ * WhatsApp only. Optional E.164 number already paired with the Facebook Page. Omit to let Meta select the paired number. Sent to the creative CTA and, when creating a new ad set, its promoted_object. Attach requests do not change the existing ad set. Stored as creative.whatsappPhoneNumber on every created ad.
4215
4219
  */
4216
4220
  whatsappPhoneNumber?: string;
4217
4221
  /**
@@ -34706,11 +34710,11 @@ type BoostPostData = {
34706
34710
  */
34707
34711
  instagramAccountId?: string;
34708
34712
  /**
34709
- * Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Messaging destinations imply their matching CTA and require goal engagement. Lead ads use ON_AD; combining an instant form with a messaging destination is rejected.
34713
+ * Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Independent of plain link CTAs and their goal. A messaging callToAction selects its destination automatically; an explicit destinationType must then match. Lead ads use ON_AD.
34710
34714
  */
34711
34715
  destinationType?: 'INSTAGRAM_PROFILE' | 'WEBSITE' | 'ON_AD' | 'MESSENGER' | 'WHATSAPP' | 'INSTAGRAM_DIRECT';
34712
34716
  /**
34713
- * Meta WhatsApp only. E.164 number already paired with the Page. Omit to use the default pairing. Requires WHATSAPP destinationType or WHATSAPP_MESSAGE callToAction.
34717
+ * Meta WhatsApp only. E.164 number already paired with the Page. Omit to use the default pairing. Requires WHATSAPP_MESSAGE callToAction. Stored as creative.whatsappPhoneNumber on the ad.
34714
34718
  */
34715
34719
  whatsappPhoneNumber?: string;
34716
34720
  /**
@@ -34968,7 +34972,7 @@ type BoostPostData = {
34968
34972
  */
34969
34973
  leadGenFormId?: string;
34970
34974
  /**
34971
- * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
34975
+ * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On Meta a new campaign stays paused until explicitly activated; an attached ad is itself paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
34972
34976
  */
34973
34977
  status?: 'ACTIVE' | 'PAUSED';
34974
34978
  /**
package/dist/index.d.ts CHANGED
@@ -1820,6 +1820,10 @@ type Ad = {
1820
1820
  * Destination URL
1821
1821
  */
1822
1822
  linkUrl?: string;
1823
+ /**
1824
+ * Explicit E.164 WhatsApp number supplied when creating a Meta boost or messaging ad. Absent when omitted by the caller or on older records.
1825
+ */
1826
+ whatsappPhoneNumber?: string;
1823
1827
  pinterestImageUrl?: string;
1824
1828
  pinterestTitle?: string;
1825
1829
  pinterestDescription?: string;
@@ -4211,7 +4215,7 @@ type CtwaAdRequestBody = {
4211
4215
  */
4212
4216
  objectStoryId?: string;
4213
4217
  /**
4214
- * WhatsApp only. Optional E.164 number already paired with the Facebook Page. Omit to let Meta select the paired number. Sent to the creative CTA and, when creating a new ad set, its promoted_object. Attach requests do not change the existing ad set.
4218
+ * WhatsApp only. Optional E.164 number already paired with the Facebook Page. Omit to let Meta select the paired number. Sent to the creative CTA and, when creating a new ad set, its promoted_object. Attach requests do not change the existing ad set. Stored as creative.whatsappPhoneNumber on every created ad.
4215
4219
  */
4216
4220
  whatsappPhoneNumber?: string;
4217
4221
  /**
@@ -34706,11 +34710,11 @@ type BoostPostData = {
34706
34710
  */
34707
34711
  instagramAccountId?: string;
34708
34712
  /**
34709
- * Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Messaging destinations imply their matching CTA and require goal engagement. Lead ads use ON_AD; combining an instant form with a messaging destination is rejected.
34713
+ * Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Independent of plain link CTAs and their goal. A messaging callToAction selects its destination automatically; an explicit destinationType must then match. Lead ads use ON_AD.
34710
34714
  */
34711
34715
  destinationType?: 'INSTAGRAM_PROFILE' | 'WEBSITE' | 'ON_AD' | 'MESSENGER' | 'WHATSAPP' | 'INSTAGRAM_DIRECT';
34712
34716
  /**
34713
- * Meta WhatsApp only. E.164 number already paired with the Page. Omit to use the default pairing. Requires WHATSAPP destinationType or WHATSAPP_MESSAGE callToAction.
34717
+ * Meta WhatsApp only. E.164 number already paired with the Page. Omit to use the default pairing. Requires WHATSAPP_MESSAGE callToAction. Stored as creative.whatsappPhoneNumber on the ad.
34714
34718
  */
34715
34719
  whatsappPhoneNumber?: string;
34716
34720
  /**
@@ -34968,7 +34972,7 @@ type BoostPostData = {
34968
34972
  */
34969
34973
  leadGenFormId?: string;
34970
34974
  /**
34971
- * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
34975
+ * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On Meta a new campaign stays paused until explicitly activated; an attached ad is itself paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
34972
34976
  */
34973
34977
  status?: 'ACTIVE' | 'PAUSED';
34974
34978
  /**
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@zernio/node",
39
- version: "0.2.729",
39
+ version: "0.2.730",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@zernio/node",
8
- version: "0.2.729",
8
+ version: "0.2.730",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zernio/node",
3
- "version": "0.2.729",
3
+ "version": "0.2.730",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -9516,7 +9516,9 @@ export const getDsaRecommendations = <ThrowOnError extends boolean = false>(opti
9516
9516
  * **Messaging boosts (Meta).** Use `goal: engagement` with
9517
9517
  * `callToAction: WHATSAPP_MESSAGE`, `MESSAGE_PAGE`, or `INSTAGRAM_MESSAGE`.
9518
9518
  * The CTA implies WHATSAPP, MESSENGER, or INSTAGRAM_DIRECT respectively;
9519
- * `destinationType` alone also selects the matching CTA. Omit `linkUrl`.
9519
+ * `destinationType` alone does not select a messaging CTA. Omit `linkUrl`
9520
+ * only for messaging CTAs. Plain link CTAs keep their goal and link behavior
9521
+ * when combined with an independent `destinationType`.
9520
9522
  * The campaign uses OUTCOME_ENGAGEMENT and the ad set uses CONVERSATIONS
9521
9523
  * with the promoted Page. Optional `whatsappPhoneNumber` selects a number
9522
9524
  * already paired with that Page. Conflicting CTA/destination, instant form,
@@ -338,6 +338,10 @@ export type Ad = {
338
338
  * Destination URL
339
339
  */
340
340
  linkUrl?: string;
341
+ /**
342
+ * Explicit E.164 WhatsApp number supplied when creating a Meta boost or messaging ad. Absent when omitted by the caller or on older records.
343
+ */
344
+ whatsappPhoneNumber?: string;
341
345
  pinterestImageUrl?: string;
342
346
  pinterestTitle?: string;
343
347
  pinterestDescription?: string;
@@ -2835,7 +2839,7 @@ export type CtwaAdRequestBody = {
2835
2839
  */
2836
2840
  objectStoryId?: string;
2837
2841
  /**
2838
- * WhatsApp only. Optional E.164 number already paired with the Facebook Page. Omit to let Meta select the paired number. Sent to the creative CTA and, when creating a new ad set, its promoted_object. Attach requests do not change the existing ad set.
2842
+ * WhatsApp only. Optional E.164 number already paired with the Facebook Page. Omit to let Meta select the paired number. Sent to the creative CTA and, when creating a new ad set, its promoted_object. Attach requests do not change the existing ad set. Stored as creative.whatsappPhoneNumber on every created ad.
2839
2843
  */
2840
2844
  whatsappPhoneNumber?: string;
2841
2845
  /**
@@ -35309,11 +35313,11 @@ export type BoostPostData = {
35309
35313
  */
35310
35314
  instagramAccountId?: string;
35311
35315
  /**
35312
- * Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Messaging destinations imply their matching CTA and require goal engagement. Lead ads use ON_AD; combining an instant form with a messaging destination is rejected.
35316
+ * Meta only. Ad-set destination_type: where the click LANDS, as opposed to instagramAccountId which is who the ad runs as. Independent of plain link CTAs and their goal. A messaging callToAction selects its destination automatically; an explicit destinationType must then match. Lead ads use ON_AD.
35313
35317
  */
35314
35318
  destinationType?: 'INSTAGRAM_PROFILE' | 'WEBSITE' | 'ON_AD' | 'MESSENGER' | 'WHATSAPP' | 'INSTAGRAM_DIRECT';
35315
35319
  /**
35316
- * Meta WhatsApp only. E.164 number already paired with the Page. Omit to use the default pairing. Requires WHATSAPP destinationType or WHATSAPP_MESSAGE callToAction.
35320
+ * Meta WhatsApp only. E.164 number already paired with the Page. Omit to use the default pairing. Requires WHATSAPP_MESSAGE callToAction. Stored as creative.whatsappPhoneNumber on the ad.
35317
35321
  */
35318
35322
  whatsappPhoneNumber?: string;
35319
35323
  /**
@@ -35571,7 +35575,7 @@ export type BoostPostData = {
35571
35575
  */
35572
35576
  leadGenFormId?: string;
35573
35577
  /**
35574
- * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
35578
+ * Meta, TikTok, and LinkedIn. Publish state of the created entities. Omitted or ACTIVE publishes live (default); PAUSED creates them paused so you can review before they spend. On Meta a new campaign stays paused until explicitly activated; an attached ad is itself paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each).
35575
35579
  */
35576
35580
  status?: 'ACTIVE' | 'PAUSED';
35577
35581
  /**