@talqing/mcp 0.12.2 → 0.13.1

package/SKILL.md

@@ -1441,14 +1441,26 @@ drafting and does not touch a send that is already scheduled or going out.
 A **WhatsApp batch** sends one *approved* template to every row of a CSV from a
 connected WhatsApp integration. There is no drafting: Meta approved the wording,
 and only the template's variables change per row. `list_whatsapp_templates`
-gives a sender's approved templates — header, body, footer, buttons and variable
-names; one with `unsupported_reason` cannot be used.
+gives a sender's templates — header, body, footer, buttons, variable names and
+review `status`; only `approved` ones send, and one with `unsupported_reason`
+cannot be used.
 `create_whatsapp_batch` maps `to_column` and every variable onto CSV columns. A
 row with a bad or repeated phone, or a blank mapped cell, is kept and skipped
 with the reason, so read the returned `counts`. `send_daily_cap` takes the same
 object an email batch's does (a fixed 250 by default); for a new sender suggest
 a ramp.
 
+**Templates** are written here too, on a Twilio sender (Gupshup ones are made in
+the Gupshup app). `create_whatsapp_template` submits it to WhatsApp at once; it
+is shared by every number on that Twilio account. Variables are named
+(`{{first_name}}`), each with a realistic sample in `examples`. Meta rejects a
+body that starts or ends with a variable, puts two variables side by side, or has
+fewer than `2x+1` other words for `x` variables — these come back in one 400, so
+draft around them. `utility` is for updates about something the person asked
+for; anything promotional is `marketing`. Review usually takes minutes: report
+`status`, and poll the list when asked. A submitted template can't be edited; a
+rejected one is fixed by creating a corrected copy under a new name.
+
 **Say these before creating one:**
 
 - **Only people who opted in to hear from the business on WhatsApp** may be
@@ -1460,8 +1472,8 @@ a ramp.
 - **`add_whatsapp_batch_recipients` on a sending or completed batch messages
   the new rows at once**, with nobody pressing anything. Get an explicit yes.
 
-Replies are answered by the agent on the sender's
-`whatsapp.message.inbound` trigger, which sees the row's columns as
+Replies are answered by the batch's own agent, if `create_whatsapp_batch` named
+one, else the agent on the sender's `whatsapp.message.inbound` trigger. It sees the row's columns as
 `{{userdata.<column>}}` and the whole template, buttons included, as its own
 first message — so write that agent's prompt against the CSV's column names.
 
@@ -1495,6 +1507,12 @@ reply starts from. Send an `idempotency_key` when retrying is possible. A
 provider refusal still stores the item, `delivery_status: failed` (nothing resends it). While
 they have an open chat, post anything but a note into that chat's conversation:
 another one is refused with `chat_open_elsewhere`.
+**Choosing the agent:** a post or batch takes the agent fields an outbound call
+does (`agent_id`, `agent`, `agent_override`, `vars`…; a batch takes no `secrets`).
+Send them to make that agent answer this person — an open chat running something
+else ends, and a template or `agent_text` saves it for their reply; leave them
+out to continue whatever runs. Needs the number's messages trigger on
+(`messages_off`).
 
 ## Secrets, keys and webhooks
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talqing/mcp",
-  "version": "0.12.2",
+  "version": "0.13.1",
   "description": "MCP server for building Talqing AI voice, video and text agents from Claude Code, Codex, or any MCP client.",
   "license": "MIT",
   "homepage": "https://talqing.com",

package/tools.json

@@ -2488,7 +2488,7 @@
       "role": "write"
     },
     {
-      "description": "List a WhatsApp sender's approved templates, read live from its BSP.",
+      "description": "List a WhatsApp sender's templates in every review state, newest first, live from its BSP.",
       "method": "GET",
       "name": "list_whatsapp_templates",
       "parameters": {
@@ -2497,6 +2497,9 @@
         "properties": {
           "integration_id": {
             "type": "string"
+          },
+          "status": {
+            "type": "array"
           }
         },
         "required": [
@@ -2508,6 +2511,52 @@
       "read_only": true,
       "role": "read"
     },
+    {
+      "description": "Create a template, shared by every number on the Twilio account, and submit it to WhatsApp.",
+      "method": "POST",
+      "name": "create_whatsapp_template",
+      "parameters": {
+        "additionalProperties": false,
+        "description": "Arguments not inlined: call describe_function('create_whatsapp_template').",
+        "properties": {
+          "body": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "body"
+        ],
+        "type": "object"
+      },
+      "path": "/v1/whatsapp/templates",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Delete a template from WhatsApp for good. Refused while a live batch sends it.",
+      "method": "DELETE",
+      "name": "delete_whatsapp_template",
+      "parameters": {
+        "additionalProperties": false,
+        "description": "Arguments not inlined: call describe_function('delete_whatsapp_template').",
+        "properties": {
+          "integration_id": {
+            "type": "string"
+          },
+          "template_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "template_id",
+          "integration_id"
+        ],
+        "type": "object"
+      },
+      "path": "/v1/whatsapp/templates/{template_id}",
+      "read_only": false,
+      "role": "write"
+    },
     {
       "description": "List the WhatsApp senders on a Twilio account, before connecting one. Stores nothing.",
       "method": "POST",