@lionchat/mcp-server 0.5.6 → 0.5.7

package/dist/docs/resources/best-practices.md

@@ -261,6 +261,48 @@ Pra dados fixos que se repetem (slogans, endereços, horários):
 
 Nunca hard-code esses dados em respostas geradas.
 
+## Templates WhatsApp com variáveis do sistema (auto-preenchimento) (2026-06)
+
+Ao criar/editar um template WhatsApp (`inboxes_whatsapp_templates_create` / `_create_2`), o corpo usa
+variáveis posicionais `{{1}}`, `{{2}}`. Por padrão elas são **manuais** (o atendente digita o valor no
+envio). Pra deixar uma variável **auto-preenchida** com um campo do contato/conversa, mande o parâmetro
+opcional `variable_mapping` junto.
+
+- Formato: objeto com chave = posição da variável (`"1"`, `"2"`...) e valor = `{ source, field, label }`.
+- Só entram no mapping as que devem auto-preencher; as demais `{{N}}` continuam manuais.
+- O `variable_mapping` é salvo localmente (NÃO vai pra Meta) e usado no momento do envio.
+
+Exemplo — `{{1}}` vira o primeiro nome do contato:
+
+```json
+{
+  "components": [
+    { "type": "BODY", "text": "Olá {{1}}! Sua oferta de {{2}} está ativa.",
+      "example": { "body_text": [["Maria", "20%"]] } }
+  ],
+  "variable_mapping": {
+    "1": { "source": "contact", "field": "name.split.first", "label": "Primeiro nome" }
+  }
+}
+```
+
+Fontes/campos disponíveis (`source` / `field`):
+
+| Variável | source | field |
+|---|---|---|
+| Nome completo | contact | name |
+| Primeiro nome | contact | name.split.first |
+| Sobrenome | contact | name.split[1..] |
+| Telefone | contact | phone_number |
+| E-mail | contact | email |
+| Atendente | conversation | assignee.name |
+| Equipe | conversation | team.name |
+| Nome da conta | account | name |
+| Campo personalizado | contact | custom_attributes.CHAVE |
+
+Lembrete: todo template recém-criado pelo MCP só mostra o texto na tela depois de **sincronizar**
+(o MCP cria na Meta, mas o "puxar de volta" o conteúdo é o que a tela faz com o botão Sincronizar).
+
 ## Status codes a respeitar
 
 | Code | O que fazer |

package/endpoints.json

@@ -14521,6 +14521,13 @@
         "location": "body",
         "required": true,
         "description": "Componentes do template"
+      },
+      {
+        "name": "variable_mapping",
+        "type": "object",
+        "location": "body",
+        "required": false,
+        "description": "Opcional. Mapeia variaveis {{N}} do corpo a campos do sistema para auto-preenchimento no envio (NAO vai para a Meta, fica salvo localmente). Chave = posicao da variavel (\"1\", \"2\"...), valor = objeto {source, field, label}. Ex: {\"1\": {\"source\": \"contact\", \"field\": \"name.split.first\", \"label\": \"Primeiro nome\"}}. Variavel sem mapping continua manual (digitada no envio). Fontes/campos: contact/name (Nome completo), contact/name.split.first (Primeiro nome), contact/name.split[1..] (Sobrenome), contact/phone_number, contact/email, conversation/assignee.name (Atendente), conversation/team.name (Equipe), account/name, ou contact/custom_attributes.CHAVE para campo personalizado."
       }
     ],
     "returns": "template WhatsApp criado (com novo ID)",
@@ -14640,6 +14647,13 @@
         "location": "body",
         "required": false,
         "description": "Componentes atualizados"
+      },
+      {
+        "name": "variable_mapping",
+        "type": "object",
+        "location": "body",
+        "required": false,
+        "description": "Opcional. Mapeia variaveis {{N}} a campos do sistema para auto-preenchimento no envio (NAO vai para a Meta). Chave = posicao da variavel (\"1\", \"2\"...), valor = objeto {source, field, label}. Ex: {\"1\": {\"source\": \"contact\", \"field\": \"name.split.first\", \"label\": \"Primeiro nome\"}}. Mesmas fontes/campos do endpoint de criacao."
       }
     ],
     "returns": "{ success: true }",
@@ -14654,6 +14668,33 @@
       "lionchat_inboxes_whatsapp_templates_destroy"
     ]
   },
+  {
+    "id": "lionchat_inboxes_sync_templates",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/sync_templates",
+    "title": "Sincronizar Templates WhatsApp",
+    "description": "Sincroniza (puxa) os templates de WhatsApp da Meta para a caixa, atualizando nome, corpo e status no LionChat. SOMENTE Channel::Whatsapp Cloud. Use logo apos criar/editar um template via API: a criacao retorna so id/status e o conteudo so aparece na tela depois deste sync.",
+    "category": "Templates WhatsApp",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da inbox"
+      }
+    ],
+    "returns": "{ message: 'Template sync initiated successfully' } — dispara o job de sincronizacao",
+    "common_use_cases": [
+      "Tornar visivel um template recem-criado via API (sai do estado vazio)",
+      "Atualizar status (aprovado/recusado) dos templates"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_whatsapp_templates_create",
+      "lionchat_inboxes_whatsapp_templates_create_2",
+      "lionchat_inboxes_whatsapp_templates_list"
+    ]
+  },
   {
     "id": "lionchat_inboxes_csat_template_list",
     "method": "GET",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "MCP server for LionChat API — 547 tools + 10 resources + 9 prompts. Audit-log aware, completion API, progress notifications.",
   "type": "module",
   "main": "dist/index.js",