@lionchat/mcp-server 0.5.1 → 0.5.3

package/dist/docs/instructions.md

@@ -57,6 +57,16 @@ Account (conta/empresa)
 - `agent` (atendente comum)
 - `administrator` (admin/dono)
 
+### Supervisor de caixa (InboxMember.auto_assignable)
+
+Independente do `role`, um membro de caixa pode ser **supervisor**: vê TODAS as conversas e cards
+daquela caixa, mas fica FORA da distribuição automática (round-robin nunca atribui a ele). É o flag
+`inbox_members.auto_assignable` (false = supervisor, true = membro comum). As tools
+`lionchat_inbox_members_create/update` separam `user_ids[]` (comuns) de `supervisor_ids[]`
+(supervisores); a resposta traz `is_supervisor` por agente. Lembre: agente não-admin só enxerga as
+caixas das quais participa — exceção é estar atribuído a um card, que libera só aquela conversa (ver
+`lionchat://docs/kanban-deep-dive`).
+
 ## 3. Convenções da API
 
 ### Datas
@@ -273,6 +283,11 @@ Antes de escolher a ferramenta, cheque se a intenção bate com a coluna da dire
 | **Exportar contatos** (CSV completo por e-mail) | `lionchat_contacts_export` | Respeita filtros/segmento aplicados |
 | Mensagem pra OUTRO AGENTE (não cliente) | `lionchat_internal_chat_*` (salas e mensagens do time) | NÃO confundir com nota privada (dentro da conversa do cliente) |
 | Achar contato pelo que aconteceu com ele (conversa/card) | `lionchat_contacts_filter` com `linked_records` | Ver api-conventions → registros vinculados |
+| **Origem dos leads** (de onde vieram, por plataforma/campanha/conjunto) | `lionchat_lead_origin_reports` | Relatório de leitura; filtros `platform`/`campaign`/`adset`; `won` = cards em Ganho; leads únicos por telefone |
+| **Bloquear/desbloquear** contato | `lionchat_conversations_toggle_block` (`blocked: true|false`) | Gera pílula de atividade e descarta mensagens futuras do contato; NÃO resolve a conversa |
+| **Importar histórico** de caixa WhatsApp Cloud (QR) | `lionchat_inboxes_whatsapp_history_start` / `_status` / `_cancel` | Admin-only + flag `qr_history_import`; só caixa oficial. Acompanhe `state` no `_status` |
+| **Definir supervisor** de caixa | `lionchat_inbox_members_create` / `_update` com `supervisor_ids[]` | Supervisor vê TUDO da caixa mas fica fora do rodízio (ver abaixo) |
+| Saber se a IA deve TOCAR a ligação WP (Wavoip) / marcar recusada | `lionchat_wavoip_should_ring` / `lionchat_wavoip_flag_rejected` | Controle fino do toque de chamada na caixa QR Code |
 
 ## 9. Quando NÃO chamar nenhuma ferramenta
 

package/dist/docs/resources/api-conventions.md

@@ -198,6 +198,10 @@ Ou para listas grandes (cursors):
 - `includes` / `excludes` (relacionamentos)
 - `before` / `after` (datas)
 
+> **Contatos — busca parcial por nome/ID externo:** no `POST /contacts/filter`, os campos `name` e
+> `identifier` aceitam `contains` / `does_not_contain` (match parcial, case-insensitive). Use isso
+> pra "contatos cujo nome contém X" sem precisar do valor exato.
+
 ## Formatos de Data
 
 ### Quando enviar (input)
@@ -374,6 +378,28 @@ O `field_mapping` do webhook personalizado aceita caminhos com índice de array:
 mesmo caminho captura valores diferentes. Campo `flow_id` na criação liga o webhook a um flow
 (webhook embutido — ver resource de fluxos).
 
+### Import de histórico do WhatsApp Cloud (2026-06)
+
+Caixas WhatsApp Cloud API podem importar o histórico de conversas via QR Code. Tools sob
+`/inboxes/:inbox_id/whatsapp_history`:
+
+- `lionchat_inboxes_whatsapp_history_start` — `POST` com param `days` (quantos dias de histórico
+  puxar). Inicia o processo.
+- `lionchat_inboxes_whatsapp_history_status` — `GET`, retorna `{state, qr, days, progress, stats,
+  error}`. Estados na ordem: `idle` → `scan_qr` → `importing` → `migrating` → `cleaning` →
+  `done` (ou `failed`). Quando `state = scan_qr`, o campo `qr` traz o código pra escanear.
+- `lionchat_inboxes_whatsapp_history_cancel` — `POST`, aborta o import em andamento.
+
+**Gates:** admin-only + feature flag `qr_history_import`. SÓ funciona em caixa WhatsApp Cloud API
+(`Channel::Whatsapp`) — não confundir com a importação de histórico do WAHA (QR Code não-oficial),
+que é outro mecanismo.
+
+### Ver histórico anterior do contato (2026-06)
+
+Dentro de uma conversa há um botão que mostra as CONVERSAS ANTERIORES do mesmo contato NA MESMA
+caixa. Não há endpoint novo pra isso — pra reproduzir via API, liste as conversas do contato
+filtrando pelo `inbox_id` (`conversations_list` / `conversations_filter` por contato + caixa).
+
 ## Headers úteis pra mandar
 
 - `Accept: application/json` (sempre)

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

@@ -180,6 +180,28 @@ Sem o tipo, o filtro pode bater no escopo errado. A UI mostra sufixo "(Conversa)
   pendência de permissão).
 - Meta CAPI: o evento `InitiateCheckout` foi RENOMEADO para `begin_checkout`.
 
+### Meta CAPI — moeda do valor (2026-06)
+
+O disparo da conversão aceita `currency` (código ISO, ex: `BRL`, `USD`); default `BRL`. Dá pra
+escolher a moeda no próprio disparo e também na config do funil (valor padrão herdado pelos cards
+daquele funil). Sempre confirme a moeda com o usuário se o valor não for em reais.
+
+### Meta Lead — resiliência da ativação e backfill (2026-06)
+
+A ativação ficou tolerante a falhas — não trava mais por causa de um lead de exemplo (sample) com
+formato estranho: o erro de sample é tolerado e a ativação segue. Outros ganhos de robustez:
+
+- **Auto-retry de limite:** quando bate o rate limit da Meta, tenta de novo sozinho com espera, em
+  vez de falhar de cara.
+- **Botão "7 dias" (backfill):** puxa leads recentes que ficaram pra trás. Parâmetro `days` (default
+  7, máximo 30). A resposta traz `mode`: `bulk` (puxa em lote pela API) ou `replay` (reprocessa
+  eventos já recebidos). Recupera inclusive leads que tinham sido ignorados antes.
+- **Sem `pages_manage_ads`:** funciona mesmo sem essa permissão específica da Meta.
+- **Log legível** dos eventos (em vez de dump cru) e suporte a **múltiplas BMs**.
+
+**Pro MCP:** ao acionar o backfill, informe ao usuário o `mode` retornado e quantos dias foram
+puxados. Se a ativação reclamar de sample, NÃO é bloqueio — a integração ainda fica ativa.
+
 ## Campanhas: audiência acumulativa (2026-06)
 
 `audience` aceita 3 tipos de seção combináveis: `Label`, `Funnel` (com stages/include_won/include_lost)

package/dist/docs/resources/data-model.md

@@ -58,9 +58,16 @@ Channel::Waha / Channel::Whatsapp / Channel::WebWidget / ...
 
 InboxMember (junction Inbox ↔ User)
 ├── inbox_id
-└── user_id
+├── user_id
+└── auto_assignable (bool) — true = membro comum (entra na distribuição automática);
+                              false = supervisor (vê TUDO da caixa, fora do rodízio)
 ```
 
+> **Supervisor de caixa:** o flag `inbox_members.auto_assignable = false` marca o membro como
+> supervisor. Ele enxerga todas as conversas/cards da caixa, mas o round-robin nunca atribui
+> conversas a ele. As tools `lionchat_inbox_members_create/update` separam `user_ids[]` (membros
+> comuns) de `supervisor_ids[]` (supervisores); a resposta expõe `is_supervisor` por agente.
+
 ## Conversação e Mensagens
 
 ```

package/dist/docs/resources/flowbuilder-design-guide.md

@@ -77,6 +77,14 @@ Todo node tem essa estrutura base:
 4. Salvar o flow (`flows_update`) — o save sincroniza a ativação do webhook embutido (remover o item desativa a integração automaticamente).
 Webhooks embutidos NÃO aparecem na listagem de integrações standalone; excluir o flow destrói o webhook; duplicar o flow NÃO copia o gatilho embutido. Rate limit do endpoint público: 60/min por token.
 
+**TRAVA DE GATILHO DUPLICADO (2026-06-16) — leia ANTES de ativar/criar flow ativo:** o sistema BLOQUEIA ter dois flows ATIVOS com o MESMO gatilho na MESMA inbox e mesmo `conversation_mode` (evita o evento disparar dois flows). Colisão = mesmo tipo de gatilho + config cruzando (mesmas keywords/funil/labels/url/etc) + inbox compartilhada + mesmo modo. EXCEÇÕES que podem coexistir: `webhook_received` e `manual_trigger`.
+- Ao **ativar** (`flows_toggle` inativo→ativo) ou **criar já ativo**: qualquer conflito é barrado.
+- Ao **editar** um flow já ativo: só conflito NOVO é barrado (duplicados que já existiam são preservados).
+- A API responde **422** com `{ "error_code": "flow_trigger_conflict", "conflicts": [{ flow_id, flow_name, trigger_type, inbox_id, inbox_name }] }`.
+- Existe `POST /flows/check_conflicts` (mesma assinatura, NÃO salva) pra checar antes.
+
+**Como a IA deve agir:** antes de ativar um flow, confira via `flows_list` se já não há outro flow ativo no mesmo gatilho+inbox. Se receber 422 `flow_trigger_conflict`, NÃO fique reativando — EXPLIQUE o conflito ao usuário (nome do flow conflitante + caixa) e ofereça desativar o outro flow ou ajustar o gatilho/keywords.
+
 **Handles que SAEM:** `success`.
 
 ### 2.2 `send_message`
@@ -133,7 +141,20 @@ Webhooks embutidos NÃO aparecem na listagem de integrações standalone; exclui
 }
 ```
 
-**`validation` válidos:** `any`, `options`, `regex`.
+**`validation` válidos:** `any`, `options`, `varied_options`, `regex`, `email`, `phone`, `number`.
+
+**`options` normaliza a resposta (2026-06-16):** a comparação com `acceptedOptions` é feita sem acento e sem maiúscula (`I18n.transliterate` + downcase + strip nos dois lados). "São Paulo", "sao paulo" e "SAO PAULO" casam todos.
+
+**`varied_options` — uma opção, vários jeitos de escrever (2026-06-16):** use quando a MESMA opção pode vir em sinônimos/variações (ex: "sim", "claro", "quero" → tudo é "sim"). Em vez de `acceptedOptions`, configure `optionGroups`: cada grupo tem uma lista de termos e um `matchType` PRÓPRIO (`contains` padrão, ou `equals`). Use `equals` quando o termo curto colidiria — ex: o termo "1" com `contains` casaria "12"; com `equals` não. Roteia por uma saída dedicada por grupo: `option_<group_id>` (uma por grupo, não por termo). Mesma normalização do `options` (sem acento/maiúscula). Fallback de matchType: se um grupo não tiver `matchType`, usa o `optionsMatchType` do node (modo global antigo); sem isso, `contains`.
+
+```json
+{ "validation": "varied_options",
+  "optionGroups": [
+    { "id": "sim", "terms": ["sim", "claro", "quero", "pode ser"], "matchType": "contains" },
+    { "id": "nao", "terms": ["nao", "não", "agora nao"], "matchType": "contains" }
+  ] }
+```
+→ edges: `sourceHandle: "option_sim"`, `sourceHandle: "option_nao"` (+ `timeout` + `retries_exhausted`).
 
 **`saveTo` válidos (nomes EXATOS — qualquer outro valor NÃO salva nada):**
 - `variable` — variável temporária do flow (use `saveVariable` pra nomear; senão usa o próprio `saveTo`)
@@ -146,14 +167,22 @@ Webhooks embutidos NÃO aparecem na listagem de integrações standalone; exclui
 
 **NÃO existem** `attribute` nem `contact_attribute` — use `conversation_attr` / `contact_attr`.
 
+**Salvar e-mail/telefone/nome do contato com segurança (2026-06-16):** o valor é normalizado antes de gravar (telefone → E.164 via `+55`; e-mail → strip). O cadastro do contato REVERTE silenciosamente um e-mail/telefone inválido (não dá erro, mas não muda). Por isso os destinos `contact_email`/`contact_phone`/`contact_name` SÓ devem ser usados com a validação que combina:
+- `saveTo: "contact_email"` → use `validation: "email"`
+- `saveTo: "contact_phone"` → use `validation: "phone"`
+- `saveTo: "contact_name"` → `any` serve
+No editor visual esses destinos só aparecem quando a validação bate (computed `allowedSaveTargets`). Os destinos `variable`/`contact_attr`/`conversation_attr` aceitam QUALQUER valor (sem essa restrição).
+
 **Handles que SAEM dependem da validation:**
-- `validation: 'any'` → `success`, `timeout`
-- `validation: 'options'` → `option_<valor>` para cada valor em `acceptedOptions` (ex: `option_1`, `option_2`, `option_sim`) + `timeout`
-- `validation: 'regex'` → `success`, `timeout`
+- `validation: 'any'` (e `regex`/`email`/`phone`/`number`) → `success`, `timeout`, `retries_exhausted`
+- `validation: 'options'` → `option_<valor>` para cada valor em `acceptedOptions` (ex: `option_1`, `option_2`, `option_sim`) + `timeout` + `retries_exhausted`
+- `validation: 'varied_options'` → `option_<group_id>` para cada grupo em `optionGroups` (ex: `option_sim`, `option_nao`) + `timeout` + `retries_exhausted`
+
+**`timeout` vs `retries_exhausted` (DISTINTOS):** `timeout` = cliente ficou em silencio (estourou `waitTime`). `retries_exhausted` = cliente respondeu, mas errou a validacao mais que `maxRetries` vezes. Ligue cada um ao caminho desejado. Se `retries_exhausted` nao tiver edge, ha fallback p/ o edge de `timeout`; sem nenhum dos dois, o flow encerra ao esgotar as tentativas.
 
 **Timeout AGORA dispara de verdade (corrigido 2026-06-09):** `waitTime` + `waitUnit` agendam o estouro — se o cliente não responder no prazo, o flow segue pelo handle `timeout`. Antes dessa data o backend ignorava o waitTime (flows antigos que dependiam do timeout passaram a funcionar). Sempre ligue um edge no handle `timeout` quando definir waitTime; sem edge, o flow simplesmente para ali no estouro.
 
-**REGRA:** depois de wait_response com options, NUNCA coloque node `condition` pra ramificar — ligue os edges direto nos handles `option_X`.
+**REGRA:** depois de wait_response com `options` OU `varied_options`, NUNCA coloque node `condition` pra ramificar — ligue os edges direto nos handles `option_X` (em `varied_options`, `X` é o `id` do grupo).
 
 ### 2.4 `condition`
 
@@ -459,6 +488,26 @@ Não tente contornar criando flows intermediários.
 
 ---
 
+## 2-C. Variáveis — de onde vêm e onde aparecem
+
+Variáveis de sessão (`{{nome}}`) são CRIADAS por alguns nodes e ficam disponíveis pros nodes seguintes. O autocomplete `{{` no editor é **ciente do grafo (graph-aware)**: num node, ele só lista variáveis definidas por nodes UPSTREAM (no caminho de execução até ali) — não sugere variável que ainda não existe no ponto da execução. Use isso como regra: só referencie `{{var}}` se algum node ANTES dele (no caminho) a tiver criado.
+
+Fontes de variável (quem cria o quê):
+
+| Node | Variável(is) criada(s) |
+|---|---|
+| `set_variable` | cada item de `data.variables[].name` |
+| `wait_response` com `saveTo: 'variable'` | o nome em `data.saveVariable` |
+| `ai` mode `generate` / `custom` | `aiResponseVar` (default `ai_response`) |
+| `ai` mode `intent` | `ai_intent` |
+| `ai` mode `sentiment` | `ai_sentiment` |
+| `ai` mode `extract` | cada `aiExtractParams[].name` (uma variável por parâmetro) |
+| `api` | `apiResponseVar` (+ `apiResponseVar`_status) e campos do JSON de resposta |
+
+Variáveis salvas em atributo (`saveTo: 'contact_attr'`/`'conversation_attr'`, ou node `action` `update_attribute`) NÃO viram variável de sessão `{{var}}` — leia-as via `{{contact.custom_attribute.X}}` / `{{conversation.custom_attribute.X}}` (singular).
+
+---
+
 ## 3. Edges
 
 ```json
@@ -540,6 +589,9 @@ Nodes nunca devem ficar com a mesma coordenada `(x, y)`. Se dois nodes têm posi
 | Edge com `target` apontando pra ID que não existe | Quebra o grafo | Confira que `target` está em `nodes[]` |
 | `channel_type: "WhatsApp"` | Precisa do nome de classe Rails | `"Channel::Whatsapp"`, `"Channel::Waha"`, `"Channel::WebWidget"` |
 | `validation: "option"` (singular) | Não existe | `"options"` (plural) |
+| `varied_options` com `acceptedOptions` | Modo errado de config | `optionGroups: [{ id, terms, matchType }]` |
+| `saveTo: "contact_phone"`/`"contact_email"` com `validation: "any"` | Cadastro reverte valor inválido em silêncio | Combine com `validation: "phone"`/`"email"` |
+| Ativar 2 flows no mesmo gatilho+inbox+modo | 422 `flow_trigger_conflict` (exceto webhook/manual) | Desative o outro flow ou mude o gatilho |
 | `custom_attributes` (plural) em `{{...}}` ou `field` | Resolve vazio | `custom_attribute` (singular) |
 | `update_attribute` com `{entity, key, value}` | Campos errados, não salva | `{attr_source, attr_key, attr_value}` |
 | `saveTo: "attribute"` ou `"contact_attribute"` | Não existem, não salva | `"conversation_attr"` / `"contact_attr"` |
@@ -572,5 +624,7 @@ Antes de chamar `flows_create` ou `flows_update`, valide mentalmente:
 - [ ] Todo `sourceHandle` é um handle real exposto pelo node source (seção 2)
 - [ ] `channel_type` é classe Rails (`Channel::Waha` etc)
 - [ ] `inbox_ids` (se enviado) tem inboxes do mesmo `channel_type`
-- [ ] Não tem `condition` redundante depois de `wait_response` com options
+- [ ] Não tem `condition` redundante depois de `wait_response` com `options`/`varied_options`
+- [ ] `wait_response` que salva e-mail/telefone do contato usa a validação correspondente (`email`/`phone`)
+- [ ] Antes de ATIVAR: nenhum outro flow ativo no mesmo gatilho+inbox+modo (senão vem 422 `flow_trigger_conflict`)
 - [ ] Layout: nodes em ordem visual da esquerda pra direita, sem sobreposição

package/dist/docs/resources/flowbuilder-patterns.md

@@ -433,6 +433,55 @@
 
 ---
 
+## 14. Sim/Não com sinônimos (varied_options) + salvar e-mail com segurança
+
+**Caso:** cliente pode responder "sim" de vários jeitos ("claro", "quero", "pode ser") — `varied_options` agrupa tudo numa só saída. Depois pede o e-mail e salva no cadastro com a validação certa (`email`), pra não ser revertido em silêncio.
+
+```json
+{
+  "nodes": [
+    { "id": "n1", "type": "start", "position": { "x": 50, "y": 300 }, "data": { "label": "Início", "triggers": [{ "type": "conversation_created" }] } },
+    { "id": "n2", "type": "send_message", "position": { "x": 370, "y": 300 }, "data": { "label": "Oferece", "messageItems": [
+      { "id": "m1", "type": "text", "content": "Quer receber nossas novidades por e-mail?" }
+    ] } },
+    { "id": "n3", "type": "wait_response", "position": { "x": 690, "y": 300 }, "data": {
+      "label": "Quer?", "waitTime": 30, "waitUnit": "minutes", "validation": "varied_options",
+      "optionGroups": [
+        { "id": "sim", "terms": ["sim", "claro", "quero", "pode ser", "aceito"], "matchType": "contains" },
+        { "id": "nao", "terms": ["nao", "não", "agora nao", "passo"], "matchType": "contains" }
+      ],
+      "invalidMessage": "Responda com sim ou não, por favor.", "maxRetries": 2, "saveTo": ""
+    } },
+    { "id": "n4", "type": "send_message", "position": { "x": 1010, "y": 180 }, "data": { "label": "Pede e-mail", "messageItems": [
+      { "id": "m2", "type": "text", "content": "Show! Qual seu melhor e-mail?" }
+    ] } },
+    { "id": "n5", "type": "wait_response", "position": { "x": 1330, "y": 180 }, "data": {
+      "label": "Captura e-mail", "waitTime": 15, "waitUnit": "minutes", "validation": "email",
+      "invalidMessage": "Esse e-mail não parece válido, pode conferir?", "maxRetries": 2,
+      "saveTo": "contact_email"
+    } },
+    { "id": "n6", "type": "send_message", "position": { "x": 1650, "y": 180 }, "data": { "label": "Confirma", "messageItems": [
+      { "id": "m3", "type": "text", "content": "Pronto, anotei aqui. Obrigado!" }
+    ] } },
+    { "id": "n7", "type": "send_message", "position": { "x": 1010, "y": 420 }, "data": { "label": "Tudo bem", "messageItems": [
+      { "id": "m4", "type": "text", "content": "Sem problema! Qualquer coisa é só chamar." }
+    ] } }
+  ],
+  "edges": [
+    { "id": "e1", "source": "n1", "target": "n2", "sourceHandle": "success", "type": "deletable", "animated": true },
+    { "id": "e2", "source": "n2", "target": "n3", "sourceHandle": "success", "type": "deletable", "animated": true },
+    { "id": "e3", "source": "n3", "target": "n4", "sourceHandle": "option_sim", "type": "deletable", "animated": true },
+    { "id": "e4", "source": "n3", "target": "n7", "sourceHandle": "option_nao", "type": "deletable", "animated": true },
+    { "id": "e5", "source": "n4", "target": "n5", "sourceHandle": "success", "type": "deletable", "animated": true },
+    { "id": "e6", "source": "n5", "target": "n6", "sourceHandle": "success", "type": "deletable", "animated": true }
+  ]
+}
+```
+
+**Lembretes:** em `varied_options` o handle é `option_<id do grupo>` (não por termo); use `matchType: "equals"` quando um termo curto colidiria (ex: "1" casando "12" com `contains`). Pra salvar telefone use `validation: "phone"` + `saveTo: "contact_phone"`.
+
+---
+
 ## Como usar este catálogo
 
 1. **Identifique o pattern mais próximo** do que o cliente pediu
@@ -440,6 +489,6 @@
 3. **Substitua os IDs e valores reais** (team_id, funnel_id, assistant_id, templateId, URLs, etc) — confira antes via `teams_list`, `funnels_list`, `captain_assistants_list`, `inboxes_whatsapp_templates_list`
 4. **Adicione campos do flow**: `name`, `description`, `channel_type` (`Channel::Waha` etc), `inbox_ids`
 5. **Chame `flows_create`** com o payload completo
-6. Após criar, **ative** com `flows_toggle` se o cliente quiser que rode já
+6. Após criar, **ative** com `flows_toggle` se o cliente quiser que rode já. ATENÇÃO (2026-06-16): se já existir outro flow ATIVO com o mesmo gatilho na mesma inbox (e mesmo modo), a ativação retorna **422 `flow_trigger_conflict`** — exceto `webhook_received`/`manual_trigger`, que podem coexistir. Não fique reativando: explique o conflito ao usuário (qual flow + qual caixa) e ofereça desativar o outro ou mudar o gatilho. Dá pra checar antes com `POST /flows/check_conflicts` (não salva). Detalhes no `flowbuilder-design-guide` (seção 2.1, "Trava de gatilho duplicado").
 
 Se a necessidade não bate com nenhum pattern, monte do zero seguindo o **`flowbuilder-design-guide`** — mas use estes templates como referência de layout/handle/schema válidos.

package/dist/docs/resources/glossary.md

@@ -108,6 +108,21 @@ Glossário completo de termos, status codes, enums e conceitos da plataforma. Us
 - `source_id`: ID do contato no canal (ex: `5511999999999@c.us` no WhatsApp WAHA)
 - Um contato pode ter vários ContactInboxes (um por canal)
 
+### Bloqueio de contato (`blocked`)
+
+**Termo:** "bloquear contato" / "contato bloqueado".
+
+**O que é:** marca o contato como bloqueado. Quando bloqueado, mensagens recebidas dele são
+DESCARTADAS na entrada (não criam conversa nem notificam). Bloquear NÃO resolve a conversa atual.
+
+**Como aplicar via tools:**
+- Forma dedicada: `lionchat_conversations_toggle_block` — `POST .../conversations/:id/toggle_block`
+  com body `{blocked: true|false}`. Bloqueia/desbloqueia o contato DAQUELA conversa e gera uma
+  pílula de atividade ("contato bloqueado") na timeline.
+- Forma alternativa: o atributo `blocked` no update de contato (`lionchat_contacts_update`) também
+  liga/desliga o bloqueio — mas SEM a pílula de atividade. Prefira `toggle_block` quando estiver
+  no contexto de uma conversa.
+
 ## Inbox (Caixa de Entrada / Canal)
 
 ### `channel_type`
@@ -136,6 +151,23 @@ Glossário completo de termos, status codes, enums e conceitos da plataforma. Us
 - `working_hours_enabled`: se respeita horário de atendimento
 - `greeting_enabled` / `greeting_message`: mensagem de boas-vindas
 
+### Supervisor de caixa (InboxMember.auto_assignable = false)
+
+**Termo:** "Supervisor de caixa" / "supervisor da caixa de entrada".
+
+**O que é:** um membro da caixa marcado como supervisor. Ele VÊ TODAS as conversas e cards
+daquela caixa (visão completa), mas fica FORA da distribuição automática (round-robin) — ou seja,
+o sistema nunca atribui conversas novas a ele automaticamente. Serve pra gestor/líder que precisa
+acompanhar tudo sem entrar na fila de atendimento.
+
+**Onde fica armazenado:** flag `inbox_members.auto_assignable` (boolean). Membro comum =
+`auto_assignable: true` (entra no rodízio); supervisor = `auto_assignable: false` (vê tudo, fora
+do rodízio).
+
+**Como definir/ler via tools:** `lionchat_inbox_members_create` e `lionchat_inbox_members_update`
+aceitam `supervisor_ids[]` além de `user_ids[]` — os IDs em `supervisor_ids` viram supervisores;
+os de `user_ids` viram membros comuns. A resposta traz `is_supervisor` (boolean) por agente.
+
 ## KanbanItem (Card do CRM)
 
 ### Estrutura
@@ -350,6 +382,13 @@ por FASES configuráveis (LiontrackJourneyStage: padrão de URL → fase, match
 Feature flag `liontrack` (404 sem ela). Relatório: `journey_funnel_reports` (v2), janela máx 30
 dias, URLs sem querystring (LGPD).
 
+## Meta CAPI — moeda do evento de conversão (2026-06)
+
+Ao disparar uma conversão pro Meta (Conversions API), o valor agora carrega uma moeda. Parâmetro
+`currency` (código ISO, ex: `BRL`, `USD`); default `BRL` quando omitido. A moeda pode ser escolhida
+tanto no disparo individual da conversão quanto na configuração do funil (valor padrão herdado pelos
+cards daquele funil).
+
 ## Idiomas da plataforma (2026-06)
 
 A plataforma opera com 6 idiomas: `en`, `es`, `fr`, `it`, `pt`, `pt_BR` (default das contas

package/dist/docs/resources/kanban-deep-dive.md

@@ -272,6 +272,32 @@ Funis agora têm visibilidade por usuário. Um funil é visível pra alguém qua
 **Pro MCP:** antes de tentar mover/editar card, confira os campos `can_*` do show — se `can_move`
 é false, explique ao usuário que ele não tem acesso àquele funil em vez de tentar mesmo assim.
 
+## Controle de acesso por CAIXA (conversas + cards) e a "ponte" da conversa atribuída (2026-06)
+
+Além da visibilidade por funil (acima), há um controle de acesso POR CAIXA que vale tanto pro
+Kanban quanto pras CONVERSAS. Um agente NÃO-admin só vê as conversas e os cards das caixas das quais
+ele é membro (membro comum OU supervisor — ver "Supervisor de caixa" no glossário). Admin vê tudo.
+
+**A ponte (exceção pontual):** estar ATRIBUÍDO a um card dá acesso PONTUAL à conversa daquele card,
+mesmo que o agente não seja membro da caixa. A ponte vale pra:
+- a conversa PRINCIPAL do card (`conversation_display_id`), e
+- as conversas em `linked_conversations`.
+
+O que a ponte libera: ABRIR e RESPONDER aquela conversa específica. O que a ponte NÃO libera: a
+caixa inteira (o agente continua sem ver as outras conversas/cards daquela caixa). A atribuição é a
+qualquer agente no card (`assigned_agents`), não só ao responsável da conversa.
+
+**Efeitos práticos nas tools (lado conversas):**
+- `conversations_list` / `conversations_search` retornam SÓ conversas de caixas acessíveis (mais as
+  liberadas pela ponte de card atribuído).
+- `conversations_show` / `conversations_messages_*` de conversa inacessível → **404**.
+- Buscar card por ID ou rodar ação em massa (`kanban_bulk_bulk_actions`, export) numa caixa
+  inacessível → **404** (a ação não vaza cards de caixa que o agente não pode ver).
+
+**Pro MCP:** se uma conversa/card "some" da listagem ou dá 404 pra um agente que jura que existe,
+provavelmente é acesso por caixa — explique que ele só vê as caixas das quais participa, e que o
+acesso a uma conversa solta vem de estar atribuído ao card dela.
+
 ## Funil arquivado vs ativo
 
 - `archived = true`: funil escondido da UI principal. Cards ainda existem mas não aparecem nas listas

package/dist/docs/resources/reports-guide.md

@@ -300,6 +300,33 @@ fase, match literal de substring, sem regex).
 **Perguntas que esse relatório responde:** "por onde os leads entram?", "qual página perde mais
 gente?", "quem veio da campanha X navegou por onde antes de chamar?".
 
+## Origem dos Leads — relatório novo (2026-06)
+
+`GET /api/v2/accounts/{id}/lead_origin_reports` (tool `lionchat_lead_origin_reports`) — agrega de
+ONDE vieram os leads, cruzando os campos `origin_*` das conversas com os leads órfãos (que ainda não
+viraram conversa). É um relatório de LEITURA puro — não cria nem altera nada.
+
+**Filtros (query, todos opcionais):** `since` / `until` (ISO 8601; default = 30 dias atrás → agora),
+`funnel_id`, `platform`, `kind`, `campaign`, `adset`, `group_by`.
+
+**Retorno:**
+- `period` — janela efetiva considerada.
+- `totals` — `conversations`, `classified` (com origem identificada), `unclassified` (sem origem),
+  `orphan_leads` (leads sem conversa ainda), `unique_leads` (deduplicados por TELEFONE),
+  `won_leads` (leads em cards de estágio de Ganho) e `conversion_rate`.
+- Arrays de quebra: `by_platform`, `by_kind`, `by_campaign`, `by_adset`, `by_creative`. Cada linha
+  tem `{value, conversations, won, conversion_rate}`.
+
+**Conceitos importantes:**
+- `won` = cards parados em etapas de GANHO do funil (fechados como sucesso).
+- `unique_leads` deduplica por telefone (mesmo lead que falou várias vezes conta 1).
+- "orphan lead" = lead capturado (ex: Meta Lead) que ainda não tem conversa associada.
+
+**Gates:** permissão de relatórios (admin ou report_manage).
+
+**Perguntas que esse relatório responde:** "qual plataforma trouxe mais leads?", "qual campanha/
+conjunto converteu melhor?", "quantos leads únicos vieram esse mês e quantos fecharam?".
+
 ## Quando o usuário pede algo MUITO específico que não existe num endpoint
 
 Se a pergunta requer cálculos custom (ex: "conversas por agente que duraram mais de X minutos"):

package/dist/tools.js

@@ -283,7 +283,7 @@ function registerListCategoriesTool(server, allEndpoints) {
 // Helps LLMs build correct flow_data without hitting trial-and-error on
 // node types, action keys, source handles, etc.
 function registerFlowsSchemaReferenceTool(server) {
-    const reference = `LIONCHAT FLOW BUILDER — SCHEMA REFERENCE (atualizado 2026-06-11)
+    const reference = `LIONCHAT FLOW BUILDER — SCHEMA REFERENCE (atualizado 2026-06-16)
 
 flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
 
@@ -332,19 +332,32 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
 ▸ wait_response
   data: {
     label, waitTime, waitUnit: "minutes"|"seconds"|"hours",
-    validation: "any"|"options"|"regex",
+    groupInputsSeconds: 0|10|15|20|25|30|40,   // 0=off (padrao). Agrupa baloes picados do cliente antes de validar (debounce)
+    validation: "any"|"number"|"email"|"phone"|"options"|"varied_options"|"regex"|"cpf"|"cnpj"|"cpf_cnpj"|"date"|"rg"|"profession",
     acceptedOptions: ["1","2"],     // se validation='options'
+    optionGroups: [{ id, terms:["sim","claro"], matchType:"contains"|"equals" }], // se validation='varied_options'
     regexPattern,                    // se validation='regex'
     invalidMessage, maxRetries,
-    saveTo: "variable"|"contact_name"|"contact_email"|"contact_phone"|"contact_attr"|"conversation_attr"|"",
+    saveTo: "variable"|"contact_name"|"contact_email"|"contact_phone"|"contact_cpf"|"contact_cnpj"|"contact_document"|"contact_birthdate"|"contact_rg"|"contact_profession"|"contact_attr"|"conversation_attr"|"",
     saveVariable, saveAttrKey        // saveAttrKey obrigatorio p/ contact_attr e conversation_attr
   }
+  CPF/CNPJ validam digito verificador (documento falso -> invalidMessage). Alvos cadastrais so com a validation
+    correspondente: cpf=>contact_cpf, cnpj=>contact_cnpj, cpf_cnpj=>contact_document (decide pelos digitos),
+    date=>contact_birthdate (dd/mm/aaaa->ISO), rg=>contact_rg, profession=>contact_profession. Campo cadastral
+    ja preenchido NAO e sobrescrito (imutavel). saveTo contact_attr/conversation_attr: se o atributo tiver tipo
+    (number/currency/percent/date/list ou text+regex), a resposta tambem e validada/formatada por esse tipo.
   saveTo "attribute"/"contact_attribute" NAO EXISTEM — nao salvam nada.
   TIMEOUT DISPARA DE VERDADE (corrigido 2026-06-09): waitTime estourou -> handle "timeout"
   (ou "option_{val}_timeout" no modo options). Sempre ligue um edge no timeout.
+  Respostas invalidas alem de maxRetries -> handle "retries_exhausted" (distinto do timeout de silencio;
+    se nao houver edge nele, cai no "timeout").
   Handles validation='options': "option_{val}" por opcao + "timeout"
+  Handles validation='varied_options': "option_{group_id}" por grupo (optionGroups) + "timeout"
   Handles outros: "success" + "timeout"
-  IMPORTANTE: validation='options' ja roteia por opcao — NAO precisa condition depois.
+  options/varied_options normalizam a resposta (sem acento/maiuscula); varied_options usa matchType por
+    grupo ('contains' padrao ou 'equals'). saveTo contact_email/contact_phone exige validation 'email'/'phone'
+    (valor invalido NAO grava; telefone vira E.164) — pra texto livre use saveTo "variable".
+  IMPORTANTE: validation='options'/'varied_options' ja roteia por opcao/grupo — NAO precisa condition depois.
 
 ▸ condition
   data: { label, conditions: [

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/endpoints.json

@@ -1055,7 +1055,7 @@
         "location": "query",
         "required": false,
         "query_name": "labels[]",
-        "description": "Labels (tags) — array de títulos"
+        "description": "Labels (tags) — array de titulos. Conta conversas marcadas com a etiqueta E conversas cujo CONTATO tem a etiqueta (uniao)."
       }
     ],
     "returns": "{ meta: { mine_count, assigned_count, unassigned_count, all_count } }",
@@ -1122,7 +1122,7 @@
         "location": "query",
         "required": false,
         "query_name": "labels[]",
-        "description": "Labels (tags) — array de títulos"
+        "description": "Labels (tags) — array de titulos. Traz conversas marcadas com a etiqueta E conversas cujo CONTATO tem a etiqueta (uniao). Cada conversa retorna 'labels' (da conversa) e 'contact_labels' (do contato)."
       },
       {
         "name": "sort_by",
@@ -2004,7 +2004,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages/search",
     "title": "Buscar Mensagens",
-    "description": "Busca mensagens por texto dentro de uma conversa. Suporta private_only e file_type.\n\nNOVO (2026-06): 'q' aceita multiplos termos (espacos = E/AND, cap 5; cada termo precisa bater) e dados cadastrais (CPF/CNPJ/RG por digitos, ignora pontuacao).",
+    "description": "Busca mensagens por texto dentro de uma conversa. Suporta private_only e file_type.\n\nNOVO (2026-06): 'q' aceita multiplos termos (espacos = E/AND, cap 5; cada termo precisa bater) e dados cadastrais (CPF/CNPJ/RG por digitos, ignora pontuacao). NOVO (2026-06-16): casa por TRECHO/substring (multi-termo AND — ex.: 'época d' acha 'época do'); e cada resultado de mensagem inclui previous_message e next_message (as mensagens anterior e seguinte da MESMA conversa, em ordem cronológica, ignorando eventos de sistema) como objeto {id, content, sender_name, message_type, private, created_at} ou null quando não há vizinha.",
     "category": "Mensagens",
     "params": [
       {
@@ -2063,6 +2063,13 @@
         "location": "query",
         "required": false,
         "description": "Filtros estruturados aplicados aos resultados de CARDS. JSON-string de condicoes no formato do endpoint /filter correspondente (ex: [{\"attribute_key\":\"status\",\"filter_operator\":\"equal_to\",\"values\":[\"open\"]}]). Cap 10 condicoes; payload invalido = 422"
+      },
+      {
+        "name": "favorited",
+        "type": "boolean",
+        "location": "query",
+        "required": false,
+        "description": "Apenas mensagens favoritadas (true). Favorito GLOBAL — vale para todos os atendentes."
       }
     ],
     "returns": "payload (array de mensagens, geralmente 25 resultados)",
@@ -2077,6 +2084,39 @@
       "lionchat_conversations_messages_update"
     ]
   },
+  {
+    "id": "lionchat_conversations_messages_toggle_favorite",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages/{id}/toggle_favorite",
+    "title": "Favoritar/Desfavoritar Mensagem",
+    "description": "Inverte o estado de favorita de uma mensagem (favorito GLOBAL — todos os atendentes veem a mesma estrela; atualiza em tempo real). Toggle puro: nao recebe corpo, so alterna. Use o filtro favorited=true na busca de mensagens para listar as favoritadas.",
+    "category": "Mensagens",
+    "params": [
+      {
+        "name": "conversation_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "Display ID da conversa"
+      },
+      {
+        "name": "id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da mensagem"
+      }
+    ],
+    "returns": "Mensagem serializada com o novo estado em 'favorited' (booleano)",
+    "common_use_cases": [
+      "Marcar uma mensagem importante para todos os atendentes",
+      "Desfavoritar uma mensagem"
+    ],
+    "related_tools": [
+      "lionchat_conversations_messages_search",
+      "lionchat_conversations_messages_list"
+    ]
+  },
   {
     "id": "lionchat_conversations_messages_create_1",
     "method": "POST",
@@ -7504,7 +7544,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/search",
     "title": "Busca Global",
-    "description": "Busca global por texto (conversas, contatos, mensagens, artigos) — sempre retorna todos os tipos. Para um tipo unico use /search/conversations|contacts|messages.\n\nNOVO (2026-06): 'q' aceita multiplos termos (espacos = E/AND, cap 5; cada termo precisa bater) e dados cadastrais (CPF/CNPJ/RG por digitos, ignora pontuacao).",
+    "description": "Busca global por texto (conversas, contatos, mensagens, artigos) — sempre retorna todos os tipos. Para um tipo unico use /search/conversations|contacts|messages.\n\nNOVO (2026-06): 'q' aceita multiplos termos (espacos = E/AND, cap 5; cada termo precisa bater) e dados cadastrais (CPF/CNPJ/RG por digitos, ignora pontuacao). Sempre retorna todos os tipos: conversations, contacts, messages, articles e kanban_items. Mensagens trazem previous_message/next_message.",
     "category": "Busca",
     "params": [
       {
@@ -7571,7 +7611,7 @@
         "description": "Filtros estruturados aplicados aos resultados de CARDS. JSON-string de condicoes no formato do endpoint /filter correspondente (ex: [{\"attribute_key\":\"status\",\"filter_operator\":\"equal_to\",\"values\":[\"open\"]}]). Cap 10 condicoes; payload invalido = 422"
       }
     ],
-    "returns": "payload (array de resultados de busca, geralmente 25 resultados)",
+    "returns": "Resultado por tipo: conversations, contacts, messages, articles e kanban_items (cards do Kanban). Cada mensagem inclui previous_message/next_message (contexto vizinho).",
     "common_use_cases": [
       "Localizar resultado de busca pelo nome",
       "Buscar pelo email/telefone parcial",
@@ -7694,7 +7734,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/search/messages",
     "title": "Buscar Mensagens",
-    "description": "Busca apenas em mensagens por texto.\n\nNOVO (2026-06): 'q' aceita multiplos termos (espacos = E/AND, cap 5; cada termo precisa bater) e dados cadastrais (CPF/CNPJ/RG por digitos, ignora pontuacao).",
+    "description": "Busca apenas em mensagens por texto.\n\nNOVO (2026-06): 'q' aceita multiplos termos (espacos = E/AND, cap 5; cada termo precisa bater) e dados cadastrais (CPF/CNPJ/RG por digitos, ignora pontuacao). NOVO (2026-06-16): casa por TRECHO/substring (multi-termo AND — ex.: 'época d' acha 'época do'); e cada resultado de mensagem inclui previous_message e next_message (as mensagens anterior e seguinte da MESMA conversa, em ordem cronológica, ignorando eventos de sistema) como objeto {id, content, sender_name, message_type, private, created_at} ou null quando não há vizinha.",
     "category": "Busca",
     "params": [
       {
@@ -10755,11 +10795,60 @@
     "category": "Ofertas",
     "params": [
       {
-        "name": "offer",
-        "type": "object",
+        "name": "title",
+        "type": "string",
         "location": "body",
         "required": true,
-        "description": "Wrapper com { title, value, currency, type (product/service), description, prices: [{label, value, currency, description, checkout_url}], links: [{label, url}], image }. value auto-derivado do menor prices[].value quando prices presente."
+        "description": "Titulo da oferta/produto"
+      },
+      {
+        "name": "value",
+        "type": "number",
+        "location": "body",
+        "required": false,
+        "description": "Valor base"
+      },
+      {
+        "name": "currency",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Moeda (ex: BRL)"
+      },
+      {
+        "name": "image",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "URL da imagem"
+      },
+      {
+        "name": "type",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Tipo da oferta"
+      },
+      {
+        "name": "description",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Descricao da oferta"
+      },
+      {
+        "name": "prices",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Lista de precos/planos: [{label,value,currency,description,checkout_url}]"
+      },
+      {
+        "name": "links",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Lista de links: [{label,url}]"
       }
     ],
     "returns": "oferta criado (com novo ID)",
@@ -10811,11 +10900,60 @@
         "description": "ID da oferta"
       },
       {
-        "name": "offer",
-        "type": "object",
+        "name": "title",
+        "type": "string",
         "location": "body",
-        "required": true,
-        "description": "Wrapper com { title, value, currency, type, description, prices, links, image, remove_image }. Todos os campos opcionais."
+        "required": false,
+        "description": "Titulo da oferta/produto"
+      },
+      {
+        "name": "value",
+        "type": "number",
+        "location": "body",
+        "required": false,
+        "description": "Valor base"
+      },
+      {
+        "name": "currency",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Moeda (ex: BRL)"
+      },
+      {
+        "name": "image",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "URL da imagem"
+      },
+      {
+        "name": "type",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Tipo da oferta"
+      },
+      {
+        "name": "description",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Descricao da oferta"
+      },
+      {
+        "name": "prices",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Lista de precos/planos: [{label,value,currency,description,checkout_url}]"
+      },
+      {
+        "name": "links",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Lista de links: [{label,url}]"
       }
     ],
     "returns": "oferta atualizado",
@@ -12325,7 +12463,7 @@
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/account_variables",
     "title": "Criar Variável",
-    "description": "Cria uma nova variável da conta. Se secret=true, valor é criptografado. Cria novo variável de conta. Obrigatórios: key. Valida unicidade quando aplicável. Retorna o variável de conta criado com ID atribuído.",
+    "description": "Cria uma nova variável da conta. Para valor secreto/criptografado, use attribute_display_type=secret (o apelido legado encrypted_text também funciona). Cria novo variável de conta. Obrigatórios: key. Valida unicidade quando aplicável. Retorna o variável de conta criado com ID atribuído.",
     "category": "Variaveis da Conta",
     "params": [
       {
@@ -12354,7 +12492,7 @@
         "type": "string",
         "location": "body",
         "required": false,
-        "description": "Tipo do valor: text (padrao), encrypted_text (secret), number, checkbox, list, link, date"
+        "description": "Tipo do valor: text (padrão), secret (valor secreto — guardado criptografado), number, checkbox, list, link, date. Apelido legado: encrypted_text é aceito e convertido para secret automaticamente. Tipo fora dessa lista retorna 422."
       },
       {
         "name": "value",
@@ -19211,7 +19349,7 @@
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/inbox_members",
     "title": "Definir Membros da Inbox",
-    "description": "Define os agentes membros da inbox (substitui a lista). Para adicionar incrementalmente, leia a lista atual e mescle.",
+    "description": "Define os agentes membros da inbox (substitui a lista). Para adicionar incrementalmente, leia a lista atual e mescle. Use supervisor_ids[] para marcar supervisores (veem tudo, fora da distribuicao automatica); a resposta traz is_supervisor por agente.",
     "category": "Membros de Inbox",
     "params": [
       {
@@ -19227,6 +19365,13 @@
         "location": "body",
         "required": true,
         "description": "Array de IDs dos agentes"
+      },
+      {
+        "name": "supervisor_ids",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "IDs dos membros que entram como SUPERVISORES da caixa: veem TODAS as conversas/cards dela, mas ficam FORA da distribuicao automatica (round-robin). Quem nao estiver aqui (e estiver em user_ids) vira agente normal. A resposta traz is_supervisor por agente."
       }
     ],
     "returns": "lista de agentes atualizada",
@@ -19274,7 +19419,7 @@
     "method": "PATCH",
     "path": "/api/v1/accounts/{account_id}/inbox_members",
     "title": "Atualizar Membros da Inbox",
-    "description": "Atualiza os agentes membros da inbox (substitui a lista).",
+    "description": "Atualiza os agentes membros da inbox (substitui a lista). Use supervisor_ids[] para marcar supervisores (veem tudo, fora da distribuicao automatica); a resposta traz is_supervisor por agente.",
     "category": "Membros de Inbox",
     "params": [
       {
@@ -19290,6 +19435,13 @@
         "location": "body",
         "required": true,
         "description": "Nova lista de IDs"
+      },
+      {
+        "name": "supervisor_ids",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "IDs dos membros que entram como SUPERVISORES da caixa: veem TODAS as conversas/cards dela, mas ficam FORA da distribuicao automatica (round-robin). Quem nao estiver aqui (e estiver em user_ids) vira agente normal. A resposta traz is_supervisor por agente."
       }
     ],
     "returns": "lista de agentes atualizada",
@@ -19694,11 +19846,60 @@
     "category": "Atributos Personalizados",
     "params": [
       {
-        "name": "custom_attribute_definition",
-        "type": "object",
+        "name": "attribute_display_name",
+        "type": "string",
+        "location": "body",
+        "required": true,
+        "description": "Nome de exibicao do atributo (ex: 'Perfil')"
+      },
+      {
+        "name": "attribute_display_type",
+        "type": "string",
+        "location": "body",
+        "required": true,
+        "description": "Tipo de exibicao: text, number, link, date, list, checkbox, currency, percent ou secret"
+      },
+      {
+        "name": "attribute_key",
+        "type": "string",
         "location": "body",
         "required": true,
-        "description": "Wrapper com { attribute_display_name, attribute_display_type (text/number/link/date/list/checkbox), attribute_model (contact_attribute/conversation_attribute, default conversation_attribute), attribute_key (slug snake_case), attribute_description, attribute_values (para tipo list), regex_pattern, regex_cue }"
+        "description": "Slug unico em snake_case (ex: 'perfil')"
+      },
+      {
+        "name": "attribute_model",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "contact_attribute ou conversation_attribute (default conversation_attribute)"
+      },
+      {
+        "name": "attribute_description",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Descricao do atributo"
+      },
+      {
+        "name": "attribute_values",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Opcoes quando o tipo for list (ex: ['MCMV','SBPE','Investidor'])"
+      },
+      {
+        "name": "regex_pattern",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Regex de validacao (opcional)"
+      },
+      {
+        "name": "regex_cue",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Dica do formato esperado (opcional)"
       }
     ],
     "returns": "atributo personalizado criado (com novo ID)",
@@ -19758,11 +19959,60 @@
         "description": "ID da definicao"
       },
       {
-        "name": "custom_attribute_definition",
-        "type": "object",
+        "name": "attribute_display_name",
+        "type": "string",
         "location": "body",
-        "required": true,
-        "description": "Wrapper com os mesmos campos do create { attribute_display_name, attribute_display_type, attribute_model, attribute_key, attribute_description, attribute_values, regex_pattern, regex_cue }"
+        "required": false,
+        "description": "Nome de exibicao do atributo"
+      },
+      {
+        "name": "attribute_display_type",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Tipo de exibicao: text, number, link, date, list, checkbox, currency, percent ou secret"
+      },
+      {
+        "name": "attribute_key",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Slug unico em snake_case"
+      },
+      {
+        "name": "attribute_model",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "contact_attribute ou conversation_attribute"
+      },
+      {
+        "name": "attribute_description",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Descricao do atributo"
+      },
+      {
+        "name": "attribute_values",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Opcoes quando o tipo for list"
+      },
+      {
+        "name": "regex_pattern",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Regex de validacao (opcional)"
+      },
+      {
+        "name": "regex_cue",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Dica do formato esperado (opcional)"
       }
     ],
     "returns": "atributo personalizado atualizado",
@@ -23870,5 +24120,252 @@
     "related_tools": [
       "lionchat_inboxes_show"
     ]
+  },
+  {
+    "id": "lionchat_lead_origin_reports",
+    "method": "GET",
+    "path": "/api/v2/accounts/{account_id}/lead_origin_reports",
+    "title": "Relatório de Origem dos Leads",
+    "description": "SÓ LEITURA. Agregado de origem dos leads/conversas: de qual plataforma, tipo, campanha, conjunto de anúncios e criativo vieram, com totais e taxa de conversão. Janela padrão: últimos 30 dias. Cruza os atributos origin_* das conversas + leads órfãos (contatos sem conversa); 'won' = cards em estágios de ganho do Kanban; leads únicos deduplicados por telefone. Permite drill-down por níveis (plataforma → tipo → campanha → conjunto → criativo).",
+    "category": "Relatorios",
+    "params": [
+      {
+        "name": "since",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Início ISO 8601 (padrão: 30 dias atrás)"
+      },
+      {
+        "name": "until",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Fim ISO 8601 (padrão: agora)"
+      },
+      {
+        "name": "funnel_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por funil do Kanban"
+      },
+      {
+        "name": "platform",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por plataforma de origem"
+      },
+      {
+        "name": "kind",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por tipo de origem"
+      },
+      {
+        "name": "campaign",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por campanha"
+      },
+      {
+        "name": "adset",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por conjunto de anúncios"
+      },
+      {
+        "name": "group_by",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Agrupamento do resultado: platform, kind, campaign, adset ou creative"
+      }
+    ],
+    "returns": "{ period, totals: { conversations, classified, unclassified, orphan_leads, unique_leads, won_leads, conversion_rate }, by_platform, by_kind, by_campaign, by_adset, by_creative }",
+    "common_use_cases": [
+      "Ver de onde vêm os leads (campanha, anúncio, plataforma)",
+      "Medir taxa de conversão por origem",
+      "Comparar desempenho de campanhas/criativos"
+    ],
+    "related_tools": [
+      "lionchat_journey_funnel_reports"
+    ]
+  },
+  {
+    "id": "lionchat_inboxes_whatsapp_history_start",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/whatsapp_history/start",
+    "title": "Importar Histórico WhatsApp Cloud (Iniciar)",
+    "description": "AÇÃO DE ESCRITA. Inicia a importação do histórico de conversas antigas para uma caixa WhatsApp Cloud (API oficial), lendo um QR Code (coexistência — não desconecta o número oficial). Só admin + requer a feature qr_history_import. Acompanhe pelo status.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa WhatsApp Cloud"
+      },
+      {
+        "name": "days",
+        "type": "integer",
+        "location": "body",
+        "required": false,
+        "description": "Quantidade de dias de histórico a importar (valor inválido cai para 30)"
+      }
+    ],
+    "returns": "{ state, qr, days }",
+    "common_use_cases": [
+      "Trazer o histórico antigo ao migrar para WhatsApp oficial"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_whatsapp_history_status",
+      "lionchat_inboxes_whatsapp_history_cancel"
+    ]
+  },
+  {
+    "id": "lionchat_inboxes_whatsapp_history_status",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/whatsapp_history/status",
+    "title": "Importar Histórico WhatsApp Cloud (Status)",
+    "description": "SÓ LEITURA. Status da importação de histórico da caixa WhatsApp Cloud: estado, QR Code (quando precisa parear), progresso e estatísticas. Estados: idle → scan_qr → importing → migrating → cleaning → done/failed.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa WhatsApp Cloud"
+      }
+    ],
+    "returns": "{ state, qr, days, progress, stats, error }",
+    "common_use_cases": [
+      "Acompanhar o andamento da importação",
+      "Pegar o QR Code para parear"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_whatsapp_history_start",
+      "lionchat_inboxes_whatsapp_history_cancel"
+    ]
+  },
+  {
+    "id": "lionchat_inboxes_whatsapp_history_cancel",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/whatsapp_history/cancel",
+    "title": "Importar Histórico WhatsApp Cloud (Cancelar)",
+    "description": "AÇÃO DE ESCRITA. Cancela uma importação de histórico em andamento na caixa WhatsApp Cloud.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa WhatsApp Cloud"
+      }
+    ],
+    "returns": "{ state }",
+    "common_use_cases": [
+      "Interromper uma importação demorada ou iniciada por engano"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_whatsapp_history_start",
+      "lionchat_inboxes_whatsapp_history_status"
+    ]
+  },
+  {
+    "id": "lionchat_conversations_toggle_block",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/conversations/{id}/toggle_block",
+    "title": "Bloquear / Desbloquear Contato",
+    "description": "AÇÃO DE ESCRITA. Bloqueia ou desbloqueia o CONTATO da conversa. Quando bloqueado, as mensagens RECEBIDAS desse contato passam a ser descartadas na entrada (não criam conversa/mensagem) e fica registrada uma pílula de atividade. NÃO resolve a conversa. Recebe o display_id da conversa. (Alternativa: setar o atributo blocked via lionchat_contacts_update.)",
+    "category": "Conversas",
+    "params": [
+      {
+        "name": "id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "Display ID (ID de exibição) da conversa"
+      },
+      {
+        "name": "blocked",
+        "type": "boolean",
+        "location": "body",
+        "required": true,
+        "description": "true = bloquear o contato; false = desbloquear"
+      }
+    ],
+    "returns": "A conversa atualizada (contato com blocked = true/false)",
+    "common_use_cases": [
+      "Bloquear um contato abusivo/spam",
+      "Desbloquear um contato bloqueado por engano"
+    ],
+    "related_tools": [
+      "lionchat_contacts_update"
+    ]
+  },
+  {
+    "id": "lionchat_wavoip_should_ring",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/should_ring",
+    "title": "Deve Tocar? (Wavoip)",
+    "description": "SÓ LEITURA. Diz se a ligação WhatsApp (Wavoip) deve tocar para ESTE agente, segundo a regra de toque (responsável pela conversa + presença/disponibilidade do agente). Usado pela tela de atendimento para decidir o toque/ringback.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      }
+    ],
+    "returns": "{ ring: boolean }",
+    "common_use_cases": [
+      "Decidir se toca o telefone do agente numa ligação recebida"
+    ],
+    "related_tools": [
+      "lionchat_wavoip_status",
+      "lionchat_wavoip_flag_rejected"
+    ]
+  },
+  {
+    "id": "lionchat_wavoip_flag_rejected",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/flag_rejected",
+    "title": "Sinalizar Recusa (Wavoip)",
+    "description": "AÇÃO DE ESCRITA. Marca que o agente RECUSOU a ligação WhatsApp (Wavoip) de um número, para o webhook registrar o desfecho como recusada (flag de curta duração). Use ao recusar uma ligação recebida.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      },
+      {
+        "name": "phone",
+        "type": "string",
+        "location": "body",
+        "required": true,
+        "description": "Telefone do número da ligação recusada"
+      }
+    ],
+    "returns": "200 OK",
+    "common_use_cases": [
+      "Registrar que a ligação foi recusada pelo agente"
+    ],
+    "related_tools": [
+      "lionchat_wavoip_should_ring",
+      "lionchat_wavoip_calls"
+    ]
   }
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "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",