@lionchat/mcp-server 1.25.0 → 1.26.0

package/dist/docs/instructions.md

@@ -437,7 +437,7 @@ Antes de escolher a ferramenta, cheque se a intenção bate com a coluna da dire
 | **Mudar o modo de distribuição da caixa** (Rodízio × Equilibrado) | `lionchat_inboxes_update` (`auto_assignment_config.assignment_order`) | Só vale quando a caixa NÃO tem política vinculada (com política, a política manda). O jsonb é SUBSTITUÍDO, não mesclado: releia o `auto_assignment_config` atual e reenvie as outras chaves junto, senão apaga o `assign_offline_agents` e o freio |
 | **Criar/atualizar time** | `lionchat_teams_create` / `_update` | **Preencha `description`**: desde 03/08 é ela que o AI Agente lê pra decidir o roteamento por time. Descreva QUANDO mandar pra lá, não o que o time é |
 | **Trocar um atendente por outro** ("fulano saiu, entrou ciclano") | `lionchat_agents_replace` (`POST /agents/{id}/replace`, body `agent: {email, name, role}`; `inherit_memberships` default `true`) | Faz os dois passos de uma vez: cria o novo (passa pelo limite de vagas do plano por 30 min), manda a carteira inteira (conversas, cards, tarefas, agendamentos) e exclui o antigo em segundo plano. Responde **202** com `new_agent` — o antigo some da lista quando a transferência termina (`replacing: true` em `agents_list` enquanto roda). **Confirme antes** (seção 7a: é exclusão). Recusas 422: substituir a si mesmo, agente de suporte, e-mail já membro, e o **único administrador confirmado só troca por usuário já confirmado** (convide e espere aceitar). `agents_destroy` recusa quem está ENTRANDO numa substituição viva. Admin-only |
-| **Pausar a automação no meio** (esperar atribuição/card antes da próxima ação) | ação `wait` em `lionchat_automation_rules_create` / `_update` | Segundos, teto 300. Acima disso é caso de FlowBuilder. Ver `lionchat://docs/conversation-flows` |
+| **Pausar a automação no meio** (esperar atribuição/card antes da próxima ação) | ação `wait` em `lionchat_automation_rules_create` / `_update` | Segundos, teto 300. Acima disso é caso de FlowBuilder. Formato objeto `[{seconds, only_if_open, only_if_no_reply}]` confere na volta se a conversa segue aberta e se ninguém respondeu (25/09). Ver `lionchat://docs/conversation-flows` |
 | **Buscar contato/conversa/card** | `lionchat_search_*`, `lionchat_contacts_search` | **Termo com letra exige 3+ caracteres** (dígito é isento). Menos que isso volta VAZIO sem erro — não conclua que o registro não existe. Ver `lionchat://docs/api-conventions` |
 | **Migrar conversas** de uma caixa WhatsApp pra outra (ex.: QR Code → Oficial) | `lionchat_inboxes_inbox_migration_list` (prévia) → `_execute` → acompanhar status | Admin-only e IRREVERSÍVEL: sempre mostre os números da prévia e confirme (seção 7a). Grupos não vão pro canal oficial — ficam na caixa de origem |
 | Qualquer coisa de Ligação WP (Wavoip) | **INTEGRAÇÃO REMOVIDA em 12/08/2026** — não há tool nem tela | A Wavoip saiu do produto: a aba "Ligação WP" **não existe mais**. NUNCA orientar o usuário a "Configurações da caixa → Ligação WP". Para voz em caixa QR Code, o caminho hoje é o **LionCalls**. As ligações antigas seguem no histórico (`provider: "wavoip"`); as gravações delas ficavam no servidor da Wavoip e vão sumir — ao tentar ouvir, o painel mostra "Esta gravação não está mais disponível", e isso é esperado, não é defeito. |

package/dist/docs/resources/api-conventions.md

@@ -9,6 +9,7 @@ Padrões de autenticação, paginação, filtros, formatos e tratamento de erros
 | Tipo | Header / Param | Quando usar |
 |---|---|---|
 | `api_access_token` | Header `api_access_token: <token>` | API principal (você usa isto via MCP) |
+| Chave de API como Bearer | `Authorization: Bearer <token>` (mesma chave de 24 caracteres do perfil) | Desde 26/09/2026, pra n8n, Make e ferramentas que só sabem mandar Bearer. Se os dois vierem, vale o `api_access_token` |
 | Devise Token Auth | `access-token` + `client` + `uid` | Dashboard web/mobile (não você) |
 | HMAC | `X-Webhook-Signature` | Webhooks de entrada |
 | OAuth Bearer | `Authorization: Bearer <token>` | MCP Remote (você usa isto) |

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

@@ -1001,3 +1001,50 @@ grupo, então o número entraria num grupo que nunca apareceria no painel. O cam
 a opção nas configurações da caixa e tentar de novo.
 
 A resposta do join_info vem no formato cru do motor, em PascalCase (`Name`, não `name`).
+
+## Gerenciar um grupo: permissões, pedidos para entrar, link e foto (26/09/2026)
+
+Só em caixa de WhatsApp QR Code. O `group_id` é o id do WhatsApp **com o sufixo** (`120363...@g.us`),
+sempre como texto. Toda ação que muda o grupo exige que o número da caixa seja **admin do grupo**
+(403 se não for) — confira `my_role` em `lionchat_inboxes_waha_groups_show` antes.
+
+**Permissões** — `lionchat_inboxes_waha_groups_update_2` aceita quatro chaves, todas no mesmo sentido
+(`true` = só admins / precisa aprovar):
+
+| Chave | O que faz |
+|---|---|
+| `messages_admin_only` | só admins enviam mensagens |
+| `info_admin_only` | só admins editam nome, foto e descrição |
+| `members_add_admin_only` | só admins adicionam participantes |
+| `approval_required` | quem pede para entrar pelo link espera um admin aprovar |
+
+- Mande só `true` ou `false` nas duas últimas — qualquer outra coisa é recusada com 422 (nunca vira `true`).
+- A resposta diz o que foi aplicado: com várias chaves, se uma falhar vem 422 com `applied` e `failed`.
+  Informe à pessoa o que mudou e o que não mudou; não repita tudo de novo.
+- Para LER as duas últimas use `lionchat_inboxes_waha_groups_list_4`. `null` = o WhatsApp não respondeu
+  agora (não é `false`). `approval_supported: false` = o servidor do WhatsApp daquela caixa ainda não
+  tem aprovação de novos participantes: não ofereça a opção.
+- **Desligar `approval_required` com pedidos esperando:** o WhatsApp pode aprovar todos de uma vez.
+  Liste os pedidos antes (`lionchat_inboxes_waha_groups_list_5`), diga quantos são e só desligue com
+  confirmação explícita.
+
+**Pedidos para entrar**
+
+1. `lionchat_inboxes_waha_groups_list_5` — lista. `supported: false` = servidor sem o recurso;
+   `allowed: false` = o WhatsApp não deixou (o número não é admin do grupo).
+2. `lionchat_inboxes_waha_groups_create_7` (aprovar) ou `_create_8` (recusar) com
+   `participants: [{ id }]`, usando o `id` de cada pedido da lista.
+
+- Aprovar coloca a pessoa no grupo e **aciona a pílula "entrou" e os fluxos "Entrou no grupo"**, igual a
+  quem entra pelo link. Aprovar muitos de uma vez dispara um fluxo por pessoa.
+- A resposta traz `results` por pessoa e as listas **relidas** (`join_requests` e `participants`). Use
+  essas listas para responder — não chame o `show` de novo (ele faz 6 perguntas ao WhatsApp e leva ~7 s).
+- 422 com as listas reais = o WhatsApp recusou (o pedido pode ter sido tratado pelo celular). Não repita.
+- Telefone do pedido só vem em `pn`. Quando vier `null`, o WhatsApp escondeu o número: diga isso; nunca
+  apresente os dígitos do `id` (terminado em `@lid`) como telefone.
+
+**Link de convite** — `lionchat_inboxes_waha_groups_create_4` gera um link novo e **mata o antigo**,
+inclusive o que fluxos e campanhas já enviaram. Confirme antes.
+
+**Foto** — `lionchat_inboxes_waha_groups_update_3` troca; `lionchat_inboxes_waha_groups_destroy` remove
+(no WhatsApp e na lista de conversas do LionChat).

package/dist/docs/resources/conversation-flows.md

@@ -721,7 +721,7 @@ Todos os formatos abaixo foram conferidos linha a linha em `app/services/action_
 | `add_note_to_kanban_item` | `[{"funnel_id": 31, "text": "texto da nota"}]` — a chave e **`text`**, nao `note` |
 | `set_kanban_item_status` | `[{"funnel_id": 31, "status": "won"}]` — `won`, `lost` ou `open`. Status fora disso e ignorado |
 | `start_kanban_item_timer` / `stop_kanban_item_timer` | `[{"funnel_id": 31}]` |
-| `wait` | `[30]` — segundos. Ver "Acao Aguardar" abaixo |
+| `wait` | `[30]` — segundos. Com conferência na volta: `[{"seconds": 120, "only_if_open": true, "only_if_no_reply": true}]`. Ver "Acao Aguardar" abaixo |
 
 **Acoes de Kanban:** todas precisam que a conversa ja tenha um card no funil informado. Sem card,
 a acao e pulada (fica so no log do servidor). Use `create_kanban_item` antes, na mesma regra.
@@ -756,6 +756,24 @@ conversas esperam ao mesmo tempo sem travar o atendimento. Na volta, o sistema c
 ainda existe e esta ligada, se a conversa ainda existe e se a caixa nao foi excluida — se algo
 disso mudou, ele simplesmente nao retoma.
 
+**Conferir na volta (novo 2026-09-25).** Duas caixinhas opcionais, no formato OBJETO:
+
+```json
+{ "action_name": "wait", "action_params": [{ "seconds": 120, "only_if_open": true, "only_if_no_reply": true }] }
+```
+
+| Chave | O que faz na volta |
+|---|---|
+| `only_if_open` | So segue se a conversa ainda estiver **aberta ou pendente**. Resolvida/adiada = o resto da regra NAO roda |
+| `only_if_no_reply` | So segue se **ninguem respondeu** o cliente durante a espera. Conta qualquer mensagem PUBLICA de saida depois da pausa — atendente, IA, outra automacao ou mensagem automatica da caixa (saudacao, ausencia). Nota privada nao conta |
+
+- Booleano de verdade (`true`/`false`); texto `"true"` tambem e aceito. Sem as chaves = retoma como sempre.
+- O formato antigo (`[120]`) continua valendo e nao tem conferencia nenhuma.
+- Quando a conferencia barra, o historico da execucao (`lionchat_automation_rules_list_1`) ganha o passo
+  `wait_check` com status `skipped` e o motivo. Nao e erro: e a regra fazendo o que foi pedido.
+- Caso tipico: "manda o lembrete em 5 minutos **se ninguem tiver atendido ainda**" — sem `only_if_no_reply`,
+  o lembrete sai mesmo depois que o atendente ja respondeu.
+
 Lista autoritativa de nomes validos: `AutomationRule#actions_attributes` no backend. Nome de acao
 fora dessa lista e recusado com 422 ao salvar — isso a API valida. O que ela **nao** valida e o
 conteudo do `action_params`. `apply_kanban_checklist_template` existe no motor mas **nao** e uma

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

@@ -221,6 +221,7 @@ universal); a superfície REST de contatos não mudou.
 **Padrões de `source_id` por canal:**
 - Waha: `5511999999999@c.us` (1-on-1) ou `120363xxx@g.us` (grupo) ou `XXXX@lid` (LID)
 - WhatsApp Cloud: `5511999999999` (E.164 sem prefixo)
+  - ou o ID do WhatsApp da Meta (`CO.1046754121506176`) quando o cliente chegou SEM telefone (so nome de usuario). Nesse caso o contato nao tem `phone_number` e guarda `additional_attributes.social_whatsapp_user_id` / `social_whatsapp_user_name` (2026-09-25)
 - Email: o email mesmo
 - WebWidget: UUID gerado
 
@@ -365,6 +366,8 @@ Captain::AssistantResponse (FAQ)
 ├── question
 ├── answer
 ├── status (pending/approved/rejected)
+├── occurrences_count (int, default 1 — em quantas conversas DIFERENTES a mesma pergunta pendente
+│     apareceu; soma so enquanto pendente. Lista: sort=occurrences = mais perguntadas primeiro, 2026-09-25)
 ├── embedding (vector, pgvector)
 └── documentable (polymorphic: Conversation que gerou)
 
@@ -414,6 +417,8 @@ e `send_conversion` (`[{destinations, event_names, value}]` — só administrado
 execução). Atributo protegido em `update_*_attribute` é recusado na execução (só no log). Executar
 (`lionchat_macros_execute`): até 100 conversas por chamada, a mesma conversa em 5 s é pulada em silêncio,
 30 execuções por minuto por usuário (429). A mensagem de `send_canned_response` sai assinada por quem executou.
+Cada execução deixa na conversa a pílula "Macro: X executada por Fulano" (uma por conversa, 26/09) — vale
+também pelo MCP, então quem executa aparece no histórico da conversa.
 
 ## Agenda / Tarefas / Booking
 
@@ -572,12 +577,12 @@ Atributos de sistema no CONTATO (prefixo `eclinica_`, protegidos, usáveis como
 |---|---|---|
 | `eclinica_cliente_id` | text | ID do paciente no e-Clínica (chave de matching) |
 | `eclinica_unit_id` / `eclinica_unit_name` | text | Unidade/filial que originou o evento |
-| `eclinica_idagenda` | text | ID do último agendamento |
-| `eclinica_data_consulta` | date | Data da consulta, ISO |
+| `eclinica_idagenda` | text | ID do último agendamento (tela: "e-Clinica - ID do Ultimo Agendamento (ficha)") |
+| `eclinica_data_consulta` | date | Data da consulta do ÚLTIMO aviso recebido, ISO (tela: "e-Clinica - Data da Ultima Consulta (ficha)"). **Nunca use na mensagem de LEMBRETE** — ver "Variáveis do lembrete" abaixo |
 | `eclinica_hora_consulta` | **time** | Hora da consulta 24h `"HH:MM"` (novo 2026-07-06) |
 | `eclinica_hora_final` | **time** | Hora final da consulta (novo 2026-07-27) |
-| `eclinica_link_confirmacao` | **link** | Link ecli.co para o paciente confirmar/cancelar a ÚLTIMA consulta (novo 2026-09-08; só existe quando a unidade aprendeu o padrão na aba Unidades). No LEMBRETE use a variável `{{link_confirmacao}}` do fluxo (ou `{{agendamento.link_confirmacao}}` na automação): é da consulta certa — a ficha aponta para a última, e quem tem duas marcadas receberia o link errado |
-| `eclinica_paciente_nome` | text | Nome do PACIENTE como está no cadastro da e-Clínica (novo 2026-09-09). O nome do contato pode ser o do WhatsApp (mãe que agenda o filho pelo celular dela) — por isso NUNCA use `{{contact.name}}` nas mensagens da clínica. Nos fluxos por evento: `{{ contact.custom_attribute.eclinica_paciente_nome \| default: contact.name \| primeiro_nome }}`; no LEMBRETE use a variável `{{ paciente_nome \| default: contact.name \| primeiro_nome }}` (por consulta) ou `{{agendamento.paciente_nome}}` na automação. `primeiro_nome` = primeira palavra com inicial maiúscula. |
+| `eclinica_link_confirmacao` | **link** | Link ecli.co para o paciente confirmar/cancelar a ÚLTIMA consulta (novo 2026-09-08; só existe quando a unidade aprendeu o padrão na aba Unidades). No LEMBRETE use a variável `{{link_confirmacao}}` do fluxo (ou `{{eclinica_lembrete.link_confirmacao}}` na automação): é da consulta certa — a ficha aponta para a última, e quem tem duas marcadas receberia o link errado |
+| `eclinica_paciente_nome` | text | Nome do PACIENTE como está no cadastro da e-Clínica (novo 2026-09-09). O nome do contato pode ser o do WhatsApp (mãe que agenda o filho pelo celular dela) — por isso NUNCA use `{{contact.name}}` nas mensagens da clínica. Nos fluxos por evento: `{{ contact.custom_attribute.eclinica_paciente_nome \| default: contact.name \| primeiro_nome }}`; no LEMBRETE use a variável `{{ paciente_nome \| default: contact.name \| primeiro_nome }}` (por consulta) ou `{{eclinica_lembrete.paciente_nome}}` na automação. `primeiro_nome` = primeira palavra com inicial maiúscula. |
 | `eclinica_status_agendamento` | text | `agendado` / `aguardando` (paciente chegou) / `no_show` / `atendido` / `desmarcado`. Vem do TIPO do evento, nunca da letra da situação. **Estado terminal do MESMO agendamento não volta pra `agendado`** (2026-08-20): a e-Clínica manda `agendamento_alterado` a cada edição da consulta, inclusive depois da chegada/atendimento, e isso NÃO reabre o status. Consulta com `eclinica_idagenda` DIFERENTE nasce `agendado` |
 | `eclinica_situacao` | text | Situação do agendamento no painel, **POR EXTENSO** (2026-08-21, legenda oficial da e-Clínica): AGUARDANDO, NA CADEIRA, PASSAR FINANCEIRO, AGENDAR RETORNO, ATENDIDO, CONFIRMADO, CONFIRMADO PELO LINK, CONFIRMADO PELA API, FALTA, DESMARCADO, CANCELADO PELO LINK, CANCELADO PELA API. Antes guardava a letra crua (`A`, `C`…). Código nunca visto aparece como veio |
 | `eclinica_compromisso` | text | Tipo da consulta — TEXTO LIVRE da recepção (ex: Consulta, Retorno) |
@@ -658,11 +663,32 @@ linhas ANTIGAS (até 17/09); e `fail_reason = fluxo_ainda_em_andamento_com_este_
 fluxo do aviso anterior ainda estava em andamento com aquele contato (típico de fluxo que aguarda o
 paciente clicar num botão) — pode ser reenviado com `lionchat_eclinica_reminder_history_reprocess`.
 O fluxo do lembrete recebe também `{{cliente_id}}` (código do paciente DAQUELA consulta na e-Clínica) e
-`{{agendatipo}}`; na automação, `{{agendamento.cliente_id}}` e `{{agendamento.agendatipo}}`. Ao consultar a
+`{{agendatipo}}`; na automação, `{{eclinica_lembrete.cliente_id}}` e `{{eclinica_lembrete.agendatipo}}`. Ao consultar a
 agenda do paciente dentro do fluxo, use `{{cliente_id}}` do lembrete — a ficha do contato é uma por
 TELEFONE e guarda só o último paciente. Quem quiser "só um lembrete por dia" monta no próprio fluxo
 (condição num atributo da conversa com `{{data_consulta}}` + ação que grava o dia depois de enviar).
 
+**Variáveis do lembrete — o nome certo (desde 2026-09-28).** Cada lembrete guarda a FOTOGRAFIA da consulta
+dele. A FICHA do contato (`eclinica_data_consulta`, `eclinica_hora_consulta`, `eclinica_profissional`...) guarda
+só a consulta do ÚLTIMO aviso que a e-Clínica mandou — quem marca o retorno no mesmo dia em que é atendido tem
+a ficha sobrescrita e o lembrete sai com a data de OUTRA consulta (caso real: Big Odonto, 28/09). Na tela, os 9
+campos de agendamento da ficha aparecem como "e-Clinica - ... Ultima Consulta (ficha)" (a chave não mudou).
+- **Na AUTOMAÇÃO alvo de lembrete** (`reminder_config[].automation_id`), use SEMPRE
+  `{{eclinica_lembrete.<campo>}}`: `data_consulta`, `hora_consulta`, `profissional`, `compromisso`,
+  `paciente_nome`, `unidade`, `link_confirmacao`, `idagenda`, `cliente_id`, `agendatipo`, `cor`; no lembrete de
+  laboratório `data_prevista`, `data_entrega`, `data_referencia`; no de cobrança `vencimento`, `valor`,
+  `descricao`. Vale na mensagem, na nota interna, nos parâmetros do modelo de WhatsApp
+  (`processed_params.body`) e em título/descrição de tarefa. A data sai **DD/MM/AAAA** onde vira texto para a
+  pessoa; gravada em campo (atualizar atributo/campo do card) fica no formato interno `AAAA-MM-DD`. Filtro
+  Liquid (`{{ x | f }}`) NÃO funciona nesse nome. O nome antigo `{{agendamento.<campo>}}` continua funcionando
+  (automações antigas), mas não ensine mais.
+- **No FLUXO nada muda**: continue com as variáveis soltas `{{data_consulta}}`, `{{hora_consulta}}`,
+  `{{link_confirmacao}}`, `{{paciente_nome}}`, `{{cliente_id}}`... Não use `eclinica_lembrete` em fluxo. Nos
+  fluxos de lembrete que conferem a consulta na e-Clínica antes de enviar, essas variáveis soltas são
+  CORRIGIDAS pelo próprio fluxo quando a consulta foi remarcada.
+- Automação/fluxo disparado por EVENTO da e-Clínica (não lembrete) continua lendo a ficha — ali ela acabou de
+  ser gravada pelo próprio evento e está certa.
+
 ## Relatórios e Métricas
 
 ```

package/dist/docs/resources/reports-guide.md

@@ -111,6 +111,7 @@ conversa antiga que NÃO aparece no relatório de hoje (régua antiga por criaç
 | `lionchat_reports_list_3` | Resumo POR LABEL |
 | `lionchat_reports_list_4` | Resumo POR CANAL (channel) |
 | `lionchat_reports_list_5` | Série temporal / evolução (timeseries de um `metric`) |
+| `lionchat_reports_drilldown` | As CONVERSAS por trás de UM ponto da série temporal (clique na barra do gráfico) |
 | `lionchat_reports_list_6` | Resumo do BOT (bot_summary) |
 | `lionchat_reports_list_7` | Exportação de AGENTES em CSV |
 | `lionchat_reports_list_8` | Exportação de INBOXES em CSV |
@@ -146,6 +147,7 @@ conversa antiga que NÃO aparece no relatório de hoje (régua antiga por criaç
 | "qual canal tem mais demanda", "comparar WhatsApp vs Email" | `lionchat_reports_list_2` (inbox) ou `lionchat_reports_list_4` (tipo de canal) |
 | "quantas conversas urgentes", "por etiqueta" | `lionchat_reports_list_3` |
 | "evolução dia a dia", "mês a mês", "gráfico de linha" | `lionchat_reports_list_5` |
+| "quais conversas deram aquele pico de terça?", "quem são as 40 conversas do dia 12?" | `lionchat_reports_list_5` pra achar o ponto, depois `lionchat_reports_drilldown` |
 | "como tá o bot resolvendo", "% de handoff pra humano" | `lionchat_reports_list_6` ou `lionchat_reports_list_14` |
 | "exportar planilha de agentes/inboxes/labels/times" | `_7` / `_8` / `_9` / `_10` (CSV) |
 | "horário de pico", "quando tem mais demanda" | `lionchat_reports_list_13` |
@@ -233,6 +235,35 @@ Retorna pontos (data + valor) para UM `metric` por vez:
 - `business_hours`: `true` faz médias contarem só o horário de atendimento
 - `timezone_offset`: deslocamento de fuso (horas) — afeta como os pontos são agrupados por dia/hora
 
+### `lionchat_reports_drilldown` — As conversas por trás de um ponto do gráfico (2026-09-25)
+**Use quando:** "quais conversas são essas 40 do dia 12?", "por que a terça teve pico?", "quem demorou
+naquela semana?"
+
+É o mesmo que clicar numa barra do gráfico nos Relatórios do painel. Conta com a **mesma régua** que
+desenhou a barra — então a lista bate com o número do ponto (ex.: por etiqueta conta pela data em que a
+etiqueta foi APLICADA, não pela criação da conversa).
+
+Fluxo: chame `lionchat_reports_list_5` → pegue o `timestamp` do ponto → chame esta ferramenta com:
+- `metric`: a MESMA 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étrica de bot ou fora da lista = 422 `invalid metric`.
+- `bucket_timestamp`: o `timestamp` do ponto (Unix em segundos).
+- `group_by`, `type`, `id`, `timezone_offset`, `business_hours`: os MESMOS usados na série — é isso
+  que define o começo e o fim do ponto. `group_by` diferente = outro recorte e a lista não bate.
+- `since` / `until`: o período do relatório (recorta o primeiro e o último ponto quando o período começa
+  ou termina no meio de uma semana/mês).
+- `page`: 25 conversas por página, mais recentes primeiro.
+
+Resposta: `{ meta: { metric, since, until, page, per_page, total_count, visible_count, hidden_count },
+payload: [{ id, display_id, status, created_at, contact_name, inbox_name, assignee_name, detail }] }`.
+`detail` explica o porquê de cada conversa: `{count}` (quantas mensagens/eventos dela caíram no ponto) nas
+contagens de mensagens e de resoluções, `{seconds}` nas médias de tempo, ou `null`. `display_id` é o número que aparece na
+tela da conversa.
+
+> A lista mostra **só as conversas que a pessoa do token pode abrir**. `hidden_count` diz quantas ficaram
+> de fora por permissão — diga isso ao usuário em vez de concluir que "faltam conversas". Teto de 5.000
+> conversas por ponto. Exige permissão de ver relatórios.
+
 ### `lionchat_reports_list_6` — Resumo do Bot
 **Use quando:** "como tá o bot resolvendo", "quantos handoffs pra humano"
 
@@ -574,7 +605,7 @@ Não é consulta livre: escolha um `widget_type` e preencha **só os campos daqu
 | `calls_report` | `dimension` (agent/inbox) · `scope_type` (só `inbox`, opcional — recorte por caixa, desde 27/08/2026) + `scope_id` · `time_range` — ligações / atendidas / não atendidas / não concluídas / tempo total / tempo médio | — |
 | `lead_origin` | `time_range` | `liontrack` |
 | `agent_report` | `dimension` (agent/team/inbox) · `scope_type`+`scope_id` · `columns[]` · `time_range` | — |
-| `eclinica_no_show` | `dimension` (unit / operator / date) · `time_range` · `no_show_over_scheduled` (true/false, nasce desligada) — faltas na agenda da e-Clínica: agendados / compareceram / faltaram / desmarcados / sem desfecho / % de falta (o rótulo da coluna declara a base) | `eclinica_integration` |
+| `eclinica_no_show` | `dimension` (unit / operator / date) · `time_range` · `no_show_over_scheduled` (true/false, nasce desligada) · `only_first_visit` (true/false, nasce desligada) — faltas na agenda da e-Clínica: agendados / compareceram / faltaram / desmarcados / sem desfecho / % de falta (o rótulo da coluna declara a base) | `eclinica_integration` |
 | `eclinica_conversion` | `dimension` (unit / operator) · `time_range` · `count_retorno_as_consulta` (true/false, nasce LIGADA) — consultas que viraram procedimento: consultas / viraram procedimento (até 60 dias) / % / procedimentos / não classificado | `eclinica_integration` |
 
 **Os dois blocos da e-Clínica (09/09/2026)** leem os eventos da agenda (`eclinica_webhook_events`) e
@@ -594,9 +625,20 @@ só existem em conta com a integração ligada. Três regras que mudam o número
 - **`no_show_over_scheduled`** (true/false, nasce desligada — 10/09/2026): ligada, a % de falta passa a
   ser `faltaram / agendados`, e a unidade que não anota desfecho aparece como a melhor da rede; o rótulo
   da coluna declara qual base está valendo. Aceita `"true"`/`"false"` em texto; outro valor = 422.
+- **`only_first_visit`** (true/false, nasce desligada — 28/09/2026, só no `eclinica_no_show`): ligada, a
+  tabela conta **só a consulta inicial** — retorno, sessão de tratamento e procedimento ficam de fora — e
+  o rótulo da primeira coluna troca de "Agendados" para "Consultas iniciais". A regra lê o TEXTO do
+  compromisso, porque a clínica escreve o tipo por extenso: começa com `CONSULTA` **e** não contém
+  `RETORNO`. Medido na conta 56 (01 a 24/09/2026): "CONSULTA INICIAL" 1.445 vezes e "CONSULTA DE RETORNO"
+  192; Sorocaba tem 1.023 compromissos para 99 consultas iniciais. Use quando o pedido falar em primeira
+  consulta, consulta inicial, paciente novo ou primeiro atendimento. Aceita `"true"`/`"false"` em texto;
+  outro valor = 422.
 - no bloco de conversão, **a lista de nomes de procedimento foi abolida** (10/09/2026): começa com
   `CONSULTA` ou contém `RETORNO` (em qualquer posição) é consulta; **todo o resto que tem paciente é
-  procedimento**. Antes, 1.961 agendamentos em 30 dias (13,8% da agenda) caíam em "Não classificado" só
+  procedimento**. Desde 28/09/2026 o `RETORNO` é testado ANTES do prefixo `CONSULTA`: até ali
+  "CONSULTA DE RETORNO" era lido como consulta NOVA (192 agendamentos em 24 dias, 9,8% do que o bloco
+  contava como consulta). Com `count_retorno_as_consulta` ligada o número não muda; só muda para quem a
+  desligou — e ali é o conserto do que a chavinha sempre prometeu. Antes, 1.961 agendamentos em 30 dias (13,8% da agenda) caíam em "Não classificado" só
   por escrita diferente do nome ("ONDAS 1/3" x "ONDAS DE CHOQUE").
 - **`count_retorno_as_consulta`** (true/false, nasce LIGADA — 10/09/2026): ligada, o bloco responde "de
   toda consulta atendida, quantas viraram tratamento"; desligada, "do paciente NOVO, quantos fecham" — o
@@ -629,7 +671,7 @@ IDs de etiqueta**, nunca nome de métrica).
 | `series` | `{series: [{timestamp, value}]}` | `timestamp` é unix em segundos. As duas métricas de tempo vêm em **segundos** e trazem também `count` por ponto |
 | `categories` | `{categories: [{label, value}]}` | `funnel_stages` vem **na ordem das etapas do funil**, nunca por valor — não reordene |
 | `scalar` | `{value, total, secondary}` | Use o `total` para separar "ninguém respondeu" de "zero legítimo". **SLA sem nenhum prazo aplicado devolve 100.0** — não anuncie "100% de cumprimento" sem olhar o total |
-| `table` | `{dimension, columns, rows, total}` | O `total` **não é a soma das linhas** (contagem própria por métrica). As linhas são os membros **atuais**: quem saiu da equipe some da linha e continua no total |
+| `table` | `{dimension, columns, rows, total}` | O `total` **não é a soma das linhas** (contagem própria por métrica) e pode ser MENOR que ela — a mesma conversa atribuída a duas pessoas no período aparece nas duas linhas e conta uma vez no total. **Desde 28/09/2026 quem saiu da conta TEM linha**, marcada com `former: true` (antes sumia e ficava só no total). Cada linha leva `entity_id` (o código do atendente/equipe/caixa) — **use ele para identificar**, nunca o `label`: dois cadastros podem ter o mesmo nome visível. O total ainda pode ser MAIOR que a soma: ele inclui quem não tem linha (acesso de suporte, e quem saiu sem nome guardado) |
 
 ### Armadilhas que fazem o bloco sair errado
 

package/endpoints.json

@@ -5528,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": [
    {
@@ -5597,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"
   ]
  },
  {
@@ -6410,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",
@@ -6437,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",
@@ -10494,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": "Body da requisição"
+    "description": "Token da autenticação (aceita {{variáveis}}, ex. {{account.custom_attribute.minha_chave}})."
    },
    {
-    "name": "timeout",
+    "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": "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": "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",
@@ -10634,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",
@@ -10732,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",
@@ -15314,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)",
@@ -15349,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",
@@ -15391,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",
@@ -15433,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.)",
@@ -15468,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",
@@ -15510,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",
@@ -15552,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",
@@ -15594,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",
@@ -15636,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 })",
@@ -15659,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": [
    {
@@ -15671,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: ... }",
@@ -15694,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": [
    {
@@ -15706,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",
@@ -15724,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",
@@ -15755,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",
@@ -15797,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: ... }",
@@ -15884,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",
@@ -25863,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: [...]}}",
@@ -26691,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",
@@ -26739,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 }",
@@ -26788,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 }",
@@ -28057,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": [
    {
@@ -28093,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",
@@ -28115,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",
@@ -33375,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": [
    {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "1.25.0",
+  "version": "1.26.0",
   "description": "MCP server for LionChat API — 547 tools + 10 resources + 9 prompts. Audit-log aware, completion API, progress notifications.",
   "type": "module",
   "main": "dist/index.js",