@lionchat/mcp-server 1.11.1 → 1.12.0

package/dist/docs/instructions.md

@@ -377,11 +377,13 @@ Antes de escolher a ferramenta, cheque se a intenção bate com a coluna da dire
 | **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) |
 | **Definir supervisor** de time | `lionchat_team_members_create` / `_update` com `supervisor_ids[]` | Contrato diferente do da caixa: `user_ids[]` é a lista COMPLETA e `supervisor_ids[]` um subconjunto dela. Omitir `supervisor_ids` não mexe em papel nenhum (seção 2) |
 | **Mudar a fila do time** (teto por atendente, janela, online/offline) | `lionchat_teams_update` (`assignment_mode`, `fair_distribution_limit`, `fair_distribution_window`) | Time tem PREFERÊNCIA sobre a caixa na distribuição. Leia a config atual antes de mudar (ver `lionchat://docs/conversation-flows`) |
+| **Mudar o modo de distribuição do time** (Rodízio × Equilibrado) | `lionchat_teams_update` (`assignment_order`: `round_robin` \| `balanced`) | **`null` é valor válido e significa "o time não escolheu"** — a decisão herda da política da caixa, depois do `auto_assignment_config` da caixa, e por fim rodízio. NUNCA gravar `round_robin` só para "preencher": isso rebaixa em silêncio uma caixa que roda Equilibrado por política. `balanced` exige o recurso `advanced_assignment` na conta |
+| **Mudar o modo de distribuição da caixa** (Rodízio × Equilibrado) | `lionchat_inboxes_update` (`auto_assignment_config.assignment_order`) | Só vale quando a caixa NÃO tem política vinculada (com política, a política manda). O jsonb é SUBSTITUÍDO, não mesclado: releia o `auto_assignment_config` atual e reenvie as outras chaves junto, senão apaga o `assign_offline_agents` e o freio |
 | **Criar/atualizar time** | `lionchat_teams_create` / `_update` | **Preencha `description`**: desde 03/08 é ela que o AI Agente lê pra decidir o roteamento por time. Descreva QUANDO mandar pra lá, não o que o time é |
 | **Pausar a automação no meio** (esperar atribuição/card antes da próxima ação) | ação `wait` em `lionchat_automation_rules_create` / `_update` | Segundos, teto 300. Acima disso é caso de FlowBuilder. Ver `lionchat://docs/conversation-flows` |
 | **Buscar contato/conversa/card** | `lionchat_search_*`, `lionchat_contacts_search` | **Termo com letra exige 3+ caracteres** (dígito é isento). Menos que isso volta VAZIO sem erro — não conclua que o registro não existe. Ver `lionchat://docs/api-conventions` |
 | **Migrar conversas** de uma caixa WhatsApp pra outra (ex.: QR Code → Oficial) | `lionchat_inboxes_inbox_migration_list` (prévia) → `_execute` → acompanhar status | Admin-only e IRREVERSÍVEL: sempre mostre os números da prévia e confirme (seção 7a). Grupos não vão pro canal oficial — ficam na caixa de origem |
-| 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). |
+| Qualquer coisa de Ligação WP (Wavoip) | **INTEGRAÇÃO REMOVIDA em 12/08/2026** — não há tool nem tela | A Wavoip saiu do produto: a aba "Ligação WP" **não existe mais**. NUNCA orientar o usuário a "Configurações da caixa → Ligação WP". Para voz em caixa QR Code, o caminho hoje é o **LionCalls**. As ligações antigas seguem no histórico (`provider: "wavoip"`); as gravações delas ficavam no servidor da Wavoip e vão sumir — ao tentar ouvir, o painel mostra "Esta gravação não está mais disponível", e isso é esperado, não é defeito. |
 | 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 |
 | Configurar o Copiloto (modelo/temperatura/prompt base) | `lionchat_copilot_settings_update` | admin-only; copiloto tem motor próprio (padrão temp 0.3) |
 | **Resetar/testar do zero a IA** numa conversa | `lionchat_conversations_captain_history_reset` (POST, sem body) | Cria pílula de marco na conversa; a partir dali TODA leitura autônoma da IA (respostas, resumo, follow-up) considera só mensagens pós-marco. Não apaga nada; o atendente segue vendo tudo. Enterprise-only |

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

@@ -522,12 +522,10 @@ WhatsappCall (Ligação WhatsApp — enterprise, voz via Cloud API)
 ├── custom_name (observação) / favorited (bool)
 └── transcript / transcript_status (pending/processing/completed/failed — IA da conta)
 
-WavoipSetting (Ligação WP em caixa QR Code — 1 por inbox) — SEM TOOL NO MCP (2026-07-16)
-├── inbox_id (FK) / device_id / device_token (cripto) / status / due_date
-├── record_all_calls (bool) / auto_transcribe (bool) / transcription_provider (groq|openai)
-├── feature flag wavoip_calling; limite de plano wavoip_voice_inboxes
-└── NAO ha tool pra ler nem escrever isto. Ligação WP e contratada/configurada MANUALMENTE pelo
-    cliente no painel. Aqui so pra voce entender o modelo — nao tente operar.
+WavoipSetting — TABELA REMOVIDA em 13/08/2026 (integração Wavoip encerrada; último uso 30/07)
+└── Não existe mais modelo, tabela, tela nem rota. Ligações ANTIGAS do Wavoip continuam no
+    histórico (CallLog com provider "wavoip"), com quem ligou, quando e quanto durou; as gravações
+    ficavam no servidor da Wavoip e vão sumir. Para voz em caixa QR Code hoje: LionCalls.
 
 ContactDocument (aba Documentos do contato, 2026-06-11)
 ├── 3 fontes agregadas: upload direto + espelho dos cards Kanban + espelho das conversas (só image/file)

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

@@ -114,6 +114,20 @@ stage_id/inbox_id/sort_by/sort_direction/page foram REMOVIDOS, eram ignorados pe
   responde "o que se mexeu essa semana". Pontas independentes, e os dois períodos podem ser combinados.
   Nuance ao explicar pro usuário: card criado ontem que nunca se moveu TAMBÉM entra (ele entrou na
   etapa ao nascer) — o que o filtro separa de verdade é o card VELHO que se moveu.
+- `updated_date_start`/`updated_date_end` (2026-08-13) — **última alteração no card**
+  (`updated_at`). Pega QUALQUER mexida: mover, trocar etapa, etiqueta, valor, nota, anexo, marcar
+  ganho/perdido. É o "o que teve alguma ação no período", independentemente de qual ação foi.
+  Medido em 13/08: 97,7% das escritas correspondem a uma atividade visível no histórico do card.
+- `closed_date_start`/`closed_date_end` (2026-08-13) — **data do DESFECHO** (quando o card foi
+  marcado como Ganho ou Perdido). É o que responde *"quantos ganhos eu dei no mês passado"*, e é
+  a régua `closed` do `Kanban::DateBasis` — a MESMA da página Relatórios > Kanban, então os dois
+  batem. Use junto de `statuses: ['won']` para ver só os ganhos.
+  **NÃO confundir com as outras três datas:** um negócio pode ter nascido em janeiro
+  (`date_*`), estar parado na mesma etapa desde março (`stage_date_*`), ter sido editado ontem
+  (`updated_date_*`) e ter sido GANHO em julho (`closed_date_*`). Só este último responde à
+  pergunta de fechamento. Pontas independentes; combinável com os demais períodos.
+  Nuance: card cujo desfecho nunca foi carimbado cai na data da última alteração (é o 3º ramo da
+  régua, e continua valendo para card importado por planilha, que nasce fechado sem data).
 - `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

package/dist/docs/resources/glossary.md

@@ -404,32 +404,35 @@ Campos MUTÁVEIS (atualizáveis livremente por IA/integração): `marital_status
 
 | Sistema | O que é | Tools | Canal |
 |---|---|---|---|
-| **Ligação WP (Wavoip)** | Voz pelo WhatsApp em caixa **QR Code/WAHA** — QR conecta um "device" Wavoip (pago, por caixa); widget de discagem, gravação e transcrição automática | **NENHUMA — sem tool no MCP** (ver nota abaixo) | WhatsApp QR Code |
 | **LionCalls** | Voz pelo WhatsApp em caixa **QR Code**, mas pelo **motor próprio do LionChat** (credencial global, 1 sessão por caixa; flag `lioncalls_calling`, nasce desligada e é ligada conta a conta) | **NENHUMA — sem tool no MCP** | WhatsApp QR Code |
 | **WhatsApp Calling (Cloud)** | Voz pelo WhatsApp na **API oficial** (enterprise) | `whatsapp_calls_*` + enable/disable_whatsapp_calling | WhatsApp oficial |
 | **VoIP (Zenvia)** | Telefonia COMUM com softphone no navegador (ramais, saldo, recarga) | `voip_*` | Telefone |
 | **VTCall** | Telefonia por **PABX click-to-call**, config por conta + ramal por atendente; **sem softphone no navegador** — o atendente fala pelo app/ramal do VTCall | `vtcall_settings_*` (show/update/test_connection), `vtcall_ramals_*` (list/create/destroy) | Telefone (PABX do cliente) |
 
-Quando o usuário falar "ligação", descubra o canal ANTES de responder: caixa QR Code → Wavoip **ou**
-LionCalls (dois motores diferentes para o MESMO tipo de caixa — veja qual está conectado nela); caixa
-oficial → `whatsapp_calls`; telefone/ramal → Zenvia (softphone) ou VTCall (PABX).
-
-**Histórico é compartilhado.** Wavoip, LionCalls, Zenvia e VTCall gravam na MESMA tabela de ligações,
-então `voip_calls_list` (`/voip/calls`) devolve as quatro juntas — mesmo as que não têm tool própria.
-Só o WhatsApp Calling (Cloud) fica fora, em `whatsapp_calls_*`.
-
-**Wavoip — SEM TOOL NO MCP (decisão do dono, 2026-07-16).** As 8 tools `wavoip_*` (status, token,
-calls, connect, disconnect, settings, should_ring, flag_rejected) foram REMOVIDAS dos dois conectores.
-Motivo: cada device custa **R$70/mês na conta de revenda do LionChat** (não do cliente), e o MCP
-conseguia CRIAR device pago, DERRUBAR a linha de um cliente e ainda entregar o `token` — que permite
-FAZER ligações, gerando custo. Ligação WP é contratada e configurada **manualmente pelo cliente no
-painel**. Se o usuário pedir algo de Ligação WP, oriente-o ao painel (Configurações da caixa →
-Ligação WP) — **não existe tool e não deve existir**. NÃO re-adicionar sem ordem explícita do dono.
-
-Contexto (só pra conversar, não pra operar): config por inbox (`record_all_calls`, `auto_transcribe`,
-`transcription_provider` groq|openai), feature flag `wavoip_calling`, limite de plano
-`wavoip_voice_inboxes`. WhatsappCall (Cloud, esse SIM tem tool): `status`, `custom_name`,
-`favorited`, `transcript`/`transcript_status`.
+Quando o usuário falar "ligação", descubra o canal ANTES de responder: caixa QR Code → **LionCalls**;
+caixa oficial → `whatsapp_calls`; telefone/ramal → Zenvia (softphone) ou VTCall (PABX).
+
+**Histórico é compartilhado.** LionCalls, Zenvia e VTCall gravam na MESMA tabela de ligações, então
+`voip_calls_list` (`/voip/calls`) devolve as três juntas — mesmo as que não têm tool própria. Só o
+WhatsApp Calling (Cloud) fica fora, em `whatsapp_calls_*`. Ligações antigas do **Wavoip** (integração
+encerrada em 30/07/2026) continuam aparecendo nesse histórico, com `provider: "wavoip"`.
+
+**Wavoip — INTEGRAÇÃO REMOVIDA (12/08/2026).** O vínculo com a Wavoip acabou; o último uso real foi
+em 30/07/2026. Saíram do produto: a aba "Ligação WP" da caixa, o discador, o Super Admin, as rotas,
+os webhooks, as tarefas automáticas e a tabela. As 8 tools `wavoip_*` já haviam sido removidas do MCP
+em 16/07 — **não re-adicionar**, não há mais o que chamar.
+
+Se o usuário perguntar por "Ligação WP" ou "Wavoip": a integração **não existe mais**; para voz em
+caixa QR Code hoje o caminho é o **LionCalls**. Nunca orientar o usuário a "Configurações da caixa →
+Ligação WP" — essa aba não existe.
+
+**O que SOBRA e continua funcionando:** as **2.927 ligações antigas** seguem no histórico com
+`provider: "wavoip"`, com quem ligou, quando e quanto durou. As **gravações** ficavam no servidor da
+Wavoip e vão sumir — ao tentar ouvir, o painel mostra "Esta gravação não está mais disponível" em vez
+de um botão que não funciona. Isso é esperado, não é defeito.
+
+WhatsappCall (Cloud, esse SIM tem tool): `status`, `custom_name`, `favorited`,
+`transcript`/`transcript_status`.
 
 ## Chat interno da equipe (InternalChat)
 

package/endpoints.json

@@ -3658,7 +3658,7 @@
   "method": "GET",
   "path": "/api/v1/accounts/{account_id}/kanban_items/filter",
   "title": "Filtrar Items",
-  "description": "Filtra cards do Kanban com o filtro RICO da plataforma (mesmo motor da tela '+ Filtro'). Filtros REAIS aplicados: etapas (stages), prioridades, status do card (open/won/lost), agente, faixa de valor, periodo de criacao (date_start/end), periodo de MOVIMENTACAO PARA A ETAPA atual (stage_date_start/end), periodo de agendamento (scheduled_date_*), tarefas (task_filter), canal, etiqueta da conversa, oferta e atributos personalizados de card/contato/conversa (JSON-string + custom_attribute_match all/any). ATENCAO: SEM paginacao — retorna ate 5000 cards em ordem created_at DESC, shape {items:[], total, filters}. NAO existe filtro por time aqui (use lionchat_kanban_items_list_3 pra relatorio por time, ou filtre por agent_id); ordenacao e fixa. (2026-07-24: removidos os parametros stage_id/inbox_id/sort_by/sort_direction/page — eram aceitos mas IGNORADOS pelo backend; use stages[] no lugar de stage_id.)",
+  "description": "Filtra cards do Kanban com o filtro RICO da plataforma (mesmo motor da tela '+ Filtro'). Filtros REAIS aplicados: etapas (stages), prioridades, status do card (open/won/lost), agente, faixa de valor, periodo de criacao (date_start/end), periodo de MOVIMENTACAO PARA A ETAPA atual (stage_date_start/end), periodo de agendamento (scheduled_date_*), tarefas (task_filter), canal, etiqueta da conversa, oferta e atributos personalizados de card/contato/conversa (JSON-string + custom_attribute_match all/any). ATENCAO: SEM paginacao — retorna ate 5000 cards em ordem created_at DESC, shape {items:[], total, filters}. NAO existe filtro por time aqui (use lionchat_kanban_items_list_3 pra relatorio por time, ou filtre por agent_id); ordenacao e fixa. (2026-07-24: removidos os parametros stage_id/inbox_id/sort_by/sort_direction/page — eram aceitos mas IGNORADOS pelo backend; use stages[] no lugar de stage_id.) NOVO 2026-08-13: updated_date_start/end (ultima alteracao, qualquer mexida) e closed_date_start/end (data do DESFECHO — ganho/perdido; use com statuses=['won'] pra 'os ganhos do mes').",
   "category": "Itens",
   "params": [
    {
@@ -3741,6 +3741,34 @@
     "required": false,
     "description": "Movido para a etapa ate (YYYY-MM-DD) — cobre o dia inteiro."
    },
+   {
+    "name": "updated_date_start",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Ultima alteracao a partir de (YYYY-MM-DD) — QUALQUER mexida no card (mover, trocar etapa, etiqueta, valor, nota, anexo, marcar ganho/perdido). Responde 'o que teve alguma acao no periodo', sem distinguir qual acao. Pontas independentes."
+   },
+   {
+    "name": "updated_date_end",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Ultima alteracao ate (YYYY-MM-DD) — cobre o dia inteiro."
+   },
+   {
+    "name": "closed_date_start",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Ganho ou perdido a partir de (YYYY-MM-DD) — data do DESFECHO do card. E o filtro que responde 'quantos ganhos eu dei no mes passado': use junto com statuses=['won']. Mesma regua da pagina Relatorios > Kanban (date_basis 'closed'), entao os numeros batem. NAO confundir com as outras tres datas: um negocio pode ter nascido em janeiro (date_start), estar parado na etapa desde marco (stage_date_start), ter sido editado ontem (updated_date_start) e ter sido GANHO em julho (closed_date_start). Card cujo desfecho nunca foi carimbado cai na data da ultima alteracao. Pontas independentes."
+   },
+   {
+    "name": "closed_date_end",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Ganho ou perdido ate (YYYY-MM-DD) — cobre o dia inteiro."
+   },
    {
     "name": "scheduled_date_start",
     "type": "string",
@@ -7516,6 +7544,27 @@
     "location": "body",
     "required": false,
     "description": "Modo de atribuicao de conversas no time. Valores: 'online_only' (padrao — so atribui a agentes com status online no momento) ou 'include_offline' (rodizio entre TODOS os agentes do time, mesmo offline)."
+   },
+   {
+    "name": "fair_distribution_limit",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Teto de conversas que o robo entrega a CADA atendente do time dentro da janela (freio de rajada; a vaga volta quando a conversa deixa de estar aberta). Padrao 10. Zero = sem freio. So tem efeito com assignment_mode 'online_only'."
+   },
+   {
+    "name": "fair_distribution_window",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Tamanho da janela do freio em SEGUNDOS (600 = 10 minutos). Padrao 600."
+   },
+   {
+    "name": "assignment_order",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Ordem de atribuicao do time: 'round_robin' (rodizio — distribui igualmente, por ordem de vez) ou 'balanced' (equilibrado — entrega pra quem tem MENOS conversas abertas no momento). OMITIR o campo (ou mandar null) significa 'o time nao escolheu' e a decisao HERDA do nivel de cima: politica da caixa, depois auto_assignment_config da caixa, e por fim rodizio. NUNCA mandar 'round_robin' so pra preencher: isso vira escolha EXPLICITA do time e rebaixa em silencio uma caixa que roda equilibrado por politica. 'balanced' exige o recurso advanced_assignment na conta."
    }
   ],
   "returns": "time/equipe criado (com novo ID)",
@@ -7533,7 +7582,7 @@
   "method": "PUT",
   "path": "/api/v1/accounts/{account_id}/teams/{team_id}",
   "title": "Atualizar Time",
-  "description": "Atualiza um time/equipe existente. Campos suportados: name, description, allow_auto_assign, assignment_mode. Edita o time em si (não os membros — para membros use lionchat_team_members_update).",
+  "description": "Atualiza um time/equipe existente. Campos suportados: name, description, allow_auto_assign, assignment_mode, fair_distribution_limit, fair_distribution_window, assignment_order. Edita o time em si (não os membros — para membros use lionchat_team_members_update).",
   "category": "Times",
   "params": [
    {
@@ -7570,6 +7619,27 @@
     "location": "body",
     "required": false,
     "description": "Modo de atribuicao de conversas no time. Valores: 'online_only' (padrao — so atribui a agentes com status online no momento) ou 'include_offline' (rodizio entre TODOS os agentes do time, mesmo offline)."
+   },
+   {
+    "name": "fair_distribution_limit",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Teto de conversas que o robo entrega a CADA atendente do time dentro da janela (freio de rajada; a vaga volta quando a conversa deixa de estar aberta). Padrao 10. Zero = sem freio. So tem efeito com assignment_mode 'online_only'."
+   },
+   {
+    "name": "fair_distribution_window",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Tamanho da janela do freio em SEGUNDOS (600 = 10 minutos). Padrao 600."
+   },
+   {
+    "name": "assignment_order",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Ordem de atribuicao do time: 'round_robin' (rodizio — distribui igualmente, por ordem de vez) ou 'balanced' (equilibrado — entrega pra quem tem MENOS conversas abertas no momento). OMITIR o campo (ou mandar null) significa 'o time nao escolheu' e a decisao HERDA do nivel de cima: politica da caixa, depois auto_assignment_config da caixa, e por fim rodizio. NUNCA mandar 'round_robin' so pra preencher: isso vira escolha EXPLICITA do time e rebaixa em silencio uma caixa que roda equilibrado por politica. 'balanced' exige o recurso advanced_assignment na conta."
    }
   ],
   "returns": "time/equipe atualizado",
@@ -9770,6 +9840,13 @@
     "required": true,
     "description": "Título"
    },
+   {
+    "name": "booking_event_type.user_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "ID do agente responsável pelo Booking (Agente responsável). Só admin pode definir para outro agente; sem isso fica em nome de quem cria. Pegue o ID em agents_list."
+   },
    {
     "name": "booking_event_type.duration_minutes",
     "type": "integer",
@@ -9868,6 +9945,13 @@
     "required": false,
     "description": "Título"
    },
+   {
+    "name": "booking_event_type.user_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "ID do novo agente responsável (só admin pode trocar o dono do Booking)."
+   },
    {
     "name": "booking_event_type.active",
     "type": "boolean",
@@ -28171,4 +28255,4 @@
    "lionchat_conversations_show"
   ]
  }
-]
+]

package/package.json

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