@lionchat/mcp-server 1.5.0 → 1.7.0

package/dist/docs/instructions.md

@@ -285,7 +285,7 @@ Antes de QUALQUER ação que escreve, modifica, apaga ou envia, pare e avalie se
 
 **Sempre confirme em linguagem natural (resumindo o efeito) antes de executar quando:**
 
-- **(a) A ação é destrutiva/irreversível** — qualquer `*_destroy`, `*_bulk_actions`, apagar contato (cascateia para as conversas dele), mudar status em massa.
+- **(a) A ação é destrutiva/irreversível** — qualquer `*_destroy`, `*_bulk_actions`, apagar contato (cascateia para as conversas dele), mudar status em massa, cancelar reenvio de mensagem falhada (`*_cancel_retry`, `*_bulk_cancel` — a mensagem sai de todo reenvio pra sempre).
 - **(b) Envia mensagem ao cliente final** — `lionchat_conversations_messages_create` com `message_type` outgoing, `*_scheduled_messages_*`, templates WhatsApp, campanhas/disparos.
 - **(c) Altera config** — conta, inbox, funil, automação, IA Agente (`captain_assistants_update`).
 - **(d) O pedido é ambíguo/incompleto** — falta ID, período, canal, destinatário, ou há mais de uma interpretação possível.
@@ -322,6 +322,7 @@ Antes de escolher a ferramenta, cheque se a intenção bate com a coluna da dire
 | **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` |
+| Ver / limpar **falhas de envio** de uma caixa | `lionchat_inboxes_failed_messages_summary` primeiro; depois `_bulk_retry` (reenviar) ou `_bulk_cancel` (descartar) | Admin-only. Reenvio em massa e cancelamento em massa são ações irreversíveis: mostre as contagens do summary e confirme (seção 7a/7b). Numa mensagem só: `lionchat_conversations_messages_create_1` (reenviar) / `lionchat_conversations_messages_cancel_retry` (cancelar) |
 | **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) |
 | Qualquer coisa de Ligação WP (Wavoip) | **NÃO HÁ TOOL** — removidas em 2026-07-16 por decisão do dono | Ligação WP é contratada e configurada **manualmente pelo cliente no painel**. O MCP não conecta, não desconecta, não entrega token de discagem nem muda config. Oriente o usuário a fazer pelo painel (Configurações da caixa → Ligação WP). |
 | Restringir agendas que a IA oferece | `lionchat_captain_assistants_update` (`config.booking_event_type_ids: [Int]`) | binding de agenda por cenário NÃO é settable via API |

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

@@ -38,7 +38,8 @@ page=2 → próxima
 
 O conector devolve `pagination.total_count` e `pagination.has_more` — **pagine enquanto `has_more=true`** (não pare na 1ª página). Se `has_more=false`, acabou. Não tente "paginar até zerar" quando o total já é enorme (milhões) — filtre antes.
 
-**Puxando RELATÓRIO grande (2026-07-18):** a resposta é cortada em 80 mil caracteres. Se aparecer o aviso `[RESPOSTA CORTADA ...]`, os dados vieram **INCOMPLETOS** — o certo NÃO é insistir na mesma chamada, e sim **ESTREITAR**: reduza o intervalo de datas (`since`/`until`), adicione filtros, use `per_page` menor, ou pagine (`page`) nas ferramentas de LISTA. **Relatórios agregados** (`reports_summary`, `sla_metrics`, `csat_metrics`, `journey_funnel_reports`, `lead_origin_reports`) **NÃO paginam** — se cortar, restrinja o período. Pra CSAT em lista (`csat_list`), o total vem só no `csat_metrics` — combine os dois.
+**Respostas grandes (atualizado 2026-07-24):** o teto continua 80 mil caracteres, mas agora com 3 melhorias:
+(1) **Slim por padrão** — listas voltam sem campos pesados/decorativos (`message_templates`, `working_hours`, avatares, `meta_history_import` viram `[omitido...]`); pra resposta completa use `full_response:true` (tools de lista/show pesadas). (2) **Corte limpo** — ao estourar o teto, a resposta é enxugada por ITENS INTEIROS com o aviso `[LISTA ENXUGADA: exibindo N de M itens...]`; o JSON nunca vem quebrado no meio. (3) **Segredos** — chaves de credencial (api_key, tokens, senhas) saem SEMPRE `[REDACTED]`, sem exceção. Se ainda aparecer `[RESPOSTA CORTADA ...]` (shape sem lista reconhecível), os dados vieram INCOMPLETOS — NÃO insista na mesma chamada: **ESTREITE** (reduza `since`/`until`, adicione filtros, use `per_page` menor, ou pagine com `page`). **Relatórios agregados** (`reports_summary`, `sla_metrics`, `csat_metrics`, `journey_funnel_reports`, `lead_origin_reports`) **NÃO paginam** — se cortar, restrinja o período. Pra CSAT em lista (`csat_list`), o total vem só no `csat_metrics` — combine os dois. Guia completo de filtros: resource `filtros-e-relatorios`.
 
 ## Cache local mental
 
@@ -146,6 +147,12 @@ Dispara quando o CLIENTE fica inativo após resposta da IA. O motor de follow-up
 **só-leitura** (não executa ferramentas, não coleta dado — só redige a mensagem de retomada,
 com saída estruturada garantida). `paused=true` no assistente corta os follow-ups também.
 
+**Corrigido em 2026-07-24:** quando a IA é ativada por um **Flow** (ação "Ativar IA") ou por uma
+**automação**, o follow-up agora é agendado no ato da ativação. Antes, nesses dois caminhos a
+cadência simplesmente nunca começava — a conversa ficava com IA ativa e sem nenhum follow-up. Se um
+cliente relatar "a IA nunca faz o follow-up", confira primeiro se a ativação veio por flow/automação
+e se a conta já está na versão de 24/07.
+
 ## Condições para NÃO fazer follow-up + horário de silêncio (2026-07)
 
 `config.follow_up_skip_conditions` — array de até 3 condições (lógica OU: qualquer uma verdadeira
@@ -197,6 +204,11 @@ Como a coleta de dados/cenários funciona hoje (importante pra diagnosticar "IA
 - Cenários são instruções inline no prompt (sem troca de personagem); o raciocínio do cenário
   fica no "caderninho" da conversa (campo scenario_checklist, visível no card Raciocínio).
 - Sem AI Agente ativo na conversa = NENHUMA resposta de IA (motor V1 aposentado em 2026-06).
+- **Corrigido em 2026-07-24:** a IA agora enxerga no prompt a lista de atributos personalizados
+  definidos de **Conversa** e de **Card do Kanban** (antes só a de Contato chegava, e mesmo essa em
+  parte) — por isso ela conseguia gravar atributo de contato mas "não funcionava" pra conversa/card.
+  Regra prática que continua valendo: só dá pra a IA preencher atributo que **existe cadastrado**
+  (`custom_attributes_create`) no modelo certo — conversa, contato ou card.
 
 ## Cenários com parâmetro fixo e execução determinística (2026-06)
 
@@ -308,7 +320,9 @@ criar a campanha e mostre a contagem ao usuário — estimativa e disparo usam o
 ## Variáveis de conta (account_variables)
 
 Pra dados fixos que se repetem (slogans, endereços, horários):
-- `account_variables_create` UMA vez — campos: `attribute_display_name` (rótulo), `attribute_key` (a chave usada no `{{ }}`), `attribute_display_type` (`text`; use `secret` pra token/senha), `value`. Admin-only.
+- `account_variables_create` UMA vez — campos: `attribute_display_name` (rótulo), `attribute_key` (a chave usada no `{{ }}`), `attribute_display_type`, `value`. Admin-only.
+- Tipos oferecidos na tela (2026-07-25): **Texto** (`text`), **Data** (`date`), **Hora** (`time`) e **Confidencial** (`secret`). Data e Hora gravam o valor já normalizado (`AAAA-MM-DD` e `HH:MM` em 24h) — antes a tela só tinha Texto e a data entrava como texto solto, sem validar formato. Os demais tipos do enum (`number`, `list`, `link`, `checkbox`, `currency`, `percent`, `datetime`) funcionam pela API, mas a tela os edita como texto.
+- O **tipo e a chave não mudam depois de criados** — `account_variables_update` só altera rótulo, descrição e valor. Pra trocar o tipo, apague e crie de novo.
 - Use em templates com a sintaxe COMPLETA `{{ account.custom_attribute.<attribute_key> }}` (ex: `{{ account.custom_attribute.slogan }}`). NÃO existe atalho `{{slogan}}` solto — sem o prefixo `account.custom_attribute.` não resolve.
 - Resolve em: mensagens, respostas prontas, campanhas e automações. NÃO resolve nas instruções do AI Agente (base/cenário) — ali só `contact.*` e `conversation.*`.
 - `secret` nunca aparece em template (sai vazio); só resolve em nós API Request do FlowBuilder.
@@ -359,6 +373,9 @@ Endereço: {% assign chave = "endereco_" | append: contact.custom_attribute.unid
   nas instruções do AI Agente.
 - Se a chave montada não existir, o `{% echo %}` sai vazio (sem erro). Teste com um contato
   de cada valor da lista antes de entregar.
+- Botão com link (CTA) da resposta pronta/flow: a URL do botão aceita variáveis
+  (`{{contact.name}}`, `{{contact.phone}}`, atributo etc.) — cada valor é codificado
+  automaticamente (espaço vira `%20`), então o link nunca quebra. Útil pra rastrear cliques.
 
 ### Padrão geral (serve pra qualquer caso)
 
@@ -409,6 +426,48 @@ Fontes/campos disponíveis (`source` / `field`):
 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).
 
+### Botão de link do template com variável — link rastreável por cliente (2026-07-25)
+
+O botão de URL do template pode terminar com uma variável, pra montar um link diferente por contato
+(rastrear cliques, pré-preencher formulário, etc).
+
+Regras da Meta (o template é recusado na hora se furar qualquer uma):
+
+- No máximo **UMA** variável no botão, e ela é sempre `{{1}}`.
+- `{{1}}` só pode ficar **no FINAL** da URL, com base `https://` fixa antes.
+- O componente `BUTTONS` precisa mandar `example` com a URL completa de exemplo (sem ele, erro 100).
+
+E o `variable_mapping` recebe a chave especial `_button_url` (com underscore na frente de propósito:
+ela **não** conta como variável de corpo):
+
+```json
+{
+  "components": [
+    { "type": "BODY", "text": "Olá {{1}}, sua proposta está pronta." ,
+      "example": { "body_text": [["Maria"]] } },
+    { "type": "BUTTONS", "buttons": [
+      { "type": "URL", "text": "Ver proposta",
+        "url": "https://minhaempresa.com.br/proposta?cliente={{1}}",
+        "example": ["https://minhaempresa.com.br/proposta?cliente=Maria Silva"] }
+    ] }
+  ],
+  "variable_mapping": {
+    "1": { "source": "contact", "field": "name.split.first", "label": "Primeiro nome" },
+    "_button_url": { "source": "contact", "field": "name", "label": "Nome completo",
+                     "example": "Maria Silva", "button_index": 0 }
+  }
+}
+```
+
+- `button_index` = a **posição do botão** dentro do componente `BUTTONS` (0 = primeiro).
+- `source`/`field` usam a mesma tabela de fontes acima, mais `custom` (texto fixo, escrito no `field`).
+- No envio, o valor é **codificado automaticamente** (espaço vira `%20`) — o link nunca quebra.
+- Vale em conversa, automação, flow, agendada e campanha (na campanha resolve por contato).
+
+O mesmo vale pro **botão de link (CTA)** de resposta pronta e do FlowBuilder: a URL aceita
+`{{contact.name}}`, `{{contact.phone}}`, atributo personalizado etc., com a mesma codificação
+automática. Ver a seção de variáveis de conta acima.
+
 ## FlowBuilder — notas de editor (2026-07)
 
 - **Tipo de atributo `time` (Hora 24h):** ao criar custom attribute com `attribute_display_type: "time"` (ou o numérico `9`), o valor canônico é `"HH:MM"` 24h e o fuso mora na definição (`attribute_timezone`, IANA, default `America/Sao_Paulo`). Uso principal: alimentar o campo Horário do node `wait` (modo date, `waitTimeMode: "variable"`).

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

@@ -408,6 +408,22 @@ Atributos de sistema no CONTATO (prefixo `eclinica_`, protegidos, usáveis como
 | `eclinica_ultimo_pagamento` | text | Valor do último pagamento |
 | `eclinica_ultimo_pagamento_data` | date | Data do último pagamento/baixa (novo 2026-07-06) |
 | `eclinica_ultimo_pagamento_descricao` | text | Descrição da baixa (ex: CONSULTA INICIAL) |
+| `eclinica_laboratorio_data_prevista` | date | Previsão de entrega da medicação (novo 2026-07-23) |
+| `eclinica_laboratorio_data_moldagem` | date | Data do pedido da medicação |
+| `eclinica_laboratorio_data_entrega` | date | Data de entrega da medicação |
+| `eclinica_laboratorio_situacao` | text | Situação do pedido no laboratório |
+| `eclinica_ultima_cobranca_valor` | text | Valor da última cobrança/carnê gerado |
+| `eclinica_ultima_cobranca_vencimento` | date | Vencimento da última cobrança |
+| `eclinica_ultima_cobranca_descricao` | text | Descrição da última cobrança |
+
+**Lembretes automáticos (Integrações > e-Clínica > Lembretes).** Cada linha tem um **tipo de
+evento** que decide de qual data a contagem parte: `agendamento` (data da consulta, padrão),
+`controle_laboratorio_novo` (previsão de entrega da medicação) e `cliente_inclusao_pagamento`
+(vencimento da cobrança). Desde 2026-07-25 cada linha exige também uma **hora do disparo** —
+`HH:MM` fixo ou fórmula com variável de conta/contato (ex.: horário por unidade, ou a própria hora
+da consulta) — em vez de herdar sempre o horário da consulta. Há ainda um filtro opcional
+("Só quando") por atributo `eclinica_*` do contato. Nada disso é editável pelo MCP: só pelo painel.
+Pra auditar o que foi/será disparado, use `lionchat_eclinica_reminder_history_list`.
 
 ## Relatórios e Métricas
 

package/dist/docs/resources/filtros-e-relatorios.md

@@ -0,0 +1,147 @@
+# Filtros e Relatórios — Guia Completo
+
+Como filtrar conversas, contatos e cards do Kanban com precisão, e como montar relatórios por
+período/atendente/etapa/valor sem tentativa e erro. Tabelas extraídas do código da plataforma
+(2026-07-24) — operador fora da lista da chave retorna **422 "Operador inválido"**.
+
+## Os DOIS padrões de transporte de filtro (não confundir)
+
+| Padrão | Onde | Como enviar |
+|---|---|---|
+| **A — array no BODY** | `conversations_filter`, `contacts_filter`, `audience`/`exclusion` de campanhas | Array NATIVO de objetos no parâmetro (`payload`, `audience`, `exclusion`) |
+| **B — JSON-string na QUERY** | `*_custom_attribute_filters` do Kanban, `conversation_filters`/`contact_filters`/`kanban_filters` das buscas | STRING com o JSON serializado (`"[{\"attribute_key\":...}]"`) |
+
+Regra de bolso: ferramenta POST de filtro = array nativo; parâmetro de filtro em ferramenta GET =
+JSON-string. NUNCA mande array-de-objetos em parâmetro de query.
+
+## 1. Conversas — `lionchat_conversations_filter`
+
+`payload` = array de condições `{attribute_key, filter_operator, values[], query_operator:'and'|'or',
+custom_attribute_type?}`. Ordenação FIXA `last_activity_at DESC`, 25/página (param `page`).
+E/OU é encadeado condição a condição (sem parênteses).
+
+| attribute_key | Operadores |
+|---|---|
+| `status` (open/resolved/pending/snoozed, aceita 'all') | equal_to, not_equal_to |
+| `chat_type` (individual/group/channel/broadcast/status) | equal_to, not_equal_to |
+| `priority` | equal_to, not_equal_to |
+| `assignee_id` (atendente), `inbox_id`, `team_id`, `campaign_id`, `captain_assistant_id` (IA), `labels` | equal_to, not_equal_to, is_present, is_not_present |
+| `display_id` | equal_to, not_equal_to, contains, does_not_contain (o `contains`, busca por trecho do número, passou a funcionar de verdade em 2026-07-25 — antes dava erro de banco) |
+| `referer`, `mail_subject` | equal_to, not_equal_to, contains, does_not_contain |
+| `browser_language`, `conversation_language` | equal_to, not_equal_to |
+| `created_at`, `last_activity_at` (valor = data) | is_greater_than, is_less_than, days_before |
+| `card_funnel_stage` (conversa POR CARD do Kanban — valor `funnel:<id>` ou `stage:<id>:<chave_etapa>`) | equal_to, not_equal_to |
+| **qualquer outra chave** = atributo personalizado | conforme o tipo do atributo (ver tabela em api-conventions) |
+
+Atributo personalizado: informe `custom_attribute_type` na condição — `'conversation_attribute'`
+(atributo da conversa) ou `'contact_attribute'`. Sem ele o escopo pode sair errado.
+
+## 2. Contatos — `lionchat_contacts_filter`
+
+Mesmo shape de condição. 15/página.
+
+| attribute_key | Operadores |
+|---|---|
+| `id` (id interno do contato) | equal_to, not_equal_to |
+| `name`, `email`, `identifier`, `city`, `company`, `profession` | equal_to, not_equal_to, contains, does_not_contain |
+| `phone_number` | + starts_with |
+| `cpf`, `cnpj`, `rg` (cadastral) | equal_to, not_equal_to, contains, does_not_contain, is_present, is_not_present |
+| `country_code` | equal_to, not_equal_to |
+| `labels` | equal_to, not_equal_to, is_present, is_not_present |
+| `created_at`, `last_activity_at` | is_greater_than, is_less_than, days_before |
+| `blocked` | equal_to, not_equal_to |
+| **qualquer outra chave** = atributo personalizado do contato | conforme o tipo |
+
+**Registros vinculados** (acha o contato pelo que aconteceu com ele):
+- `conversation_status`, `conversation_inbox_id` (equal_to/not_equal_to), `conversation_labels`
+  (+is_present/is_not_present) — conversa vinculada.
+- `card_funnel_id`, `card_stage`, `card_priority`, `card_status` (equal_to/not_equal_to) — card
+  do Kanban vinculado.
+- Condição com `custom_attribute_type:'conversation_attribute'` — atributo da conversa vinculada.
+
+## 3. Kanban — `lionchat_kanban_items_filter` (lista rica de cards)
+
+GET com parâmetros FLAT (não usa payload). Filtros REAIS (2026-07-24 — parâmetros fantasmas
+stage_id/inbox_id/sort_by/sort_direction/page foram REMOVIDOS, eram ignorados pelo backend):
+
+- `funnel_id` (obrigatório), `stages[]` (chaves internas das etapas), `priorities[]`,
+  `statuses[]` (open/won/lost), `agent_id`, `value_min`/`value_max`
+- `date_start`/`date_end` (criação do card, YYYY-MM-DD)
+- `scheduled_date_start`/`scheduled_date_end` (agendamento: scheduled_at/deadline_at do card E
+  tarefas da agenda vinculadas)
+- `task_filter`: has_task | no_task | today | tomorrow | this_week | overdue
+- `channel` (tipo de canal SEM prefixo: Waha, Whatsapp, Instagram...), `label` (etiqueta da
+  conversa do card), `offer` (descrição exata de oferta no card)
+- `card_custom_attribute_filters` / `contact_custom_attribute_filters` /
+  `conversation_custom_attribute_filters` — **JSON-string** (padrão B) de condições
+  `{attribute_key, filter_operator, values[]}`, operadores: equal_to, not_equal_to, contains,
+  does_not_contain, is_present, is_not_present. `custom_attribute_match`: 'all' (E) | 'any' (OU).
+
+ATENÇÃO: **sem paginação** — até 5000 cards, ordem created_at DESC, shape `{items, total, filters}`.
+NÃO há filtro por time aqui (por time: use o relatório agregado abaixo, ou filtre por agent_id).
+
+## 4. Relatório agregado do Kanban — `lionchat_kanban_items_list_3`
+
+`GET /kanban_items/reports` — a resposta é um OBJETO de métricas (não lista): valores GANHOS,
+contagem/valor por etapa, forecast ponderado, top negócios, cards parados, metas do funil.
+Params: `funnel_id` (obrigatório), `from`, `to`, `user_ids[]` (agentes), `team_id`.
+É a ferramenta certa pra "relatório de vendas/ganhos do mês por agente ou time".
+
+## 5. Busca com filtro estruturado
+
+`search_search` (tudo), `conversations_search`, `contacts_search`, `kanban_items_search` aceitam
+`conversation_filters`/`contact_filters` (JSON-string no MESMO shape do payload dos /filter, mesmo
+motor, cap 10 condições) e `kanban_filters` (JSON-string do subset flat da seção 3). Paginação por
+categoria: 15/página (kanban: primeiros 15, sem paginação).
+
+## 6. Respostas: enxutas por padrão + paginação
+
+- **Slim (2026-07-24, default LIGADO):** listas voltam SEM campos pesados/decorativos
+  (`message_templates`, `working_hours`, `meta_history_import`, avatares — viram marcador
+  `[omitido...]`). Pra resposta completa: `full_response:true` (disponível nas tools de
+  lista/show pesadas). Anexos de mensagem (data_url/download_url) NUNCA são podados.
+- **Segredos:** chaves de credencial (api_key, tokens, senhas) saem SEMPRE como `[REDACTED]` —
+  sem exceção, nem com full_response. Precisa de um token? Painel, não robô.
+- **Paginação:** os DOIS conectores agora informam `pagination.{current_page,total_pages,
+  total_count,has_more}` — pagine até `has_more=false`. (No remoto o bloco é ADICIONADO ao lado
+  do shape original.)
+- **Corte:** resposta acima do teto é enxugada por ITENS INTEIROS (aviso `[LISTA ENXUGADA...]`
+  com contagem exibida/total) — o JSON nunca vem quebrado no meio.
+
+## 7. Receitas prontas
+
+**R1 — Conversas de um período por atendente:**
+```json
+payload=[
+  {"attribute_key":"assignee_id","filter_operator":"equal_to","values":[6],"query_operator":"and"},
+  {"attribute_key":"created_at","filter_operator":"is_greater_than","values":["2026-07-01"],"query_operator":"and"},
+  {"attribute_key":"created_at","filter_operator":"is_less_than","values":["2026-07-31"]}
+]
+```
+(paginar até has_more=false; pra métricas agregadas prefira `reports_summary` type=agent)
+
+**R2 — Cards por etapa + faixa de valor no mês:**
+`kanban_items_filter funnel_id=37 stages=["negociacao"] value_min=5000 date_start=2026-07-01 date_end=2026-07-31`
+
+**R3 — Ganhos do mês por agente/time:**
+`kanban_items_list_3 funnel_id=37 from=2026-07-01 to=2026-07-31 user_ids=[6,12]` (ou `team_id=3`)
+
+**R4 — Conversas de uma campanha que FALHARAM/entregaram:** filtre por
+`campaign_id equal_to <id>`; o status da MENSAGEM de template (sent/delivered/read/failed) está
+nas mensagens da conversa (`conversations_messages_list`) — não é atributo da conversa.
+
+**R5 — Contatos por atributo + etiqueta:**
+```json
+payload=[
+  {"attribute_key":"faixa_investimento","filter_operator":"equal_to","values":["300k_1m"],"query_operator":"and"},
+  {"attribute_key":"labels","filter_operator":"equal_to","values":["apoiador"]}
+]
+```
+
+**R6 — Cards parados (sem tarefa) com atributo do contato:**
+`kanban_items_filter funnel_id=37 task_filter=no_task contact_custom_attribute_filters="[{\"attribute_key\":\"ja_investe\",\"filter_operator\":\"equal_to\",\"values\":[\"ja_invisto\"]}]"`
+
+**Erros clássicos a evitar:** `includes` em labels (não existe — use equal_to); operador de
+número/data em texto; array-de-objetos em query (padrão B exige JSON-string); esquecer
+`custom_attribute_type` quando contato e conversa têm atributo de mesmo nome; esperar paginação
+no kanban_items_filter (não tem — estreite o filtro).

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

@@ -12,6 +12,27 @@ Como interpretar cada um dos endpoints de relatório (`lionchat_reports_*`) e m
 86400 segundos → "24 horas" ou "1 dia"
 ```
 
+## Por que o número "não bate" — leia ANTES de responder ao usuário (2026-07-24)
+
+Quando o usuário disser "o relatório está errado / não bate", quase sempre é UMA destas semânticas
+(verificadas no código e com prova empírica em conta real):
+
+1. **"Conversas" e "Resolvidas" têm âncoras de tempo DIFERENTES.** conversations_count = conversas
+   CRIADAS no período; resolutions_count = eventos de resolução OCORRIDOS no período (a conversa pode
+   ter sido criada antes). Um atendente pode "resolver mais do que recebeu" — correto, não é bug.
+2. **"Resolvidas" conta EVENTOS, não conversas.** Resolver → reabrir → resolver = 2. Pode passar do
+   total de conversas.
+3. **Recorte por ATENDENTE só enxerga conversas ATRIBUÍDAS.** Conversa sem responsável (auto-atribuição
+   desligada, disparo em massa) não aparece em NENHUM atendente — a soma dos atendentes pode ser uma
+   fração minúscula do total da conta (caso real: 202 de 4001). Sempre diga quantas estão sem atendente.
+4. **A contagem de conversas por atendente usa o responsável ATUAL** — reatribuir conversa antiga move
+   o histórico de um atendente pro outro. Já resoluções/tempos usam quem era o dono NA HORA do evento.
+   Os dois cards podem divergir legitimamente em conta que reatribui.
+5. **timezone_offset NÃO altera totais** de summary — só o agrupamento dos pontos da série temporal.
+   Diferenças de ~1% entre relatório e lista filtrada são borda de janela/fuso, não defeito.
+6. **since/until são unix SEGUNDOS** em TODOS os endpoints de relatório. ISO 8601 quebra a janela em
+   silêncio (relatório vazio/errado).
+
 ## Mapeamento dos endpoints `lionchat_reports_*`
 
 > ⚠️ **A numeração `_N` é gerada automaticamente e NÃO segue uma ordem lógica.** Use SEMPRE a tabela
@@ -116,6 +137,10 @@ Retorna array de métricas, **uma por usuário da conta**. Campos confirmados (e
 > - **CSAT por agente:** use `lionchat_csat_list` com filtro `user_ids=<id>` e calcule a média.
 > - **Tempo online / status:** use `lionchat_agent_availability` ou os live_reports (`_16`/`_17`).
 
+**Filtro por caixa (novo em 2026-07-24):** aceita `inbox_id` — o desempenho dos agentes DENTRO de
+uma caixa específica. É exclusivo deste relatório; os resumos de time/caixa/etiqueta/canal
+(`_1` a `_4`) NÃO aceitam `inbox_id`.
+
 `_1` (time), `_2` (inbox), `_3` (label), `_4` (canal) seguem a mesma ideia de resumo agrupado,
 trocando a chave de agrupamento.
 
@@ -146,7 +171,7 @@ Retorna SOMENTE estes dois campos (não existe taxa pronta):
 ### `lionchat_reports_list_13` — Conversation Traffic (tráfego)
 **Use quando:** "horário de pico", "quando tem mais demanda"
 
-Heatmap de volume por hora. Aceita `timezone_offset` (importante: sem ele o pico sai em UTC).
+Heatmap de volume por hora. Aceita SÓ `timezone_offset` (sem ele o pico sai em UTC). ATENÇÃO: janela FIXA a partir de hoje — NÃO aceita `since`/`until`.
 
 ### `lionchat_reports_list_16` / `_17` — Tempo real (live)
 **Use quando:** "quem tá online agora", "carga atual", "conversas abertas no momento"
@@ -154,6 +179,10 @@ Heatmap de volume por hora. Aceita `timezone_offset` (importante: sem ele o pico
 São os live_reports (`conversation_metrics` e a versão agrupada). Use estes — e não os resumos
 históricos — quando o usuário quiser o agora.
 
+**Filtros aceitos (expostos na tool desde 2026-07-24):** `inbox_id`, `assignee_id` e `team_id`,
+todos opcionais e combináveis — é o mesmo recorte da tela Visão Geral. Em `_17` o `group_by`
+(`team_id` ou `assignee_id`) continua obrigatório e os filtros recortam a base ANTES de agrupar.
+
 ### `lionchat_csat_metrics` — CSAT agregado
 **Use quando:** "satisfação", "nota média dos clientes", "CSAT"
 
@@ -171,7 +200,7 @@ Retorna SOMENTE estes campos (nem média, nem taxa de resposta vêm prontas):
 > **Taxa de resposta** = `total_count / total_sent_messages_count`.
 > No exemplo: 80/210 = **38%**.
 
-**Filtros aceitos:** `user_ids`, `inbox_id`, `team_id`, `rating`, `since`/`until`.
+**Filtros aceitos (expostos na tool desde 2026-07-24):** `user_ids[]`, `inbox_id`, `team_id`, `rating`, `since`/`until` (unix segundos). Agora dá pra recortar CSAT por caixa/atendente direto.
 
 ### `lionchat_sla_metrics` — SLA agregado (ENTERPRISE-ONLY)
 **Use quando:** "cumprimento de SLA", "quantos prazos estouraram"
@@ -190,7 +219,7 @@ Retorna:
 > O `hit_rate` já vem calculado como string (ex.: `"95.5%"`, ou `"100%"` quando não há falhas).
 > Não divida nada — apenas exiba o valor.
 
-**Filtros aceitos:** `inbox_id`, `team_id`, `sla_policy_id`, `label_list`, `assigned_agent_id`, `since`/`until`.
+**Filtros aceitos (expostos na tool desde 2026-07-24):** `inbox_id`, `team_id`, `sla_policy_id`, `label_list[]`, `assigned_agent_id`, `since`/`until` (unix segundos).
 
 ## Padrões de interpretação
 

package/dist/docs/resources/troubleshooting.md

@@ -265,6 +265,39 @@ Participantes continuam vendo a conversa, mas não recebem sino/push a cada mens
 alguém específico, use @menção em nota interna (que notifica pelo caminho próprio; a lista de quem
 pode ser mencionado vem de `lionchat_conversations_mentionable_users`).
 
+### "Mandei reenviar a mensagem falhada e voltou 422" (25/07)
+Não é bug: mensagem **cancelada** ou **excluída** nunca reenvia. O bloqueio é na fonte e vale pros
+três caminhos — botão da bolha (`lionchat_conversations_messages_create_1`), reenvio em lote
+(`lionchat_inboxes_failed_messages_bulk_retry`) e a auto-recuperação do WAHA. Se o usuário quer
+mesmo mandar de novo, o caminho é escrever uma mensagem nova.
+
+### "A falha sumiu do painel" / "apareceu um grupo Excluídas" (25/07)
+Dois comportamentos novos e propositais no painel Falhas de envio
+(`lionchat_inboxes_failed_messages_summary`):
+- **Cancelada** (`cancel_retry` / `bulk_cancel`) some do painel de vez — cancelar é limpar.
+- **Excluída** NÃO some: vira o grupo informativo `deleted` (campo `deleted_count`), guardando
+  contato, horário e o **motivo original** da falha. É registro, então não tem botão de reenviar
+  nem de cancelar e fica fora de `retryable_count` e do `total`.
+
+Cancelar vale pra TODOS os grupos (inclusive `permanent`, `window_expired`, `campaign` e `partial`,
+que nunca seriam reenviados) — é assim que se limpa o painel. Ações irreversíveis: confirme com o
+usuário e mostre as contagens do summary antes.
+
+### "O Messenger parou de enviar / 'Invalid parameter'" (24/07)
+Causa raiz do apagão de 22 a 24/07: a Meta **aposentou a message tag** que o sistema mandava em todo
+envio de Messenger. Corrigido em 24/07. Agora o Messenger respeita a **janela de 24h** de verdade:
+dentro da janela envia normal; passou de 24h da última mensagem do cliente, a Meta recusa — não é
+falha do LionChat, é regra da plataforma. Não existe template de Messenger pra "reabrir" a janela
+(isso é WhatsApp). Instagram nunca usou tag e não foi afetado.
+
+### "A importação de histórico do WhatsApp (QR) parou no meio" (25/07)
+A importação agora se recupera sozinha: se o servidor reiniciar no meio, ela fica `interrupted` e
+**retoma de onde parou** (não baixa de novo o que já entrou) na próxima verificação. Estados
+possíveis: `importing` (rodando), `interrupted` (caiu, vai retomar sozinha), `paused` (alguém pausou
+pelo painel de suporte — só volta no botão Retomar), `cancelled` (encerrada de vez), `completed`.
+Enquanto uma importação está viva, o repescador de mensagens da sessão fica fora do caminho, de
+propósito. Pausar, retomar e cancelar são ações do painel de suporte — não existem no MCP.
+
 ### "Editei o evento no Google Calendar e não sincronizou"
 Auto-cura desde 2026-06-09: o vigia horário re-arma o "watch" morto de conexões saudáveis
 sozinho (sem reconectar a conta). Se persistir >1h, aí sim investigar a conexão

package/dist/resources.js

@@ -29,6 +29,12 @@ export const RESOURCES = [
         description: 'Auth, paginacao, filtros, datas, codigos HTTP, rate limits. Use quando tiver duvida sobre como chamar endpoint.',
         filename: 'api-conventions.md',
     },
+    {
+        name: 'Filtros e Relatorios',
+        uri: 'lionchat://docs/filtros-e-relatorios',
+        description: 'Tabelas COMPLETAS de chaves/operadores dos filtros de conversas, contatos e Kanban + relatorio agregado do funil + receitas prontas. Consulte ANTES de montar qualquer filtro ou relatorio — evita 422 de operador invalido.',
+        filename: 'filtros-e-relatorios.md',
+    },
     {
         name: 'Fluxos de Conversacao',
         uri: 'lionchat://docs/conversation-flows',

package/dist/resources.js.map

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

package/dist/sanitize.d.ts

@@ -0,0 +1,9 @@
+export declare const FULL_RESPONSE_PARAM = "full_response";
+export declare const FULL_RESPONSE_DESCRIPTION: string;
+export declare const FULL_RESPONSE_TOOLS: Set<string>;
+export declare function supportsFullResponse(toolId: string): boolean;
+export interface SanitizeOptions {
+    slim: boolean;
+    toolId?: string;
+}
+export declare function sanitizeResponse(value: unknown, opts: SanitizeOptions): unknown;

package/dist/sanitize.js

@@ -0,0 +1,136 @@
+// AIDEV-NOTE: [seguranca+slim 2026-07-24] Sanitizacao central de TODA resposta MCP.
+// 1) Segredos: SEMPRE redigidos (sem opt-out) — respostas embutiam provider_config.api_key
+//    (token da Meta Cloud), smtp_password, hmac_token etc. Chave de credencial vira '[REDACTED]'.
+// 2) Slim: default LIGADO — poda sub-objetos pesados (message_templates com 13 templates,
+//    working_hours, meta_history_import, avatares) que estouravam o teto de 80k e cortavam
+//    o JSON no meio. Escape: full_response:true nas tools curadas (FULL_RESPONSE_TOOLS).
+// AIDEV-SECURITY: recursivo POR NOME DE CHAVE (nao por caminho) de proposito — o conector NPM
+// normaliza a resposta ({data,pagination}) e o remoto entrega o shape cru; poda por caminho
+// fixo seria no-op num dos dois. Este arquivo e PORTADO byte-identico pro lionchat-mcp-remote
+// (src/mcp/sanitize.ts) — alterar um exige alterar o outro.
+const REDACT_PLACEHOLDER = '[REDACTED]';
+const SLIM_PLACEHOLDER = '[omitido — use full_response:true ou a tool dedicada]';
+// AIDEV-SECURITY: chaves EXATAS de credencial (case-insensitive). Fontes: _inbox.json.jbuilder
+// (auth_token/account_sid Twilio, imap/smtp_password Email, hmac_token, provider_config Meta),
+// _account.json.jbuilder (topsend_api_key, liontrack_token), _user.json.jbuilder (access_token).
+const REDACT_EXACT = new Set([
+    'api_key',
+    'apikey',
+    'api_key_plain',
+    'auth_token',
+    'access_token',
+    'account_sid',
+    'password',
+    'imap_password',
+    'smtp_password',
+    'hmac_token',
+    'webhook_verify_token',
+    'pubsub_token',
+    'topsend_api_key',
+    'liontrack_token',
+    'client_secret',
+    'consumer_key',
+    'consumer_secret',
+    'app_secret',
+    'secret',
+]);
+const REDACT_SUFFIXES = ['_password', '_secret', '_api_key', '_auth_token', '_access_token'];
+// AIDEV-NOTE: website_token e publico por design (vai inline no HTML do site do cliente pro
+// widget) — unica excecao da redacao. NAO adicionar excecoes sem decisao explicita do dono
+// (politica 2026-07-24: censura total de credencial em resposta de robo).
+const REDACT_EXCEPTIONS = new Set(['website_token']);
+// AIDEV-NOTE: chaves PESADAS podadas pelo slim. NUNCA incluir aqui data_url/download_url/
+// file_url/thumb_url — sao de ANEXO de mensagem (baixar midia e caso de uso legitimo).
+// avatar_url/thumbnail/avatar sao foto de contato/agente/inbox (decorativo em lista).
+const SLIM_KEYS = new Set([
+    'message_templates',
+    'working_hours',
+    'meta_history_import',
+    'avatar_url',
+    'thumbnail',
+    'avatar',
+]);
+// AIDEV-NOTE: tools cujo PROPOSITO e o campo pesado — slim nao se aplica nelas
+// (segredos continuam redigidos mesmo assim).
+const SLIM_EXEMPT_SUBSTRINGS = ['whatsapp_templates', 'csat_template'];
+export const FULL_RESPONSE_PARAM = 'full_response';
+export const FULL_RESPONSE_DESCRIPTION = 'true = resposta COMPLETA, sem a poda de campos pesados (message_templates, working_hours, ' +
+    'avatares, meta_history_import). Padrao false (resposta enxuta). Segredos sao SEMPRE censurados, ' +
+    'com ou sem esta opcao.';
+// AIDEV-NOTE: conjunto CURADO de tools pesadas que ganham o param full_response no schema.
+// Nao injetar nas 682 (inflaria o tools/list em ~20-30k tokens). Tools fora da lista continuam
+// com slim ligado — o dado podado e alcancavel pela tool dedicada (ex: whatsapp_templates_list).
+export const FULL_RESPONSE_TOOLS = new Set([
+    'lionchat_conversations_list',
+    'lionchat_conversations_filter',
+    'lionchat_conversations_search',
+    'lionchat_conversations_show',
+    'lionchat_conversations_meta',
+    'lionchat_conversations_messages_list',
+    'lionchat_conversations_messages_search',
+    'lionchat_contacts_list',
+    'lionchat_contacts_filter',
+    'lionchat_contacts_search',
+    'lionchat_contacts_show',
+    'lionchat_campaigns_list',
+    'lionchat_campaigns_show',
+    'lionchat_inboxes_list',
+    'lionchat_inboxes_show',
+    'lionchat_inboxes_list_1',
+    'lionchat_inboxes_show_1',
+    'lionchat_kanban_items_list',
+    'lionchat_kanban_items_filter',
+    'lionchat_kanban_items_search',
+    'lionchat_kanban_items_show',
+    'lionchat_search_search',
+    'lionchat_search_list',
+    'lionchat_search_list_1',
+    'lionchat_search_list_2',
+    'lionchat_agents_list',
+    'lionchat_teams_list',
+    'lionchat_account_show',
+]);
+export function supportsFullResponse(toolId) {
+    return FULL_RESPONSE_TOOLS.has(toolId);
+}
+function shouldRedact(key) {
+    const k = key.toLowerCase();
+    if (REDACT_EXCEPTIONS.has(k)) {
+        return false;
+    }
+    if (REDACT_EXACT.has(k)) {
+        return true;
+    }
+    return REDACT_SUFFIXES.some((suffix) => k.endsWith(suffix));
+}
+// AIDEV-NOTE: caminha a resposta inteira (qualquer shape) redigindo segredos e, se slim,
+// substituindo campos pesados pelo marcador curto. Nao muta o objeto original.
+export function sanitizeResponse(value, opts) {
+    const slimActive = opts.slim &&
+        !SLIM_EXEMPT_SUBSTRINGS.some((s) => (opts.toolId ?? '').includes(s));
+    const walk = (node) => {
+        if (Array.isArray(node)) {
+            return node.map(walk);
+        }
+        if (node && typeof node === 'object') {
+            const out = {};
+            for (const [key, val] of Object.entries(node)) {
+                if (shouldRedact(key)) {
+                    // AIDEV-SECURITY: valor vazio/null passa como esta (informativo); qualquer valor
+                    // presente vira o placeholder — nunca o conteudo.
+                    out[key] = val === null || val === undefined || val === '' ? val : REDACT_PLACEHOLDER;
+                    continue;
+                }
+                if (slimActive && SLIM_KEYS.has(key.toLowerCase()) && val !== null && val !== undefined) {
+                    out[key] = SLIM_PLACEHOLDER;
+                    continue;
+                }
+                out[key] = walk(val);
+            }
+            return out;
+        }
+        return node;
+    };
+    return walk(value);
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/sanitize.js.map

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