siluzan-tso-cli 1.1.29-beta.3 → 1.1.29-beta.4

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.29-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.29-beta.4），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -112491,6 +112491,7 @@ async function runAdEdit(opts) {
 
 // src/commands/ad/extension.ts
 init_auth();
+import { readFileSync as readFileSync7 } from "fs";
 init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 
@@ -112606,6 +112607,101 @@ function buildLeadFormExtensionBody(cfg, extensionId) {
   return body;
 }
 
+// src/commands/ad/extension-whatsapp.ts
+import { readFileSync as readFileSync6 } from "fs";
+var VALID_WHATSAPP_CTA_SELECTIONS = [
+  "CONTACT_US",
+  "LEARN_MORE",
+  "GET_QUOTE",
+  "BOOK_NOW",
+  "SHOP_NOW",
+  "SIGN_UP"
+];
+function loadWhatsappExtensionConfig(configFile) {
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync6(configFile, "utf8"));
+  } catch {
+    console.error(`
+\u274C \u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6\u5931\u8D25\uFF08${configFile}\uFF09
+`);
+    process.exit(1);
+  }
+  const cfg = stripMetaKeys(raw);
+  const result = validateWhatsappExtensionConfig(cfg);
+  if (!result.ok) {
+    console.error("\n\u274C WhatsApp \u914D\u7F6E\u6821\u9A8C\u5931\u8D25\uFF1A\n");
+    for (const e of result.errors) console.error(`  - ${e}`);
+    console.error();
+    process.exit(1);
+  }
+  return cfg;
+}
+function validateBusinessMessagePayload(bm, prefix = "businessMessage") {
+  const errors = [];
+  if (!bm || typeof bm !== "object") {
+    errors.push(`${prefix} \u5BF9\u8C61\u4E0D\u80FD\u4E3A\u7A7A`);
+    return errors;
+  }
+  if (!bm.starterMessage?.trim()) {
+    errors.push(`${prefix}.starterMessage \u4E0D\u80FD\u4E3A\u7A7A`);
+  }
+  const provider = (bm.messageProvider?.trim() || "WHATSAPP").toUpperCase();
+  if (provider !== "WHATSAPP") {
+    errors.push(`${prefix}.messageProvider \u5F53\u524D\u4EC5\u652F\u6301 WHATSAPP`);
+  }
+  const cta = bm.callToActionSelection?.trim();
+  if (cta && !VALID_WHATSAPP_CTA_SELECTIONS.includes(cta.toUpperCase())) {
+    errors.push(
+      `${prefix}.callToActionSelection \u65E0\u6548\uFF1A${cta}\uFF1B\u652F\u6301 ${VALID_WHATSAPP_CTA_SELECTIONS.join(", ")}`
+    );
+  }
+  const wa = bm.whatsapp;
+  if (!wa?.countryCode?.trim()) {
+    errors.push(`${prefix}.whatsapp.countryCode \u4E0D\u80FD\u4E3A\u7A7A\uFF08\u5982 US\u3001CN\uFF09`);
+  }
+  if (!wa?.phoneNumber?.trim()) {
+    errors.push(`${prefix}.whatsapp.phoneNumber \u4E0D\u80FD\u4E3A\u7A7A\uFF08WhatsApp Business \u6CE8\u518C\u53F7\u7801\uFF09`);
+  }
+  return errors;
+}
+function validateWhatsappExtensionConfig(cfg) {
+  const errors = [];
+  if (!cfg.account?.trim()) errors.push("account\uFF08\u5A92\u4F53\u5BA2\u6237 ID\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
+  if (!cfg.campaignId?.trim()) errors.push("campaignId\uFF08PMax \u6D3B\u52A8 ID\uFF09\u4E0D\u80FD\u4E3A\u7A7A");
+  errors.push(...validateBusinessMessagePayload(cfg.businessMessage, "businessMessage"));
+  return { ok: errors.length === 0, errors };
+}
+function buildBusinessMessageExtensionBody(cfg, extensionId) {
+  const bm = cfg.businessMessage;
+  const body = {
+    activeuseridg: cfg.account,
+    campaignId: cfg.campaignId,
+    level: "Campaign",
+    typeV2: "BUSINESS_MESSAGE",
+    assetFieldType: "BUSINESS_MESSAGE",
+    businessMessage: {
+      messageProvider: (bm.messageProvider?.trim() || "WHATSAPP").toUpperCase(),
+      starterMessage: bm.starterMessage.trim(),
+      callToActionSelection: (bm.callToActionSelection?.trim() || "CONTACT_US").toUpperCase(),
+      callToActionDescription: bm.callToActionDescription?.trim() || "Message us on WhatsApp",
+      whatsapp: {
+        countryCode: bm.whatsapp.countryCode.trim(),
+        phoneNumber: bm.whatsapp.phoneNumber.trim()
+      }
+    }
+  };
+  if (extensionId) body["id"] = extensionId;
+  return body;
+}
+function buildBusinessMessageBodyForCampaign(accountId, campaignId, bm) {
+  return buildBusinessMessageExtensionBody({
+    account: accountId,
+    campaignId,
+    businessMessage: bm
+  });
+}
+
 // src/commands/ad/extension.ts
 async function runAdExtensionList(opts) {
   const config = loadConfig(opts.token);
@@ -112671,6 +112767,12 @@ async function runAdExtensionList(opts) {
     } else if (type === "LEAD_FORM") {
       const lf = item["leadForm"];
       if (lf) detail = `\u300C${lf["headline"] ?? ""}\u300D business=${lf["businessName"] ?? ""}`;
+    } else if (type === "BUSINESS_MESSAGE") {
+      const bm = item["businessMessage"];
+      if (bm) {
+        const wa = bm["whatsapp"];
+        detail = `\u300C${bm["starterMessage"] ?? ""}\u300D +${wa?.["countryCode"] ?? ""}${wa?.["phoneNumber"] ?? ""}`;
+      }
     }
     const camp = item["campaignId"] ? `  campaign:${item["campaignId"]}` : "";
     console.log(`  [${type}] id:${id}  level:${level}${camp}  ${detail}`);
@@ -112808,11 +112910,13 @@ async function runAdExtensionPmaxTypes(opts) {
   }
   const levels = obj["supportedLevels"]?.join(", ") ?? "";
   const lfLevels = obj["leadFormSupportedLevels"]?.join(", ") ?? "";
+  const bmLevels = obj["businessMessageSupportedLevels"]?.join(", ") ?? "";
   console.log(`
   \u652F\u6301\u5C42\u7EA7\uFF1A${levels}`);
   console.log(`  Lead Form \u5C42\u7EA7\uFF1A${lfLevels}`);
+  console.log(`  WhatsApp\uFF08BUSINESS_MESSAGE\uFF09\u5C42\u7EA7\uFF1A${bmLevels}`);
   console.log("  \u4E0D\u652F\u6301\uFF1AAd Group\uFF08PMax \u4F1A 400\uFF09");
-  console.log("  WhatsApp\uFF1A\u540E\u7AEF\u5C1A\u672A\u5F00\u653E\uFF08\u540E\u7EED\u9636\u6BB5\uFF09\n");
+  console.log("  WhatsApp \u9700 Google API \u767D\u540D\u5355\uFF08\u672A\u5F00\u901A\u4F1A CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS\uFF09\n");
 }
 async function runAdExtensionSnippetHeaders(opts) {
   const config = loadConfig(opts.token);
@@ -112905,15 +113009,98 @@ async function runAdExtensionLeadFormCreate(opts) {
     "\u63D0\u793A\uFF1A\u521B\u5EFA\u6210\u529F\u540E\u540E\u7AEF\u4F1A\u81EA\u52A8\u5C1D\u8BD5\u5F00\u542F SUBMIT_LEAD_FORM + GOOGLE_HOSTED \u8F6C\u5316\u76EE\u6807\uFF08biddable=true\uFF09\u3002\n"
   );
 }
-async function runAdExtensionUpdate(opts) {
+async function runAdExtensionWhatsappCreate(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const cfg = loadLeadFormExtensionConfig(opts.configFile);
-  if (opts.account !== cfg.account) {
+  if (!opts.configFile) {
+    console.error(
+      "\n\u274C WhatsApp \u987B\u4F7F\u7528 --config-file\uFF08\u6A21\u677F\u89C1 assets/pmax-whatsapp-template.json\uFF09\n"
+    );
+    process.exit(1);
+  }
+  const cfg = loadWhatsappExtensionConfig(opts.configFile);
+  if (opts.account && opts.account !== cfg.account) {
     console.error("\n\u274C --account \u4E0E\u914D\u7F6E\u6587\u4EF6 account \u4E0D\u4E00\u81F4\n");
     process.exit(1);
   }
-  const body = buildLeadFormExtensionBody(cfg, opts.id);
+  if (opts.campaignId && opts.campaignId !== cfg.campaignId) {
+    console.error("\n\u274C --campaign-id \u4E0E\u914D\u7F6E\u6587\u4EF6 campaignId \u4E0D\u4E00\u81F4\n");
+    process.exit(1);
+  }
+  const body = buildBusinessMessageExtensionBody(cfg);
+  const url = `${googleApiUrl}/extensionmanagement/extension/${cfg.account}`;
+  let response;
+  try {
+    response = await apiFetch2(
+      url,
+      config,
+      { method: "POST", body: JSON.stringify(body) },
+      opts.verbose
+    );
+  } catch (err) {
+    console.error(`
+\u274C \u521B\u5EFA WhatsApp \u6269\u5C55\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  if (await emitCliJsonOrSnapshot(opts, {
+    section: `ad-extension-whatsapp-${cfg.account}`,
+    commandLabel: "ad extension whatsapp",
+    commandHint: `${cfg.account}:${cfg.campaignId}`,
+    payload: response,
+    idSuffix: cfg.campaignId
+  })) {
+    return;
+  }
+  const resObj = response ?? {};
+  const extId = resObj["id"];
+  console.log(
+    `
+\u2705 PMax WhatsApp \u5DF2\u521B\u5EFA\uFF08campaignId: ${cfg.campaignId}${extId ? `\uFF0Cid: ${extId}` : ""}\uFF09
+`
+  );
+  console.log(
+    "\u63D0\u793A\uFF1A\u8D26\u6237\u987B\u5DF2\u5F00\u901A Google Business Message API \u767D\u540D\u5355\uFF1B\u540C Campaign \u4EC5 1 \u4E2A ENABLED WhatsApp\u3002\n"
+  );
+}
+function detectExtensionUpdateKind(raw) {
+  if (raw["businessMessage"] != null) return "whatsapp";
+  if (raw["leadForm"] != null) return "lead-form";
+  console.error("\n\u274C \u914D\u7F6E\u6587\u4EF6\u987B\u542B leadForm \u6216 businessMessage \u5BF9\u8C61\n");
+  process.exit(1);
+}
+async function runAdExtensionUpdate(opts) {
+  const config = loadConfig(opts.token);
+  const googleApiUrl = requireGoogleApi(config);
+  let raw;
+  try {
+    raw = stripMetaKeys(JSON.parse(readFileSync7(opts.configFile, "utf8")));
+  } catch {
+    console.error(`
+\u274C \u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6\u5931\u8D25\uFF08${opts.configFile}\uFF09
+`);
+    process.exit(1);
+  }
+  const kind = detectExtensionUpdateKind(raw);
+  let body;
+  let commandLabel;
+  if (kind === "whatsapp") {
+    const cfg = loadWhatsappExtensionConfig(opts.configFile);
+    if (opts.account !== cfg.account) {
+      console.error("\n\u274C --account \u4E0E\u914D\u7F6E\u6587\u4EF6 account \u4E0D\u4E00\u81F4\n");
+      process.exit(1);
+    }
+    body = buildBusinessMessageExtensionBody(cfg, opts.id);
+    commandLabel = "ad extension update (whatsapp)";
+  } else {
+    const cfg = loadLeadFormExtensionConfig(opts.configFile);
+    if (opts.account !== cfg.account) {
+      console.error("\n\u274C --account \u4E0E\u914D\u7F6E\u6587\u4EF6 account \u4E0D\u4E00\u81F4\n");
+      process.exit(1);
+    }
+    body = buildLeadFormExtensionBody(cfg, opts.id);
+    commandLabel = "ad extension update (lead-form)";
+  }
   const url = `${googleApiUrl}/extensionmanagement/extension/${opts.account}/${opts.id}`;
   let response;
   try {
@@ -112931,16 +113118,24 @@ async function runAdExtensionUpdate(opts) {
   }
   if (await emitCliJsonOrSnapshot(opts, {
     section: `ad-extension-update-${opts.account}`,
-    commandLabel: "ad extension update",
+    commandLabel,
     commandHint: `${opts.account}:${opts.id}`,
     payload: response,
     idSuffix: opts.id
   })) {
     return;
   }
-  console.log(`
+  const resObj = response ?? {};
+  const newId = resObj["id"];
+  if (kind === "whatsapp" && newId && newId !== opts.id) {
+    console.log(`
+\u2705 WhatsApp \u5DF2\u66F4\u65B0\uFF08\u65B0 asset id: ${newId}\uFF0C\u65E7 id ${opts.id} \u5DF2\u5931\u6548\uFF09
+`);
+  } else {
+    console.log(`
 \u2705 \u9644\u52A0\u4FE1\u606F ${opts.id} \u5DF2\u66F4\u65B0
 `);
+  }
 }
 
 // src/commands/ad/search-terms.ts
@@ -114890,7 +115085,7 @@ async function runPmaxImageValidation(configFile, cfg) {
 // src/commands/ad/pmax-image-resolve.ts
 init_auth();
 import { basename as basename4, dirname as dirname8, isAbsolute as isAbsolute3, resolve as resolve7 } from "path";
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync8 } from "fs";
 
 // src/commands/ad/pmax-urls.ts
 function pmaxChannelTypesUrl(googleApiUrl) {
@@ -115047,7 +115242,7 @@ async function uploadPmaxImageFileBase64(config, googleApiUrl, accountId, absIma
 async function uploadPmaxImageFile(config, googleApiUrl, accountId, absImagePath, name2, verbose) {
   const fileName = basename4(absImagePath);
   const assetName = (name2 ?? fileName).trim() || fileName;
-  const fileBuffer = readFileSync6(absImagePath);
+  const fileBuffer = readFileSync8(absImagePath);
   if (fileBuffer.length <= MAX_BASE64_UPLOAD_BYTES) {
     return uploadPmaxImageFileBase64(
       config,
@@ -115133,7 +115328,7 @@ function assertPmaxImageSlotsResolved(slots) {
 }
 
 // src/commands/ad/pmax-load.ts
-import { readFileSync as readFileSync7 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 function loadPmaxCreateConfig(configFile) {
   const cfg = tryLoadPmaxCreateConfig(configFile);
   if (!cfg) {
@@ -115204,7 +115399,7 @@ function detectDeprecatedPmaxVideoKeys(raw) {
 function tryLoadPmaxCreateConfig(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync7(configFile, "utf8"));
+    raw = JSON.parse(readFileSync9(configFile, "utf8"));
   } catch {
     return null;
   }
@@ -115212,7 +115407,7 @@ function tryLoadPmaxCreateConfig(configFile) {
 }
 function loadPmaxCreateConfigRaw(configFile) {
   try {
-    const raw = JSON.parse(readFileSync7(configFile, "utf8"));
+    const raw = JSON.parse(readFileSync9(configFile, "utf8"));
     return stripMetaKeys(raw);
   } catch {
     return null;
@@ -115260,19 +115455,19 @@ function buildPmaxCreateUrl(googleApiUrl, accountId) {
 }
 
 // src/commands/ad/pmax-video-upload.ts
-import { existsSync as existsSync3, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync11 } from "fs";
 import { basename as basename5, dirname as dirname10, isAbsolute as isAbsolute5, resolve as resolve9 } from "path";
 
 // src/commands/ad/pmax-shared.ts
 init_auth();
 init_cli_json_snapshot();
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 import { dirname as dirname9, isAbsolute as isAbsolute4, resolve as resolve8 } from "path";
 var PMAX_MONEY_KEYS = /* @__PURE__ */ new Set(["budget", "targetCpa_BidingAmount"]);
 function loadPmaxJsonFile(configFile) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync8(configFile, "utf8"));
+    raw = JSON.parse(readFileSync10(configFile, "utf8"));
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     console.error(`
@@ -115459,7 +115654,7 @@ function runPmaxVideoValidation(configFile, cfg) {
     return { errors, warnings };
   }
   try {
-    const buf = readFileSync9(abs);
+    const buf = readFileSync11(abs);
     if (buf.length === 0) errors.push(`videoPath \u4E3A\u7A7A\u6587\u4EF6\uFF1A${abs}`);
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
@@ -115522,7 +115717,7 @@ async function uploadPmaxLocalVideo(opts) {
   const fileName = basename5(opts.absVideoPath);
   const title = (opts.title ?? fileName).trim() || fileName;
   const description = (opts.description ?? "Uploaded via siluzan-tso PMax video upload").trim() || "Uploaded via siluzan-tso";
-  const fileBuffer = readFileSync9(opts.absVideoPath);
+  const fileBuffer = readFileSync11(opts.absVideoPath);
   const form = new FormData();
   form.append("media_account_id", opts.accountId.replace(/-/g, ""));
   form.append("title", title);
@@ -115578,7 +115773,7 @@ function validatePmaxVideoPathQuick(absPath) {
     return `\u89C6\u9891\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${absPath}`;
   }
   try {
-    if (readFileSync9(absPath).length === 0) return `\u89C6\u9891\u6587\u4EF6\u4E3A\u7A7A\uFF1A${absPath}`;
+    if (readFileSync11(absPath).length === 0) return `\u89C6\u9891\u6587\u4EF6\u4E3A\u7A7A\uFF1A${absPath}`;
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     return `\u65E0\u6CD5\u8BFB\u53D6\u89C6\u9891\u6587\u4EF6\uFF08${absPath}\uFF09\uFF1A${msg}`;
@@ -115677,9 +115872,17 @@ function validatePmaxCampaignExtensions(ext) {
     const lfErrors = validateLeadFormPayload(ext.leadForm, "campaignExtensions.leadForm");
     errors.push(...lfErrors);
   }
-  if (callouts.length === 0 && snippets.length === 0 && !ext.leadForm) {
+  if (ext.businessMessage) {
+    errors.push(
+      ...validateBusinessMessagePayload(ext.businessMessage, "campaignExtensions.businessMessage")
+    );
+    warnings.push(
+      "WhatsApp\uFF08BUSINESS_MESSAGE\uFF09\u9700 Google API \u767D\u540D\u5355\uFF1B\u672A\u5F00\u901A\u4F1A\u8FD4\u56DE CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS"
+    );
+  }
+  if (callouts.length === 0 && snippets.length === 0 && !ext.leadForm && !ext.businessMessage) {
     warnings.push(
-      "campaignExtensions \u5DF2\u58F0\u660E\u4F46 callouts / structuredSnippets / leadForm \u5747\u4E3A\u7A7A\uFF0C\u521B\u5EFA\u65F6\u5C06\u8DF3\u8FC7\u9644\u52A0\u8D44\u4EA7"
+      "campaignExtensions \u5DF2\u58F0\u660E\u4F46 callouts / structuredSnippets / leadForm / businessMessage \u5747\u4E3A\u7A7A\uFF0C\u521B\u5EFA\u65F6\u5C06\u8DF3\u8FC7\u9644\u52A0\u8D44\u4EA7"
     );
   }
   return { errors, warnings };
@@ -115690,7 +115893,7 @@ function hasExtensionsToAttach(ext) {
   const hasSnippets = (ext.structuredSnippets ?? []).some(
     (s) => s?.header?.trim() && (s.values ?? []).some((v) => v?.trim())
   );
-  return hasCallouts || hasSnippets || Boolean(ext.leadForm);
+  return hasCallouts || hasSnippets || Boolean(ext.leadForm) || Boolean(ext.businessMessage);
 }
 async function postExtension(config, googleApiUrl, accountId, body, verbose) {
   const url = `${googleApiUrl}/extensionmanagement/extension/${accountId}`;
@@ -115817,6 +116020,32 @@ async function attachPmaxCampaignExtensions(opts) {
       result.leadForm = { ok: false, error: posted.error, label: headline };
     }
   }
+  if (ext.businessMessage) {
+    const label = ext.businessMessage.starterMessage?.trim().slice(0, 40) || "WhatsApp";
+    if (opts.logProgress) console.log(`
+   \u6302\u8F7D WhatsApp \u79C1\u4FE1\uFF1A${label}`);
+    const posted = await postExtension(
+      opts.config,
+      opts.googleApiUrl,
+      opts.accountId,
+      buildBusinessMessageBodyForCampaign(
+        opts.accountId,
+        opts.campaignId,
+        ext.businessMessage
+      ),
+      opts.verbose
+    );
+    if (posted.ok) {
+      result.whatsapp = {
+        ok: true,
+        id: String(posted.data["id"] ?? ""),
+        label
+      };
+    } else {
+      result.allOk = false;
+      result.whatsapp = { ok: false, error: posted.error, label };
+    }
+  }
   return result;
 }
 function formatPmaxExtensionsAttachErrors(result) {
@@ -115830,6 +116059,9 @@ function formatPmaxExtensionsAttachErrors(result) {
   if (result.leadForm && !result.leadForm.ok) {
     msgs.push(`\u6F5C\u5728\u5BA2\u6237\u8868\u5355\u300C${result.leadForm.label}\u300D\u5931\u8D25\uFF1A${result.leadForm.error}`);
   }
+  if (result.whatsapp && !result.whatsapp.ok) {
+    msgs.push(`WhatsApp\u300C${result.whatsapp.label}\u300D\u5931\u8D25\uFF1A${result.whatsapp.error}`);
+  }
   return msgs;
 }
 
@@ -115993,7 +116225,7 @@ async function runAdPmaxCreate(opts) {
       `   \u53EF\u624B\u52A8\u8865\u6302\uFF1Asiluzan-tso ad extension callout|snippet|lead-form -a ${accountId} --campaign-id ${campaignId} \u2026
 `
     );
-  } else if (extensionsResult?.allOk && extensionsResult.callouts.length + extensionsResult.structuredSnippets.length + (extensionsResult.leadForm ? 1 : 0) > 0) {
+  } else if (extensionsResult?.allOk && extensionsResult.callouts.length + extensionsResult.structuredSnippets.length + (extensionsResult.leadForm ? 1 : 0) + (extensionsResult.whatsapp ? 1 : 0) > 0) {
     if (!opts.jsonOut) {
       console.log("\n\u2705 Campaign \u9644\u52A0\u8D44\u4EA7\u5DF2\u6302\u8F7D");
     }
@@ -116895,7 +117127,7 @@ async function runAdCampaignValidate(opts) {
 }
 
 // src/commands/ad/pmax-image-convert.ts
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync5, readFileSync as readFileSync10, existsSync as existsSync4 } from "fs";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync5, readFileSync as readFileSync12, existsSync as existsSync4 } from "fs";
 import { resolve as resolve10, dirname as dirname11, basename as basename7, extname } from "path";
 var SPECS = [
   { kind: "marketing", width: 1200, height: 628, fit: "cover", suffix: "_marketing" },
@@ -116986,7 +117218,7 @@ async function runAdPmaxImageConvert(opts) {
   if (opts.updateConfig) {
     const configPath = resolve10(opts.updateConfig);
     try {
-      const raw = JSON.parse(readFileSync10(configPath, "utf8"));
+      const raw = JSON.parse(readFileSync12(configPath, "utf8"));
       const imgPaths = raw["imagePaths"] ?? {};
       if (outputPaths.marketing) imgPaths["marketing"] = outputPaths.marketing;
       if (outputPaths.square) imgPaths["square"] = outputPaths.square;
@@ -117834,7 +118066,7 @@ function register20(program2) {
   );
   extensionCmd.command("list").description("\u67E5\u8BE2\u9644\u52A0\u4FE1\u606F\u5217\u8868").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").option(
     "--type <type>",
-    "\u6309\u7C7B\u578B\u7B5B\u9009\uFF1ASITELINK | CALL | CALLOUT | STRUCTURED_SNIPPET | LEAD_FORM"
+    "\u6309\u7C7B\u578B\u7B5B\u9009\uFF1ASITELINK | CALL | CALLOUT | STRUCTURED_SNIPPET | LEAD_FORM | BUSINESS_MESSAGE"
   ).option("--campaign-id <id>", "\u6309\u5E7F\u544A\u7CFB\u5217 ID \u7B5B\u9009\uFF08PMax Campaign \u7EA7\u6269\u5C55\uFF09").option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF1B\u76EE\u5F55\u6A21\u5F0F\u6587\u4EF6\u540D\u4E3A `<section>[-<\u67E5\u8BE2id>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09",
@@ -117869,7 +118101,27 @@ function register20(program2) {
       });
     }
   );
-  extensionCmd.command("update").description("\u66F4\u65B0\u9644\u52A0\u4FE1\u606F\uFF08\u5F53\u524D\u652F\u6301 LEAD_FORM\uFF1BPUT \u5168\u91CF\u66FF\u6362 leadForm \u5BF9\u8C61\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <extensionId>", "\u9644\u52A0\u4FE1\u606F ID\uFF08\u5148 ad extension list \u67E5\u8BE2\uFF09").requiredOption("--config-file <path>", "Lead Form JSON \u914D\u7F6E").option("-t, --token <token>", "Auth Token").option(
+  extensionCmd.command("whatsapp").description(
+    "\u4E3A PMax \u6D3B\u52A8\u6DFB\u52A0 WhatsApp \u79C1\u4FE1\uFF08BUSINESS_MESSAGE\uFF1B\u987B --config-file\uFF1B\u9700 Google API \u767D\u540D\u5355\uFF09\n  \u6A21\u677F\uFF1Aassets/pmax-whatsapp-template.json"
+  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--config-file <path>", "WhatsApp JSON \u914D\u7F6E\uFF08\u89C1 pmax-whatsapp-template.json\uFF09").option("--campaign-id <id>", "\u8986\u76D6\u914D\u7F6E\u6587\u4EF6\u4E2D\u7684 campaignId").option("-t, --token <token>", "Auth Token").option(
+    "--json-out <path>",
+    "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json",
+    void 0
+  ).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runAdExtensionWhatsappCreate({
+        token: opts.token,
+        account: opts.account,
+        campaignId: opts.campaignId,
+        configFile: opts.configFile,
+        jsonOut: opts.jsonOut,
+        verbose: opts.verbose
+      });
+    }
+  );
+  extensionCmd.command("update").description(
+    "\u66F4\u65B0\u9644\u52A0\u4FE1\u606F\uFF08LEAD_FORM \u6216 WhatsApp\uFF1B\u914D\u7F6E\u6587\u4EF6\u542B leadForm / businessMessage\uFF1BWhatsApp PUT \u540E id \u4F1A\u53D8\uFF09"
+  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <extensionId>", "\u9644\u52A0\u4FE1\u606F ID\uFF08\u5148 ad extension list \u67E5\u8BE2\uFF09").requiredOption("--config-file <path>", "Lead Form JSON \u914D\u7F6E").option("-t, --token <token>", "Auth Token").option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json",
     void 0

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.29-beta.3",
-  "publishedAt": 1781073977455
+  "version": "1.1.29-beta.4",
+  "publishedAt": 1781076395156
 }

package/dist/skill/assets/pmax-create-template.json

@@ -61,6 +61,15 @@
         { "inputType": "EMAIL" },
         { "inputType": "PHONE_NUMBER" }
       ]
+    },
+    "businessMessage": {
+      "starterMessage": "Hi! How can we help you today?",
+      "callToActionSelection": "CONTACT_US",
+      "callToActionDescription": "Message us on WhatsApp",
+      "whatsapp": {
+        "countryCode": "US",
+        "phoneNumber": "2125550100"
+      }
     }
   }
 }

package/dist/skill/assets/pmax-create-template.md

@@ -81,8 +81,9 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 | `callouts` | string[] | 宣传信息（CALLOUT），每条 ≤25 字符，各创建 1 个扩展 |
 | `structuredSnippets` | object[] | `{ header, values }`；`values` 至少 3 项 |
 | `leadForm` | object | 潜在客户表单；字段同 `pmax-lead-form-template.json` 的 `leadForm` |
+| `businessMessage` | object | WhatsApp 私信；字段同 `pmax-whatsapp-template.json` 的 `businessMessage` |
 
-标头可选值：`ad extension snippet-headers`。WhatsApp 尚未支持。
+标头可选值：`ad extension snippet-headers`。WhatsApp 需 Google API 白名单（见 `pmax-whatsapp-template.md`）。
 
 若挂载失败，活动仍已创建；`--json-out` 的 `campaignExtensions` 段含各条 `ok` / `error`，可手动 `ad extension *` 补挂。
 

package/dist/skill/assets/pmax-lead-form-template.json

@@ -8,7 +8,7 @@
       "勿在 pmax-create 流程内创建；先 pmax-create 再 ad extension lead-form",
       "每个 PMax 活动通常仅允许 1 个 Lead Form；创建前用 ad extension list --type LEAD_FORM --campaign-id 检查",
       "账户须在 Google Ads UI 接受 Lead Form ToS",
-      "WhatsApp 私信扩展后端尚未开放"
+      "WhatsApp 见 pmax-whatsapp-template.json 或 campaignExtensions.businessMessage"
     ]
   },
   "account": "REPLACE_mediaCustomerId",

package/dist/skill/assets/pmax-lead-form-template.md

@@ -54,7 +54,7 @@ siluzan-tso ad extension update -a <accountId> --id <extensionId> --config-file
 | 潜在客户表单 | `LEAD_FORM` | `ad extension lead-form` |
 | 附加链接 | `SITELINK` | `ad extension sitelink` |
 | 附加电话 | `CALL` | `ad extension call` |
-| 私信 WhatsApp | — | **后端尚未开放** |
+| 私信 WhatsApp | `BUSINESS_MESSAGE` | `ad extension whatsapp` 或 `campaignExtensions.businessMessage` |
 
 **层级**：PMax 仅 `Account` / `Campaign`；`Ad Group` 会 **400**。
 

package/dist/skill/assets/pmax-whatsapp-template.json

@@ -0,0 +1,26 @@
+{
+  "_meta": {
+    "schema": "pmax-whatsapp/v1",
+    "doc": "pmax-whatsapp-template.md",
+    "note": "以 _ 开头的键仅作说明，CLI 提交前会剥离",
+    "agentPitfalls": [
+      "BUSINESS_MESSAGE 仅支持 Campaign / Account 级；PMax 用 Campaign + campaignId",
+      "每 Campaign 仅 1 个 ENABLED WhatsApp；重复 POST 会 400，须 DELETE 或 PUT 更新",
+      "PUT 成功后 asset id 会变化，后续删除/更新须用响应中的新 id",
+      "账户须已开通 Google Business Message API 白名单，否则 CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS",
+      "勿与 pmax-create 同时挂 businessMessage 若活动上已有 WhatsApp"
+    ]
+  },
+  "account": "REPLACE_mediaCustomerId",
+  "campaignId": "REPLACE_pmaxCampaignId",
+  "businessMessage": {
+    "messageProvider": "WHATSAPP",
+    "starterMessage": "Hi! How can we help you today?",
+    "callToActionSelection": "CONTACT_US",
+    "callToActionDescription": "Message us on WhatsApp",
+    "whatsapp": {
+      "countryCode": "US",
+      "phoneNumber": "2125550100"
+    }
+  }
+}

package/dist/skill/assets/pmax-whatsapp-template.md

@@ -0,0 +1,45 @@
+# `ad extension whatsapp` JSON 配置说明
+
+为**已创建的 PMax 活动**挂载 WhatsApp 私信（`BUSINESS_MESSAGE`）。也可写入 `pmax-create` JSON 的 `campaignExtensions.businessMessage` 由 CLI 自动编排。
+
+模板：`pmax-whatsapp-template.json`。
+
+---
+
+## 命令
+
+```bash
+# 单独挂载
+siluzan-tso ad extension whatsapp -a <accountId> --config-file ./whatsapp.json --json-out ./snap
+
+# 更新（PUT 后 id 会变，用响应新 id）
+siluzan-tso ad extension update -a <accountId> --id <extensionId> --config-file ./whatsapp.json
+
+# 或在 pmax-create 一并挂载
+# campaignExtensions.businessMessage 见 pmax-create-template.md
+```
+
+---
+
+## 字段
+
+| 字段 | 必填 | 说明 |
+|------|:----:|------|
+| `account` | ✅ | Google 媒体客户 ID |
+| `campaignId` | ✅ | PMax 活动 ID |
+| `businessMessage.starterMessage` | ✅ | 欢迎语 |
+| `businessMessage.callToActionDescription` | | 默认 `Message us on WhatsApp` |
+| `businessMessage.callToActionSelection` | | 默认 `CONTACT_US`；可选 `LEARN_MORE`、`GET_QUOTE` 等 |
+| `businessMessage.messageProvider` | | 默认 `WHATSAPP` |
+| `businessMessage.whatsapp.countryCode` | ✅ | 两位国家码（如 `US`） |
+| `businessMessage.whatsapp.phoneNumber` | ✅ | WhatsApp Business 注册号码 |
+
+---
+
+## 前置条件
+
+1. **Google API 白名单**（阻塞项）：未开通返回 `CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS`；须 MCC 运营联系 Google AM 申请。
+2. 号码已在 **WhatsApp Business** 注册。
+3. 同 Campaign **仅 1 个** ENABLED WhatsApp；已有则 POST 400，须 DELETE 或 PUT。
+
+详见 Sammamish `pmax-frontend-api.md` §3.2.4。

package/dist/skill/references/core/cli-enums.md

@@ -68,8 +68,9 @@
 | 命令 | 选项 | 合法值 |
 | ---- | ---- | ------ |
 | ad extension sitelink, callout, snippet, … | --level | Account \| Campaign \| AdGroup |
-| ad extension list | --type | SITELINK \| CALL \| CALLOUT \| STRUCTURED_SNIPPET \| LEAD_FORM |
+| ad extension list | --type | SITELINK \| CALL \| CALLOUT \| STRUCTURED_SNIPPET \| LEAD_FORM \| BUSINESS_MESSAGE |
 | ad extension lead-form / update | --config-file | JSON（见 `assets/pmax-lead-form-template.json`） |
+| ad extension whatsapp / update | --config-file | JSON（见 `assets/pmax-whatsapp-template.json`） |
 
 
 ### 搜索系列 `BiddingStrategyTypeV2`

package/dist/skill/references/google-ads/google-ads.md

@@ -64,7 +64,7 @@
 | 改资产 | `ad pmax-assets-update --config-file …` |
 | YouTube 追加 | `ad pmax-youtube-link`（单条 `--youtube` / `--video-path`）；批量见 `ad pmax-assets-update` |
 | 信号 | `ad pmax-signals-get` / `ad pmax-signals-set`；受众下拉 `ad pmax-audiences` |
-| 附加资产 | `ad extension pmax-types`；`callout` / `snippet` / `lead-form`（见 `pmax-api.md` § 附加资产） |
+| 附加资产 | `ad extension pmax-types`；`callout` / `snippet` / `lead-form` / `whatsapp`（见 `pmax-api.md` § 附加资产） |
 | 图片库 | `ad pmax-image-upload` |
 | 报表 | `ad pmax-report-asset-groups` / `ad pmax-report-geo` |
 | 删活动 | `ad campaign-delete -a <id> --id <campaignId>`（与 Search 共用；勿用 `ad campaign-edit`） |
@@ -513,7 +513,7 @@ siluzan-tso ad keyword-negative-edit \
 
 ## ad extension — 附加信息管理
 
-Callout / Snippet / Sitelink / Call 等类型修改可**先删后建**；**Lead Form** 支持 `ad extension update`（PUT 全量替换 `leadForm`）。所有 `extension <type>` 子命令均支持 `--json-out`，输出网关返回的扩展对象（含 `id`），批量脚本可据此回填。
+Callout / Snippet / Sitelink / Call 等类型修改可**先删后建**；**Lead Form / WhatsApp** 支持 `ad extension update`（PUT；WhatsApp 成功后 **id 会变**）。所有 `extension <type>` 子命令均支持 `--json-out`，输出网关返回的扩展对象（含 `id`），批量脚本可据此回填。
 
 ```bash
 # PMax 支持的类型与层级（含 LEAD_FORM）
@@ -524,7 +524,7 @@ siluzan-tso ad extension snippet-headers [--json-out ./snap]
 
 # 查询
 siluzan-tso ad extension list -a <accountId> \
-  [--type SITELINK|CALL|CALLOUT|STRUCTURED_SNIPPET|LEAD_FORM] \
+  [--type SITELINK|CALL|CALLOUT|STRUCTURED_SNIPPET|LEAD_FORM|BUSINESS_MESSAGE] \
   [--campaign-id <campaignId>] [--json-out ./snap]
 
 # 附加链接
@@ -544,14 +544,17 @@ siluzan-tso ad extension snippet -a <accountId> --header "Brands" --values "A,B,
 # PMax 潜在客户表单（仅 Campaign 级；模板 assets/pmax-lead-form-template.json）
 siluzan-tso ad extension lead-form -a <accountId> --config-file ./lead-form.json [--json-out ./snap]
 
-# 更新 Lead Form
+# PMax WhatsApp 私信（BUSINESS_MESSAGE；需 Google API 白名单；模板 assets/pmax-whatsapp-template.json）
+siluzan-tso ad extension whatsapp -a <accountId> --config-file ./whatsapp.json [--json-out ./snap]
+
+# 更新 Lead Form 或 WhatsApp（配置文件含 leadForm / businessMessage；WhatsApp PUT 后 id 会变）
 siluzan-tso ad extension update -a <accountId> --id <extensionId> --config-file ./lead-form.json
 
 # 删除
 siluzan-tso ad extension delete -a <accountId> --id <extensionId>
 ```
 
-**PMax 约束**：仅 `Account` / `Campaign` 层级；`Ad Group` 会 400。`LEAD_FORM` 仅挂 Campaign。WhatsApp 私信扩展后端尚未开放。
+**PMax 约束**：仅 `Account` / `Campaign` 层级；`Ad Group` 会 400。`LEAD_FORM` 仅 Campaign。WhatsApp 每 Campaign 仅 1 个 ENABLED，须 Google API 白名单。
 
 `--header` 常用值：`Brands`/`Services`/`Amenities`/`Types`/`Styles`/`Courses`/`Models` 等（完整列表：`ad extension snippet-headers`）。
 

package/dist/skill/references/google-ads/pmax-api.md

@@ -30,7 +30,7 @@
 | `ad pmax-report-asset-groups` / `ad pmax-report-geo` | 报表 |
 | `ad campaigns` | 列表（筛 `PERFORMANCE_MAX`） |
 | `ad extension pmax-types` | PMax 支持的附加资产类型与层级 |
-| `ad extension callout` / `snippet` / `lead-form` | 宣传信息 / 结构化摘要 / 潜在客户表单 |
+| `ad extension callout` / `snippet` / `lead-form` / `whatsapp` | 宣传信息 / 结构化摘要 / 潜在客户表单 / WhatsApp |
 | `ad extension list` | 查询已挂载扩展（`--type` / `--campaign-id`） |
 
 模板：`assets/pmax-create-template.json`、`pmax-asset-group-template.json`、`pmax-assets-update-template.json`、`pmax-signals-template.json`、`pmax-patch-campaign-template.json`、`pmax-lead-form-template.json`。
@@ -46,7 +46,8 @@
   "campaignExtensions": {
     "callouts": ["Free shipping"],
     "structuredSnippets": [{ "header": "Services", "values": ["A", "B", "C"] }],
-    "leadForm": { "businessName": "...", "headline": "...", "description": "...", "privacyPolicyUrl": "...", "finalUrl": "...", "fields": [{ "inputType": "EMAIL" }] }
+    "leadForm": { "businessName": "...", "headline": "...", "description": "...", "privacyPolicyUrl": "...", "finalUrl": "...", "fields": [{ "inputType": "EMAIL" }] },
+    "businessMessage": { "starterMessage": "Hi!", "whatsapp": { "countryCode": "US", "phoneNumber": "2125550100" } }
   }
 }
 ```
@@ -61,7 +62,7 @@
 | 结构化摘要 | `STRUCTURED_SNIPPET` | `ad extension snippet -a <id> --header Brands --values "A,B,C" --level Campaign --campaign-id <cid>` |
 | 潜在客户表单 | `LEAD_FORM` | `ad extension lead-form -a <id> --config-file ./lead-form.json` |
 | 附加链接 / 电话 | `SITELINK` / `CALL` | `ad extension sitelink` / `call`（同上 `--level Campaign`） |
-| 私信 WhatsApp | — | **后端尚未开放**（后续阶段） |
+| 私信 WhatsApp | `BUSINESS_MESSAGE` | `ad extension whatsapp` 或 `campaignExtensions.businessMessage` |
 
 ```bash
 # 查 PMax 支持类型
@@ -73,15 +74,22 @@ siluzan-tso ad extension snippet-headers --json-out ./snap
 # Lead Form（模板见 assets/pmax-lead-form-template.md）
 siluzan-tso ad extension lead-form -a <accountId> --config-file ./lead-form.json --json-out ./snap
 
+# WhatsApp（模板见 assets/pmax-whatsapp-template.md；需 Google API 白名单）
+siluzan-tso ad extension whatsapp -a <accountId> --config-file ./whatsapp.json --json-out ./snap
+
 # 复核 / 更新 / 删除
 siluzan-tso ad extension list -a <accountId> --type LEAD_FORM --campaign-id <cid> --json-out ./snap
+siluzan-tso ad extension list -a <accountId> --type BUSINESS_MESSAGE --campaign-id <cid> --json-out ./snap
 siluzan-tso ad extension update -a <accountId> --id <extId> --config-file ./lead-form.json
+siluzan-tso ad extension update -a <accountId> --id <extId> --config-file ./whatsapp.json  # id 会变
 siluzan-tso ad extension delete -a <accountId> --id <extId>
 ```
 
 **约束**：
 - PMax **不支持** `level: Ad Group`（会 400）
 - `LEAD_FORM` **仅** `Campaign` 级；每活动通常 1 个
+- `BUSINESS_MESSAGE`（WhatsApp）每 Campaign **仅 1 个** ENABLED；须 **Google API 白名单**
+- WhatsApp **PUT 后 asset id 会变**；后续操作须用响应中的新 `id`
 - 创建 Lead Form 后后端自动尝试开启 `SUBMIT_LEAD_FORM` + `GOOGLE_HOSTED` 转化目标
 
 **网关**：`GET /extensionmanagement/pmaxSupportedTypeList`；`POST|PUT|DELETE /extensionmanagement/extension/{accountId}[/{id}]`（Sammamish `ExtensionManagementController.cs`）。

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.29-beta.3'
+$PKG_VERSION = '1.1.29-beta.4'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.29-beta.3"
+readonly PKG_VERSION="1.1.29-beta.4"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.29-beta.3",
+  "version": "1.1.29-beta.4",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",