@lionchat/mcp-server 0.5.7 → 0.5.9

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

@@ -261,6 +261,57 @@ Pra dados fixos que se repetem (slogans, endereços, horários):
 
 Nunca hard-code esses dados em respostas geradas.
 
+## Variável dinâmica: atributo do contato escolhe a variável da conta (2026-07)
+
+Receita pra quando a mensagem precisa puxar um valor que DEPENDE de um campo do contato.
+Exemplo clássico: contato tem `unidade_de_atendimento` (Sorocaba) e a mensagem deve trazer
+o endereço DAQUELA unidade sem o atendente escolher nada.
+
+A técnica é busca indireta (indirect lookup) em Liquid: montar o NOME da variável da conta
+usando o VALOR do atributo do contato e buscar por colchete `account.custom_attribute[chave]`.
+
+### Peças a criar (todas têm tool no MCP)
+
+1. Atributo de contato tipo lista (`custom_attributes_create`): ex. `unidade_de_atendimento`
+   com valores `sorocaba`, `tatuape`... (slugs limpos: sem acento, sem espaço).
+2. Uma variável da conta por opção (`account_variables_create`), nomeada `prefixo_` + valor:
+   `endereco_sorocaba`, `endereco_tatuape`...
+3. Resposta pronta (`canned_responses_create`) usando a sintaxe abaixo.
+
+### Sintaxe que funciona
+
+```text
+Seu atendimento será na unidade {{contact.custom_attribute.unidade_de_atendimento}}.
+Endereço: {% assign chave = "endereco_" | append: contact.custom_attribute.unidade_de_atendimento | downcase %}{% echo account.custom_attribute[chave] %}
+```
+
+### Regras críticas (confirmadas no código)
+
+- A parte dinâmica DEVE usar `{% assign %}` + `{% echo %}` (tags `{% %}`), NUNCA `{{ }}`:
+  a caixa de mensagem substitui/apaga `{{ }}` desconhecido antes de enviar; tags `{% %}`
+  passam intactas e o backend (Liquid 5) resolve na criação da mensagem.
+- Variáveis simples conhecidas (ex. `{{contact.custom_attribute.unidade_de_atendimento}}`)
+  podem ficar em `{{ }}` normalmente.
+- Casamento da chave: o valor do atributo, em minúsculo, precisa bater EXATAMENTE com o
+  final do nome da variável da conta (`sorocaba` -> `endereco_sorocaba`). Por isso os
+  valores da lista devem ser slugs sem acento/espaço. O `| downcase` cobre maiúsculas,
+  mas NÃO remove acento nem espaço.
+- NÃO envolva o trecho Liquid em crase/backticks: código entre crases vira `{% raw %}`
+  (não processa) — a mensagem sairia com o código literal.
+- Variável da conta tipo `secret` sai VAZIA em mensagem (bloqueio de segurança; só resolve
+  em nó API Request do FlowBuilder).
+- Onde resolve: mensagens outgoing, respostas prontas, campanhas e automações. NÃO resolve
+  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.
+
+### Padrão geral (serve pra qualquer caso)
+
+- Atributo do contato = o seletor (unidade, plano, cidade...).
+- Variáveis da conta = a tabela de valores (`endereco_X`, `preco_X`, `link_X`...).
+- Mensagem monta a chave: `"prefixo_" | append: valor_do_contato | downcase` e busca com
+  `account.custom_attribute[chave]`.
+
 ## Templates WhatsApp com variáveis do sistema (auto-preenchimento) (2026-06)
 
 Ao criar/editar um template WhatsApp (`inboxes_whatsapp_templates_create` / `_create_2`), o corpo usa

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

@@ -248,7 +248,7 @@ No editor visual esses destinos só aparecem quando a validação bate (computed
 | `conversation_has_agent` / `conversation_no_agent` / `conversation_not_agent` | agente atribuído |
 | `contact_has_label` / `contact_no_label` / `conversation_has_label` / `conversation_no_label` | labels |
 | `kanban_exists` / `kanban_in_stage` / `kanban_won` / `kanban_lost` | card no funil (usa `funnel_id` + `stage`) |
-| `card_attr_equals` / `card_attr_contains` | atributo do card (`attrSource: 'card'` + `attr_key`) |
+| `card_attr_equals` / `card_attr_contains` | atributo do card (`attrSource: 'card'` + `attr_key`; aceita `card_source: 'trigger'` p/ ler o card que iniciou o flow) |
 | `pagetrack_visited` / `pagetrack_event` | LionTrack |
 | `sla_check` | status do SLA da conversa (usa `value` = código fixo; ver abaixo) |
 
@@ -327,6 +327,8 @@ Ex.: `{ "operator": "sla_check", "value": "frt_breached" }`. "Estourado" = o mon
 
 **Handles que SAEM:** `success`. Não tem handle `error` — falhas viram warning silencioso e o flow continua.
 
+**`card_source` (blocos de card) — opcional:** as ações de card aceitam `card_source`: `'funnel'` (default — procura o card pelo `funnel_id`) ou `'trigger'` (usa o card que DISPAROU o flow, em flows iniciados por `card_created`/`card_moved`/`card_won`/`card_lost`). Com `'trigger'`, `funnel_id` deixa de ser obrigatório — EXCETO em `move_kanban_stage`/`create_kanban_item`, cujo funil/etapa são o DESTINO. Sem card-gatilho disponível, a ação é pulada (não cai no fallback de funil). Aplica-se a `move_kanban_stage`, `set_won`/`set_lost`/`set_open`, `assign_agent_card`, `add_card_note`, `update_attribute` (com `attr_source: 'card'`) e às condições `card_attr_equals`/`card_attr_contains` (gravando `card_source` na própria regra).
+
 **`update_attribute` — campos EXATOS:** `attr_source` (`'contact'`, `'conversation'` ou `'card'`), `attr_key` (nome do atributo), `attr_value` (valor). NÃO existem `entity`/`key`/`value` — esses são ignorados e não salvam nada.
 
 **Somar/subtrair NÃO é operação dedicada** — é filtro Liquid no próprio `attr_value`. O valor é resolvido como template antes de salvar. Exemplos:

package/endpoints.json

@@ -1901,6 +1901,13 @@
         "location": "body",
         "required": false,
         "description": "Arquivos anexos"
+      },
+      {
+        "name": "content_attributes",
+        "type": "object",
+        "location": "body",
+        "required": false,
+        "description": "Atributos livres da mensagem (objeto). Chaves uteis: coex_backup=true => envia fora da janela de 24h via sessao WAHA so-envio (caixa Cloud em coexistencia); reply_mode='public'|'private' + in_reply_to_comment_id => responde a um comentario do Instagram; in_reply_to => cita/responde outra mensagem pelo id."
       }
     ],
     "returns": "mensagem criada",
@@ -2295,7 +2302,7 @@
         "type": "object",
         "location": "body",
         "required": false,
-        "description": "Configurações"
+        "description": "Objeto de configuracoes do funil. Chaves: goals[], agents[] e automations[] (automacoes do funil). Cada automacao: {id, enabled, trigger_type: 'card_created'|'stage_moved'|'status_change', trigger_value (id da etapa p/ stage_moved; status p/ status_change; vazio p/ card_created), action: 'move_to_stage'|'assign_agent'|'create_note'|'update_checklist'|'apply_checklist_template'|'notify_team'|'duplicate_item'|'send_webhook', action_config: {} (ex.: move_to_stage->{stage}; assign_agent->{agent_id}; create_note->{note_text}; apply_checklist_template->{template_id}; notify_team->{message}; send_webhook->{webhook_url}; duplicate_item->{funnel_id,stage})}. ATENCAO: gravar settings SUBSTITUI o objeto inteiro — leia o funil (show) e reenvie settings completo (goals+agents+automations)."
       },
       {
         "name": "funnel.global_custom_attributes",
@@ -2374,7 +2381,7 @@
         "type": "object",
         "location": "body",
         "required": false,
-        "description": "Configurações"
+        "description": "Objeto de configuracoes do funil. Chaves: goals[], agents[] e automations[] (automacoes do funil). Cada automacao: {id, enabled, trigger_type: 'card_created'|'stage_moved'|'status_change', trigger_value (id da etapa p/ stage_moved; status p/ status_change; vazio p/ card_created), action: 'move_to_stage'|'assign_agent'|'create_note'|'update_checklist'|'apply_checklist_template'|'notify_team'|'duplicate_item'|'send_webhook', action_config: {} (ex.: move_to_stage->{stage}; assign_agent->{agent_id}; create_note->{note_text}; apply_checklist_template->{template_id}; notify_team->{message}; send_webhook->{webhook_url}; duplicate_item->{funnel_id,stage})}. ATENCAO: gravar settings SUBSTITUI o objeto inteiro — leia o funil (show) e reenvie settings completo (goals+agents+automations)."
       }
     ],
     "returns": "funil atualizado",
@@ -3997,6 +4004,13 @@
         "location": "body",
         "required": false,
         "description": "BOTAO DE PANICO: true pausa TODA a IA do assistente (respostas, follow-ups, callbacks) sem perder config. Top-level, auditado"
+      },
+      {
+        "name": "config.follow_up_skip_conditions",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Condicoes para a IA NAO fazer follow-up (ate 3). Array de objetos, ex.: {type, operator, attribute, value, labels:[]}."
       }
     ],
     "returns": "assistente AI criado (com novo ID)",
@@ -4208,6 +4222,13 @@
         "location": "body",
         "required": false,
         "description": "BOTAO DE PANICO: true pausa TODA a IA do assistente (respostas, follow-ups, callbacks) sem perder config. Top-level, auditado"
+      },
+      {
+        "name": "config.follow_up_skip_conditions",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Condicoes para a IA NAO fazer follow-up (ate 3). Array de objetos, ex.: {type, operator, attribute, value, labels:[]}."
       }
     ],
     "returns": "assistente AI atualizado",
@@ -6191,7 +6212,15 @@
     "title": "Listar Threads Copilot",
     "description": "Lista as threads do Copilot.",
     "category": "Assistentes",
-    "params": [],
+    "params": [
+      {
+        "name": "conversation_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra as threads do Copiloto pela conversa (conversation_display_id)."
+      }
+    ],
     "returns": "meta (contadores globais) + payload (array de assistentes AI)",
     "common_use_cases": [
       "Dashboard: contar/exibir assistentes AI",
@@ -7134,7 +7163,7 @@
         "type": "string",
         "location": "body",
         "required": false,
-        "description": "Modo de atribuição de conversas no time"
+        "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)."
       }
     ],
     "returns": "time/equipe criado (com novo ID)",
@@ -7188,7 +7217,7 @@
         "type": "string",
         "location": "body",
         "required": false,
-        "description": "Modo de atribuição de conversas no time"
+        "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)."
       }
     ],
     "returns": "time/equipe atualizado",
@@ -12929,6 +12958,13 @@
         "required": false,
         "description": "Nome"
       },
+      {
+        "name": "description",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Nova descricao do cargo"
+      },
       {
         "name": "permissions",
         "type": "array",
@@ -18172,9 +18208,73 @@
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/kanban_config",
     "title": "Criar Configuracao Kanban",
-    "description": "Cria a configuracao do Kanban. Cria novo config Kanban. Valida unicidade quando aplicável. Retorna o config Kanban criado com ID atribuído.",
+    "description": "Cria a configuracao do Kanban da conta (singleton). Aceita: checklist_templates (templates de checklist reutilizaveis aplicados aos cards), win_reasons/loss_reasons (motivos de ganho/perda), global_custom_attributes (atributos dos cards), config (preferencias) e webhook (url/secret/events).",
     "category": "Config Kanban",
-    "params": [],
+    "params": [
+      {
+        "name": "kanban_config.checklist_templates",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Templates de checklist reutilizaveis aplicaveis aos cards. Formato: [{id, name, items:[{id, text}]}]"
+      },
+      {
+        "name": "kanban_config.win_reasons",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Motivos de ganho do funil. Formato: [{id, title}]"
+      },
+      {
+        "name": "kanban_config.loss_reasons",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Motivos de perda do funil. Formato: [{id, title}]"
+      },
+      {
+        "name": "kanban_config.global_custom_attributes",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Atributos personalizados globais dos cards. Formato: [{name, type, is_list, list_values:[]}]"
+      },
+      {
+        "name": "kanban_config.config",
+        "type": "object",
+        "location": "body",
+        "required": false,
+        "description": "Preferencias do Kanban: title, default_view, auto_assignment, notifications_enabled, support_email, support_phone, support_chat_hours, support_chat_enabled, dragbar_enabled, quick_message_enabled, list_view_enabled, agenda_view_enabled"
+      },
+      {
+        "name": "kanban_config.enabled",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Habilita/desabilita a config (afeta o webhook)"
+      },
+      {
+        "name": "kanban_config.webhook_url",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "URL do webhook do Kanban"
+      },
+      {
+        "name": "kanban_config.webhook_secret",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Segredo HMAC do webhook"
+      },
+      {
+        "name": "kanban_config.webhook_events",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Eventos do webhook habilitados (array de strings)"
+      }
+    ],
     "returns": "config Kanban criado (com novo ID)",
     "common_use_cases": [
       "Cadastro inicial de config Kanban",
@@ -18192,9 +18292,73 @@
     "method": "PUT",
     "path": "/api/v1/accounts/{account_id}/kanban_config",
     "title": "Atualizar Configuracao Kanban",
-    "description": "Atualiza a configuracao do Kanban. Atualiza campos do config Kanban existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados.",
+    "description": "Atualiza a configuracao do Kanban da conta. Atualizacao parcial — so os campos enviados mudam. Use para criar/editar checklist_templates (templates de checklist dos cards), win_reasons/loss_reasons (motivos de ganho/perda), global_custom_attributes (atributos dos cards), config (preferencias) e webhook (url/secret/events).",
     "category": "Config Kanban",
-    "params": [],
+    "params": [
+      {
+        "name": "kanban_config.checklist_templates",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Templates de checklist reutilizaveis aplicaveis aos cards. Formato: [{id, name, items:[{id, text}]}]"
+      },
+      {
+        "name": "kanban_config.win_reasons",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Motivos de ganho do funil. Formato: [{id, title}]"
+      },
+      {
+        "name": "kanban_config.loss_reasons",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Motivos de perda do funil. Formato: [{id, title}]"
+      },
+      {
+        "name": "kanban_config.global_custom_attributes",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Atributos personalizados globais dos cards. Formato: [{name, type, is_list, list_values:[]}]"
+      },
+      {
+        "name": "kanban_config.config",
+        "type": "object",
+        "location": "body",
+        "required": false,
+        "description": "Preferencias do Kanban: title, default_view, auto_assignment, notifications_enabled, support_email, support_phone, support_chat_hours, support_chat_enabled, dragbar_enabled, quick_message_enabled, list_view_enabled, agenda_view_enabled"
+      },
+      {
+        "name": "kanban_config.enabled",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Habilita/desabilita a config (afeta o webhook)"
+      },
+      {
+        "name": "kanban_config.webhook_url",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "URL do webhook do Kanban"
+      },
+      {
+        "name": "kanban_config.webhook_secret",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Segredo HMAC do webhook"
+      },
+      {
+        "name": "kanban_config.webhook_events",
+        "type": "array",
+        "location": "body",
+        "required": false,
+        "description": "Eventos do webhook habilitados (array de strings)"
+      }
+    ],
     "returns": "config Kanban atualizado",
     "common_use_cases": [
       "Edição parcial de config Kanban",
@@ -19745,6 +19909,26 @@
       "lionchat_agents_create"
     ]
   },
+  {
+    "id": "lionchat_agents_list",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/agents",
+    "title": "Listar Agentes",
+    "description": "Lista todos os agentes (usuarios) da conta. Retorna id, name, email, availability_status, confirmed, role (agent ou administrator) e, no Enterprise, custom_role_id (ID do cargo personalizado aplicado ao agente, ou null). Use para descobrir os IDs dos agentes antes de atualizar papel/cargo, reatribuir recursos ou auditar a equipe.",
+    "category": "Agentes",
+    "params": [],
+    "returns": "array de agentes (id, name, email, role, custom_role_id, availability_status, confirmed)",
+    "common_use_cases": [
+      "Descobrir o ID de um agente antes de atualizar ou remover",
+      "Auditar quem e administrador, agente puro ou tem cargo personalizado",
+      "Listar a equipe para aplicar um cargo personalizado em massa"
+    ],
+    "related_tools": [
+      "lionchat_agents_update",
+      "lionchat_agents_create",
+      "lionchat_custom_roles_list"
+    ]
+  },
   {
     "id": "lionchat_agents_create",
     "method": "POST",
@@ -19787,6 +19971,13 @@
         "location": "body",
         "required": false,
         "description": "Define se o agente fica offline automaticamente por inatividade"
+      },
+      {
+        "name": "custom_role_id",
+        "type": "integer",
+        "location": "body",
+        "required": false,
+        "description": "ID do cargo personalizado (custom role) a aplicar ja no convite. Requer Enterprise. Use lionchat_custom_roles_list para obter os IDs. Envie junto com role=agent (cargo personalizado e sempre nivel agente)."
       }
     ],
     "returns": "agente convidado (com novo ID)",
@@ -19800,12 +19991,38 @@
       "lionchat_agents_update"
     ]
   },
+  {
+    "id": "lionchat_agents_resend_invitation",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/agents/{id}/resend_invitation",
+    "title": "Reenviar Convite do Agente",
+    "description": "Reenvia o e-mail de convite (confirmacao de acesso) para um agente que ainda nao confirmou a conta. Retorna erro se o agente ja estiver confirmado. Rate limit: 1 envio por minuto por agente (429 com retry_after se chamar cedo demais).",
+    "category": "Agentes",
+    "params": [
+      {
+        "name": "id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do agente"
+      }
+    ],
+    "returns": "message: sent + email do agente | 422 se ja confirmado | 429 se rate-limited",
+    "common_use_cases": [
+      "Agente novo nao recebeu ou perdeu o e-mail de convite",
+      "Reativar acesso de agente que nunca confirmou a conta"
+    ],
+    "related_tools": [
+      "lionchat_agents_list",
+      "lionchat_agents_create"
+    ]
+  },
   {
     "id": "lionchat_agents_update",
     "method": "PATCH",
     "path": "/api/v1/accounts/{account_id}/agents/{id}",
     "title": "Atualizar Agente",
-    "description": "Atualiza um agente existente. Campos suportados: name, role (agent ou administrator), availability, auto_offline. Use para promover/rebaixar papel ou ajustar disponibilidade.",
+    "description": "Atualiza um agente existente. Campos suportados: name, role (agent ou administrator), availability, auto_offline e custom_role_id (aplica um cargo personalizado no Enterprise). Use para promover/rebaixar papel, ajustar disponibilidade ou aplicar um cargo personalizado.",
     "category": "Agentes",
     "params": [
       {
@@ -19842,16 +20059,26 @@
         "location": "body",
         "required": false,
         "description": "Define se o agente fica offline automaticamente por inatividade"
+      },
+      {
+        "name": "custom_role_id",
+        "type": "integer",
+        "location": "body",
+        "required": false,
+        "description": "ID do cargo personalizado (custom role) a aplicar ao agente. Requer Enterprise. IMPORTANTE: o backend aplica este campo em TODA atualizacao do agente — se voce atualizar um agente que tem cargo personalizado SEM enviar custom_role_id, o cargo sera REMOVIDO. Ao editar um agente que tem cargo, envie sempre o custom_role_id junto. Use lionchat_custom_roles_list para obter os IDs dos cargos."
       }
     ],
     "returns": "agente atualizado",
     "common_use_cases": [
       "Promover um agente a administrador",
       "Alterar disponibilidade de um agente",
-      "Ajustar o comportamento de offline automático"
+      "Ajustar o comportamento de offline automático",
+      "Aplicar um cargo personalizado (custom role) a um agente"
     ],
     "related_tools": [
-      "lionchat_agents_create"
+      "lionchat_agents_create",
+      "lionchat_agents_list",
+      "lionchat_custom_roles_list"
     ]
   },
   {
@@ -24364,6 +24591,84 @@
       "lionchat_inboxes_whatsapp_history_status"
     ]
   },
+  {
+    "id": "lionchat_inboxes_coex_backup_connect",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/coex_backup/connect",
+    "title": "Conectar Saida de Emergencia (Coex)",
+    "description": "Provisiona/conecta a sessao WAHA so-envio (retorna QR) de uma caixa WhatsApp Cloud em coexistencia, usada para enviar texto fora da janela de 24h. Requer admin + feature 'coexistence_backup_send' + caixa Cloud em coexistencia.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (inbox)"
+      }
+    ],
+    "returns": "Estado da sessao de emergencia (state, qr, connected)",
+    "common_use_cases": [
+      "Ativar o envio fora da janela de 24h numa caixa Cloud",
+      "Exibir o QR para parear o numero de emergencia"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_coex_backup_status",
+      "lionchat_inboxes_coex_backup_disconnect"
+    ]
+  },
+  {
+    "id": "lionchat_inboxes_coex_backup_status",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/coex_backup/status",
+    "title": "Status da Saida de Emergencia (Coex)",
+    "description": "Retorna o estado da sessao WAHA so-envio da caixa (state, qr, connected). Nunca levanta erro. Requer admin + feature 'coexistence_backup_send'.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (inbox)"
+      }
+    ],
+    "returns": "{ state, qr, connected }",
+    "common_use_cases": [
+      "Verificar se a saida de emergencia esta conectada",
+      "Buscar o QR atual durante o pareamento"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_coex_backup_connect",
+      "lionchat_inboxes_coex_backup_disconnect"
+    ]
+  },
+  {
+    "id": "lionchat_inboxes_coex_backup_disconnect",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/coex_backup/disconnect",
+    "title": "Desconectar Saida de Emergencia (Coex)",
+    "description": "Desconecta/destroi a sessao WAHA so-envio da caixa Cloud em coexistencia. Requer admin + feature 'coexistence_backup_send'.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (inbox)"
+      }
+    ],
+    "returns": "Resultado da desconexao",
+    "common_use_cases": [
+      "Desligar o envio fora da janela de 24h",
+      "Limpar a sessao de emergencia da caixa"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_coex_backup_connect",
+      "lionchat_inboxes_coex_backup_status"
+    ]
+  },
   {
     "id": "lionchat_conversations_toggle_block",
     "method": "POST",

package/package.json

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