@lionchat/mcp-server 1.24.0 → 1.26.0

package/endpoints.json

@@ -173,7 +173,7 @@
   "method": "POST",
   "path": "/api/v1/accounts/{account_id}/contacts",
   "title": "Criar Contato",
-  "description": "Cria um contato. Nenhum campo e estritamente obrigatorio (recomendado phone_number ou email). Aceita name, email, phone_number, identifier, additional_attributes, custom_attributes, blocked. TELEFONE UNICO POR CONTA (trava no BANCO desde 01/09/2026, como e-mail e identifier): phone_number ja cadastrado em outro contato da conta = 422 'phone_number has already been taken' — inclusive em chamadas paralelas. Procure antes com contacts_search (acha com e sem o 9o digito) e use contacts_update no que existe.\n\nSE VOLTAR 422 com attributes:['phone_number']: o contato JA EXISTE — na forma exata OU na outra forma do nono digito. Nao tente criar de novo trocando a forma do numero (a recusa protege contra ficha em dobro): busque com lionchat_contacts_search e use contacts_update. Case os 'attributes' da resposta, nunca o texto da mensagem (ela sai no idioma padrao da instalacao, em ingles).",
+  "description": "Cria um contato. Nenhum campo e estritamente obrigatorio (recomendado phone_number ou email). Aceita name, email, phone_number, identifier, additional_attributes, custom_attributes, blocked. TELEFONE UNICO POR CONTA (trava no BANCO desde 01/09/2026, como e-mail e identifier): phone_number ja cadastrado em outro contato da conta = 422 'phone_number has already been taken' — inclusive em chamadas paralelas. Procure antes com contacts_search (acha com e sem o 9o digito) e use contacts_update no que existe.\n\nSE VOLTAR 422 com attributes:['phone_number']: o contato JA EXISTE — na forma exata OU na outra forma do nono digito. Nao tente criar de novo trocando a forma do numero (a recusa protege contra ficha em dobro): busque com lionchat_contacts_search e use contacts_update. Case os 'attributes' da resposta, nunca o texto da mensagem (ela sai no idioma padrao da instalacao, em ingles). EMPRESA (2026-09-25): aceita company_id (ver param); o contato devolve company_id. Cargo da pessoa = additional_attributes.job_title.",
   "category": "Contatos",
   "params": [
    {
@@ -231,6 +231,13 @@
     "location": "body",
     "required": false,
     "description": "ID da sessão"
+   },
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Empresa da mesma conta a ligar ao contato (null/vazio tira da empresa; sem a chave nada muda). Escolher a empresa faz additional_attributes.company_name virar o nome dela. Empresa de outra conta = 404. Empresa com 100 contatos = 422 (teto)."
    }
   ],
   "returns": "contato criado (com novo ID)",
@@ -283,7 +290,7 @@
   "method": "PATCH",
   "path": "/api/v1/accounts/{account_id}/contacts/{id}",
   "title": "Atualizar Contato",
-  "description": "Atualiza um contato. Aceita name, email, phone_number, identifier, custom_attributes, additional_attributes, blocked, avatar/avatar_url. NUNCA sobrescreva phone_number/email ja preenchido sem confirmacao. TELEFONE UNICO POR CONTA (trava no banco desde 01/09/2026): trocar phone_number para um numero que ja e de outro contato da conta = 422 'phone_number has already been taken'.",
+  "description": "Atualiza um contato. Aceita name, email, phone_number, identifier, custom_attributes, additional_attributes, blocked, avatar/avatar_url. NUNCA sobrescreva phone_number/email ja preenchido sem confirmacao. TELEFONE UNICO POR CONTA (trava no banco desde 01/09/2026): trocar phone_number para um numero que ja e de outro contato da conta = 422 'phone_number has already been taken'. EMPRESA (2026-09-25): aceita company_id (ver param); o contato devolve company_id. Cargo da pessoa = additional_attributes.job_title.",
   "category": "Contatos",
   "params": [
    {
@@ -348,6 +355,13 @@
     "location": "body",
     "required": false,
     "description": "Bloquear contato"
+   },
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Empresa da mesma conta a ligar ao contato (null/vazio tira da empresa; sem a chave nada muda). Escolher a empresa faz additional_attributes.company_name virar o nome dela. Empresa de outra conta = 404. Empresa com 100 contatos = 422 (teto)."
    }
   ],
   "returns": "contato atualizado",
@@ -698,7 +712,7 @@
   "method": "POST",
   "path": "/api/v1/accounts/{account_id}/contacts/filter",
   "title": "Filtrar Contatos",
-  "description": "Filtra contatos com condicoes avancadas (payload de condicoes). 15/pagina.\n\nCHAVES FILTRAVEIS: name, email, identifier (equal_to/not_equal_to/contains/does_not_contain — match parcial case-insensitive); phone_number (+starts_with); country_code, city, company; cpf, cnpj, rg, profession (cadastral; cpf/cnpj/rg aceitam is_present/is_not_present); labels; created_at, last_activity_at (is_greater_than/is_less_than/days_before); blocked (equal_to true/false); QUALQUER outra chave = atributo personalizado do contato.\n\nREGISTROS VINCULADOS (acha o contato pelo que aconteceu com ele): attribute_key 'conversation_search' (conversa vinculada: conversation_status/conversation_labels/conversation_inbox_id), condicoes com custom_attribute_type 'conversation_attribute' (atributo da conversa vinculada) e attribute_key 'kanban_card' (card vinculado: card_funnel_id/card_stage/card_priority/card_status). Combinaveis com E/OU.\n\nCada condicao: {attribute_key, filter_operator, values[], query_operator:'and'|'or', custom_attribute_type?}. Operador fora da lista da chave = 422. [2026-07-25] Nova chave id (id interno do contato, equal_to/not_equal_to) — serve pra exportar/checar UM contato especifico. NOTA 18/08: data FIXA com is_greater_than/is_less_than corta o dia no FUSO DA CONTA (padrao America/Sao_Paulo), nao mais em UTC — mesmo criterio das datas relativas.\n\nTELEFONE COM E SEM O 9 (desde 05/09/2026): phone_number com equal_to/not_equal_to casa as DUAS formas do celular brasileiro (mande +5541999887766 ou +554199887766 — acham a mesma ficha; not_equal_to exclui as duas). Valor formatado ('(41) 99988-7766') tambem casa. Telefone fixo, estrangeiro ou trecho segue exato. ATENCAO: 'Selecionar todos' + excluir sobre um filtro de telefone apaga as 2 fichas da mesma pessoa (decisao do dono, 05/09).",
+  "description": "Filtra contatos com condicoes avancadas (payload de condicoes). 15/pagina.\n\nCHAVES FILTRAVEIS: name, email, identifier (equal_to/not_equal_to/contains/does_not_contain — match parcial case-insensitive); phone_number (+starts_with); country_code, city, company_name (Empresa), job_title (Cargo) [company = campo antigo, nunca casa]; cpf, cnpj, rg, profession (cadastral; cpf/cnpj/rg aceitam is_present/is_not_present); labels; created_at, last_activity_at (is_greater_than/is_less_than/days_before); blocked (equal_to true/false); QUALQUER outra chave = atributo personalizado do contato.\n\nREGISTROS VINCULADOS (acha o contato pelo que aconteceu com ele): attribute_key 'conversation_search' (conversa vinculada: conversation_status/conversation_labels/conversation_inbox_id), condicoes com custom_attribute_type 'conversation_attribute' (atributo da conversa vinculada) e attribute_key 'kanban_card' (card vinculado: card_funnel_id/card_stage/card_priority/card_status). Combinaveis com E/OU.\n\nCada condicao: {attribute_key, filter_operator, values[], query_operator:'and'|'or', custom_attribute_type?}. Operador fora da lista da chave = 422. [2026-07-25] Nova chave id (id interno do contato, equal_to/not_equal_to) — serve pra exportar/checar UM contato especifico. NOTA 18/08: data FIXA com is_greater_than/is_less_than corta o dia no FUSO DA CONTA (padrao America/Sao_Paulo), nao mais em UTC — mesmo criterio das datas relativas.\n\nTELEFONE COM E SEM O 9 (desde 05/09/2026): phone_number com equal_to/not_equal_to casa as DUAS formas do celular brasileiro (mande +5541999887766 ou +554199887766 — acham a mesma ficha; not_equal_to exclui as duas). Valor formatado ('(41) 99988-7766') tambem casa. Telefone fixo, estrangeiro ou trecho segue exato. ATENCAO: 'Selecionar todos' + excluir sobre um filtro de telefone apaga as 2 fichas da mesma pessoa (decisao do dono, 05/09).",
   "category": "Contatos",
   "params": [
    {
@@ -3274,7 +3288,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Objeto com os detalhes do card. MESCLA SO NO 1o NIVEL: cada chave enviada troca a chave inteira no card; as nao enviadas ficam. Lista FECHADA (outras chaves sao descartadas em silencio): title, description, status, reason, win_reason, loss_reason, attributed_to, duplicated_from_id, priority, value (NUMERO; texto de numero como \"1500.5\" e convertido, \"R$ 1.500,00\" e recusado com 422), currency, custom_attributes, offers, closed_offers, closed_offer, deadline_at, scheduling_type, scheduled_at, conversation_id, automations, notes. custom_attributes = campos da aba Campos do card: LISTA [{name, type, value}] onde name+type batem EXATAMENTE com a definicao da CONTA (lionchat_kanban_config_list -> global_custom_attributes). Ex.: [{\"name\": \"Origem do Lead\", \"type\": \"string\", \"value\": \"Google\"}]. A lista e TROCADA inteira: leia o card com lionchat_kanban_items_show e reenvie TODOS os campos. Objeto {chave: valor} no lugar da lista APAGA todos os campos do card. notes e offers tambem sao listas trocadas inteiras. Motivo de ganho/perda: status \"won\"/\"lost\" + win_reason/loss_reason = o id (TEXTO) de um motivo de kanban_config.win_reasons/loss_reasons + reason = o titulo dele. Motivo livre (fora da lista): win_reason/loss_reason nulo e o texto em reason. Ex.: {\"status\": \"lost\", \"loss_reason\": \"perda-preco\", \"reason\": \"Preco alto\"}."
+    "description": "Objeto com os detalhes do card. MESCLA SO NO 1o NIVEL: cada chave enviada troca a chave inteira no card; as nao enviadas ficam. Lista FECHADA (outras chaves sao descartadas em silencio): title, description, status, reason, win_reason, loss_reason, attributed_to, duplicated_from_id, priority, value (NUMERO; texto de numero como \"1500.5\" e convertido, \"R$ 1.500,00\" e recusado com 422), currency, custom_attributes, offers, closed_offers, closed_offer, deadline_at, scheduling_type, scheduled_at, conversation_id, automations, notes, retroativo_em. custom_attributes = campos da aba Campos do card: LISTA [{name, type, value}] onde name+type batem EXATAMENTE com a definicao da CONTA (lionchat_kanban_config_list -> global_custom_attributes). Ex.: [{\"name\": \"Origem do Lead\", \"type\": \"string\", \"value\": \"Google\"}]. A lista e TROCADA inteira: leia o card com lionchat_kanban_items_show e reenvie TODOS os campos. Objeto {chave: valor} no lugar da lista APAGA todos os campos do card. notes e offers tambem sao listas trocadas inteiras. Motivo de ganho/perda: status \"won\"/\"lost\" + win_reason/loss_reason = o id (TEXTO) de um motivo de kanban_config.win_reasons/loss_reasons + reason = o titulo dele. Motivo livre (fora da lista): win_reason/loss_reason nulo e o texto em reason. Ex.: {\"status\": \"lost\", \"loss_reason\": \"perda-preco\", \"reason\": \"Preco alto\"}. Lancamento retroativo (marcar o fechamento com data PASSADA): retroativo_em = \"AAAA-MM-DD\" faz o ganho/perda contar no MES ESCOLHIDO em todos os relatorios, em vez do dia de hoje. So funciona JUNTO com um status \"won\"/\"lost\" que MUDA o status do card — card que ja esta ganho ignora a data (pra corrigir uma data lancada errado: mande status \"open\", que apaga o carimbo, e depois \"won\"/\"lost\" com o retroativo_em certo). A chave NAO fica gravada no card: ela so decide o carimbo item_details.status_changed_at, que e o que os relatorios contam. Data FUTURA ou ilegivel = 422. Data anterior a criacao do card e permitida. Vale SO nesta ferramenta — no criar card a chave e descartada. Ex.: {\"status\": \"won\", \"win_reason\": \"indicacao\", \"retroativo_em\": \"2026-08-05\"}."
    },
    {
     "name": "kanban_item.assigned_agents",
@@ -3316,7 +3330,8 @@
   "common_use_cases": [
    "Edição parcial de item Kanban",
    "Alteração de status/estado",
-   "Atualização em massa via automação"
+   "Atualização em massa via automação",
+   "Registrar uma venda fechada no mes passado: status \"won\" + retroativo_em \"AAAA-MM-DD\" (o relatorio conta no mes escolhido)"
   ],
   "related_tools": [
    "lionchat_kanban_items_list",
@@ -5513,7 +5528,7 @@
   "method": "GET",
   "path": "/api/v2/accounts/{account_id}/reports",
   "title": "Relatorios Detalhados",
-  "description": "Serie temporal de uma metrica. metric obrigatorio. group_by: hour/day/week/month/year.",
+  "description": "Serie temporal de uma metrica. metric obrigatorio. group_by: hour/day/week/month/year. Pra ver QUAIS conversas formam um ponto, use lionchat_reports_drilldown com o 'timestamp' dele.",
   "category": "Relatorios",
   "params": [
    {
@@ -5582,7 +5597,99 @@
   "related_tools": [
    "lionchat_reports_list",
    "lionchat_reports_list_1",
-   "lionchat_reports_list_2"
+   "lionchat_reports_list_2",
+   "lionchat_reports_drilldown"
+  ]
+ },
+ {
+  "id": "lionchat_reports_drilldown",
+  "method": "GET",
+  "path": "/api/v2/accounts/{account_id}/reports/drilldown",
+  "title": "Conversas por trás de um ponto do gráfico",
+  "description": "Lista as CONVERSAS que formam UM ponto da série temporal (lionchat_reports_list_5) — o mesmo que clicar numa barra do gráfico nos Relatórios. Usa a MESMA régua que desenhou o ponto, então a lista bate com o número (ex.: etiqueta conta pela data em que foi APLICADA). Fluxo: chame lionchat_reports_list_5, pegue o 'timestamp' do ponto e passe aqui em bucket_timestamp, repetindo metric, group_by, type, id, timezone_offset e business_hours da série (são eles que definem onde o ponto começa e termina). Mostra SÓ as conversas que a pessoa do token pode abrir: meta.hidden_count diz quantas ficaram de fora por permissão — diga isso ao usuário em vez de concluir que faltam conversas. 25 por página, mais recentes primeiro; teto de 5.000 conversas por ponto. Exige permissão de ver relatórios. Métrica fora da lista = 422 {error: 'invalid metric'}; data fora do formato Unix = 400.",
+  "category": "Relatorios",
+  "params": [
+   {
+    "name": "metric",
+    "type": "string",
+    "location": "query",
+    "required": true,
+    "description": "A MESMA métrica da série. Aceita SÓ: conversations_count | incoming_messages_count | outgoing_messages_count | resolutions_count | avg_first_response_time | avg_resolution_time | reply_time. Métricas de bot (bot_resolutions_count, bot_handoffs_count) NÃO têm lista."
+   },
+   {
+    "name": "bucket_timestamp",
+    "type": "string",
+    "location": "query",
+    "required": true,
+    "description": "Início do ponto: o campo 'timestamp' devolvido por lionchat_reports_list_5 (Unix em SEGUNDOS)."
+   },
+   {
+    "name": "group_by",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Tamanho do ponto: hour | day | week | month | year (padrão day). Use o MESMO da série, senão o recorte muda e a lista não bate."
+   },
+   {
+    "name": "type",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Escopo: account | inbox | agent | label | team (padrão account). O mesmo da série."
+   },
+   {
+    "name": "id",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "ID da caixa/agente/etiqueta/time quando type != account. O mesmo da série."
+   },
+   {
+    "name": "since",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Início do período do relatório (Unix em SEGUNDOS). Recorta o ponto quando o período começa no meio dele (ex.: semana que começou antes)."
+   },
+   {
+    "name": "until",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Fim do período do relatório (Unix em SEGUNDOS). Recorta o último ponto."
+   },
+   {
+    "name": "timezone_offset",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Fuso em horas (ex: -3 pra Brasília). O MESMO da série — define a fronteira do dia/hora do ponto."
+   },
+   {
+    "name": "business_hours",
+    "type": "boolean",
+    "location": "query",
+    "required": false,
+    "description": "Só nas médias de tempo: true = mede só o expediente (mesma regra da série). Use o MESMO valor da série."
+   },
+   {
+    "name": "page",
+    "type": "integer",
+    "location": "query",
+    "required": false,
+    "description": "Página (25 por página, fixo). Padrão 1."
+   }
+  ],
+  "returns": "{ meta: { metric, since, until (o recorte REAL do ponto, Unix), page, per_page, total_count (conversas do ponto), visible_count (as que a pessoa pode abrir), hidden_count (fora por permissão) }, payload: [{ id, display_id (número da conversa na tela), status, created_at (Unix), contact_name, inbox_name, assignee_name, detail }] }. detail = o porquê de cada conversa: {count} (quantas mensagens/eventos dela caíram no ponto) nas contagens de mensagens e resoluções, {seconds} nas médias de tempo, ou null.",
+  "common_use_cases": [
+   "Quais conversas formam o pico de terça-feira no gráfico",
+   "Ver quem demorou para responder naquela semana (avg_first_response_time)",
+   "Listar as conversas resolvidas num dia específico"
+  ],
+  "related_tools": [
+   "lionchat_reports_list_5",
+   "lionchat_reports_summary",
+   "lionchat_conversations_show"
   ]
  },
  {
@@ -6395,9 +6502,16 @@
     "location": "query",
     "required": false,
     "description": "Busca textual em pergunta/resposta"
+   },
+   {
+    "name": "sort",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "occurrences = mais perguntadas primeiro (use com status=pending pra ver as sugestões que mais se repetem). Sem o parâmetro = mais recentes primeiro."
    }
   ],
-  "returns": "array de respostas (AssistantResponse)",
+  "returns": "array de respostas (AssistantResponse). Cada uma traz occurrences_count (desde 26/09/2026): em quantas conversas DIFERENTES a mesma pergunta pendente apareceu (começa em 1; só soma enquanto pendente) — é o 'perguntada em N conversas' da tela.",
   "common_use_cases": [
    "Dashboard: contar/exibir assistentes AI",
    "Buscar com filtros antes de outra operação",
@@ -6422,7 +6536,7 @@
     "type": "integer",
     "location": "body",
     "required": true,
-    "description": "ID do agente dono da FAQ — NOT NULL no banco"
+    "description": "ID do agente dono da FAQ — NOT NULL no banco. Tem que ser um agente DESTA conta: de outra conta = 404 (25/09/2026)."
    },
    {
     "name": "question",
@@ -10479,46 +10593,102 @@
   "method": "POST",
   "path": "/api/v1/accounts/{account_id}/flows/test_api",
   "title": "Testar Node API",
-  "description": "Testa um no de API (executa a requisicao HTTP) e retorna a resposta.",
+  "description": "Executa a requisição HTTP de um bloco de API do FlowBuilder pelo SERVIDOR (o mesmo que o botão 'Testar requisição' da tela) e devolve a resposta. Só administrador. Tudo vai dentro de 'config', com os MESMOS nomes que o bloco de API grava no flow_data (apiUrl, apiMethod, apiHeaders...): dá pra copiar o data do node lido com lionchat_flows_show. Variáveis {{...}} são trocadas pelo valor de test_variables; {{account.custom_attribute.X}} usa a variável da conta (inclusive secreta). Variável sem valor fica como {{nome}} no texto. CORRIGIDO 25/09/2026: antes o servidor descartava em silêncio apiQueryParams, apiBodyMode, apiBodyFields, apiSendHeaders e apiSendQueryParams — o teste saía sem parâmetro de URL e sem body em modo chave-valor. Não segue redirecionamento.",
   "category": "Flows",
   "params": [
    {
-    "name": "url",
+    "name": "config.apiUrl",
     "type": "string",
     "location": "body",
     "required": true,
-    "description": "URL do endpoint"
+    "description": "URL do endpoint (aceita {{variáveis}})."
    },
    {
-    "name": "method",
+    "name": "config.apiMethod",
     "type": "string",
     "location": "body",
     "required": false,
-    "description": "GET, POST, PUT, PATCH, DELETE"
+    "description": "GET (padrão), POST, PUT, PATCH, DELETE. Body só é enviado em POST/PUT/PATCH."
    },
    {
-    "name": "headers",
-    "type": "object",
+    "name": "config.apiQueryParams",
+    "type": "array",
     "location": "body",
     "required": false,
-    "description": "Headers customizados"
+    "description": "Parâmetros de URL: lista de {key, value} (aceitam {{variáveis}}). Acrescentados à URL já codificados."
    },
    {
-    "name": "body",
+    "name": "config.apiSendQueryParams",
+    "type": "boolean",
+    "location": "body",
+    "required": false,
+    "description": "false = ignora apiQueryParams (chave desligada na tela). Padrão true."
+   },
+   {
+    "name": "config.apiHeaders",
+    "type": "array",
+    "location": "body",
+    "required": false,
+    "description": "Cabeçalhos: lista de {key, value} (aceitam {{variáveis}})."
+   },
+   {
+    "name": "config.apiSendHeaders",
+    "type": "boolean",
+    "location": "body",
+    "required": false,
+    "description": "false = ignora apiHeaders. Padrão true."
+   },
+   {
+    "name": "config.apiAuthType",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "bearer (vira Authorization: Bearer <token>) | basic (Authorization: Basic <token>, token já em base64) | api_key (X-Api-Key: <token>) | vazio = sem autenticação."
+   },
+   {
+    "name": "config.apiAuthToken",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Token da autenticação (aceita {{variáveis}}, ex. {{account.custom_attribute.minha_chave}})."
+   },
+   {
+    "name": "config.apiBodyMode",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "json (padrão: manda apiBody como está) | fields (monta um JSON a partir de apiBodyFields)."
+   },
+   {
+    "name": "config.apiBody",
     "type": "string",
     "location": "body",
     "required": false,
-    "description": "Body da requisição"
+    "description": "Corpo em texto (normalmente JSON) quando apiBodyMode=json. Aceita {{variáveis}}."
+   },
+   {
+    "name": "config.apiBodyFields",
+    "type": "array",
+    "location": "body",
+    "required": false,
+    "description": "Corpo em modo chave-valor (apiBodyMode=fields): lista de {key, value}; vira um JSON {key: value}."
    },
    {
-    "name": "timeout",
+    "name": "config.apiTimeout",
     "type": "integer",
     "location": "body",
     "required": false,
-    "description": "Timeout em segundos (max 25)"
+    "description": "Tempo limite em SEGUNDOS: padrão 10, máximo 25 (acima disso é limitado a 25)."
+   },
+   {
+    "name": "test_variables",
+    "type": "object",
+    "location": "body",
+    "required": false,
+    "description": "Valores pras variáveis do teste: {\"contact.name\": \"Maria\", \"var.pedido\": \"123\"} — a chave é o texto de dentro das chaves duplas."
    }
   ],
-  "returns": "resposta HTTP",
+  "returns": "{ status (código HTTP; 0 = não chegou a responder), ok (true se 2xx), body (resposta como texto; em falha, o motivo — ex. 'URL nao configurada', 'Request timeout apos 10s') }",
   "common_use_cases": [
    "Cadastro inicial de flow",
    "Automação a partir de evento externo",
@@ -10619,7 +10789,7 @@
     "type": "array",
     "location": "body",
     "required": true,
-    "description": "CADA item de actions DEVE ser um OBJETO {action_name (string), action_params (array)} — NUNCA um texto/string solto. Ex.: [{\"action_name\":\"send_message\",\"action_params\":[\"Oi\"]}]. [{action_name, action_params[]}] Actions novas (2026-07-21): 'update_contact_attribute' e 'update_conversation_attribute' — action_params: [{attribute_key, value}], value aceita texto fixo OU variável Liquid (ex. {{contact.phone_number}}); grava atributo personalizado com MERGE (não apaga os demais) e passa pelo porteiro de data. 'pending_conversation' (2026-07-20, sem params) — deixa a conversa PENDENTE (handoff; mensagem nova do cliente NÃO reabre). ATENCAO — 'send_whatsapp_template': action_params: [{name, id, language, category, processed_params}]. 'name' e OBRIGATORIO e e o nome EXATO do modelo aprovado na Meta (o envio acontece por ele); 'language' precisa bater com o idioma aprovado (padrao pt_BR); processed_params: {\"body\": {\"1\": \"{{contact.first_name}}\"}}. NUNCA use template_name/template_id/template_category/template_language — esse e o formato dos nos do FlowBuilder e aqui e IGNORADO: a regra salva com sucesso, aparece na tela e NAO ENVIA NADA, sem erro nem log (incidente real conta 39 em 02/08/2026: 14h sem enviar, 9 leads perdidos). Confira o modelo antes com lionchat_inboxes_whatsapp_templates_list. So funciona em caixa WhatsApp API Oficial (Cloud). REGRA GERAL: action_params e SEMPRE um array (o backend le params[0]) e seu CONTEUDO nao e validado pela API. Se nao souber o formato de uma acao, leia uma regra existente com lionchat_automation_rules_show e copie — nunca invente nome de chave. Formato de TODAS as acoes no resource 'conversation-flows'. MAIS USADOS (action_params e SEMPRE lista): send_message [\"texto\"]; add_private_note [\"texto\"]; add_label/remove_label [\"nome-da-etiqueta\"]; assign_agent [70] ([\"nil\"] desatribui); assign_team [3]; change_status [\"resolved\"|\"open\"|\"pending\"|\"snoozed\"]; change_priority [\"high\"]; send_canned_response [12]; update_conversation_attribute [{\"attribute_key\": \"chave\", \"value\": \"texto\"}]; create_kanban_item [{\"funnel_id\": 31, \"funnel_stage\": \"prospeccao\"}]; move_kanban_item_to_stage [{\"funnel_id\": 31, \"funnel_stage\": \"qualificacao\"}]. Tabela completa no resource conversation-flows ('Acoes de automacao')."
+    "description": "CADA item de actions DEVE ser um OBJETO {action_name (string), action_params (array)} — NUNCA um texto/string solto. Ex.: [{\"action_name\":\"send_message\",\"action_params\":[\"Oi\"]}]. [{action_name, action_params[]}] Actions novas (2026-07-21): 'update_contact_attribute' e 'update_conversation_attribute' — action_params: [{attribute_key, value}], value aceita texto fixo OU variável Liquid (ex. {{contact.phone_number}}); grava atributo personalizado com MERGE (não apaga os demais) e passa pelo porteiro de data. 'pending_conversation' (2026-07-20, sem params) — deixa a conversa PENDENTE (handoff; mensagem nova do cliente NÃO reabre). ATENCAO — 'send_whatsapp_template': action_params: [{name, id, language, category, processed_params}]. 'name' e OBRIGATORIO e e o nome EXATO do modelo aprovado na Meta (o envio acontece por ele); 'language' precisa bater com o idioma aprovado (padrao pt_BR); processed_params: {\"body\": {\"1\": \"{{contact.first_name}}\"}}. NUNCA use template_name/template_id/template_category/template_language — esse e o formato dos nos do FlowBuilder e aqui e IGNORADO: a regra salva com sucesso, aparece na tela e NAO ENVIA NADA, sem erro nem log (incidente real conta 39 em 02/08/2026: 14h sem enviar, 9 leads perdidos). Confira o modelo antes com lionchat_inboxes_whatsapp_templates_list. So funciona em caixa WhatsApp API Oficial (Cloud). REGRA GERAL: action_params e SEMPRE um array (o backend le params[0]) e seu CONTEUDO nao e validado pela API. Se nao souber o formato de uma acao, leia uma regra existente com lionchat_automation_rules_show e copie — nunca invente nome de chave. Formato de TODAS as acoes no resource 'conversation-flows'. MAIS USADOS (action_params e SEMPRE lista): send_message [\"texto\"]; add_private_note [\"texto\"]; add_label/remove_label [\"nome-da-etiqueta\"]; assign_agent [70] ([\"nil\"] desatribui); assign_team [3]; change_status [\"resolved\"|\"open\"|\"pending\"|\"snoozed\"]; change_priority [\"high\"]; send_canned_response [12]; update_conversation_attribute [{\"attribute_key\": \"chave\", \"value\": \"texto\"}]; create_kanban_item [{\"funnel_id\": 31, \"funnel_stage\": \"prospeccao\"}]; move_kanban_item_to_stage [{\"funnel_id\": 31, \"funnel_stage\": \"qualificacao\"}]. Tabela completa no resource conversation-flows ('Acoes de automacao'). ESPERA QUE CONFERE (26/09/2026): 'wait' aceita o formato OBJETO [{\"seconds\": 120, \"only_if_open\": true, \"only_if_no_reply\": true}] — na VOLTA, only_if_open só segue se a conversa ainda estiver aberta/pendente e only_if_no_reply só segue se ninguém respondeu o cliente durante a espera (qualquer mensagem pública de saída conta). Barrou = o resto da regra não roda e o histórico da execução mostra o passo wait_check 'skipped'. O formato antigo [120] continua valendo, sem conferência. Teto 300 s."
    },
    {
     "name": "active",
@@ -10717,7 +10887,7 @@
     "type": "array",
     "location": "body",
     "required": false,
-    "description": "CADA item de actions DEVE ser um OBJETO {action_name (string), action_params (array)} — NUNCA um texto/string solto. Ex.: [{\"action_name\":\"send_message\",\"action_params\":[\"Oi\"]}]. Acoes Actions novas (2026-07-21): 'update_contact_attribute' e 'update_conversation_attribute' — action_params: [{attribute_key, value}], value aceita texto fixo OU variável Liquid (ex. {{contact.phone_number}}); grava atributo personalizado com MERGE (não apaga os demais) e passa pelo porteiro de data. 'pending_conversation' (2026-07-20, sem params) — deixa a conversa PENDENTE (handoff; mensagem nova do cliente NÃO reabre). ATENCAO — 'send_whatsapp_template': action_params: [{name, id, language, category, processed_params}]. 'name' e OBRIGATORIO e e o nome EXATO do modelo aprovado na Meta (o envio acontece por ele); 'language' precisa bater com o idioma aprovado (padrao pt_BR); processed_params: {\"body\": {\"1\": \"{{contact.first_name}}\"}}. NUNCA use template_name/template_id/template_category/template_language — esse e o formato dos nos do FlowBuilder e aqui e IGNORADO: a regra salva com sucesso, aparece na tela e NAO ENVIA NADA, sem erro nem log (incidente real conta 39 em 02/08/2026: 14h sem enviar, 9 leads perdidos). Confira o modelo antes com lionchat_inboxes_whatsapp_templates_list. So funciona em caixa WhatsApp API Oficial (Cloud). REGRA GERAL: action_params e SEMPRE um array (o backend le params[0]) e seu CONTEUDO nao e validado pela API. Se nao souber o formato de uma acao, leia uma regra existente com lionchat_automation_rules_show e copie — nunca invente nome de chave. Formato de TODAS as acoes no resource 'conversation-flows'. MAIS USADOS (action_params e SEMPRE lista): send_message [\"texto\"]; add_private_note [\"texto\"]; add_label/remove_label [\"nome-da-etiqueta\"]; assign_agent [70] ([\"nil\"] desatribui); assign_team [3]; change_status [\"resolved\"|\"open\"|\"pending\"|\"snoozed\"]; change_priority [\"high\"]; send_canned_response [12]; update_conversation_attribute [{\"attribute_key\": \"chave\", \"value\": \"texto\"}]; create_kanban_item [{\"funnel_id\": 31, \"funnel_stage\": \"prospeccao\"}]; move_kanban_item_to_stage [{\"funnel_id\": 31, \"funnel_stage\": \"qualificacao\"}]. Tabela completa no resource conversation-flows ('Acoes de automacao')."
+    "description": "CADA item de actions DEVE ser um OBJETO {action_name (string), action_params (array)} — NUNCA um texto/string solto. Ex.: [{\"action_name\":\"send_message\",\"action_params\":[\"Oi\"]}]. Acoes Actions novas (2026-07-21): 'update_contact_attribute' e 'update_conversation_attribute' — action_params: [{attribute_key, value}], value aceita texto fixo OU variável Liquid (ex. {{contact.phone_number}}); grava atributo personalizado com MERGE (não apaga os demais) e passa pelo porteiro de data. 'pending_conversation' (2026-07-20, sem params) — deixa a conversa PENDENTE (handoff; mensagem nova do cliente NÃO reabre). ATENCAO — 'send_whatsapp_template': action_params: [{name, id, language, category, processed_params}]. 'name' e OBRIGATORIO e e o nome EXATO do modelo aprovado na Meta (o envio acontece por ele); 'language' precisa bater com o idioma aprovado (padrao pt_BR); processed_params: {\"body\": {\"1\": \"{{contact.first_name}}\"}}. NUNCA use template_name/template_id/template_category/template_language — esse e o formato dos nos do FlowBuilder e aqui e IGNORADO: a regra salva com sucesso, aparece na tela e NAO ENVIA NADA, sem erro nem log (incidente real conta 39 em 02/08/2026: 14h sem enviar, 9 leads perdidos). Confira o modelo antes com lionchat_inboxes_whatsapp_templates_list. So funciona em caixa WhatsApp API Oficial (Cloud). REGRA GERAL: action_params e SEMPRE um array (o backend le params[0]) e seu CONTEUDO nao e validado pela API. Se nao souber o formato de uma acao, leia uma regra existente com lionchat_automation_rules_show e copie — nunca invente nome de chave. Formato de TODAS as acoes no resource 'conversation-flows'. MAIS USADOS (action_params e SEMPRE lista): send_message [\"texto\"]; add_private_note [\"texto\"]; add_label/remove_label [\"nome-da-etiqueta\"]; assign_agent [70] ([\"nil\"] desatribui); assign_team [3]; change_status [\"resolved\"|\"open\"|\"pending\"|\"snoozed\"]; change_priority [\"high\"]; send_canned_response [12]; update_conversation_attribute [{\"attribute_key\": \"chave\", \"value\": \"texto\"}]; create_kanban_item [{\"funnel_id\": 31, \"funnel_stage\": \"prospeccao\"}]; move_kanban_item_to_stage [{\"funnel_id\": 31, \"funnel_stage\": \"qualificacao\"}]. Tabela completa no resource conversation-flows ('Acoes de automacao'). ESPERA QUE CONFERE (26/09/2026): 'wait' aceita o formato OBJETO [{\"seconds\": 120, \"only_if_open\": true, \"only_if_no_reply\": true}] — na VOLTA, only_if_open só segue se a conversa ainda estiver aberta/pendente e only_if_no_reply só segue se ninguém respondeu o cliente durante a espera (qualquer mensagem pública de saída conta). Barrou = o resto da regra não roda e o histórico da execução mostra o passo wait_check 'skipped'. O formato antigo [120] continua valendo, sem conferência. Teto 300 s."
    }
   ],
   "returns": "regra de automação atualizado",
@@ -11668,7 +11838,7 @@
   "method": "GET",
   "path": "/api/v1/accounts/{account_id}/companies",
   "title": "Listar Empresas",
-  "description": "Lista as empresas da conta. meta usa total_count/page.",
+  "description": "Lista as empresas da conta. meta usa total_count/page. Cada empresa traz last_activity_at (ultima atividade dos contatos dela; null = nunca). Excluir empresa (lionchat_companies_destroy) e so para administrador e NAO apaga os contatos.",
   "category": "Empresas",
   "params": [
    {
@@ -11683,7 +11853,7 @@
     "type": "string",
     "location": "query",
     "required": false,
-    "description": "Ordenação: name, domain, created_at, contacts_count"
+    "description": "Ordenacao: name, domain, created_at, contacts_count, last_activity_at (prefixo - = decrescente, ex. -last_activity_at)"
    }
   ],
   "returns": "meta (contadores globais) + payload (array de empresas)",
@@ -11699,7 +11869,7 @@
   "method": "POST",
   "path": "/api/v1/accounts/{account_id}/companies",
   "title": "Criar Empresa",
-  "description": "Cria uma empresa. Body exige wrapper company. Aceita name, domain, description, avatar. NAO aceita custom_attributes. ENTERPRISE-only.",
+  "description": "Cria uma empresa. Body exige wrapper company. Aceita name, domain, description, avatar e additional_attributes (cadastro). NAO aceita custom_attributes. ENTERPRISE-only. Empresa so nasce assim (manual): o sistema nao cria empresa pelo dominio do e-mail dos contatos. Cadastro da empresa em additional_attributes: { legal_name (razao social), cnpj (validado; grava so digitos), phone, email, address: {cep, street, number, complement, neighborhood, city, state, country}, social_profiles: {linkedin, facebook, instagram, telegram, tiktok, twitter, github} }. A gravacao MESCLA: mande so o que muda; valor vazio (\"\") apaga aquela chave; chave ausente nao mexe. CNPJ ou e-mail invalido = 422. additional_attributes, address e social_profiles precisam ser OBJETOS (texto ou lista = 422, nada e apagado).",
   "category": "Empresas",
   "params": [
    {
@@ -11707,7 +11877,7 @@
     "type": "object",
     "location": "body",
     "required": true,
-    "description": "Wrapper com { name, domain, description, avatar }"
+    "description": "Wrapper com { name, domain, description, avatar, additional_attributes: { legal_name, cnpj, phone, email, address: {...}, social_profiles: {...} } }"
    }
   ],
   "returns": "empresa criado (com novo ID)",
@@ -11741,14 +11911,18 @@
    "Verificar estado atual antes de uma ação",
    "Mostrar perfil ou ficha de empresa"
   ],
-  "related_tools": []
+  "related_tools": [
+   "lionchat_companies_contacts_list",
+   "lionchat_companies_conversations_list",
+   "lionchat_companies_notes_list"
+  ]
  },
  {
   "id": "lionchat_companies_update",
   "method": "PATCH",
   "path": "/api/v1/accounts/{account_id}/companies/{id}",
   "title": "Atualizar Empresa",
-  "description": "Atualiza dados da empresa. Atualiza campos do empresa existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados. Campos suportados: name, domain.",
+  "description": "Atualiza dados da empresa. Suporta atualizacao parcial (PATCH) — so campos enviados sao alterados. Campos suportados: name, domain, description, avatar e additional_attributes (cadastro). Cadastro da empresa em additional_attributes: { legal_name (razao social), cnpj (validado; grava so digitos), phone, email, address: {cep, street, number, complement, neighborhood, city, state, country}, social_profiles: {linkedin, facebook, instagram, telegram, tiktok, twitter, github} }. A gravacao MESCLA: mande so o que muda; valor vazio (\"\") apaga aquela chave; chave ausente nao mexe. CNPJ ou e-mail invalido = 422. additional_attributes, address e social_profiles precisam ser OBJETOS (texto ou lista = 422, nada e apagado).",
   "category": "Empresas",
   "params": [
    {
@@ -11763,7 +11937,7 @@
     "type": "object",
     "location": "body",
     "required": true,
-    "description": "Wrapper com { name, domain, description, avatar }"
+    "description": "Wrapper com { name, domain, description, avatar, additional_attributes: { legal_name, cnpj, phone, email, address: {...}, social_profiles: {...} } }"
    }
   ],
   "returns": "empresa atualizado",
@@ -11851,6 +12025,183 @@
   ],
   "related_tools": []
  },
+ {
+  "id": "lionchat_companies_contacts_list",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/contacts",
+  "title": "Contatos da Empresa",
+  "description": "Lista os contatos ligados a UMA empresa, 25 por pagina, ordenados por nome. meta usa count/current_page. Cada contato traz company_id e additional_attributes (company_name = texto 'Empresa', job_title = cargo).",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   },
+   {
+    "name": "page",
+    "type": "integer",
+    "location": "query",
+    "required": false,
+    "description": "Pagina (padrao: 1)"
+   }
+  ],
+  "returns": "meta {count, current_page} + payload (array de contatos)",
+  "common_use_cases": [
+   "Ver quem trabalha numa empresa",
+   "Conferir cargo das pessoas de um cliente"
+  ],
+  "related_tools": [
+   "lionchat_companies_show",
+   "lionchat_companies_contacts_create",
+   "lionchat_companies_contacts_destroy"
+  ]
+ },
+ {
+  "id": "lionchat_companies_contacts_create",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/contacts",
+  "title": "Colocar Contato na Empresa",
+  "description": "Liga um contato da conta a esta empresa (se ele estava em outra, MOVE). O texto additional_attributes.company_name do contato passa a ser o nome da empresa. Para achar o contato use lionchat_contacts_search. Contato de outra conta = 404. TETO: 100 contatos por empresa (25/09) — o 101o e recusado com 422 'Esta empresa ja tem 100 contatos, o maximo permitido...'; tire alguem (lionchat_companies_contacts_destroy) antes de colocar outro. Empresa e vinculo sao SEMPRE manuais: o sistema NAO cria empresa nem vincula contato pelo dominio do e-mail.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   },
+   {
+    "name": "contact_id",
+    "type": "integer",
+    "location": "body",
+    "required": true,
+    "description": "ID do contato a colocar na empresa"
+   }
+  ],
+  "returns": "payload (contato atualizado)",
+  "common_use_cases": [
+   "Organizar contatos por cliente",
+   "Corrigir a empresa de um contato"
+  ],
+  "related_tools": [
+   "lionchat_contacts_search",
+   "lionchat_companies_contacts_list",
+   "lionchat_contacts_update"
+  ]
+ },
+ {
+  "id": "lionchat_companies_contacts_destroy",
+  "method": "DELETE",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/contacts/{contact_id}",
+  "title": "Tirar Contato da Empresa",
+  "description": "Tira o contato da empresa (o contato NAO e excluido). O texto company_name so e apagado se ainda era exatamente o nome da empresa.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   },
+   {
+    "name": "contact_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID do contato"
+   }
+  ],
+  "returns": "200 OK",
+  "common_use_cases": [
+   "Pessoa saiu da empresa",
+   "Contato ligado errado pelo dominio do e-mail"
+  ],
+  "related_tools": [
+   "lionchat_companies_contacts_list"
+  ]
+ },
+ {
+  "id": "lionchat_companies_notes_list",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/notes",
+  "title": "Anotacoes da Empresa",
+  "description": "Anotacoes da empresa, mais nova primeiro: as da PROPRIA empresa (kind 'company', criadas com lionchat_companies_notes_create) + as ultimas 50 feitas nos contatos dela (kind 'contact', com contact {id, name, thumbnail}). Cada item traz id, kind, content, user, created_at.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   }
+  ],
+  "returns": "payload (array de anotacoes; kind = company ou contact)",
+  "common_use_cases": [
+   "Resumo do relacionamento com um cliente",
+   "Preparar reuniao com a empresa"
+  ],
+  "related_tools": [
+   "lionchat_companies_notes_create",
+   "lionchat_contacts_notes_show",
+   "lionchat_companies_conversations_list"
+  ]
+ },
+ {
+  "id": "lionchat_companies_conversations_list",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/conversations",
+  "title": "Conversas da Empresa",
+  "description": "Ultimas 20 conversas dos contatos da empresa, da mais recente para a mais antiga, filtradas pelo que o usuario do token pode ver (mesma regra da lista de conversas).",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   }
+  ],
+  "returns": "payload (array de conversas)",
+  "common_use_cases": [
+   "Historico de atendimento de um cliente",
+   "Ver se alguem da empresa falou recentemente"
+  ],
+  "related_tools": [
+   "lionchat_companies_notes_list",
+   "lionchat_conversations_show"
+  ]
+ },
+ {
+  "id": "lionchat_companies_avatar_destroy",
+  "method": "DELETE",
+  "path": "/api/v1/accounts/{account_id}/companies/{id}/avatar",
+  "title": "Tirar Foto da Empresa",
+  "description": "Remove a foto da empresa. Para trocar a foto, envie avatar (arquivo) no lionchat_companies_update.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   }
+  ],
+  "returns": "payload (empresa)",
+  "common_use_cases": [
+   "Foto errada puxada do site da empresa"
+  ],
+  "related_tools": [
+   "lionchat_companies_update"
+  ]
+ },
  {
   "id": "lionchat_offers_list",
   "method": "GET",
@@ -15118,10 +15469,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    }
   ],
   "returns": "grupo WhatsApp (objeto completo com associações)",
@@ -15153,10 +15504,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "subject",
@@ -15195,10 +15546,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "description",
@@ -15237,10 +15588,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    }
   ],
   "returns": "array de participantes do grupo (id, admin, etc.)",
@@ -15272,10 +15623,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "participants",
@@ -15314,10 +15665,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "participants",
@@ -15356,10 +15707,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "participants",
@@ -15398,10 +15749,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "participants",
@@ -15440,10 +15791,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    }
   ],
   "returns": "link de convite do grupo (ex: { code, url })",
@@ -15463,7 +15814,7 @@
   "method": "POST",
   "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/waha_groups/{group_id}/invite_code/revoke",
   "title": "Revogar Link de Convite",
-  "description": "Revoga o link de convite atual do grupo WAHA e gera um novo. O numero conectado precisa ser admin do grupo (403 senao).",
+  "description": "Revoga o link de convite atual do grupo WAHA e gera um novo. O link antigo PARA DE FUNCIONAR, inclusive o que ja foi enviado por fluxos e campanhas — confirme com a pessoa antes. O numero conectado precisa ser admin do grupo (403 senao).",
   "category": "Grupos WhatsApp",
   "params": [
    {
@@ -15475,10 +15826,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    }
   ],
   "returns": "{ success: true } ou { data: ... }",
@@ -15498,7 +15849,7 @@
   "method": "PUT",
   "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/waha_groups/{group_id}/settings",
   "title": "Atualizar Config do Grupo",
-  "description": "Atualiza as permissoes do grupo WAHA.",
+  "description": "Atualiza as permissoes do grupo WAHA. Aplica chave por chave: se uma falhar, responde 422 com `applied` (o que ja foi gravado) e `failed` (a chave que falhou). O numero conectado precisa ser admin do grupo (403 senao). `approval_required` so existe em servidores do WhatsApp mais novos: onde nao existe, 422 dizendo que o servidor ainda nao tem a opcao (confira antes com lionchat_inboxes_waha_groups_list_4, campo approval_supported).",
   "category": "Grupos WhatsApp",
   "params": [
    {
@@ -15510,10 +15861,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "info_admin_only",
@@ -15528,9 +15879,23 @@
     "location": "body",
     "required": false,
     "description": "Se true, somente admins podem enviar mensagens"
+   },
+   {
+    "name": "members_add_admin_only",
+    "type": "boolean",
+    "location": "body",
+    "required": false,
+    "description": "Se true, somente admins podem adicionar participantes (o servidor traduz para o sentido invertido do WhatsApp). So true ou false; qualquer outro valor e recusado com 422."
+   },
+   {
+    "name": "approval_required",
+    "type": "boolean",
+    "location": "body",
+    "required": false,
+    "description": "Se true, quem pede para entrar pelo link espera um admin aprovar. So true ou false. ATENCAO ao desligar: com pedidos esperando, o WhatsApp pode aprovar todos de uma vez — liste os pedidos antes (lionchat_inboxes_waha_groups_list_5) e confirme com a pessoa."
    }
   ],
-  "returns": "{ success: true } ou { data: ... }",
+  "returns": "{ success: true, applied: [...] } ou 422 { error, applied: [...], failed: \"chave\" }",
   "common_use_cases": [
    "Edição parcial de grupo WhatsApp",
    "Alteração de status/estado",
@@ -15559,10 +15924,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    },
    {
     "name": "file",
@@ -15601,10 +15966,10 @@
    },
    {
     "name": "group_id",
-    "type": "integer",
+    "type": "string",
     "location": "path",
     "required": true,
-    "description": "ID do grupo"
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
    }
   ],
   "returns": "{ success: true } ou { data: ... }",
@@ -15688,6 +16053,183 @@
    "lionchat_inboxes_waha_groups_show"
   ]
  },
+ {
+  "id": "lionchat_inboxes_waha_groups_list_4",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/waha_groups/{group_id}/security_settings",
+  "title": "Ler Permissoes Extras do Grupo",
+  "description": "SO LEITURA. Le \"apenas admins podem adicionar participantes\" (members_add_admin_only) e \"aprovar novos participantes\" (approval_required), ja no sentido da tela (true = so admins / precisa aprovar). null = o WhatsApp nao respondeu agora: NAO trate como false. approval_supported=false = o servidor do WhatsApp desta caixa ainda nao tem a opcao de aprovacao.",
+  "category": "Grupos WhatsApp",
+  "params": [
+   {
+    "name": "inbox_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da inbox (precisa ser WhatsApp QR Code)"
+   },
+   {
+    "name": "group_id",
+    "type": "string",
+    "location": "path",
+    "required": true,
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
+   }
+  ],
+  "returns": "{ data: { members_add_admin_only: true|false|null, approval_required: true|false|null, approval_supported: true|false|null } }",
+  "common_use_cases": [
+   "Conferir as permissoes do grupo antes de mudar",
+   "Saber se o grupo exige aprovacao para entrar"
+  ],
+  "related_tools": [
+   "lionchat_inboxes_waha_groups_update_2",
+   "lionchat_inboxes_waha_groups_show"
+  ]
+ },
+ {
+  "id": "lionchat_inboxes_waha_groups_destroy",
+  "method": "DELETE",
+  "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/waha_groups/{group_id}/picture",
+  "title": "Remover Foto do Grupo",
+  "description": "Remove a foto do grupo no WhatsApp e tambem a copia que o LionChat mostra na lista de conversas. O numero conectado precisa ser admin do grupo (403 senao).",
+  "category": "Grupos WhatsApp",
+  "params": [
+   {
+    "name": "inbox_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da inbox (precisa ser WhatsApp QR Code)"
+   },
+   {
+    "name": "group_id",
+    "type": "string",
+    "location": "path",
+    "required": true,
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
+   }
+  ],
+  "returns": "{ success: true }",
+  "common_use_cases": [
+   "Tirar a foto do grupo"
+  ],
+  "related_tools": [
+   "lionchat_inboxes_waha_groups_update_3",
+   "lionchat_inboxes_waha_groups_show"
+  ]
+ },
+ {
+  "id": "lionchat_inboxes_waha_groups_list_5",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/waha_groups/{group_id}/join_requests",
+  "title": "Listar Pedidos para Entrar no Grupo",
+  "description": "SO LEITURA. Pedidos de quem quer entrar no grupo e espera aprovacao. Use o campo `id` de cada pedido para aprovar/recusar. `pn` e o telefone (pode vir null: o WhatsApp esconde o numero — NUNCA use os digitos do id como telefone). `name` so vem se a pessoa ja e contato. supported=false = o servidor do WhatsApp desta caixa ainda nao tem pedidos para entrar; allowed=false = o WhatsApp nao deixou (o numero da caixa nao e admin do grupo).",
+  "category": "Grupos WhatsApp",
+  "params": [
+   {
+    "name": "inbox_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da inbox (precisa ser WhatsApp QR Code)"
+   },
+   {
+    "name": "group_id",
+    "type": "string",
+    "location": "path",
+    "required": true,
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
+   }
+  ],
+  "returns": "{ data: { supported, allowed, requests: [{ id, requesterId, pn, name, request_method (invite_link|linked_group_join|non_admin_add|unknown), timestamp }] } }",
+  "common_use_cases": [
+   "Ver quem pediu para entrar no grupo",
+   "Aprovar pedidos pendentes em lote"
+  ],
+  "related_tools": [
+   "lionchat_inboxes_waha_groups_create_7",
+   "lionchat_inboxes_waha_groups_create_8",
+   "lionchat_inboxes_waha_groups_list_4"
+  ]
+ },
+ {
+  "id": "lionchat_inboxes_waha_groups_create_7",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/waha_groups/{group_id}/join_requests/approve",
+  "title": "Aprovar Pedidos para Entrar no Grupo",
+  "description": "Aprovar pedidos para entrar no grupo. A pessoa entra no grupo e isso aciona a pilula \"entrou\" e os fluxos com gatilho \"Entrou no grupo\". Tentativa unica (nao repita sozinho). A resposta traz o resultado por pessoa e as listas RELIDAS no WhatsApp (pedidos e participantes). Se o WhatsApp recusar (ex.: pedido ja tratado pelo celular), 422 com a mensagem e as listas reais. O numero conectado precisa ser admin do grupo (403 senao); ids fora do formato = 422.",
+  "category": "Grupos WhatsApp",
+  "params": [
+   {
+    "name": "inbox_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da inbox (precisa ser WhatsApp QR Code)"
+   },
+   {
+    "name": "group_id",
+    "type": "string",
+    "location": "path",
+    "required": true,
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
+   },
+   {
+    "name": "participants",
+    "type": "array",
+    "location": "body",
+    "required": true,
+    "description": "Lista de pedidos no formato [{ id: '...' }], com o `id` que veio em lionchat_inboxes_waha_groups_list_5"
+   }
+  ],
+  "returns": "{ data: { results: [{ id, success, error }], join_requests: [...]|null, participants: [...]|null } } ou 422 { error, data: { join_requests, participants } }",
+  "common_use_cases": [
+   "Aprovar quem pediu para entrar no grupo"
+  ],
+  "related_tools": [
+   "lionchat_inboxes_waha_groups_list_5",
+   "lionchat_inboxes_waha_groups_list_1"
+  ]
+ },
+ {
+  "id": "lionchat_inboxes_waha_groups_create_8",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/waha_groups/{group_id}/join_requests/reject",
+  "title": "Recusar Pedidos para Entrar no Grupo",
+  "description": "Recusar pedidos para entrar no grupo. A pessoa nao entra e nada e disparado. Tentativa unica (nao repita sozinho). A resposta traz o resultado por pessoa e as listas RELIDAS no WhatsApp (pedidos e participantes). Se o WhatsApp recusar (ex.: pedido ja tratado pelo celular), 422 com a mensagem e as listas reais. O numero conectado precisa ser admin do grupo (403 senao); ids fora do formato = 422.",
+  "category": "Grupos WhatsApp",
+  "params": [
+   {
+    "name": "inbox_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da inbox (precisa ser WhatsApp QR Code)"
+   },
+   {
+    "name": "group_id",
+    "type": "string",
+    "location": "path",
+    "required": true,
+    "description": "ID do grupo no WhatsApp, com o sufixo (ex.: '120363389719781395@g.us')"
+   },
+   {
+    "name": "participants",
+    "type": "array",
+    "location": "body",
+    "required": true,
+    "description": "Lista de pedidos no formato [{ id: '...' }], com o `id` que veio em lionchat_inboxes_waha_groups_list_5"
+   }
+  ],
+  "returns": "{ data: { results: [{ id, success, error }], join_requests: [...]|null, participants: [...]|null } } ou 422 { error, data: { join_requests, participants } }",
+  "common_use_cases": [
+   "Recusar quem pediu para entrar no grupo"
+  ],
+  "related_tools": [
+   "lionchat_inboxes_waha_groups_list_5",
+   "lionchat_inboxes_waha_groups_list_1"
+  ]
+ },
  {
   "id": "lionchat_inboxes_whatsapp_templates_list",
   "method": "GET",
@@ -25667,7 +26209,7 @@
   "method": "GET",
   "path": "/api/v1/accounts/{account_id}/eclinica_integrations",
   "title": "Listar Integração e-Clínica",
-  "description": "Lista a integração e-Clínica da conta (no máximo 1 por conta) com id, status e configurações. Use PRIMEIRO para descobrir o {id} exigido pelas ferramentas de histórico de lembretes. Eventos mapeáveis incluem (23/07) os novos cliente_inclusao_pagamento ('Inclusão de cobrança' — cobrança/carnê criado, ainda não pago; grava eclinica_ultima_cobranca_valor/vencimento/descricao no contato) e controle_laboratorio_novo ('Controle de laboratório' — grava eclinica_laboratorio_data_prevista/data_moldagem/data_entrega/situacao). O mapeamento evento→flow É EDITÁVEL via MCP desde 31/08/2026 — use lionchat_eclinica_integrations_update (ele SUBSTITUI o mapeamento inteiro: leia aqui primeiro e devolva completo). [2026-07-25] Cada linha de reminder_config traz agora event_type ('agendamento' padrao, 'controle_laboratorio_novo' para lembrete de laboratorio/medicacao, 'cliente_inclusao_pagamento' para lembrete de vencimento de cobranca), dispatch_time (hora do disparo, OBRIGATORIA: 'HH:MM' fixo ou formula Liquid com variavel de conta/contato) e o filtro opcional filter_field/filter_operator/filter_value. Os lembretes SAO editaveis via MCP desde 31/08/2026 — use lionchat_eclinica_integrations_update (ele SUBSTITUI a lista inteira: leia aqui primeiro e devolva completa). Cada unidade em units[] traz tambem settings {} (18/08). O atributo eclinica_cor (cor da agenda, hex com #) virou campo fresco dos lembretes: filtravel por filter_field e disponivel como variavel {{cor}}. LEMBRETE POR AUTOMACAO (25/08): cada entrada de reminder_config aceita `automation_id` alem do `flow_id` — pelo menos um dos dois (422 sem nenhum); com os DOIS preenchidos a AUTOMACAO vence no disparo. A automacao precisa ser da propria conta (422 senao). ALERTA de regra de negocio ao configurar: o caminho por automacao RODA AS ACOES SEM AVALIAR AS CONDICOES da automacao. Desde 17/09/2026 os DOIS caminhos (fluxo e automacao) mandam um aviso POR CONSULTA: paciente com duas consultas no dia (ou dois pacientes no mesmo celular) recebe um aviso para cada uma, ~10 min um do outro (fila por contato). Quem quer so um por dia monta no FLUXO (condicao num atributo com {{data_consulta}}); na automacao nao da, porque as condicoes dela nao sao avaliadas — avise o cliente antes de trocar fluxo por automacao.",
+  "description": "Lista a integração e-Clínica da conta (no máximo 1 por conta) com id, status e configurações. Use PRIMEIRO para descobrir o {id} exigido pelas ferramentas de histórico de lembretes. Eventos mapeáveis incluem (23/07) os novos cliente_inclusao_pagamento ('Inclusão de cobrança' — cobrança/carnê criado, ainda não pago; grava eclinica_ultima_cobranca_valor/vencimento/descricao no contato) e controle_laboratorio_novo ('Controle de laboratório' — grava eclinica_laboratorio_data_prevista/data_moldagem/data_entrega/situacao). O mapeamento evento→flow É EDITÁVEL via MCP desde 31/08/2026 — use lionchat_eclinica_integrations_update (ele SUBSTITUI o mapeamento inteiro: leia aqui primeiro e devolva completo). [2026-07-25] Cada linha de reminder_config traz agora event_type ('agendamento' padrao, 'controle_laboratorio_novo' para lembrete de laboratorio/medicacao, 'cliente_inclusao_pagamento' para lembrete de vencimento de cobranca), dispatch_time (hora do disparo, OBRIGATORIA: 'HH:MM' fixo ou formula Liquid com variavel de conta/contato) e o filtro opcional filter_field/filter_operator/filter_value. Os lembretes SAO editaveis via MCP desde 31/08/2026 — use lionchat_eclinica_integrations_update (ele SUBSTITUI a lista inteira: leia aqui primeiro e devolva completa). Cada unidade em units[] traz tambem settings {} (18/08). O atributo eclinica_cor (cor da agenda, hex com #) virou campo fresco dos lembretes: filtravel por filter_field e disponivel como variavel {{cor}}. LEMBRETE POR AUTOMACAO (25/08): cada entrada de reminder_config aceita `automation_id` alem do `flow_id` — pelo menos um dos dois (422 sem nenhum); com os DOIS preenchidos a AUTOMACAO vence no disparo. A automacao precisa ser da propria conta (422 senao). ALERTA de regra de negocio ao configurar: o caminho por automacao RODA AS ACOES SEM AVALIAR AS CONDICOES da automacao. Desde 17/09/2026 os DOIS caminhos (fluxo e automacao) mandam um aviso POR CONSULTA: paciente com duas consultas no dia (ou dois pacientes no mesmo celular) recebe um aviso para cada uma, ~10 min um do outro (fila por contato). Quem quer so um por dia monta no FLUXO (condicao num atributo com {{data_consulta}}); na automacao nao da, porque as condicoes dela nao sao avaliadas — avise o cliente antes de trocar fluxo por automacao. VARIAVEIS DA MENSAGEM (28/09/2026): na automacao alvo de lembrete use {{eclinica_lembrete.<campo>}} (data_consulta, hora_consulta, profissional, compromisso, paciente_nome, unidade, link_confirmacao, idagenda, cliente_id, agendatipo, cor; laboratorio: data_prevista/data_entrega/data_referencia; cobranca: vencimento/valor/descricao) — e a consulta DAQUELE lembrete, data em DD/MM/AAAA. NUNCA a ficha {{contact.custom_attribute.eclinica_*}}: guarda so a consulta do ULTIMO aviso e manda a data de outra consulta. O nome antigo {{agendamento.*}} ainda funciona. No FLUXO nada muda ({{data_consulta}} etc). Detalhe no resource data-model, secao e-Clinica.",
   "category": "Integracoes",
   "params": [],
   "returns": "200 {payload: {eclinica_integrations: [...]}}",
@@ -25845,7 +26387,7 @@
   "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.",
+  "description": "Central de arquivos do contato: uploads diretos + espelho dos anexos dos cards Kanban + das conversas (só imagem/documento). Dedup por arquivo. (25/09) O mesmo arquivo em varias origens vem UMA vez (representado pelo upload da ficha, se houver); cada item traz contacts [{id,name}]. Contrato assinado so aparece para quem pode ver contratos; arquivo de compromisso particular de outra pessoa nao aparece. mirror aceita tambem anexo de compromisso e de contrato.",
   "category": "Documentos do Contato",
   "params": [
    {
@@ -26495,6 +27037,13 @@
     "required": false,
     "description": "true/false (padrao false). SO no bloco `eclinica_no_show`: a % de falta passa a ser faltaram/agendados em vez de faltaram/(compareceram+faltaram). Ligado, a unidade que nao anota desfecho parece a melhor da rede — o rotulo da coluna declara a base. Aceita as strings 'true'/'false' (novo 10/09/2026)."
    },
+   {
+    "name": "only_first_visit",
+    "type": "boolean",
+    "location": "body",
+    "required": false,
+    "description": "true/false (padrao false). SO no bloco `eclinica_no_show`: a tabela conta so a consulta INICIAL — retorno, sessao de tratamento e procedimento ficam de fora — e o rotulo da primeira coluna troca de 'Agendados' para 'Consultas iniciais'. A regra le o TEXTO do compromisso, porque a clinica escreve o tipo por extenso: comeca com CONSULTA e NAO contem RETORNO. Medido na conta 56 (01 a 24/09/2026): 'CONSULTA INICIAL' 1.445 vezes e 'CONSULTA DE RETORNO' 192, e Sorocaba tem 1.023 compromissos para 99 consultas iniciais. Use quando o pedido falar em primeira consulta, consulta inicial, paciente novo ou primeiro atendimento. Novo em 28/09/2026."
+   },
    {
     "name": "count_retorno_as_consulta",
     "type": "boolean",
@@ -26543,7 +27092,7 @@
     "type": "array",
     "location": "body",
     "required": false,
-    "description": "Lista de blocos. Cada item: {id, widget_type, chart_type, ...} com os mesmos campos do custom_dashboards_preview_widget. Maximo 12. DOIS campos de bloco que faltavam aqui: `follow_report_period` (true/false, tambem aceita as strings; AUSENTE = true) diz se o bloco obedece o calendario do TOPO do relatorio ou usa o periodo proprio — vale pra qualquer bloco, novo em 22/08/2026; e `direction_split` (true/false, padrao false) que SO faz efeito no bloco `calls_report` e troca as colunas fixas por Feitas x Recebidas, com quem atendeu na recebida — OPT-IN de proposito pra nao mexer no relatorio de quem ja usa o bloco, novo em 28/08/2026. Desde 10/09/2026, dois campos SO dos blocos da e-Clinica: `no_show_over_scheduled` (true/false, padrao false — a % de falta passa a ser faltaram/agendados em vez de sobre os desfechos conhecidos; so faz efeito em `eclinica_no_show`) e `count_retorno_as_consulta` (true/false, padrao true — retorno conta como consulta na base da conversao; desligado, o retorno vai para 'Nao classificado'; so faz efeito em `eclinica_conversion`). Aceitam as strings 'true'/'false'; qualquer outro valor = 422 com o motivo."
+    "description": "Lista de blocos. Cada item: {id, widget_type, chart_type, ...} com os mesmos campos do custom_dashboards_preview_widget. Maximo 12. DOIS campos de bloco que faltavam aqui: `follow_report_period` (true/false, tambem aceita as strings; AUSENTE = true) diz se o bloco obedece o calendario do TOPO do relatorio ou usa o periodo proprio — vale pra qualquer bloco, novo em 22/08/2026; e `direction_split` (true/false, padrao false) que SO faz efeito no bloco `calls_report` e troca as colunas fixas por Feitas x Recebidas, com quem atendeu na recebida — OPT-IN de proposito pra nao mexer no relatorio de quem ja usa o bloco, novo em 28/08/2026. Desde 10/09/2026, campos SO dos blocos da e-Clinica: `no_show_over_scheduled` (true/false, padrao false — a % de falta passa a ser faltaram/agendados em vez de sobre os desfechos conhecidos; so faz efeito em `eclinica_no_show`) e `count_retorno_as_consulta` (true/false, padrao true — retorno conta como consulta na base da conversao; desligado, o retorno vai para 'Nao classificado'; so faz efeito em `eclinica_conversion`). E desde 28/09/2026, `only_first_visit` (true/false, padrao false — SO em `eclinica_no_show`: conta so a consulta INICIAL, deixando de fora retorno, sessao de tratamento e procedimento, e o cabecalho da primeira coluna vira 'Consultas iniciais'). Aceitam as strings 'true'/'false'; qualquer outro valor = 422 com o motivo."
    }
   ],
   "returns": "{ id, name, position, widgets, created_at }",
@@ -26592,7 +27141,7 @@
     "type": "array",
     "location": "body",
     "required": false,
-    "description": "Lista COMPLETA de blocos — substitui a atual. Preserve o `id` de cada bloco que ja existia, senao a tela perde o vinculo. Maximo 12. DOIS campos de bloco que faltavam aqui: `follow_report_period` (true/false, tambem aceita as strings; AUSENTE = true) diz se o bloco obedece o calendario do TOPO do relatorio ou usa o periodo proprio — vale pra qualquer bloco, novo em 22/08/2026; e `direction_split` (true/false, padrao false) que SO faz efeito no bloco `calls_report` e troca as colunas fixas por Feitas x Recebidas, com quem atendeu na recebida — OPT-IN de proposito pra nao mexer no relatorio de quem ja usa o bloco, novo em 28/08/2026. Desde 10/09/2026, dois campos SO dos blocos da e-Clinica: `no_show_over_scheduled` (true/false, padrao false — a % de falta passa a ser faltaram/agendados em vez de sobre os desfechos conhecidos; so faz efeito em `eclinica_no_show`) e `count_retorno_as_consulta` (true/false, padrao true — retorno conta como consulta na base da conversao; desligado, o retorno vai para 'Nao classificado'; so faz efeito em `eclinica_conversion`). Aceitam as strings 'true'/'false'; qualquer outro valor = 422 com o motivo."
+    "description": "Lista COMPLETA de blocos — substitui a atual. Preserve o `id` de cada bloco que ja existia, senao a tela perde o vinculo. Maximo 12. DOIS campos de bloco que faltavam aqui: `follow_report_period` (true/false, tambem aceita as strings; AUSENTE = true) diz se o bloco obedece o calendario do TOPO do relatorio ou usa o periodo proprio — vale pra qualquer bloco, novo em 22/08/2026; e `direction_split` (true/false, padrao false) que SO faz efeito no bloco `calls_report` e troca as colunas fixas por Feitas x Recebidas, com quem atendeu na recebida — OPT-IN de proposito pra nao mexer no relatorio de quem ja usa o bloco, novo em 28/08/2026. Desde 10/09/2026, campos SO dos blocos da e-Clinica: `no_show_over_scheduled` (true/false, padrao false — a % de falta passa a ser faltaram/agendados em vez de sobre os desfechos conhecidos; so faz efeito em `eclinica_no_show`) e `count_retorno_as_consulta` (true/false, padrao true — retorno conta como consulta na base da conversao; desligado, o retorno vai para 'Nao classificado'; so faz efeito em `eclinica_conversion`). E desde 28/09/2026, `only_first_visit` (true/false, padrao false — SO em `eclinica_no_show`: conta so a consulta INICIAL, deixando de fora retorno, sessao de tratamento e procedimento, e o cabecalho da primeira coluna vira 'Consultas iniciais'). Aceitam as strings 'true'/'false'; qualquer outro valor = 422 com o motivo."
    }
   ],
   "returns": "{ id, name, position, widgets, created_at }",
@@ -27861,7 +28410,7 @@
   "method": "GET",
   "path": "/api/v1/accounts/{account_id}/audit_logs",
   "title": "Registro de Auditoria",
-  "description": "Histórico de quem mexeu no quê dentro da conta (criação, edição, exclusão, login e logout), com o autor, o IP e o antes/depois de cada campo. ATENÇÃO ao formato das datas: aqui 'since' e 'until' são DATA POR EXTENSO (AAAA-MM-DD) e NÃO timestamp Unix — é o oposto dos relatórios; mandar um número Unix derruba a chamada com erro. Somente administradores; a conta precisa ter o recurso de auditoria habilitado, senão a lista volta VAZIA sem nenhum aviso de erro.",
+  "description": "Histórico de quem mexeu no quê dentro da conta (criação, edição, exclusão, login e logout), com o autor, o IP e o antes/depois de cada campo. ATENÇÃO ao formato das datas: aqui 'since' e 'until' são DATA POR EXTENSO (AAAA-MM-DD) e NÃO timestamp Unix — é o oposto dos relatórios; mandar um número Unix derruba a chamada com erro. Somente administradores; a conta precisa ter o recurso de auditoria habilitado, senão a lista volta VAZIA sem nenhum aviso de erro. MENSAGEM APAGADA (26/09/2026): quando alguém apaga uma mensagem pelo painel, fica um registro auditable_type 'Message', action 'destroy', com audited_changes = { content (texto, até 2000 caracteres), display_id (conversa), inbox_id, sender_type, sender_id, sender_name, attachments (nomes dos arquivos) } — é a foto tirada ANTES de apagar; auditable vem null nesse caso. Busque com q='trecho da mensagem' ou auditable_type=Message.",
   "category": "Auditoria",
   "params": [
    {
@@ -27897,7 +28446,7 @@
     "type": "string",
     "location": "query",
     "required": false,
-    "description": "Tipo de recurso afetado: Account, AccountUser, AutomationRule, Conversation, Inbox, InboxMember, Macro, Team, TeamMember, User, Webhook"
+    "description": "Tipo de recurso afetado: Account, AccountUser, AutomationRule, Conversation, Inbox, InboxMember, Macro, Message (mensagem APAGADA pelo painel, desde 26/09/2026), Team, TeamMember, User, Webhook"
    },
    {
     "name": "remote_address",
@@ -27919,9 +28468,23 @@
     "location": "query",
     "required": false,
     "description": "Data final no formato AAAA-MM-DD (o dia inteiro entra). NÃO é timestamp Unix — número aqui gera erro"
+   },
+   {
+    "name": "q",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Busca por texto (3+ letras): nome de quem fez OU conteúdo da mudança (inclusive o texto de mensagem apagada). Menos de 3 letras = ignorado. Em conta grande pode levar ~1 s; combine com since/until pra encurtar."
+   },
+   {
+    "name": "sort",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "Ordem por data: desc (mais recentes primeiro, padrão) ou asc."
    }
   ],
-  "returns": "{ per_page, total_entries, current_page, audit_logs: [{ id, auditable_id, auditable_type, auditable, associated_id, associated_type, user_id, user_type, username, action, audited_changes (antes/depois por campo), version, comment, request_uuid, created_at (Unix em segundos), remote_address }] }",
+  "returns": "{ per_page, total_entries, current_page, audit_logs: [{ id, auditable_id, auditable_type, auditable, associated_id, associated_type, user_id, user_type, username, action, audited_changes (antes/depois por campo), version, comment, request_uuid, created_at (Unix em segundos), remote_address (IP inteiro), ip_masked (IP parcial, ex. 177.12.x.x; null pra IP interno), ip_city, ip_region (cidade/estado do IP — só do que já foi descoberto; o que falta aparece na próxima consulta) }] }",
   "common_use_cases": [
    "Descobrir quem apagou uma caixa de entrada ou uma automação",
    "Ver todos os logins de um agente num intervalo de datas",
@@ -33179,7 +33742,7 @@
   "method": "GET",
   "path": "/api/v1/accounts/{account_id}/eclinica_integrations/{id}",
   "title": "Detalhes da Integração e-Clínica",
-  "description": "SÓ LEITURA, somente administrador. A integração e-Clínica da conta (1 por conta; o id precisa ser o dela — 404 caso contrário) com status, saúde, mapeamento de eventos, lembretes, webhook_url e as UNIDADES (filiais) com status/token-por-variável/webhook próprio. Mesmo conteúdo de lionchat_eclinica_integrations_list, que já resolve o id. LEMBRETE POR AUTOMACAO (25/08): cada entrada de reminder_config aceita `automation_id` alem do `flow_id` — pelo menos um dos dois (422 sem nenhum); com os DOIS preenchidos a AUTOMACAO vence no disparo. A automacao precisa ser da propria conta (422 senao). ALERTA de regra de negocio ao configurar: o caminho por automacao RODA AS ACOES SEM AVALIAR AS CONDICOES da automacao. Desde 17/09/2026 os DOIS caminhos (fluxo e automacao) mandam um aviso POR CONSULTA: paciente com duas consultas no dia (ou dois pacientes no mesmo celular) recebe um aviso para cada uma, ~10 min um do outro (fila por contato). Quem quer so um por dia monta no FLUXO (condicao num atributo com {{data_consulta}}); na automacao nao da, porque as condicoes dela nao sao avaliadas — avise o cliente antes de trocar fluxo por automacao.",
+  "description": "SÓ LEITURA, somente administrador. A integração e-Clínica da conta (1 por conta; o id precisa ser o dela — 404 caso contrário) com status, saúde, mapeamento de eventos, lembretes, webhook_url e as UNIDADES (filiais) com status/token-por-variável/webhook próprio. Mesmo conteúdo de lionchat_eclinica_integrations_list, que já resolve o id. LEMBRETE POR AUTOMACAO (25/08): cada entrada de reminder_config aceita `automation_id` alem do `flow_id` — pelo menos um dos dois (422 sem nenhum); com os DOIS preenchidos a AUTOMACAO vence no disparo. A automacao precisa ser da propria conta (422 senao). ALERTA de regra de negocio ao configurar: o caminho por automacao RODA AS ACOES SEM AVALIAR AS CONDICOES da automacao. Desde 17/09/2026 os DOIS caminhos (fluxo e automacao) mandam um aviso POR CONSULTA: paciente com duas consultas no dia (ou dois pacientes no mesmo celular) recebe um aviso para cada uma, ~10 min um do outro (fila por contato). Quem quer so um por dia monta no FLUXO (condicao num atributo com {{data_consulta}}); na automacao nao da, porque as condicoes dela nao sao avaliadas — avise o cliente antes de trocar fluxo por automacao. VARIAVEIS DA MENSAGEM (28/09/2026): na automacao alvo de lembrete use {{eclinica_lembrete.<campo>}} (data_consulta, hora_consulta, profissional, compromisso, paciente_nome, unidade, link_confirmacao, idagenda, cliente_id, agendatipo, cor; laboratorio: data_prevista/data_entrega/data_referencia; cobranca: vencimento/valor/descricao) — e a consulta DAQUELE lembrete, data em DD/MM/AAAA. NUNCA a ficha {{contact.custom_attribute.eclinica_*}}: guarda so a consulta do ULTIMO aviso e manda a data de outra consulta. O nome antigo {{agendamento.*}} ainda funciona. No FLUXO nada muda ({{data_consulta}} etc). Detalhe no resource data-model, secao e-Clinica.",
   "category": "Integracoes",
   "params": [
    {
@@ -33982,7 +34545,7 @@
   "method": "GET",
   "path": "/api/v1/accounts/{account_id}/signature_envelopes",
   "title": "Listar Contratos Enviados",
-  "description": "Lista os CONTRATOS (cada envio a uma pessoa e um contrato, com PDF proprio e linha do tempo), paginada (25 por pagina) com filtro e busca no servidor. Recortes: por modelo (signature_document_id), por contato (contact_id — o que aparece na aba Contratos da ficha) ou por conversa (conversation_id). status aceita os baldes aguardando (draft/sent), visualizado (viewed/partially_signed), assinado (signed_pending_seal/signed), encerrado (refused/cancelled/expired) ou falta_eu (contratos em que o usuario do token e o remetente e ainda nao assinou). Resposta traz meta.counts com a contagem por balde.",
+  "description": "Lista os CONTRATOS (cada envio a uma pessoa e um contrato, com PDF proprio e linha do tempo), paginada (25 por pagina) com filtro e busca no servidor. Recortes: por modelo (signature_document_id), por contato (contact_id — o que aparece na aba Contratos da ficha) ou por conversa (conversation_id). status aceita os baldes aguardando (draft/sent), visualizado (viewed/partially_signed), assinado (signed_pending_seal/signed), encerrado (refused/cancelled/expired) ou falta_eu (contratos em que o usuario do token e o remetente e ainda nao assinou). Resposta traz meta.counts com a contagem por balde. Por empresa: company_id (contratos de todos os contatos dela).",
   "category": "Assinatura eletronica",
   "params": [
    {
@@ -34026,6 +34589,13 @@
     "location": "query",
     "required": false,
     "description": "Pagina (padrao 1, 25 por pagina)"
+   },
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "query",
+    "required": false,
+    "description": "Recorta pelos contatos de uma EMPRESA (aba Contratos da pagina da empresa). Empresa de outra conta = 404."
    }
   ],
   "returns": "payload: [{id, title, status, signature_document_id, document_name, contact_id, contact_name, conversation_id, sent_at, completed_at, expires_at, participants[{id, name, role, status, delivery_channel, phone, email, signed_at, viewed_at, public_url, signs_in_panel}], delivery: {failed[], delivered_participant_ids[]}, has_signed_document, pending_for_me}], meta: {page, per_page, has_more, counts}",
@@ -34882,5 +35452,207 @@
   "description": "Uma linha por AGENDA com o estado do Google de cada uma: `connected`, `state`, `calendar_id`, `connected_by`. A conexao Google e UMA POR AGENDA — cada unidade liga a conta Google dela, inclusive a mesma pessoa com contas diferentes. SO ADMINISTRADOR. Conta sem agendas devolve uma linha com agenda_id nulo (a principal).",
   "category": "Integracoes / Google Calendar",
   "params": []
+ },
+ {
+  "id": "lionchat_companies_notes_create",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/notes",
+  "title": "Criar Anotacao da Empresa",
+  "description": "Escreve uma anotacao da PROPRIA empresa (nao de um contato). Qualquer atendente da conta pode. Aparece na aba Anotacoes da pagina da empresa com o selo 'Empresa'.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   },
+   {
+    "name": "note",
+    "type": "object",
+    "location": "body",
+    "required": true,
+    "description": "{ content: texto da anotacao }"
+   }
+  ],
+  "returns": "{payload: anotacao} com kind 'company'",
+  "common_use_cases": [
+   "Registrar historico comercial da empresa",
+   "Anotar combinados com a empresa"
+  ],
+  "related_tools": [
+   "lionchat_companies_notes_list",
+   "lionchat_companies_notes_update"
+  ]
+ },
+ {
+  "id": "lionchat_companies_notes_update",
+  "method": "PATCH",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/notes/{id}",
+  "title": "Editar Anotacao da Empresa",
+  "description": "Edita uma anotacao da PROPRIA empresa (kind 'company'). A autoria passa para quem editou, como na anotacao do contato. Anotacao de contato (kind 'contact') NAO se edita aqui.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   },
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da anotacao da empresa (kind 'company')"
+   },
+   {
+    "name": "note",
+    "type": "object",
+    "location": "body",
+    "required": true,
+    "description": "{ content: texto da anotacao }"
+   }
+  ],
+  "returns": "{payload: anotacao}",
+  "common_use_cases": [
+   "Corrigir uma anotacao da empresa"
+  ],
+  "related_tools": [
+   "lionchat_companies_notes_list"
+  ]
+ },
+ {
+  "id": "lionchat_companies_notes_destroy",
+  "method": "DELETE",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/notes/{id}",
+  "title": "Apagar Anotacao da Empresa",
+  "description": "Apaga uma anotacao da PROPRIA empresa (kind 'company'). Nao tem volta.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   },
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da anotacao da empresa (kind 'company')"
+   }
+  ],
+  "returns": "200 sem corpo",
+  "common_use_cases": [
+   "Remover anotacao errada"
+  ],
+  "related_tools": [
+   "lionchat_companies_notes_list"
+  ]
+ },
+ {
+  "id": "lionchat_companies_documents_list",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/documents",
+  "title": "Documentos da Empresa",
+  "description": "Documentos de TODOS os contatos da empresa juntos (mesmas origens e regras da aba Documentos do contato: ficha, card, conversa, compromisso, formulario e contrato assinado). Cada item traz contacts [{id, name}] (de quem e). O mesmo arquivo mandado a varios contatos vem UMA vez, com todos os nomes. SO LEITURA: favoritar/renomear/enviar/apagar e pela ficha do contato (lionchat_contacts_documents_*). Lista inteira, teto de 1000 (meta.truncated avisa).",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   }
+  ],
+  "returns": "{payload: [...], meta: {total, truncated}}",
+  "common_use_cases": [
+   "Achar um arquivo de qualquer pessoa da empresa",
+   "Conferir documentos enviados para a empresa"
+  ],
+  "related_tools": [
+   "lionchat_contacts_documents_list",
+   "lionchat_companies_contacts_list"
+  ]
+ },
+ {
+  "id": "lionchat_companies_tasks_list",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/companies/{company_id}/tasks",
+  "title": "Compromissos da Empresa",
+  "description": "Compromissos de TODOS os contatos da empresa, mais novo primeiro, pela mesma regra da ficha do contato (sem o compromisso particular de outra pessoa, so as agendas que o usuario ve). Cada item traz contact_name / conversation_contact_name. Precisa da Agenda ligada (senao 404). Editar/concluir: lionchat_tasks_update / lionchat_tasks_toggle.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "company_id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   }
+  ],
+  "returns": "array de compromissos (mesmo formato de lionchat_tasks_list)",
+  "common_use_cases": [
+   "Ver a agenda de uma empresa inteira",
+   "Conferir proximas reunioes com a empresa"
+  ],
+  "related_tools": [
+   "lionchat_tasks_list",
+   "lionchat_tasks_update"
+  ]
+ },
+ {
+  "id": "lionchat_companies_kanban_items_list",
+  "method": "GET",
+  "path": "/api/v1/accounts/{account_id}/companies/{id}/kanban_items",
+  "title": "Cards do Kanban da Empresa",
+  "description": "Lista os cards do Kanban de TODOS os contatos da empresa (aba Cards da pagina da empresa). Mesma lista da aba Kanban da ficha do contato: card ligado a qualquer conversa dos contatos (principal ou vinculada), so os cards que o usuario ve no quadro (funil restrito e caixa respeitados), 25 por pagina, mais recentes primeiro. Cada card traz contacts[{id,name}] = de quem e (card ligado a 2 contatos da empresa traz os dois). ENTERPRISE; exige a funcao Empresas.",
+  "category": "Empresas",
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "ID da empresa"
+   },
+   {
+    "name": "status",
+    "type": "string",
+    "location": "query",
+    "required": false,
+    "description": "open (padrao na tela), won, lost; omitir = todos"
+   },
+   {
+    "name": "funnel_id",
+    "type": "integer",
+    "location": "query",
+    "required": false,
+    "description": "Filtra por funil"
+   },
+   {
+    "name": "page",
+    "type": "integer",
+    "location": "query",
+    "required": false,
+    "description": "Pagina (25 por pagina)"
+   }
+  ],
+  "returns": "{ meta: {total_count, page, per_page}, payload: [card com funnel, labels, next_task, permissions e contacts[{id,name}]] }",
+  "common_use_cases": [
+   "Ver os negocios de uma empresa",
+   "Somar oportunidades abertas de um cliente B2B"
+  ],
+  "related_tools": [
+   "lionchat_contacts_kanban_items_list",
+   "lionchat_companies_contacts_list",
+   "lionchat_kanban_items_show"
+  ]
  }
 ]