@lionchat/mcp-server 0.5.0 → 0.5.2

package/endpoints.json

@@ -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": [
       {
@@ -7694,7 +7694,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": [
       {
@@ -12325,7 +12325,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 +12354,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 +19211,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 +19227,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 +19281,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 +19297,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",
@@ -23402,5 +23416,720 @@
     "related_tools": [
       "lionchat_journey_funnel_reports"
     ]
+  },
+  {
+    "id": "lionchat_wavoip_status",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/status",
+    "title": "Status da Ligação WP (Wavoip)",
+    "description": "Status do device Wavoip da caixa QR Code: conectado, vencimento, QR pra parear. Flag wavoip_calling.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      }
+    ],
+    "returns": "{ status, due_date, qr_url, num_channels }",
+    "common_use_cases": [
+      "Diagnosticar ligação que não conecta"
+    ],
+    "related_tools": [
+      "lionchat_wavoip_connect"
+    ]
+  },
+  {
+    "id": "lionchat_wavoip_calls",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/calls",
+    "title": "Histórico de Ligações WP",
+    "description": "Histórico de ligações de voz da caixa (Wavoip), com gravação e transcrição quando configuradas. Membro da caixa pode ver.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      },
+      {
+        "name": "status",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Filtro por status"
+      },
+      {
+        "name": "agent_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Por agente"
+      },
+      {
+        "name": "date_from",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Início ISO 8601"
+      },
+      {
+        "name": "date_to",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Fim ISO 8601"
+      },
+      {
+        "name": "favorited",
+        "type": "boolean",
+        "location": "query",
+        "required": false,
+        "description": "Só favoritas"
+      },
+      {
+        "name": "q",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Busca por nome/telefone"
+      }
+    ],
+    "returns": "{ calls: [...], meta }",
+    "common_use_cases": [
+      "Ver ligações do dia",
+      "Achar gravação de uma ligação"
+    ],
+    "related_tools": [
+      "lionchat_wavoip_settings_update"
+    ]
+  },
+  {
+    "id": "lionchat_wavoip_token",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/token",
+    "title": "Token do Device Wavoip (agente)",
+    "description": "Token do device pro agente discar/atender no widget. Membro da caixa.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      }
+    ],
+    "returns": "{ token }",
+    "common_use_cases": [
+      "Destravar o discador de um agente"
+    ],
+    "related_tools": []
+  },
+  {
+    "id": "lionchat_wavoip_connect",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/connect",
+    "title": "Conectar Ligação WP",
+    "description": "Cria o device Wavoip da caixa (checa limite do plano wavoip_voice_inboxes; custo R$70/device/mês). ADMIN. Mudança de config — confirme com o usuário.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      }
+    ],
+    "returns": "{ status, qr_url }",
+    "common_use_cases": [
+      "Ativar voz numa caixa QR Code"
+    ],
+    "related_tools": [
+      "lionchat_wavoip_status"
+    ]
+  },
+  {
+    "id": "lionchat_wavoip_disconnect",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/disconnect",
+    "title": "Desconectar Ligação WP",
+    "description": "Deleta o device Wavoip (cancela a cobrança). ADMIN. DESTRUTIVO — confirme antes.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      }
+    ],
+    "returns": "200 OK",
+    "common_use_cases": [
+      "Desativar voz e parar cobrança"
+    ],
+    "related_tools": []
+  },
+  {
+    "id": "lionchat_wavoip_settings_update",
+    "method": "PUT",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/wavoip/settings",
+    "title": "Configurar Gravação/Transcrição (Wavoip)",
+    "description": "Define gravação e transcrição automática das ligações da caixa. ADMIN.",
+    "category": "Ligacao WP (Wavoip)",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada (WhatsApp QR Code)"
+      },
+      {
+        "name": "record_all_calls",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Gravar todas as ligações"
+      },
+      {
+        "name": "auto_transcribe",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Transcrever automaticamente com IA"
+      },
+      {
+        "name": "transcription_provider",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "groq | openai"
+      }
+    ],
+    "returns": "{ settings }",
+    "common_use_cases": [
+      "Ligar gravação + transcrição automática"
+    ],
+    "related_tools": []
+  },
+  {
+    "id": "lionchat_contacts_documents_list",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/contacts/{contact_id}/documents",
+    "title": "Documentos do Contato",
+    "description": "Central de arquivos do contato: uploads diretos + espelho dos anexos dos cards Kanban + das conversas (só imagem/documento). Dedup por arquivo.",
+    "category": "Documentos do Contato",
+    "params": [
+      {
+        "name": "contact_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do contato"
+      }
+    ],
+    "returns": "{ documents: [{ id, name, source (upload|kanban|conversation), favorited, url, created_at }] }",
+    "common_use_cases": [
+      "Ver todos os arquivos de um cliente num lugar só"
+    ],
+    "related_tools": [
+      "lionchat_contacts_documents_create"
+    ]
+  },
+  {
+    "id": "lionchat_contacts_documents_create",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/contacts/{contact_id}/documents",
+    "title": "Adicionar Documento ao Contato",
+    "description": "Upload direto de arquivo pro contato (via MCP: use lionchat_upload_create antes e passe a URL/signed_id, se suportado — upload multipart direto não é suportado).",
+    "category": "Documentos do Contato",
+    "params": [
+      {
+        "name": "contact_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do contato"
+      },
+      {
+        "name": "file",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Arquivo (signed_id do upload ou URL)"
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Nome de exibição"
+      }
+    ],
+    "returns": "{ document } (201)",
+    "common_use_cases": [
+      "Guardar contrato/documento do cliente"
+    ],
+    "related_tools": [
+      "lionchat_upload_create"
+    ]
+  },
+  {
+    "id": "lionchat_contacts_documents_update",
+    "method": "PATCH",
+    "path": "/api/v1/accounts/{account_id}/contacts/{contact_id}/documents/{id}",
+    "title": "Renomear/Favoritar Documento",
+    "description": "Renomeia ou favorita um documento direto do contato.",
+    "category": "Documentos do Contato",
+    "params": [
+      {
+        "name": "contact_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do contato"
+      },
+      {
+        "name": "id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do documento"
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Novo nome"
+      },
+      {
+        "name": "favorited",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Favoritar"
+      }
+    ],
+    "returns": "{ document }",
+    "common_use_cases": [
+      "Organizar arquivos do cliente"
+    ],
+    "related_tools": []
+  },
+  {
+    "id": "lionchat_contacts_documents_destroy",
+    "method": "DELETE",
+    "path": "/api/v1/accounts/{account_id}/contacts/{contact_id}/documents/{id}",
+    "title": "Excluir Documento do Contato",
+    "description": "Exclui documento de upload direto. DESTRUTIVO — confirme antes. (Anexos de conversa são só-leitura.)",
+    "category": "Documentos do Contato",
+    "params": [
+      {
+        "name": "contact_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do contato"
+      },
+      {
+        "name": "id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do documento"
+      }
+    ],
+    "returns": "200 OK",
+    "common_use_cases": [
+      "Remover arquivo errado"
+    ],
+    "related_tools": []
+  },
+  {
+    "id": "lionchat_contacts_documents_mirror",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/contacts/{contact_id}/documents/mirror",
+    "title": "Ajustar Documento Espelhado",
+    "description": "Define nome/favorito de um anexo espelhado (de card Kanban/conversa) sem alterar o original.",
+    "category": "Documentos do Contato",
+    "params": [
+      {
+        "name": "contact_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do contato"
+      },
+      {
+        "name": "attachment_id",
+        "type": "integer",
+        "location": "body",
+        "required": true,
+        "description": "ID do anexo espelhado"
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Nome de exibição"
+      },
+      {
+        "name": "favorited",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Favoritar"
+      }
+    ],
+    "returns": "{ document }",
+    "common_use_cases": [
+      "Renomear arquivo vindo do card"
+    ],
+    "related_tools": []
+  },
+  {
+    "id": "lionchat_contacts_documents_destroy_mirror",
+    "method": "DELETE",
+    "path": "/api/v1/accounts/{account_id}/contacts/{contact_id}/documents/mirror/{attachment_id}",
+    "title": "Excluir Anexo Espelhado (card)",
+    "description": "Exclui o anexo do CARD Kanban espelhado na aba Documentos (anexos de conversa não podem). DESTRUTIVO — confirme antes.",
+    "category": "Documentos do Contato",
+    "params": [
+      {
+        "name": "contact_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do contato"
+      },
+      {
+        "name": "attachment_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID do anexo do card"
+      }
+    ],
+    "returns": "200 OK",
+    "common_use_cases": [
+      "Limpar arquivo do card"
+    ],
+    "related_tools": []
+  },
+  {
+    "id": "lionchat_inboxes_update",
+    "method": "PATCH",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{id}",
+    "title": "Atualizar Caixa de Entrada",
+    "description": "Atualiza configurações da caixa (nome, saudação, atribuição automática, atributos extras). MUDANÇA DE CONFIG — confirme com o usuário antes. additional_attributes.mark_as_seen (bool, default true, SÓ WhatsApp oficial, 2026-06-11): envia o visto/check azul quando o agente abre a conversa — desligar em coexistência app+API. ATENÇÃO: enviar additional_attributes substitui o objeto; para WAHA prefira não mexer nesse campo (config sensível).",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa"
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Novo nome"
+      },
+      {
+        "name": "greeting_enabled",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Saudação automática ligada"
+      },
+      {
+        "name": "greeting_message",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Texto da saudação"
+      },
+      {
+        "name": "enable_auto_assignment",
+        "type": "boolean",
+        "location": "body",
+        "required": false,
+        "description": "Atribuição automática"
+      },
+      {
+        "name": "additional_attributes",
+        "type": "object",
+        "location": "body",
+        "required": false,
+        "description": "Atributos extras (ex: { mark_as_seen: false } no WhatsApp oficial)"
+      }
+    ],
+    "returns": "{ inbox }",
+    "common_use_cases": [
+      "Desligar o visto numa caixa em coexistência",
+      "Trocar saudação da caixa"
+    ],
+    "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"
+    ]
   }
 ]