@flowapt/flowiq-cli 0.7.4 → 0.7.5

package/README.md

@@ -455,8 +455,22 @@ instead of a CSV. Same guards, same status log, same resume:
 ```bash
 flowiq bc send <org_id> --tag july-promo-batch-01 --template fresh_drop_v1 \
   --body param1="Hi {{first_name}}" [--button param1=<short-code>] --commit
+
+# A template with TWO link buttons (v0.7.5), e.g. one per product: one --button per button,
+# in the order the buttons appear on the template.
+flowiq bc send <org_id> --tag new-arrivals-batch-01 --template new_arrivals_v3 \
+  --button param1=<cycle-harmony-code> --button param2=<neuroshyft-code> --commit
 ```
 
+**Link buttons (v0.7.5):** every button whose URL carries a `{{1}}` needs its own
+`--button paramN=` value (`param1` = the first such button, `param2` = the
+second). The dry run prints each button's final URL and stops if one is
+missing (WhatsApp rejects the whole message when a link button is empty); a
+value with no button to go to is ignored with a warning. Swapping the codes per
+batch is how one campaign gets per-batch click counts: mint each batch's links
+with the same `--campaign` and a different `--content`. CSV mode fills one link
+button only, so a two-button template is refused there.
+
 Values are shared across the tag (use `{{first_name}}` etc. for per-contact
 personalization — resolved server-side). Supported per-contact tokens:
 `{{first_name}}` `{{full_name}}` `{{email}}` `{{phone_number}}`

package/TEAM-GUIDE.md

@@ -167,6 +167,7 @@ several.
 | Send to one batch tag | `flowiq bc send <org_id> --tag <batch-tag> --template … --body param1="Hi {{first_name}}" --commit` (per-contact tokens: the 6 contact fields + `{{attributes.<key>}}`). Sending a **different template to the SAME tag**? Add a distinct `--campaign <name>` — otherwise the CLI aborts (a campaign belongs to one template; reusing it would send the first template's image + skip everyone it already reached). |
 | Send a broadcast whose template has an IMAGE/VIDEO/DOCUMENT header | Same as above — the media is automatic (the template's own stored header). Override with `--header-media <public-url>` if needed. The CLI verifies the resolved media's actual type against the header format — `header video (video ✓ video/mp4)` means verified; a mismatch (e.g. a video template whose stored default is secretly a png — templates made before 3 Aug 2026 can carry this) ABORTS and tells you to pass `--header-media` with the real file. |
 | Send a **CAROUSEL** template (v0.4.9) | Tag mode only: `flowiq bc send <org_id> --tag <batch-tag> --template <carousel_name> --body param1="Hi {{first_name}}" --commit`. Card images are automatic (each card's stored template image, type-verified per card); override with repeatable `--card-media <url>` (one per card, in order). If the cards carry `{{n}}` body variables or URL-button variables, the CLI tells you exactly what to put in a `--cards-file <path>` JSON (one entry per card: `header_media` / `body_params` / `button_payloads` / `url_vars`). Always sends via the python engine (any size); no CSV mode for carousels. |
+| Send a template with TWO link buttons (e.g. one per product) and track clicks per batch | Mint two short links per batch with the same campaign and a different `--content` (e.g. `--content CycleHarmony_b01` and `--content NeuroShyft_b01`), then `flowiq bc send <org_id> --tag <batch-tag> --template <name> --button param1=<first-code> --button param2=<second-code>`. `param1` is the first link button on the template, `param2` the second. The dry run prints both final URLs and stops if either is missing. Tag mode only (v0.7.5). |
 | Send via the SAME engine as the dashboard's "Python" toggle | add `--python` to a `bc send --tag …` (fire-and-forget; python resolves the tag + sends + tracks; no CLI resume for this engine). **Any tag send over 10 recipients uses python automatically.** |
 | Find a broadcast's id (don't have the `broadcastId`?) | `flowiq bc list-remote <org_id>` — the org's broadcasts newest-first with full ids (`--template <substr>` / `--since <date>` / `--limit <n>` to narrow) |
 | Check how a broadcast is landing (accepted → delivered → read, plus failed/pending) | `flowiq bc status <org_id> <broadcastId>` (from the send output, or `bc list-remote`) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "Command-line tool for FlowIQ staff: round-trip agent prompts, questionnaires, fine-tuning, pin-board tasks, webhooks, templates, agent-updates, chat exports, and live agent testing without ever touching service-role credentials.",
   "type": "module",
   "bin": {

package/src/button-params.test.mjs

@@ -0,0 +1,50 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { resolveButtonParams, checkButtonParams } from "./commands/broadcast.js";
+
+const oneBtn = { dynamic_url_buttons: 1, url_button: { present: true } };
+const twoBtn = { dynamic_url_buttons: 2, url_button: { present: true } };
+const noBtn = { dynamic_url_buttons: 0, url_button: { present: false } };
+
+test("flags win over the saved campaign", () => {
+  assert.deepEqual(resolveButtonParams({ param1: "a", param2: "b" }, { button_params_literal: { param1: "x" } }), { param1: "a", param2: "b" });
+});
+
+test("saved multi-button values, then the pre-0.7.5 single value", () => {
+  assert.deepEqual(resolveButtonParams({}, { button_params_literal: { param1: "x", param2: "y" } }), { param1: "x", param2: "y" });
+  assert.deepEqual(resolveButtonParams({}, { button_param_literal: "old" }), { param1: "old" });
+  assert.deepEqual(resolveButtonParams(undefined, null), {});
+});
+
+test("empty values are dropped", () => {
+  assert.deepEqual(resolveButtonParams({ param1: "a", param2: "" }, null), { param1: "a" });
+});
+
+test("one dynamic button: same message as before", () => {
+  assert.deepEqual(checkButtonParams(oneBtn, {}).aborts, ["template has a dynamic URL button — pass --button param1=<code>"]);
+  assert.deepEqual(checkButtonParams(oneBtn, { param1: "abc" }), { aborts: [], warnings: [] });
+});
+
+test("two dynamic buttons need both values", () => {
+  const r = checkButtonParams(twoBtn, { param1: "abc" });
+  assert.equal(r.aborts.length, 1);
+  assert.match(r.aborts[0], /2 dynamic URL buttons/);
+  assert.match(r.aborts[0], /missing param2/);
+  assert.deepEqual(checkButtonParams(twoBtn, { param1: "a", param2: "b" }), { aborts: [], warnings: [] });
+});
+
+test("a value with no button is a warning, not an abort", () => {
+  const r = checkButtonParams(oneBtn, { param1: "a", param2: "b" });
+  assert.deepEqual(r.aborts, []);
+  assert.match(r.warnings[0], /param2 ignored/);
+  assert.match(checkButtonParams(noBtn, { param1: "a" }).warnings[0], /0 dynamic URL buttons/);
+});
+
+test("non-param keys abort", () => {
+  assert.match(checkButtonParams(oneBtn, { code: "a", param1: "b" }).aborts[0], /param1\.\.N/);
+});
+
+test("older server without dynamic_url_buttons falls back to url_button", () => {
+  assert.equal(checkButtonParams({ url_button: { present: true } }, {}).aborts.length, 1);
+  assert.equal(checkButtonParams({ url_button: { present: false } }, {}).aborts.length, 0);
+});

package/src/commands/broadcast.js

@@ -502,6 +502,7 @@ function validateRows(template, mapping, headers, rows, illegalChars, headerMedi
   const aborts = [];
   if (template.status !== "APPROVED") aborts.push(`V-1: template status is ${template.status} — only APPROVED templates send`);
   if (template.parameter_format !== "POSITIONAL") aborts.push("V-2: NAMED templates are not supported in v1");
+  if ((template.dynamic_url_buttons ?? 0) > 1) aborts.push(`V-3: this template has ${template.dynamic_url_buttons} dynamic URL buttons; CSV mode fills one — use tag mode: flowiq bc send <org> --tag <tag> --template <name> --button param1=<code> --button param2=<code>`);
   if (template.is_carousel) aborts.push("V-3: carousel templates are TAG-MODE only — use: flowiq bc send <org> --tag <tag> --template <name> (the python engine sends carousels; per-row CSV carousel sends are not supported)");
   // Media headers (image/video/document) ARE supported — they just need an image
   // URL, exactly like the dashboard. Resolved as --header-media / saved mapping /
@@ -604,12 +605,64 @@ function renderPreview(template, sample, headerMedia) {
   console.log(`Row ${sample.rownum}  →  ${sample.number}   [VALID]${sample.sanitized ? " (sanitized)" : ""}`);
   if (headerMedia) console.log(`  Header (${template.header_type}): ${headerMedia}`);
   console.log(`  Body:\n    ${bodyText.replace(/\n/g, "\n    ")}`);
+  // Two-dynamic-button templates (17 Sep 2026): show every button with its own value.
+  if (Array.isArray(template.url_buttons) && template.url_buttons.length && sample.buttonParams) {
+    for (const b of template.url_buttons) {
+      const v = sample.buttonParams[b.param];
+      if (v == null) continue;
+      console.log(`  Button "${b.text ?? "URL"}" (${b.param}) → ${b.url_base.replace(/\{\{[^}]+\}\}/, v)}`);
+    }
+    return;
+  }
   if (template.url_button?.present && sample.buttonValue != null) {
     const url = template.url_button.url_base.replace(/\{\{[^}]+\}\}/, sample.buttonValue);
     console.log(`  Button "${template.url_button.text ?? "URL"}" → ${url}`);
   }
 }
 
+/** Tag-mode URL-button values: every `--button paramN=…` flag, else the saved
+ *  campaign's values (new `button_params_literal`, or the pre-0.7.5 single
+ *  `button_param_literal` as param1). Empty values are dropped. */
+export function resolveButtonParams(flagButtons, cfg) {
+  const out = {};
+  const src = flagButtons && Object.keys(flagButtons).length
+    ? flagButtons
+    : (cfg?.button_params_literal && Object.keys(cfg.button_params_literal).length
+      ? cfg.button_params_literal
+      : (cfg?.button_param_literal ? { param1: cfg.button_param_literal } : {}));
+  for (const [k, v] of Object.entries(src)) {
+    if (v == null || String(v) === "") continue;
+    out[k] = String(v);
+  }
+  return out;
+}
+
+/** Checks tag-mode button values against the template's dynamic URL buttons.
+ *  Every button needs its own value (python / send-template send '' for a
+ *  missing one and Meta rejects the message); a value with no button to go to
+ *  is a warning (it is ignored by both engines). */
+export function checkButtonParams(template, buttonParams) {
+  const aborts = [];
+  const warnings = [];
+  const keys = Object.keys(buttonParams || {});
+  const bad = keys.filter((k) => !/^param\d+$/.test(k));
+  if (bad.length) aborts.push(`--button keys must be param1..N (got ${bad.join(", ")})`);
+  const need = Number.isInteger(template.dynamic_url_buttons)
+    ? template.dynamic_url_buttons
+    : (template.url_button?.present ? 1 : 0);
+  const missing = [];
+  for (let i = 1; i <= need; i++) if (!buttonParams?.[`param${i}`]) missing.push(`param${i}`);
+  if (missing.length) {
+    const how = Array.from({ length: need }, (_, i) => `--button param${i + 1}=<code>`).join(" ");
+    aborts.push(need === 1
+      ? "template has a dynamic URL button — pass --button param1=<code>"
+      : `template has ${need} dynamic URL buttons — pass ${how} (missing ${missing.join(", ")})`);
+  }
+  const extra = keys.filter((k) => /^param\d+$/.test(k) && Number(k.slice(5)) > need);
+  if (extra.length) warnings.push(`--button ${extra.join(", ")} ignored: template has ${need} dynamic URL button${need === 1 ? "" : "s"}`);
+  return { aborts, warnings };
+}
+
 // ---------------------------------------------------------------------------
 // CSV → python fan-out builders (v0.6.0). Exported for the test harness.
 // ---------------------------------------------------------------------------
@@ -695,7 +748,9 @@ async function sendOne(apiUrl, orgId, templateName, row, headerMedia) {
     templateName,
     whatsappNumber: row.number,
     bodyParameters,
-    ...(row.buttonValue != null ? { buttonParameters: { param1: row.buttonValue } } : {}),
+    ...(row.buttonParams && Object.keys(row.buttonParams).length
+      ? { buttonParameters: row.buttonParams }
+      : (row.buttonValue != null ? { buttonParameters: { param1: row.buttonValue } } : {})),
     // Static media header (same field the dashboard passes for image/video/doc
     // headers) — /api/send-template renders it onto the HEADER component.
     ...(headerMedia ? { headerMedia } : {}),
@@ -1241,11 +1296,12 @@ function reportRoutingResult(orgId, rr, broadcastId) {
   }
 }
 
-async function runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, commitStage, cardOverrides = null, cardLines = [], replyRouting = null }) {
+async function runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, buttonParams = null, commitStage, cardOverrides = null, cardLines = [], replyRouting = null }) {
+  const buttons = buttonParams && Object.keys(buttonParams).length ? buttonParams : (buttonLiteral ? { param1: buttonLiteral } : null);
   const reqBody = (dryRun) => ({
     action: "send-python", organization_id: orgId, tag, template_name: templateName,
     body_parameters: bodyLiterals,
-    ...(buttonLiteral ? { button_parameters: { param1: buttonLiteral } } : {}),
+    ...(buttons ? { button_parameters: buttons } : {}),
     ...(headerMedia ? { header_media: headerMedia } : {}),
     ...(cardOverrides ? { card_overrides: cardOverrides } : {}),
     ...(replyRouting ? { reply_routing: replyRouting } : {}),
@@ -1262,7 +1318,7 @@ async function runPythonTagSend(orgId, { opts, tag, templateName, template, head
   console.log(`Engine: PYTHON (yapi.store/meta-broadcast) — fire-and-forget, python-tracked.`);
   console.log(`Tag "${tag}": ${total} eligible contact(s) (allow_broadcast + not blocked, resolved server-side).`);
   const sampleNum = dry.sample_contacts?.[0]?.whatsapp_id || dry.sample_contacts?.[0]?.phone_number || "<first eligible>";
-  renderPreview(template, { rownum: 1, number: sampleNum, values: bodyLiterals, buttonValue: buttonLiteral }, headerMedia);
+  renderPreview(template, { rownum: 1, number: sampleNum, values: bodyLiterals, buttonValue: buttonLiteral, buttonParams: buttons }, headerMedia);
   printCarouselPlan(cardOverrides, cardLines);
   if (Object.values(bodyLiterals).some((v) => /\{\{(first_name|full_name|email|phone_number|whatsapp_id)\}\}/.test(String(v)))) {
     console.log("  ({{first_name}}-style tokens are resolved PER CONTACT by python)");
@@ -1307,7 +1363,8 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
     process.exit(1);
   }
   const bodyLiterals = Object.keys(opts.body || {}).length ? opts.body : (cfg?.body_params_literal ?? {});
-  const buttonLiteral = (opts.button && opts.button.param1) ?? cfg?.button_param_literal ?? null;
+  const buttonParams = resolveButtonParams(opts.button, cfg);
+  const buttonLiteral = buttonParams.param1 ?? null;
 
   // introspect + validate params arithmetically (the #132000 guard, pre-send)
   let intro;
@@ -1319,7 +1376,7 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
     ? (opts.headerMedia || cfg?.header_media || template.header_media_default || null)
     : null;
   const headerCheck = await verifyHeaderMedia(template, headerMedia);
-  console.log(`Template ${template.name} [${template.status}] — ${template.parameter_format}, ${template.body_var_count} body var(s), header ${template.header_type}${headerCheck.label}${template.url_button?.present ? ", dynamic URL button" : ""}${template.is_carousel ? `, CAROUSEL (${template.carousel_cards?.length ?? "?"} cards)` : ""}`);
+  console.log(`Template ${template.name} [${template.status}] — ${template.parameter_format}, ${template.body_var_count} body var(s), header ${template.header_type}${headerCheck.label}${(template.dynamic_url_buttons ?? 0) > 1 ? `, ${template.dynamic_url_buttons} dynamic URL buttons` : (template.url_button?.present ? ", dynamic URL button" : "")}${template.is_carousel ? `, CAROUSEL (${template.carousel_cards?.length ?? "?"} cards)` : ""}`);
   const aborts = [];
   if (headerCheck.status === "mismatch") aborts.push(headerMismatchMessage(template, headerMedia, headerCheck.contentType, { explicit: !!opts.headerMedia }));
   if (template.status !== "APPROVED") aborts.push(`template status is ${template.status} — only APPROVED templates send`);
@@ -1346,7 +1403,9 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
   const keys = Object.keys(bodyLiterals);
   if (keys.some((k) => !/^param\d+$/.test(k))) aborts.push(`--body keys must be param1..N (got ${keys.join(", ")})`);
   if (keys.length !== template.body_var_count) aborts.push(`template expects ${template.body_var_count} body param(s), you provided ${keys.length} (--body paramN=…). Values may use {{first_name}}/{{full_name}}/{{email}}/{{phone_number}} — resolved per contact.`);
-  if (template.url_button?.present && !buttonLiteral) aborts.push("template has a dynamic URL button — pass --button param1=<code>");
+  const buttonCheck = checkButtonParams(template, buttonParams);
+  for (const w of buttonCheck.warnings) console.log(`⚠ ${w}`);
+  aborts.push(...buttonCheck.aborts);
   if (aborts.length) { for (const a of aborts) console.error(`ABORT — ${a}`); process.exit(1); }
 
   // SCHEDULE (--at): validation above has already run, so a scheduled send is
@@ -1360,7 +1419,7 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
   // picked — so a mistyped team stops the run in the dry run, not after a send.
   const replyRouting = await checkRouting(orgId, opts);
 
-  if (opts.at) return scheduleTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, commitStage, cardOverrides, cardLines, replyRouting });
+  if (opts.at) return scheduleTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, buttonParams, commitStage, cardOverrides, cardLines, replyRouting });
 
   // ENGINE ROUTING (policy): any send of MORE THAN 10 recipients ALWAYS uses the
   // python /meta-broadcast engine (the proven bulk sender). --python forces it at
@@ -1377,7 +1436,7 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
     console.log("Reply routing → PYTHON engine at any size (the routing is stored on the single broadcast python creates).");
   }
   if (opts.python || template.is_carousel || replyRouting) {
-    return runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, commitStage, cardOverrides, cardLines, replyRouting });
+    return runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, buttonParams, commitStage, cardOverrides, cardLines, replyRouting });
   }
 
   // resolve the tag server-side (broadcast-safe recipients only). A >2000 tag
@@ -1387,13 +1446,13 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
   catch (e) {
     if (e.status === 413) {
       console.log(`Tag "${tag}" has >2000 contacts → PYTHON engine (any send >${PYTHON_MIN} uses python).`);
-      return runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, commitStage });
+      return runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, buttonParams, commitStage });
     }
     console.error(`Tag resolution failed: ${e.message}`); if (e.body?.error) console.error(`  ${e.body.error}`); process.exit(1);
   }
   if (resolved.recipients.length > PYTHON_MIN) {
     console.log(`Tag "${tag}": ${resolved.recipients.length} sendable (>${PYTHON_MIN}) → PYTHON engine (any send >${PYTHON_MIN} uses python).`);
-    return runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, commitStage });
+    return runPythonTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, buttonParams, commitStage });
   }
   console.log(`Tag "${tag}" on ${resolved.organization_name}: ${resolved.tagged_total} contact(s), ${resolved.recipients.length} sendable, ${resolved.excluded.length} excluded (opt-out/archived/blocked).`);
   if (!resolved.recipients.length) { console.log("Nothing sendable under this tag."); return; }
@@ -1401,7 +1460,7 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
   const values = {};
   for (const [k, v] of Object.entries(bodyLiterals)) values[k] = String(v);
   let sendable = resolved.recipients.map((r, i) => ({
-    rownum: i + 1, number: r.number, values, buttonValue: buttonLiteral, contactName: r.full_name,
+    rownum: i + 1, number: r.number, values, buttonValue: buttonLiteral, buttonParams, contactName: r.full_name,
   }));
   if (opts.limit) sendable = sendable.slice(0, Number(opts.limit));
 
@@ -1447,7 +1506,7 @@ async function runTagPipeline(orgId, opts, { commitStage }) {
     schema_version: 1, campaign, mode: "tag",
     organization_id: orgId, organization_slug: slugify(resolved.organization_name, orgId.slice(0, 8)),
     template_name: templateName, tag,
-    body_params_literal: bodyLiterals, button_param_literal: buttonLiteral,
+    body_params_literal: bodyLiterals, button_param_literal: buttonLiteral, button_params_literal: buttonParams,
     ...(headerMedia ? { header_media: headerMedia } : {}),
     created_at: cfg?.created_at ?? new Date().toISOString(),
   });
@@ -1539,7 +1598,8 @@ const fmtSast = (iso) =>
   new Date(iso).toLocaleString("en-ZA", { timeZone: "Africa/Johannesburg", dateStyle: "medium", timeStyle: "short" });
 
 /** Queue a tag broadcast to fire later (server writes the api_request_queue row). */
-async function scheduleTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, commitStage, cardOverrides = null, cardLines = [], replyRouting = null }) {
+async function scheduleTagSend(orgId, { opts, tag, templateName, template, headerMedia, bodyLiterals, buttonLiteral, buttonParams = null, commitStage, cardOverrides = null, cardLines = [], replyRouting = null }) {
+  const buttons = buttonParams && Object.keys(buttonParams).length ? buttonParams : (buttonLiteral ? { param1: buttonLiteral } : null);
   const when = parseSastAt(opts.at);
   if (when.error) { console.error(`Error: --at ${when.error}`); process.exit(1); }
   if (new Date(when.iso).getTime() <= Date.now()) {
@@ -1549,7 +1609,7 @@ async function scheduleTagSend(orgId, { opts, tag, templateName, template, heade
   const needsApproval = !!opts.needsApproval;
 
   console.log("");
-  renderPreview(template, { rownum: 1, number: "(resolved at send time)", values: bodyLiterals, buttonValue: buttonLiteral }, headerMedia);
+  renderPreview(template, { rownum: 1, number: "(resolved at send time)", values: bodyLiterals, buttonValue: buttonLiteral, buttonParams: buttons }, headerMedia);
   printCarouselPlan(cardOverrides, cardLines);
   if (Object.values(bodyLiterals).some((v) => /\{\{(first_name|full_name|email|phone_number|whatsapp_id)\}\}/.test(String(v)))) {
     console.log("  ({{first_name}}-style tokens are resolved PER CONTACT at send time)");
@@ -1578,7 +1638,7 @@ async function scheduleTagSend(orgId, { opts, tag, templateName, template, heade
       scheduled_for: when.iso,
       needs_approval: needsApproval,
       body_parameters: bodyLiterals,
-      ...(buttonLiteral ? { button_parameters: { param1: buttonLiteral } } : {}),
+      ...(buttons ? { button_parameters: buttons } : {}),
       ...(headerMedia ? { header_media: headerMedia } : {}),
       ...(cardOverrides ? { card_overrides: cardOverrides } : {}),
       ...(replyRouting ? { reply_routing: replyRouting } : {}),

package/src/index.js

@@ -620,7 +620,7 @@ export function run(argv) {
     .option("--csv <file>", "path to the recipients CSV (per-row values)")
     .option("--tag <tag>", "send to every broadcast-safe contact carrying this tag (e.g. a segments batch tag)")
     .option("--body <k=v>", "with --tag: body param (repeatable), e.g. --body param1=\"Hi {{first_name}}\"", broadcastCmd.collectKV, {})
-    .option("--button <k=v>", "with --tag: dynamic URL button param, e.g. --button param1=<short-code>", broadcastCmd.collectKV, {})
+    .option("--button <k=v>", "with --tag: dynamic URL button value, repeatable for a second button, e.g. --button param1=<code> --button param2=<code>", broadcastCmd.collectKV, {})
     .option("--campaign <name>", "campaign id / config file slug (default: CSV filename / tag)")
     .option("--header-media <url>", "header image/video/doc URL for a media-header template (default: the template's own stored image)")
     .option("--card-media <url>", "with --tag, carousel templates: card image/video URL in card order (repeatable — one per card; default: each card's stored template image)", (v, acc) => (acc || []).concat([v]), [])