@lionchat/mcp-server 1.5.0 → 1.7.0

package/endpoints.json

@@ -698,7 +698,7 @@
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/contacts/filter",
     "title": "Filtrar Contatos",
-    "description": "Filtra contatos com condições avançadas (múltiplas condições combinadas com AND/OR, operadores como contains, is_present, days_before, starts_with, e filtro por custom_attributes). Ver a seção Casos de Uso e Filtros para a lista completa de atributos e operadores. Filtragem avançada de contatos via payload de condições. Múltiplos operadores: equal_to, contains, includes, is_present, etc.\n\nNOVO (2026-06): filtro por REGISTROS VINCULADOS — acha o contato pelo que aconteceu com ele: attribute_key 'conversation_search' (conversa vinculada: status/etiquetas/caixa), condicoes com custom_attribute_type 'conversation_attribute' (atributos da conversa) e attribute_key 'kanban_card' (card vinculado: funil/etapa/prioridade/status). Combinaveis com E/OU.",
+    "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.",
     "category": "Contatos",
     "params": [
       {
@@ -1426,7 +1426,7 @@
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/conversations/filter",
     "title": "Filtrar Conversas",
-    "description": "Filtra conversas com condições avançadas (múltiplas condições AND/OR, operadores como equal_to, contains, is_present, days_before, filtro por custom_attributes). Ordenação fixa: last_activity_at DESC. Paginação: 25 registros/página. Ver a seção Casos de Uso e Filtros para a lista completa de atributos e operadores. Filtragem avançada de conversas via payload de condições. Múltiplos operadores: equal_to, contains, includes, is_present, etc.",
+    "description": "Filtra conversas com condicoes avancadas (payload de condicoes, mesmas da tela). Ordenacao fixa last_activity_at DESC, 25/pagina.\n\nCHAVES FILTRAVEIS (attribute_key -> operadores): status, chat_type, priority (equal_to/not_equal_to); assignee_id, inbox_id, team_id, campaign_id, captain_assistant_id, labels (equal_to/not_equal_to/is_present/is_not_present); display_id (equal_to/not_equal_to/contains/does_not_contain); created_at, last_activity_at (is_greater_than/is_less_than/days_before — valor de data); browser_language, conversation_language, referer, mail_subject; card_funnel_stage (conversa POR CARD do Kanban — valor 'funnel:<id>' ou 'stage:<id>:<chave_etapa>'); QUALQUER outra chave = atributo personalizado (use custom_attribute_type na condicao: 'conversation_attribute' ou 'contact_attribute').\n\nCada condicao: {attribute_key, filter_operator, values[], query_operator:'and'|'or', custom_attribute_type?}. Operador fora da lista da chave = 422 'Operador invalido' (ex: labels NAO aceita 'includes' — use equal_to). [2026-07-25] O operador contains em display_id agora funciona de verdade (busca por trecho do numero da conversa; antes dava erro de banco).",
     "category": "Conversas",
     "params": [
       {
@@ -2252,7 +2252,7 @@
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages/{id}/retry",
     "title": "Reenviar Mensagem",
-    "description": "Reenvia uma mensagem que falhou. Obrigatorios: conversation_id, id.",
+    "description": "[POST] Reenvia uma mensagem que falhou. Obrigatorios: conversation_id, id. [2026-07-24] Motor unico de reenvio: limpeza cirurgica de content_attributes (preserva vinculos de flow/automacao/comentario IG) + trava anti-duplicata por mensagem. Pra reenviar TODAS as falhadas de uma caixa de uma vez, use lionchat_inboxes_failed_messages_bulk_retry. [2026-07-25] Mensagem cancelada ou excluida NAO reenvia — a chamada responde 422 com o motivo. Pra cancelar de vez o reenvio, use lionchat_conversations_messages_cancel_retry.",
     "category": "Mensagens",
     "params": [
       {
@@ -2279,7 +2279,43 @@
     "related_tools": [
       "lionchat_conversations_messages_list",
       "lionchat_conversations_messages_create",
-      "lionchat_conversations_messages_update"
+      "lionchat_conversations_messages_update",
+      "lionchat_inboxes_failed_messages_summary",
+      "lionchat_inboxes_failed_messages_bulk_retry"
+    ]
+  },
+  {
+    "id": "lionchat_conversations_messages_cancel_retry",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages/{id}/cancel_retry",
+    "title": "Cancelar Reenvio de Mensagem Falhada",
+    "description": "[NOVO 2026-07-25] Cancela DE VEZ o reenvio de UMA mensagem que falhou: na conversa ela vira o selo cinza 'Envio cancelado', sai do painel Falhas de envio e fica FORA de TODO reenvio (botao da bolha, reenvio em lote e auto-recuperacao do WAHA). IRREVERSIVEL — sempre confirme com o usuario antes de chamar. Exige mensagem outgoing + status failed + nao-privada (qualquer outra coisa responde 400). Mesma permissao do reenvio (agente com acesso a conversa). Pra cancelar todas as falhadas de uma caixa de uma vez use lionchat_inboxes_failed_messages_bulk_cancel.",
+    "category": "Mensagens",
+    "params": [
+      {
+        "name": "conversation_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "Display ID da conversa"
+      },
+      {
+        "name": "id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da mensagem falhada"
+      }
+    ],
+    "returns": "mensagem atualizada (retry_cancelled + retry_cancelled_at em content_attributes)",
+    "common_use_cases": [
+      "Desistir de reenviar uma mensagem que falhou",
+      "Limpar uma falha antiga do painel sem mandar nada pro cliente"
+    ],
+    "related_tools": [
+      "lionchat_conversations_messages_create_1",
+      "lionchat_inboxes_failed_messages_bulk_cancel",
+      "lionchat_inboxes_failed_messages_summary"
     ]
   },
   {
@@ -3504,7 +3540,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/kanban_items/filter",
     "title": "Filtrar Items",
-    "description": "Filtra items com condições avançadas (mesmos filtros do index). Filtragem avançada de itens Kanban via payload de condições. Múltiplos operadores: equal_to, contains, includes, is_present, etc.",
+    "description": "Filtra cards do Kanban com o filtro RICO da plataforma (mesmo motor da tela '+ Filtro'). Filtros REAIS aplicados: etapas (stages), prioridades, status do card (open/won/lost), agente, faixa de valor, periodo de criacao (date_start/end), periodo de agendamento (scheduled_date_*), tarefas (task_filter), canal, etiqueta da conversa, oferta e atributos personalizados de card/contato/conversa (JSON-string + custom_attribute_match all/any). ATENCAO: SEM paginacao — retorna ate 5000 cards em ordem created_at DESC, shape {items:[], total, filters}. NAO existe filtro por time aqui (use lionchat_kanban_items_list_3 pra relatorio por time, ou filtre por agent_id); ordenacao e fixa. (2026-07-24: removidos os parametros stage_id/inbox_id/sort_by/sort_direction/page — eram aceitos mas IGNORADOS pelo backend; use stages[] no lugar de stage_id.)",
     "category": "Itens",
     "params": [
       {
@@ -3514,13 +3550,6 @@
         "required": true,
         "description": "ID do funil"
       },
-      {
-        "name": "stage_id",
-        "type": "string",
-        "location": "query",
-        "required": false,
-        "description": "Etapa"
-      },
       {
         "name": "agent_id",
         "type": "integer",
@@ -3559,39 +3588,103 @@
         "description": "Valor máximo"
       },
       {
-        "name": "inbox_id",
-        "type": "integer",
+        "name": "stages",
+        "query_name": "stages[]",
+        "type": "array",
         "location": "query",
         "required": false,
-        "description": "Inbox"
+        "description": "Etapas do funil (chaves internas/slugs, ex: ['novo_lead','qualificado'])"
       },
       {
-        "name": "sort_by",
+        "name": "date_start",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Campo de ordenação"
+        "description": "Criado a partir de (YYYY-MM-DD) — filtra created_at do card"
       },
       {
-        "name": "sort_direction",
+        "name": "date_end",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "asc ou desc"
+        "description": "Criado ate (YYYY-MM-DD)"
       },
       {
-        "name": "page",
-        "type": "integer",
+        "name": "scheduled_date_start",
+        "type": "string",
         "location": "query",
         "required": false,
-        "description": "Página"
+        "description": "Agendamento a partir de (YYYY-MM-DD) — considera scheduled_at/deadline_at do card E tarefas da agenda vinculadas"
+      },
+      {
+        "name": "scheduled_date_end",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Agendamento ate (YYYY-MM-DD)"
+      },
+      {
+        "name": "task_filter",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Filtro por tarefas vinculadas: has_task | no_task | today | tomorrow | this_week | overdue"
+      },
+      {
+        "name": "channel",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Tipo de canal da conversa do card, SEM o prefixo Channel:: (ex: Waha, Whatsapp, Instagram, Email)"
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Etiqueta aplicada na CONVERSA vinculada ao card (match parcial por titulo)"
+      },
+      {
+        "name": "offer",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Descricao exata de uma oferta presente no card (item_details.offers)"
+      },
+      {
+        "name": "card_custom_attribute_filters",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "STRING JSON (array serializado) de condicoes sobre atributos personalizados do CARD: [{\"attribute_key\":\"...\",\"filter_operator\":\"equal_to|not_equal_to|contains|does_not_contain|is_present|is_not_present\",\"values\":[\"...\"]}]. Ex: \"[{\\\"attribute_key\\\":\\\"origem\\\",\\\"filter_operator\\\":\\\"equal_to\\\",\\\"values\\\":[\\\"indicacao\\\"]}]\". NAO enviar como array nativo — o backend faz JSON.parse da string."
+      },
+      {
+        "name": "contact_custom_attribute_filters",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "STRING JSON (array serializado) de condicoes sobre atributos personalizados do CONTATO vinculado: [{\"attribute_key\":\"...\",\"filter_operator\":\"equal_to|not_equal_to|contains|does_not_contain|is_present|is_not_present\",\"values\":[\"...\"]}]. Ex: \"[{\\\"attribute_key\\\":\\\"origem\\\",\\\"filter_operator\\\":\\\"equal_to\\\",\\\"values\\\":[\\\"indicacao\\\"]}]\". NAO enviar como array nativo — o backend faz JSON.parse da string."
+      },
+      {
+        "name": "conversation_custom_attribute_filters",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "STRING JSON (array serializado) de condicoes sobre atributos personalizados da CONVERSA vinculada: [{\"attribute_key\":\"...\",\"filter_operator\":\"equal_to|not_equal_to|contains|does_not_contain|is_present|is_not_present\",\"values\":[\"...\"]}]. Ex: \"[{\\\"attribute_key\\\":\\\"origem\\\",\\\"filter_operator\\\":\\\"equal_to\\\",\\\"values\\\":[\\\"indicacao\\\"]}]\". NAO enviar como array nativo — o backend faz JSON.parse da string."
+      },
+      {
+        "name": "custom_attribute_match",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "'all' (E — todas as condicoes de atributo, padrao) ou 'any' (OU — qualquer uma)"
       }
     ],
-    "returns": "payload (array de itens Kanban filtrados)",
+    "returns": "{ items: [cards serializados], total: <int>, filters: <eco dos filtros> } — cap 5000, sem paginacao",
     "common_use_cases": [
-      "Filtros complexos com múltiplas condições",
-      "Relatórios customizados",
-      "Substituir vários list calls por 1 filtro estruturado"
+      "Relatorio de cards por periodo + etapa + valor",
+      "Cards com atributo personalizado especifico (card/contato/conversa)",
+      "Cards com tarefa atrasada (task_filter=overdue) ou sem tarefa"
     ],
     "related_tools": [
       "lionchat_kanban_items_list",
@@ -3730,8 +3823,8 @@
     "id": "lionchat_kanban_items_list_3",
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/kanban_items/reports",
-    "title": "Relatórios Kanban",
-    "description": "Retorna relatórios agregados do kanban. Lista itens Kanban paginados (per_page padrão 25, máximo 100). Retorna meta (contadores) + payload (array de item Kanban).",
+    "title": "Relatório Agregado do Kanban",
+    "description": "RELATORIO AGREGADO do Kanban (funil de vendas) — a resposta e um OBJETO de metricas, nao lista de cards: soma de valores GANHOS no periodo, contagem/valor por etapa, previsao ponderada (forecast), top negocios, cards parados (stale) e metas do funil. Filtra por periodo (from/to), agentes (user_ids[]) e time (team_id). USE ESTA TOOL quando pedirem 'relatorio do funil/vendas/ganhos do mes por agente ou time'. Pra LISTAR os cards em si, use lionchat_kanban_items_filter.",
     "category": "Itens",
     "params": [
       {
@@ -3740,13 +3833,42 @@
         "location": "query",
         "required": true,
         "description": "ID do funil"
+      },
+      {
+        "name": "from",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Inicio do periodo (YYYY-MM-DD ou ISO 8601)"
+      },
+      {
+        "name": "to",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Fim do periodo (YYYY-MM-DD ou ISO 8601)"
+      },
+      {
+        "name": "user_ids",
+        "query_name": "user_ids[]",
+        "type": "array",
+        "location": "query",
+        "required": false,
+        "description": "IDs de agentes — restringe o relatorio aos cards atribuidos a eles"
+      },
+      {
+        "name": "team_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "ID do time — restringe aos cards dos agentes do time"
       }
     ],
-    "returns": "objeto de relatorios agregados (nao array de itens)",
+    "returns": "objeto de metricas agregadas do funil (valores ganhos, por etapa, forecast, top deals, stale) — NAO e array de itens",
     "common_use_cases": [
-      "Dashboard: contar/exibir itens Kanban",
-      "Buscar com filtros antes de outra operação",
-      "Auditoria/relatório de itens Kanban ativas"
+      "Ganhos do mes por agente ou time",
+      "Valor total e contagem por etapa do funil",
+      "Forecast (previsao ponderada) e negocios parados"
     ],
     "related_tools": [
       "lionchat_kanban_items_list",
@@ -5092,7 +5214,7 @@
     "method": "GET",
     "path": "/api/v2/accounts/{account_id}/summary_reports/agent",
     "title": "Relatorio por Agente",
-    "description": "Relatório por agente — lista métricas (conversas atendidas, tempos médios, CSAT) por cada agente da conta no período. ⚠️ Tempos em SEGUNDOS.",
+    "description": "Relatório por agente — lista métricas (conversas atendidas, tempos médios, CSAT) por cada agente da conta no período. ⚠️ Tempos em SEGUNDOS. [2026-07-24] Aceita inbox_id (opcional) pra ver o desempenho dos agentes DENTRO de uma caixa.",
     "category": "Relatorios",
     "params": [
       {
@@ -5100,14 +5222,14 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data inicio (ISO 8601)"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data fim (ISO 8601)"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "business_hours",
@@ -5115,6 +5237,13 @@
         "location": "query",
         "required": false,
         "description": "Considerar apenas horario comercial"
+      },
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Opcional (2026-07-24): so as conversas daquela caixa entram no calculo por agente. Exclusivo deste relatorio (os resumos de time/caixa/etiqueta/canal NAO aceitam)."
       }
     ],
     "returns": "Array por agente de { id, name, conversations_count, avg_first_response_time (seg), avg_reply_time (seg), avg_resolution_time (seg), resolved_count, csat_score_average }",
@@ -5142,14 +5271,21 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data inicio"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data fim"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
+      },
+      {
+        "name": "business_hours",
+        "type": "boolean",
+        "location": "query",
+        "required": false,
+        "description": "true = medias consideram so o horario de atendimento configurado"
       }
     ],
     "returns": "array por time { id, name, conversations_count, avg_resolution_time (seg), avg_first_response_time (seg), avg_reply_time (seg), resolved_count } (sem paginacao/meta)",
@@ -5177,14 +5313,21 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data inicio"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data fim"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
+      },
+      {
+        "name": "business_hours",
+        "type": "boolean",
+        "location": "query",
+        "required": false,
+        "description": "true = medias consideram so o horario de atendimento configurado"
       }
     ],
     "returns": "array por inbox (mesma estrutura do resumo); sem meta",
@@ -5212,14 +5355,21 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data inicio"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data fim"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
+      },
+      {
+        "name": "business_hours",
+        "type": "boolean",
+        "location": "query",
+        "required": false,
+        "description": "true = medias consideram so o horario de atendimento configurado"
       }
     ],
     "returns": "array por label; sem meta",
@@ -5247,14 +5397,21 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data inicio"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data fim"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
+      },
+      {
+        "name": "business_hours",
+        "type": "boolean",
+        "location": "query",
+        "required": false,
+        "description": "true = medias consideram so o horario de atendimento configurado"
       }
     ],
     "returns": "array por canal; sem meta",
@@ -5282,7 +5439,7 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Metrica: conversations_count, incoming_messages_count, etc"
+        "description": "Metrica (UMA por chamada): conversations_count | incoming_messages_count | outgoing_messages_count | avg_first_response_time | avg_resolution_time | resolutions_count | reply_time | bot_resolutions_count | bot_handoffs_count. Tempos em SEGUNDOS."
       },
       {
         "name": "type",
@@ -5296,14 +5453,14 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Timestamp inicio"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Timestamp fim"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "id",
@@ -5331,7 +5488,7 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Offset de timezone em horas"
+        "description": "Deslocamento de fuso em horas (ex: -3 pra Brasilia) — afeta SO o agrupamento dos pontos do grafico (fronteira do dia/hora), NAO altera totais de summary."
       }
     ],
     "returns": "array de { value, timestamp[, count] } (sem meta)",
@@ -5359,14 +5516,14 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Timestamp inicio"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Timestamp fim"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "type",
@@ -5394,7 +5551,7 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Offset de timezone em horas"
+        "description": "Deslocamento de fuso em horas (ex: -3). NAO altera os totais do summary — so afeta agrupamento em endpoints de serie temporal."
       }
     ],
     "returns": "{ conversations_count, incoming_messages_count, outgoing_messages_count, resolutions_count, avg_first_response_time (seg), avg_resolution_time (seg), previous: {...mesma estrutura...} }",
@@ -5630,7 +5787,7 @@
     "method": "GET",
     "path": "/api/v2/accounts/{account_id}/reports/conversation_traffic",
     "title": "Trafego de Conversas",
-    "description": "Exporta CSV de heatmap de trafego de conversas. Aceita timezone_offset.",
+    "description": "[GET] Conversation Traffic (heatmap de volume por hora x dia, CSV). ATENCAO: janela FIXA calculada a partir de HOJE no fuso informado — NAO aceita since/until (nao adianta passar). Unico parametro: timezone_offset (ex: -3 pra Brasilia; sem ele o pico sai em UTC).",
     "category": "Relatorios",
     "params": [
       {
@@ -5706,7 +5863,7 @@
     "method": "GET",
     "path": "/api/v2/accounts/{account_id}/live_reports/conversation_metrics",
     "title": "Metricas em Tempo Real",
-    "description": "Metricas ao vivo de conversas (conversation_metrics). Filtro opcional team_id.",
+    "description": "Metricas ao vivo de conversas (conversation_metrics). Filtro opcional team_id. [2026-07-24] Aceita tambem inbox_id e assignee_id (opcionais) — e o mesmo recorte da tela Visao Geral. Combinaveis com team_id.",
     "category": "Relatorios",
     "params": [
       {
@@ -5715,6 +5872,20 @@
         "location": "query",
         "required": false,
         "description": "Filtrar por time (opcional)"
+      },
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Opcional (2026-07-24): recorta as metricas por UMA caixa de entrada."
+      },
+      {
+        "name": "assignee_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Opcional (2026-07-24): recorta as metricas por UM atendente responsavel."
       }
     ],
     "returns": "{ open, unattended, unassigned, pending }",
@@ -5734,7 +5905,7 @@
     "method": "GET",
     "path": "/api/v2/accounts/{account_id}/live_reports/grouped_conversation_metrics",
     "title": "Metricas Agrupadas em Tempo Real",
-    "description": "Metricas ao vivo agrupadas. group_by OBRIGATORIO (team_id ou assignee_id).",
+    "description": "Metricas ao vivo agrupadas. group_by OBRIGATORIO (team_id ou assignee_id). [2026-07-24] Aceita tambem inbox_id e assignee_id (opcionais) pra recortar a base antes do agrupamento.",
     "category": "Relatorios",
     "params": [
       {
@@ -5750,6 +5921,20 @@
         "location": "query",
         "required": false,
         "description": "Filtrar por time (opcional)"
+      },
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Opcional (2026-07-24): recorta as metricas por UMA caixa de entrada."
+      },
+      {
+        "name": "assignee_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Opcional (2026-07-24): recorta as metricas por UM atendente responsavel."
       }
     ],
     "returns": "array { open, unattended, unassigned, <group_id> } (sem meta)",
@@ -12769,7 +12954,7 @@
         "type": "string",
         "location": "body",
         "required": false,
-        "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."
+        "description": "Tipo do valor: text (padrao), date (data — grava normalizado AAAA-MM-DD), time (hora — grava normalizado HH:MM, formato 24h), secret (valor secreto, guardado criptografado), number, checkbox, list, link, currency, percent, datetime. A tela de Variaveis da Conta oferece Texto, Data, Hora e Confidencial (2026-07-25) com seletor nativo; os demais tipos funcionam pela API mas a tela os edita como texto. Apelido legado: encrypted_text e aceito e convertido para secret automaticamente. Tipo fora dessa lista retorna 422."
       },
       {
         "name": "value",
@@ -12797,7 +12982,7 @@
     "method": "PATCH",
     "path": "/api/v1/accounts/{account_id}/account_variables/{id}",
     "title": "Atualizar Variável",
-    "description": "Atualiza valor de uma variável existente. Atualiza campos do variável de conta existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados. Campos suportados: value.",
+    "description": "Atualiza valor de uma variável existente. Atualiza campos do variável de conta existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados. Campos suportados: value. O TIPO (attribute_display_type) e a CHAVE (attribute_key) NAO mudam depois de criados — pra trocar o tipo, apague a variavel e crie de novo.",
     "category": "Variaveis da Conta",
     "params": [
       {
@@ -13850,9 +14035,60 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/applied_slas/metrics",
     "title": "Metricas SLA",
-    "description": "Metricas agregadas de SLA. ENTERPRISE-only, Admin.",
+    "description": "[GET] Agregado de SLA (ENTERPRISE-ONLY): total_applied_slas, number_of_sla_misses e hit_rate (string pronta com %). [2026-07-24] Agora com os filtros REAIS expostos: periodo since/until (unix SEGUNDOS), inbox_id, team_id, sla_policy_id, label_list[] e assigned_agent_id. Conta sem Enterprise/SLA: endpoint indisponivel.",
     "category": "SLA",
-    "params": [],
+    "params": [
+      {
+        "name": "since",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
+      },
+      {
+        "name": "until",
+        "type": "string",
+        "location": "query",
+        "required": false,
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
+      },
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por caixa de entrada"
+      },
+      {
+        "name": "team_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por time"
+      },
+      {
+        "name": "sla_policy_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por politica de SLA"
+      },
+      {
+        "name": "label_list",
+        "query_name": "label_list[]",
+        "type": "array",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por etiquetas da conversa (titulos)"
+      },
+      {
+        "name": "assigned_agent_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por atendente responsavel (admin; agente comum ve so o proprio)"
+      }
+    ],
     "returns": "{ total_applied_slas, number_of_sla_misses, hit_rate } — hit_rate e STRING tipo '95.5%'",
     "common_use_cases": [
       "Dashboard: contar/exibir políticas SLA",
@@ -14811,7 +15047,7 @@
         "type": "object",
         "location": "body",
         "required": false,
-        "description": "Opcional. Mapeia variaveis {{N}} do corpo a campos do sistema para auto-preenchimento no envio (NAO vai para a Meta, fica salvo localmente). Chave = posicao da variavel (\"1\", \"2\"...), valor = objeto {source, field, label}. Ex: {\"1\": {\"source\": \"contact\", \"field\": \"name.split.first\", \"label\": \"Primeiro nome\"}}. Variavel sem mapping continua manual (digitada no envio). Fontes/campos: contact/name (Nome completo), contact/name.split.first (Primeiro nome), contact/name.split[1..] (Sobrenome), contact/phone_number, contact/email, conversation/assignee.name (Atendente), conversation/team.name (Equipe), account/name, ou contact/custom_attributes.CHAVE para campo personalizado."
+        "description": "Opcional. Mapeia variaveis {{N}} do corpo a campos do sistema para auto-preenchimento no envio (NAO vai para a Meta, fica salvo localmente). Chave = posicao da variavel (\"1\", \"2\"...), valor = objeto {source, field, label}. Ex: {\"1\": {\"source\": \"contact\", \"field\": \"name.split.first\", \"label\": \"Primeiro nome\"}}. Variavel sem mapping continua manual (digitada no envio). Fontes/campos: contact/name (Nome completo), contact/name.split.first (Primeiro nome), contact/name.split[1..] (Sobrenome), contact/phone_number, contact/email, conversation/assignee.name (Atendente), conversation/team.name (Equipe), account/name, ou contact/custom_attributes.CHAVE para campo personalizado. [NOVO 2026-07-25] Botao de link (URL) com variavel — link rastreavel por cliente: a URL do botao pode terminar com {{1}} (regra da Meta: no maximo UMA variavel, exatamente {{1}}, sempre NO FINAL, com base https:// fixa antes). Nesse caso o componente BUTTONS precisa mandar example: [\"<url com o exemplo no lugar do {{1}}>\"] (sem o example a Meta recusa o template na hora, erro 100) e o variable_mapping recebe a chave especial _button_url = {source, field, label, example, button_index}, onde button_index e a POSICAO do botao dentro do componente BUTTONS. source/field usam a mesma tabela das variaveis de corpo (contact/name, contact/name.split.first, contact/phone_number, contact/email, contact/custom_attributes.CHAVE, conversation/display_id, conversation/assignee.name, account/name), mais 'custom' (texto fixo, vai no field). No envio o valor e codificado automaticamente (espaco vira %20), entao o link nunca quebra. A chave comeca com _ de proposito: ela NAO conta como variavel de corpo."
       }
     ],
     "returns": "template WhatsApp criado (com novo ID)",
@@ -14937,7 +15173,7 @@
         "type": "object",
         "location": "body",
         "required": false,
-        "description": "Opcional. Mapeia variaveis {{N}} a campos do sistema para auto-preenchimento no envio (NAO vai para a Meta). Chave = posicao da variavel (\"1\", \"2\"...), valor = objeto {source, field, label}. Ex: {\"1\": {\"source\": \"contact\", \"field\": \"name.split.first\", \"label\": \"Primeiro nome\"}}. Mesmas fontes/campos do endpoint de criacao."
+        "description": "Opcional. Mapeia variaveis {{N}} a campos do sistema para auto-preenchimento no envio (NAO vai para a Meta). Chave = posicao da variavel (\"1\", \"2\"...), valor = objeto {source, field, label}. Ex: {\"1\": {\"source\": \"contact\", \"field\": \"name.split.first\", \"label\": \"Primeiro nome\"}}. Mesmas fontes/campos do endpoint de criacao. [NOVO 2026-07-25] Botao de link (URL) com variavel — link rastreavel por cliente: a URL do botao pode terminar com {{1}} (regra da Meta: no maximo UMA variavel, exatamente {{1}}, sempre NO FINAL, com base https:// fixa antes). Nesse caso o componente BUTTONS precisa mandar example: [\"<url com o exemplo no lugar do {{1}}>\"] (sem o example a Meta recusa o template na hora, erro 100) e o variable_mapping recebe a chave especial _button_url = {source, field, label, example, button_index}, onde button_index e a POSICAO do botao dentro do componente BUTTONS. source/field usam a mesma tabela das variaveis de corpo (contact/name, contact/name.split.first, contact/phone_number, contact/email, contact/custom_attributes.CHAVE, conversation/display_id, conversation/assignee.name, account/name), mais 'custom' (texto fixo, vai no field). No envio o valor e codificado automaticamente (espaco vira %20), entao o link nunca quebra. A chave comeca com _ de proposito: ela NAO conta como variavel de corpo."
       }
     ],
     "returns": "{ success: true }",
@@ -20738,7 +20974,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/csat_survey_responses/metrics",
     "title": "Metricas CSAT",
-    "description": "Metricas de CSAT do periodo. Filtros: user_ids, inbox_id, team_id, rating. A MEDIA e a taxa NAO vem prontas — calcule de ratings_count.",
+    "description": "[GET] Agregado de CSAT: total de respostas, distribuicao por nota (ratings_count) e pesquisas enviadas (total_sent_messages_count). [2026-07-24] Agora com os filtros REAIS expostos: user_ids[] (atendentes), inbox_id (caixa), team_id, rating e periodo since/until (unix SEGUNDOS). Nota media = soma(nota x qtd)/total; taxa de resposta = total_count/total_sent_messages_count (calcule — nao vem prontas).",
     "category": "CSAT",
     "params": [
       {
@@ -20746,14 +20982,43 @@
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data inicio"
+        "description": "Inicio do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
       },
       {
         "name": "until",
         "type": "string",
         "location": "query",
         "required": false,
-        "description": "Data fim"
+        "description": "Fim do periodo — timestamp UNIX em SEGUNDOS (ex: 1782864000). NAO use ISO 8601 — o backend faz strptime %s e a janela quebra em silencio."
+      },
+      {
+        "name": "user_ids",
+        "query_name": "user_ids[]",
+        "type": "array",
+        "location": "query",
+        "required": false,
+        "description": "IDs de atendentes — CSAT so das conversas atribuidas a eles (admin; agente comum ve so o proprio)"
+      },
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por caixa de entrada"
+      },
+      {
+        "name": "team_id",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por time"
+      },
+      {
+        "name": "rating",
+        "type": "integer",
+        "location": "query",
+        "required": false,
+        "description": "Filtra por nota (1-5)"
       }
     ],
     "returns": "{ total_count, ratings_count (hash rating=>qtd), total_sent_messages_count }",
@@ -20922,7 +21187,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/campaigns/{id}",
     "title": "Detalhes da Campanha",
-    "description": "Retorna uma campanha pelo display_id (o número visível na UI, não o id interno). Inclui audience, trigger_rules e template_params completos.",
+    "description": "Retorna uma campanha pelo display_id (o número visível na UI, não o id interno). Inclui audience, trigger_rules e template_params completos. [2026-07-25] Campanha inexistente/apagada responde 404 limpo (antes dava erro 500).",
     "category": "Campanhas",
     "params": [
       {
@@ -21035,7 +21300,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/campaigns/{id}/statistics",
     "title": "Estatísticas da Campanha",
-    "description": "Métricas de entrega de campanha one-off: total, enviadas, entregues, lidas, falhas e taxas (%).",
+    "description": "Métricas de entrega de campanha one-off: total, enviadas, entregues, lidas, falhas e taxas (%). [2026-07-25] Campanha inexistente/apagada responde 404 limpo (antes dava erro 500).",
     "category": "Campanhas",
     "params": [
       {
@@ -21058,7 +21323,7 @@
     "method": "POST",
     "path": "/api/v1/accounts/{account_id}/campaigns/estimate_audience",
     "title": "Estimar Audiência da Campanha",
-    "description": "Conta quantos contatos COM TELEFONE atendem aos critérios ANTES de criar a campanha. Usa o MESMO motor do disparo (estimativa = lista real). SEMPRE chame antes de campaigns_create e mostre o número ao usuário.",
+    "description": "Conta quantos contatos COM TELEFONE atendem aos critérios ANTES de criar a campanha. Usa o MESMO motor do disparo (estimativa = lista real). SEMPRE chame antes de campaigns_create e mostre o número ao usuário. [2026-07-25] audience e exclusion aceitam tanto lista quanto texto JSON de uma lista; qualquer outro formato responde 422 com a mensagem do erro (antes dava erro 500).",
     "category": "Campanhas",
     "params": [
       {
@@ -21078,7 +21343,7 @@
       {
         "name": "exclusion",
         "type": "array",
-        "location": "query",
+        "location": "body",
         "required": false,
         "description": "Publico a EXCLUIR/negativar antes de estimar (mesmo formato do 'audience': lista de secoes por tipo). O contador desconta quem cair na exclusao. Tipos aceitos iguais aos do audience (Label, Funnel, ConversationAttribute, ContactLabel, ContactAttribute, CardAttribute, AgentTeam)."
       }
@@ -22215,6 +22480,101 @@
     ],
     "related_tools": []
   },
+  {
+    "id": "lionchat_inboxes_failed_messages_summary",
+    "method": "GET",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/failed_messages/summary",
+    "title": "Falhas de Envio da Caixa (painel)",
+    "description": "[NOVO 2026-07-24] Painel 'Falhas de envio' da caixa: mensagens FALHADAS das ultimas 24h agrupadas por motivo — billing (falta de saldo/pagamento), transient (erro comum, reenviavel), window_expired (janela de 24h da API oficial fechou), permanent (erro definitivo) — + grupos informativos campaign (mensagem de campanha NUNCA reenvia por aqui) e partial (multi-anexo parcial, anti-duplicata). group_details traz ate 30 itens por grupo com contato, conversa, erro real e horario. Canais elegiveis: WAHA (QR), WhatsApp oficial e Messenger (Telegram/Instagram nao marcam failed). ADMIN-ONLY. Use antes do bulk_retry pra mostrar ao usuario O QUE falhou e quanto e reenviavel (retryable_count = billing + transient). [ATUALIZADO 2026-07-25] Novo grupo informativo 'deleted' (Excluidas): mensagem falhada que o usuario APAGOU continua no painel como registro, com o motivo ORIGINAL da falha preservado e sem botao de reenviar/cancelar; vem tambem no campo deleted_count e fica FORA de retryable_count e do total. Mensagem CANCELADA (lionchat_conversations_messages_cancel_retry ou bulk_cancel) some do painel de vez.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada"
+      }
+    ],
+    "returns": "{ window_hours, eligible_channel, bulk_retry_running, groups:{billing,transient,window_expired,permanent}, group_details, campaign_count, partial_count, retryable_count, total }",
+    "common_use_cases": [
+      "Diagnosticar por que mensagens nao chegaram (agrupado por motivo, com erro real)",
+      "Ver quantas falhas sao reenviaveis antes de disparar o reenvio em massa",
+      "Auditoria pos-incidente de envio (saldo Meta, sessao WAHA caida)"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_failed_messages_bulk_retry",
+      "lionchat_conversations_messages_create_1",
+      "lionchat_inboxes_waha_status"
+    ]
+  },
+  {
+    "id": "lionchat_inboxes_failed_messages_bulk_retry",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/failed_messages/bulk_retry",
+    "title": "Reenvio em Massa das Falhadas",
+    "description": "[NOVO 2026-07-24] Reenvia EM LOTE as mensagens falhadas REENVIAVEIS das ultimas 24h da caixa (grupos billing + transient do summary). Teto 500 por clique; cadencia anti-ban (WAHA 8s entre mensagens, demais 1s); trava de 1 lote por caixa (409 bulk_retry_running se ja houver lote rodando); cada mensagem e re-validada na hora do reenvio (ainda failed, sem source_id, sessao WAHA WORKING, janela 24h da oficial) e tem teto de 3 tentativas no erro comum. Mensagens de CAMPANHA e multi-anexo PARCIAL nunca entram (anti-duplicata). ADMIN-ONLY. Sempre chame o summary antes e mostre as contagens ao usuario; confirme antes de disparar (acao de envio em massa real). [2026-07-25] Mensagem CANCELADA ou EXCLUIDA nunca entra no lote (bloqueio na fonte, vale tambem pro botao de reenvio e pra auto-recuperacao do WAHA). Pra descartar em vez de reenviar use lionchat_inboxes_failed_messages_bulk_cancel.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada"
+      },
+      {
+        "name": "classification",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Opcional: restringe o lote a UM grupo — 'billing' (so as de falta de saldo, ex: apos pagar a Meta) ou 'transient' (so erro comum). Ausente = todos os reenviaveis."
+      }
+    ],
+    "returns": "{ scheduled: <agendadas agora>, remaining: <elegiveis que ficaram alem do teto de 500> } | 409 {error:'bulk_retry_running'} | 422 {error:'inbox_not_eligible'|'invalid_classification'}",
+    "common_use_cases": [
+      "Pos-incidente: reenviar tudo que falhou nas ultimas 24h da caixa",
+      "Pagou o saldo da Meta: reenviar SO o grupo billing (classification='billing')"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_failed_messages_summary",
+      "lionchat_conversations_messages_create_1"
+    ]
+  },
+  {
+    "id": "lionchat_inboxes_failed_messages_bulk_cancel",
+    "method": "POST",
+    "path": "/api/v1/accounts/{account_id}/inboxes/{inbox_id}/failed_messages/bulk_cancel",
+    "title": "Cancelar Falhadas em Lote",
+    "description": "[NOVO 2026-07-25] Cancela EM LOTE o reenvio das mensagens falhadas das ultimas 24h da caixa: elas somem do painel Falhas de envio e ficam fora de todo reenvio (botao, lote e auto-recuperacao do WAHA). Diferente do reenvio, cancelar vale pra TODOS os grupos — billing, transient, window_expired, permanent, campaign e partial — e e exatamente o jeito de limpar do painel o que nunca seria reenviado. Sincrono (sem job): responde {cancelled: N} na hora. Teto de 1000 por chamada. NAO mexe no grupo 'deleted' (Excluidas), que e registro permanente. IRREVERSIVEL e ADMIN-ONLY: chame lionchat_inboxes_failed_messages_summary antes, mostre as contagens ao usuario e confirme antes de disparar.",
+    "category": "Caixas de Entrada",
+    "params": [
+      {
+        "name": "inbox_id",
+        "type": "integer",
+        "location": "path",
+        "required": true,
+        "description": "ID da caixa de entrada"
+      },
+      {
+        "name": "classification",
+        "type": "string",
+        "location": "body",
+        "required": false,
+        "description": "Opcional: restringe o cancelamento a UM grupo — 'billing', 'transient', 'window_expired', 'permanent', 'campaign' ou 'partial'. Ausente = cancela TODAS as falhadas da janela de 24h. Valor fora dessa lista responde 422 invalid_classification."
+      }
+    ],
+    "returns": "{cancelled: N} — quantidade de mensagens canceladas",
+    "common_use_cases": [
+      "Limpar o painel de falhas de envio de uma caixa",
+      "Descartar em massa falhas que nunca serao reenviadas (janela fechada, erro definitivo)"
+    ],
+    "related_tools": [
+      "lionchat_inboxes_failed_messages_summary",
+      "lionchat_inboxes_failed_messages_bulk_retry",
+      "lionchat_conversations_messages_cancel_retry"
+    ]
+  },
   {
     "id": "lionchat_internal_chat_rooms_list",
     "method": "GET",
@@ -24247,7 +24607,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). ATENÇÃO: o mapeamento evento→flow NÃO é editável via MCP (somente pelo painel).",
+    "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). ATENÇÃO: o mapeamento evento→flow NÃO é editável via MCP (somente pelo painel). [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 NAO sao editaveis via MCP — somente pelo painel (Integracoes > e-Clinica > Lembretes).",
     "category": "Integracoes",
     "params": [],
     "returns": "200 {payload: {eclinica_integrations: [...]}}",
@@ -24264,7 +24624,7 @@
     "method": "GET",
     "path": "/api/v1/accounts/{account_id}/eclinica_integrations/{id}/reminder_history",
     "title": "Histórico dos Lembretes e-Clínica",
-    "description": "Lista os disparos de lembrete agendados da integração e-Clínica (novo 23/07) — responde 'o lembrete do paciente X saiu?'. Cada item traz status (pending aguardando | fired enviado | cancelled | skipped pulado + skip_reason | failed falhou + fail_reason), datas (created_at recebido, fire_at agendado, fired_at disparado, data_consulta), flow_name, contact_name, compromisso e unidade. Somente administrador.",
+    "description": "Lista os disparos de lembrete agendados da integração e-Clínica (novo 23/07) — responde 'o lembrete do paciente X saiu?'. Cada item traz status (pending aguardando | fired enviado | cancelled | skipped pulado + skip_reason | failed falhou + fail_reason), datas (created_at recebido, fire_at agendado, fired_at disparado, data_consulta), flow_name, contact_name, compromisso e unidade. Somente administrador. [2026-07-25] O historico cobre os tres tipos de lembrete: consulta (conta a partir da data da consulta), laboratorio/medicacao (conta a partir da data prevista do laboratorio) e vencimento de cobranca (conta a partir do vencimento). O horario de cada disparo vem da 'Hora do disparo' configurada na linha do lembrete.",
     "category": "Integracoes",
     "params": [
       {