conduyt 1.36.0 → 1.37.0

package/README.md

@@ -40,7 +40,12 @@ conduyt insights summary                # run an AI insight query
 conduyt insights saved_report --report "Lead Activity" --period last_7_days   # run any saved report as a tool
 conduyt insights dashboard --dashboard Floor --period today                   # run every tile of a board
 conduyt insights report_catalog                                                # what this key can run
-conduyt messages transports             # what a workflow Send SMS step can speak through today (Twilio numbers, Project Blue lines)
+conduyt messages transports             # what a workflow Send SMS step can speak through today (Twilio numbers, Project Blue lines, the WhatsApp sender)
+conduyt whatsapp status                 # WhatsApp via your Twilio: connected? from which sender
+conduyt whatsapp senders                # the senders Twilio lists for the account (ONLINE = connectable)
+conduyt whatsapp connect <senderSid>    # connect a sender (verified with Twilio first)
+conduyt whatsapp templates              # approved / pending / rejected templates with their {{n}} placeholders
+conduyt messages send-sms --contact <id> --transport whatsapp --whatsapp-template HX… --whatsapp-variables '{"1":"Alex"}' --body "…"
 conduyt privacy export <id>             # GDPR data-portability export (owner/admin)
 conduyt privacy forget <id> --confirm FORGET  # GDPR erasure — IRREVERSIBLE, owner only
 conduyt reply-capture status            # inbound reply capture: state, DNS records, provider health

package/dist/index.js

@@ -804,8 +804,34 @@ messages
 }));
 messages
     .command("transports")
-    .description("What a workflow Send SMS step can speak through today (GET /sms/transports): Twilio {connected, numbers = account number + active reps' lines, valid send_sms fromNumber values}, Project Blue {connected, lines held by active reps, valid projectBlueLineId values for smsMode project_blue}, webhook provider count, FromK.ai coming soon (automations scope)")
+    .description("What a workflow Send SMS step can speak through today (GET /sms/transports): Twilio {connected, numbers = account number + active reps' lines, valid send_sms fromNumber values}, Project Blue {connected, lines held by active reps, valid projectBlueLineId values for smsMode project_blue}, WhatsApp {connected, sender for smsMode whatsapp}, webhook provider count, FromK.ai coming soon (automations scope)")
     .action(run(async (client) => client.get("/api/v1/sms/transports")));
+// ---- WhatsApp via Twilio (2026-09-11) ----
+const whatsapp = program.command("whatsapp").description("WhatsApp via your own Twilio account: a Meta-approved sender, approved templates for outreach, free-form replies within a contact's 24-hour window");
+whatsapp
+    .command("status")
+    .description("Connection status (GET /settings/whatsapp): connected | not_configured | twilio_required, the sender {phoneNumber, sid} (settings scope)")
+    .action(run(async (client) => client.get("/api/v1/settings/whatsapp")));
+whatsapp
+    .command("senders")
+    .description("The WhatsApp senders Twilio lists under the account's credentials, with status (only ONLINE can be connected) and which one is connected (settings scope)")
+    .action(run(async (client) => client.get("/api/v1/settings/whatsapp/senders")));
+whatsapp
+    .command("connect <senderSid>")
+    .description("Connect the account's WhatsApp sender by its Twilio sid (XE…, see `whatsapp senders`) — verified with Twilio first: on this account and ONLINE; one sender belongs to one Conduyt account (settings scope)")
+    .action(run(async (client, senderSid) => {
+    if (!/^XE[0-9a-fA-F]{32}$/.test(senderSid.trim()))
+        throw new Error("senderSid must be a Twilio WhatsApp sender SID (XE followed by 32 hex characters).");
+    return client.put("/api/v1/settings/whatsapp", { senderSid: senderSid.trim() });
+}));
+whatsapp
+    .command("disconnect")
+    .description("Forget the WhatsApp sender — workflow steps on the WhatsApp channel stop sending (settings scope)")
+    .action(run(async (client) => client.del("/api/v1/settings/whatsapp")));
+whatsapp
+    .command("templates")
+    .description("The account's WhatsApp templates (Twilio Content) with Meta's approval verdict: sid (a send-sms --whatsapp-template value), text with {{n}} placeholders, variables, approval (automations scope)")
+    .action(run(async (client) => client.get("/api/v1/sms/whatsapp/templates")));
 messages
     .command("send-sms")
     .description("Send an outbound SMS (POST /messages/sms/send) — via Twilio, or from your own Project Blue iPhone line with --transport project_blue")
@@ -813,7 +839,9 @@ messages
     .option("--body <text>", "SMS body, 1-1600 chars (required)")
     .option("--from <number>", "from number — must be an account-owned Twilio number/agent DID")
     .option("--provider <id>", "smsProviderId UUID")
-    .option("--transport <transport>", "twilio (default) | project_blue — send from your assigned Project Blue iPhone line (iMessage when the lead is on Apple, SMS otherwise)")
+    .option("--transport <transport>", "twilio (default) | project_blue — your assigned Project Blue iPhone line (iMessage when the lead is on Apple, SMS otherwise) | whatsapp — the account's WhatsApp sender (free-form only within 24 hours of the lead's last WhatsApp message, else an approved template via --whatsapp-template)")
+    .option("--whatsapp-template <sid>", "transport whatsapp: an APPROVED template (Twilio Content SID HX…, see `whatsapp templates`); Conduyt reads it from Twilio at send time and records its text with the variables in place")
+    .option("--whatsapp-variables <json>", 'transport whatsapp with a template: placeholder number → value as JSON, e.g. {"1":"Alex"}')
     .option("--idempotency-key <key>", "operation key (8-200 chars) for at-most-once sends: reuse the SAME key when retrying a send whose outcome you did not see")
     .option("--json <json>", "full JSON body, merged over the flags")
     .action(run(async (client, opts) => {
@@ -828,6 +856,10 @@ messages
         body.smsProviderId = opts.provider;
     if (opts.transport !== undefined)
         body.transport = opts.transport;
+    if (opts.whatsappTemplate !== undefined)
+        body.whatsappContentSid = opts.whatsappTemplate;
+    if (opts.whatsappVariables !== undefined)
+        body.whatsappContentVariables = jsonArg(opts.whatsappVariables, "--whatsapp-variables");
     if (opts.idempotencyKey !== undefined)
         body.idempotencyKey = opts.idempotencyKey;
     if (opts.json !== undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt",
-  "version": "1.36.0",
+  "version": "1.37.0",
   "description": "Command-line interface for Conduyt CRM — manage contacts, deals, pipelines, and run insight queries from your terminal.",
   "type": "module",
   "main": "dist/index.js",