@lionchat/mcp-server 1.30.0 → 1.32.0

package/dist/docs/resources/kanban-deep-dive.md

@@ -16,7 +16,7 @@ Container de etapas. Conta pode ter vários funis (ex: "Vendas", "Pós-venda", "
 | `archived` | Boolean — funis arquivados não aparecem na UI ativa |
 | `active` | Boolean — controla se aceita movimentação |
 | `settings` | jsonb — config customizada (ex: cores, automações) |
-| `settings.agents` | agentes do funil. Grave `[{"id": <id do agente>}]` — cada item é um OBJETO, nunca número solto (ids de `lionchat_agents_list`); o sistema completa nome, e-mail, cargo e foto — é o que o editor do funil, o card e a conversa mostram. Agente de outra conta fica sem nome e sem acesso. `settings` é substituído INTEIRO no update: leia o funil antes e reenvie goals+agents+teams+automations. |
+| `settings.agents` | agentes do funil. Grave `[{"id": <id do agente>}]` — cada item é um OBJETO, nunca número solto (ids de `lionchat_agents_list`); o sistema completa nome, e-mail, cargo e foto — é o que o editor do funil, o card e a conversa mostram. Agente de outra conta fica sem nome e sem acesso. `settings` é substituído INTEIRO no update: leia o funil antes e reenvie goals+agents+teams+automations. `settings.removed_stages` (lista das etapas já excluídas, usada para redirecionar cards) é do SERVIDOR: se você mandar essa chave ela é ignorada, sem erro, e o servidor a mantém sozinho. |
 
 ### Stages (Etapas) — dentro de `funnel.stages`
 
@@ -55,11 +55,55 @@ Stages NÃO são tabela separada. São armazenadas como jsonb dentro do Funnel:
   da mesma posição, senão pra primeira. **Confira o `funnel_stage` da resposta**: pode ser diferente
   do que você mandou. Leia `funnels_show` antes e use o slug exato.
 - `funnels_update` que tira do `stages` uma etapa com card responde **422 `STAGE_HAS_ITEMS`** com
-  `stages: {"<slug>": <quantos cards>}`. Primeiro mova os cards com `lionchat_funnels_create_2`
-  (`POST /funnels/{id}/migrate_stage`, `from_stage`, `to_stage` ou `to_funnel_id`) e só então
-  reenvie o funil sem a etapa. Não existe parâmetro de destino no `update` de propósito.
+  `stages: {"<slug>": <quantos cards>}`. **Para EXCLUIR uma etapa que tem cards, use
+  `lionchat_funnels_remove_stage`** (`POST /funnels/{id}/remove_stage`, ver "Excluir etapa" abaixo): ela move
+  os cards para o destino EM SILÊNCIO e apaga a etapa. **Não** use a receita antiga (mover com `migrate_stage` e depois reenviar
+  o funil sem aquela etapa) — o `migrate_stage` (`lionchat_funnels_create_2`) NÃO exclui a etapa: move os
+  cards DISPARANDO tudo o que está ligado ao destino (automações do funil, regras, fluxos, webhooks, conversões)
+  e a etapa de origem continua no funil, só vazia. Usar `migrate_stage` para "limpar antes de excluir" dispara
+  automação e aviso ao cliente por card movido.
 - Funil apagado continua sendo erro (o card não é criado).
 
+### Excluir etapa (20/10/2026) — `lionchat_funnels_remove_stage`
+
+`POST /funnels/{id}/remove_stage` com `from_stage` (CHAVE da etapa a excluir), `to_funnel_id` (obrigatório; pode ser o
+próprio funil) e `to_stage` (CHAVE do destino). Os cards **mudam de etapa e não são apagados**; nada dispara (nenhuma
+automação do funil, regra, fluxo, webhook, conversão nem aviso ao cliente). Desde 20/10/2026 o card passa a contar o
+tempo na etapa nova **a partir da exclusão** (`stage_entered_at` = o instante da exclusão; antes mantinha a data): é o
+que mantém os relatórios de meses passados mostrando cada card onde ele estava ("etapa removida"). Exige
+administrador ou a permissão "gerenciar funis" (sem ela: **401**; vale também para o `migrate_stage`).
+
+**Como a IA deve usar:**
+
+1. `lionchat_funnels_show` para pegar as chaves; conte os cards com `lionchat_funnels_stage_report` (id do funil + a
+   chave em `stage`, com `show_won`, `show_lost` e `show_snoozed` = `true` — sem isso o relatório conta só os abertos
+   não adiados e a etapa parece ter menos cards do que vai mover).
+2. Diga ao usuário quantos cards vão para onde e que a etapa será excluída; **peça o OK uma vez**.
+3. Chame com `confirm: true` — **toda** chamada leva `confirm: true`, inclusive a primeira. A ferramenta trabalha em
+   pedidos curtos (cerca de 8 segundos de cards por pedido, lotes de 125): **repita a chamada, sem perguntar de novo,
+   até vir `done: true`**.
+
+**Respostas:**
+
+| Resposta | Significa |
+|---|---|
+| `200 {done: true, moved, stage_removed: true, funnel}` | Terminou. `moved` é o TOTAL da exclusão inteira |
+| `200 {done: true, moved: 0}` (sem `stage_removed`) | A etapa já estava excluída para o mesmo destino (fim normal, por exemplo repetição do pedido) |
+| `200 {done: false, moved, remaining, reason}` | Ainda falta. `moved` é só deste pedido. `remaining` = cards que faltam; **nulo** = a contagem não coube no tempo (não é erro, repita); **100001** = "mais de 100 mil" |
+
+`reason` quando `done: false`: `tempo` = repita agora; `travado` ou `faxina` = o banco estava ocupado, espere ~30 s e
+repita; `destino_excluido` = a etapa de destino deixou de existir, pergunte ao usuário outro destino; `assumido` =
+OUTRA pessoa assumiu a exclusão desta etapa (vêm `holder_name` e `to_stage_name`, que podem ser nulos): avise quem está
+excluindo e para onde (sem nome, diga só "outra pessoa está excluindo esta etapa") e **pare, não repita**. Duas
+respostas seguidas com `moved: 0` e `done: false` = algo está preso: **pare e avise**.
+
+**Erros:** `422 {error, code}` com `code` = `DESTINATION_NOT_FOUND`, `SAME_STAGE`, `LAST_STAGE` (o funil precisa ficar
+com pelo menos uma etapa), `ORIGIN_NOT_FOUND`, `STAGE_ALREADY_REMOVED_BY_OTHER`, `FINAL_SAVE_FAILED` (os cards já
+foram movidos mas o funil não pôde ser salvo) e `FUNNEL_INVALID` — o texto de `error` já vem no idioma da conta,
+mostre-o ao usuário. `409 STAGE_REMOVAL_IN_PROGRESS` = outra pessoa está excluindo esta etapa agora (`holder_name` e
+`to_stage_name` podem ser nulos): avise e pare. **Qualquer Salvar do funil (com ou sem `stages`) também pode dar `409 FUNNEL_BUSY`**
+(o funil está sendo alterado agora, por outra pessoa ou por uma exclusão de etapa): espere alguns instantes e repita.
+
 ### KanbanConfig (Configuração Global do Kanban) — CRÍTICO
 
 **Tabela separada do Funnel.** 1:1 com a conta. Guarda configurações que valem pra TODOS os funis. Tem 5 campos jsonb importantes:
@@ -141,6 +185,8 @@ Um card individual dentro de uma etapa.
 | `activities` | jsonb array — log de atividades |
 | `checklist` | **O que fica guardado:** jsonb array de tarefas do card (item: `text`/`completed`/`position` + `group_id`/`group_name` opcionais para agrupar). **O que a API devolve é OUTRA coisa** — ver o aviso logo abaixo |
 | `timer_started_at`, `timer_duration` | Timer interno do card |
+| `effective_status` | **Só na resposta, não é coluna (11/10/2026).** A situação EFETIVA do card: `open`, `snoozed` (adiado), `won` ou `lost`. `item_details.status` continua `open` num card adiado — quem quer saber se ele está adiado lê ESTE campo. Vem em `kanban_items_list`/`_show`/`_filter`/`_search`, na busca geral, na ficha do contato e no card embutido em `conversations_show`. Ver "Card adiado" no fim |
+| `snoozed_until` | **Só na resposta (11/10/2026).** Até quando o card está adiado (ISO 8601); `null` quando não está adiado |
 
 > **ATENÇÃO — na maioria das respostas o `checklist` NÃO é a lista de tarefas, e sim um resumo com
 > os números:** `{ total_count, completed_count, groups: [{ group_id, group_name, total_count,
@@ -198,9 +244,9 @@ Como gravar pelo `lionchat_kanban_items_update` (`kanban_item.item_details`):
 - Mandar objeto (`{"origem_lead": "Facebook Ads"}`) no lugar da lista **APAGA todos os campos do card**: o
   servidor só aceita itens `{name, type, value}` e o objeto vira vazio.
 - Lista fechada de chaves do `item_details` (outras são descartadas em silêncio): title, description, status,
-  reason, win_reason, loss_reason, attributed_to, duplicated_from_id, priority, value, currency,
-  custom_attributes, offers, closed_offers, closed_offer, deadline_at, scheduling_type, scheduled_at,
-  conversation_id, automations, notes.
+  reason, win_reason, loss_reason, attributed_to, co_attributed_to (13/10/2026, ver "Co-participante da venda"),
+  duplicated_from_id, priority, value, currency, custom_attributes, offers, closed_offers, closed_offer, deadline_at,
+  scheduling_type, scheduled_at, conversation_id, automations, notes.
 - Para mudar UM campo sem reenviar a lista, as ações de automação/macro `update_card_attribute`
   (`[{funnel_id, attribute_key: "<nome do campo>", value}]`) mexem só naquela entrada.
 
@@ -284,6 +330,10 @@ Log automático de eventos do card:
 
 Tipos comuns: `created`, `stage_changed`, `agent_assigned`, `agent_removed`, `note_added`, `value_changed`, `priority_changed`, `archived`.
 
+Desde 11/10/2026 também `item_snoozed` (o card foi adiado — leva `snoozed_until`) e `item_unsnoozed` (o card adiado
+abriu — leva `reason`: `person` = alguém abriu, `automation` = automação, macro ou fluxo, `due` = chegou a data; e a
+data que estava marcada).
+
 Quem fez: `by_user_id`/`user` traz a pessoa; ação de automação ou flow vem com o nome da regra/fluxo;
 ação da IA (desde 21/08/2026 — entra com o próximo deploy do app depois de 21/08/2026) vem como
 `"IA: <nome do assistente>"` com `id` nulo — antes saía sem autor. Ao explicar um histórico de card,
@@ -503,7 +553,7 @@ PUT /api/v1/accounts/43/funnels/43
 | trigger_type | trigger_value |
 |---|---|
 | `card_created` | `"card_created"` (literal — NUNCA vazio) |
-| `status_change` | `"won"` ou `"lost"` |
+| `status_change` | `"won"`, `"lost"` ou `"snoozed"` (desde 11/10/2026: roda quando o card é ADIADO; trocar a data de um card já adiado NÃO roda de novo). NÃO existe `"open"` aqui |
 | `stage_moved` | chave da etapa de DESTINO no hash `funnel.stages` (ex. `"agendar_instalacao"` — a chave, NÃO o campo `id` interno) |
 
 **Ações (`action` + `action_config`):**
@@ -518,6 +568,7 @@ PUT /api/v1/accounts/43/funnels/43
 | `send_webhook` | `{webhook_url}` | POST com payload completo do card (fire-and-forget) |
 | `apply_checklist_template` | `{template_id}` | Template de `kanban_config.checklist_templates`; aditivo (appenda) — cada aplicação vira um grupo (carimba `group_id`/`group_name` nos itens) |
 | `update_checklist` | `{checklist_updates: [{checklist_item_id, completed, text}]}` | Não aparece na UI — só via API |
+| `create_task` (20/10/2026) | `{title, description?, task_type, agenda_id?, priority?, occupies_agenda?, due: {amount, unit: 'hours'\|'days', at?: 'HH:MM', business_days?: true}, responsible: {mode: 'card_owner'\|'fixed'\|'funnel_rotation'\|'team_rotation', fallback_user_id (card_owner), user_id (fixed), team_id (team_rotation)}}` | Cria uma tarefa COMUM da Agenda presa ao card (ver "Tarefa automática do card" abaixo). Exige a Agenda unificada ligada na conta |
 
 **Regras críticas (gravar diferente disso = automação perdida ou morta):**
 
@@ -528,6 +579,32 @@ PUT /api/v1/accounts/43/funnels/43
 
 Use para: "ao ganhar um card de Vendas → criar automaticamente em Pós-Venda na etapa Agendar Instalação" (`status_change`/`won` + `duplicate_item`).
 
+#### Tarefa automática do card — ação `create_task` (20/10/2026)
+
+- `title` é obrigatório (texto; aceita variáveis do card). `task_type`: um dos 7 de fábrica ou um tipo ativo da conta.
+  `agenda_id` nulo = a agenda padrão da conta. `priority`: `none|low|medium|high|urgent`.
+- **Prazo (`due`)**: `unit: 'hours'` aceita `amount` de 1 a 720; `unit: 'days'` aceita 0 a 365, com `at` ("HH:MM") e
+  `business_days: true` (dias úteis) **só em dias**. Dia útil = segunda a sexta **sem feriado de dia inteiro** da agenda
+  da tarefa (feriado de meio período não conta). O fuso é o da agenda da tarefa. Prazo que já passou nasce atrasado,
+  nunca é empurrado.
+- **Responsável (`responsible.mode`)**: `card_owner` (primeiro responsável do card; senão o da conversa; senão a reserva `fallback_user_id`,
+  obrigatória), `fixed` (exige `user_id`), `funnel_rotation` (rodízio de quem acessa o funil) e `team_rotation` (exige
+  `team_id`).
+- **Formato conferido no Salvar**: regra `create_task` NOVA ou alterada é conferida uma a uma; regra torta recebe 422 que
+  diz a posição da regra e o campo a consertar, e as demais regras do funil não são afetadas.
+- **Uma tarefa por acontecimento** (repetir o gatilho do mesmo acontecimento não duplica). Card importado por planilha
+  não cria; card importado e movido depois por uma pessoa cria.
+- A tarefa nasce **presa ao card** (campo `kanban_item_id` da tarefa; `occupies_agenda` diz se ela bloqueia o horário).
+  Ao **excluir o card** (`lionchat_kanban_items_destroy`), só é apagada a tarefa presa a ESTE card que seja
+  SIMPLES: sem conversa, sem contato, sem agendamento, sem sessão de programa, sem anexo, que não veio do Google
+  Agenda e que não é somente leitura. Toda outra tarefa presa ao card apenas se SOLTA (continua na agenda, na
+  conversa e no contato), e a tarefa que só aponta para o card por `linked_kanban_item_id` também só se solta.
+  **A tarefa AUTOMÁTICA de um card que TEM conversa grava a conversa** (o servidor associa a conversa do card à
+  tarefa), portanto NÃO é "simples": ao excluir esse card ela sobrevive e fica na conversa. Só a tarefa automática
+  de card SEM conversa morre com o card. Conversa e contato nunca são apagados. Antes de excluir, avise o usuário
+  de que as tarefas simples presas ao card também somem.
+- Excluir etapa com `remove_stage` **não** dispara esta ação (nem nenhuma outra); `migrate_stage` dispara.
+
 ### Sistema 2: AutomationRule global — eventos da conta
 
 `AutomationRule` é o motor geral da conta (mensagens, contatos, conversas, e também eventos Kanban). Bem mais genérico, com sistema completo de condições/ações.
@@ -647,6 +724,9 @@ Cada card pode receber atributos custom de 3 origens diferentes. **A escolha do
    `funnel_stage` com o slug que aparece em `kanban_items_show` e compare com `funnels_show`.
 3. `position` está faltando? (cards sem position vão pro fim)
 4. Está em outro funil? (mover entre funis muda `funnel_id`)
+5. Está **adiado**? (desde 11/10/2026) Card adiado sai da coluna e só aparece com o botão **Adiados** ligado no topo
+   do quadro. Confira `effective_status`/`snoozed_until` em `lionchat_kanban_items_show`: ele volta sozinho na data, ou
+   abra agora com `lionchat_kanban_items_unsnooze`. Ver "Card adiado" abaixo.
 
 ## Diagnóstico: "Valor do pipeline errado"
 
@@ -747,3 +827,77 @@ com o `retroativo_em` certo.
 
 A hora é montada em **UTC**, com o horário atual no dia escolhido. É o mesmo motivo do diagnóstico
 acima: o relatório compara o carimbo como texto, então a data escolhida tem que ser a data contada.
+
+## Card adiado — "Adiar até" (2026-10-11)
+
+O card ganha uma situação a mais: **Adiado** — "este negócio só volta a importar no dia X". Ele sai da coluna e, na
+data marcada, **abre sozinho** e volta para a coluna (disparando o fluxo "Card aberto", se houver).
+
+| Regra | Detalhe |
+|---|---|
+| O que é | Situação **do card**, não da conversa. Mensagem do cliente NÃO abre o card; adiar o card não mexe na conversa. |
+| Como fica gravado | `item_details.status` **continua `open`** — o adiamento mora numa tabela à parte (`kanban_item_snoozes`). Por isso o aplicativo de celular, os webhooks do cliente e a IA de atendimento continuam vendo `open`/`won`/`lost`. Para saber se está adiado, leia `effective_status` (`snoozed`) e `snoozed_until`. |
+| Quem pode | Quem pode editar o card. Só card **aberto** pode ser adiado (ganho/perdido = 422). |
+| Data | Pelo menos **1 hora** à frente (menos que isso = 422). Sem prazo máximo. Adiar um card já adiado **troca a data**. |
+| O que NÃO encerra | Mover de etapa ou de funil, editar, nota, tarefa, responsável. |
+| O que encerra | Marcar **ganho** ou **perdido** (por qualquer caminho); **abrir** de propósito (`lionchat_kanban_items_unsnooze`, `lionchat_kanban_items_create_2` com `status: "open"`, ação "Aberto" de automação/macro/fluxo); e a chegada da data. |
+| `status: "open"` no `lionchat_kanban_items_update` | **NÃO abre** card adiado (é o mesmo salvar que o aplicativo faz o tempo todo). Para abrir, use `lionchat_kanban_items_unsnooze` ou o `change_status`. |
+| Na data | O sistema abre o card numa rodada de até ~5 minutos depois da hora e dispara "Card aberto" **uma vez por card**. Esse fluxo entra na fila de disparos agendados: depois dos lembretes de consulta e, em caixa QR Code, no ritmo da caixa (um lote grande que vence junto sai aos poucos). |
+| "Criar card" acha um adiado | Trata como card que **já existe**: não cria outro, move se a etapa for diferente e **não muda a situação** (continua adiado). Vale para automação, macro, fluxo e IA. |
+
+**Ferramentas:**
+- `lionchat_kanban_items_snooze` — `POST .../kanban_items/{id}/snooze` com `snoozed_until`.
+- `lionchat_kanban_items_unsnooze` — `DELETE .../kanban_items/{id}/snooze` (abre agora e dispara "Card aberto").
+- Automações de dentro do funil (`settings.automations`): gatilho `status_change` com `trigger_value: "snoozed"`
+  ("Adiado" na tela do funil) roda quando o card passa de aberto para adiado.
+- Automação e macro: ação `snooze_kanban_item` — `[{"funnel_id": 31, "amount": 3, "unit": "days"}]` (`unit` `hours`
+  ou `days`; `amount` inteiro, 1 ou mais). Em regra de evento de CARD basta `[{"amount": 3, "unit": "days"}]` (o card
+  é o do evento). Diferente das outras ações de card, ela **falha visível** quando não dá para adiar (card fechado,
+  sem card no funil, tempo inválido) — nunca passa verde sem adiar.
+- Fluxo: ação `snooze_kanban_item`, gatilhos `card_opened` ("Card aberto") e `card_snoozed` ("Card adiado") e
+  condição `kanban_snoozed`. Ver o resource do FlowBuilder.
+
+**Onde o adiado aparece e como filtrar:**
+
+| Lugar | Comportamento |
+|---|---|
+| Quadro (`lionchat_kanban_items_list`) | Sem nenhum `show_*`, a lista traz TODAS as situações (o adiado vem com `status: "open"` e `effective_status: "snoozed"`). Com qualquer `show_*`: `show_open` vale `true` salvo se vier `"false"` (= aberto e **não** adiado) e `show_snoozed=true` inclui os adiados. **Só os adiados:** `show_snoozed=true` **e** `show_open=false`. Esta lista **ignora** `statuses`. |
+| Filtro rico (`lionchat_kanban_items_filter`), exportação e relatório da etapa | `statuses: ["open"]` = aberto e **não** adiado; `statuses: ["snoozed"]` = adiados. |
+| Ficha do contato (`lionchat_contacts_kanban_items_list`) | `status=snoozed` = adiados; `status=open` deixa os adiados de fora. |
+| Busca geral (`lionchat_search_kanban_items`) | `kanban_filters` com `statuses: ["snoozed"]`. |
+| Números | `lionchat_funnels_open_counts` conta aberto e **não** adiado. `lionchat_funnels_stage_report` traz a linha `snoozed` — mas esse relatório SEMPRE aplica os botões de situação com o padrão da tela: sem `show_*` conta só os abertos não adiados e as linhas `won`/`lost`/`snoozed` voltam zeradas (mande `show_won`/`show_lost`/`show_snoozed=true`). No relatório agregado (`lionchat_kanban_items_list_3`), `statusDistribution.open` **continua incluindo** os adiados (é a soma que o aplicativo lê) e `statusDistribution.snoozed` vem ao lado: abertos de verdade = `open − snoozed`. Parados, maiores negócios, ranking e previsão já deixam o adiado de fora. |
+| Histórico do card | `item_snoozed` (com a data) e `item_unsnoozed` (com o motivo). |
+
+**Laço de cadência é permitido:** um fluxo "Card aberto" que manda mensagem e adia de novo roda até alguém parar (no
+máximo uma volta por hora por card). Avise o cliente antes de montar. **Abrir à mão também dispara "Card aberto"**: se o
+fluxo manda mensagem, o cliente recebe na hora.
+
+## Co-participante da venda (vendedor + SDR) — 2026-10-13
+
+No ganho, além do vendedor (`attributed_to`, "Atribuir ganho a"), dá para marcar **UM co-participante** — ex.: o SDR
+que trouxe a venda. A venda conta INTEIRA para o vendedor; o co-participante tem números próprios no relatório.
+Marcar alguém como co-participante **não dá acesso ao card** nem o põe como responsável.
+
+**Como gravar:**
+- Junto com o ganho: `lionchat_kanban_items_create_2` (`change_status`) com `status: "won"` e `co_attributed_to: <id do
+  agente>`. Fora de `won` o parâmetro é ignorado.
+- Depois, num card JÁ ganho: `lionchat_kanban_items_update` com `kanban_item.item_details.co_attributed_to`. Para tirar,
+  mande `null`.
+- Mande SÓ o id (número). O nome (`co_attributed_name`) o próprio card preenche — nunca envie.
+- Objeto ou lista no lugar do id = 422 antes de gravar.
+
+**Recusas (422, com `error` legível):** id que não é número; pessoa que não é membro da conta; o próprio vendedor do
+card; pessoa sem acesso ao funil (vale: funil sem lista de agentes, agente da lista do funil ou dos times dele,
+administrador, ou quem já é responsável do card). A conferência só roda quando o valor MUDA — quem perdeu o acesso
+depois não trava outro salvamento.
+
+**O que mais saber:**
+- Reabrir ou marcar como perdido **apaga** o co-participante (o campo só existe em card ganho).
+- A ação "marcar como ganho" de fluxo, automação e macro NÃO marca co-participante (decisão do dono): ganho por ação
+  nasce sem ele, que entra depois pela tela, por `lionchat_kanban_items_update` ou pela planilha de "Importar vendas"
+  (coluna de co-participante, por nome ou e-mail).
+- Duplicar o card não copia o co-participante.
+- Histórico: marcado junto com o ganho vai dentro do registro da mudança de status; marcado depois gera
+  `co_participant_changed` (antes e depois, com nome e quem marcou).
+- Números: `coParticipantRanking`, `sharedSalesSummary`/`sharedSalesBySeller` (com `include_shared_sales=true`) no
+  relatório agregado e a lista `lionchat_kanban_items_shared_sales` — ver `lionchat://docs/filtros-e-relatorios` §4.

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

@@ -155,7 +155,8 @@ conversa antiga que NÃO aparece no relatório de hoje (régua antiga por criaç
 | "retrospectiva do ano" | `lionchat_reports_list_15` |
 | "satisfação", "CSAT", "nota dos clientes" | `lionchat_csat_metrics` |
 | "SLA", "cumprimento de prazo" (se a conta tiver Enterprise) | `lionchat_sla_metrics` |
-| "quantos agendamentos", "taxa de comparecimento", "agendamentos por tipo/atendente" | `lionchat_booking_reports` (ver "Agendamentos" no fim deste guia) |
+| "quantos agendamentos", "taxa de comparecimento", "agendamentos por tipo/atendente" | `lionchat_booking_reports` (ver "Agendamentos" no fim deste guia). Conta sem Booking (relatório zerado, compromissos marcados à mão na Agenda): `source=agenda` |
+| "vendas com SDR", "comissão dividida", "quanto cada SDR trouxe", "vendas sozinho x compartilhadas" | `lionchat_kanban_items_list_3` (`coParticipantRanking`; `include_shared_sales=true` para o quadro) e a lista `lionchat_kanban_items_shared_sales` — ver `lionchat://docs/filtros-e-relatorios` §4 |
 
 ---
 
@@ -523,7 +524,9 @@ mesma conta misturar duas lojas e não bater com o relatório da Meta. Com qualq
   `orphan_leads` (leads sem conversa ainda), `unique_leads` (deduplicados por TELEFONE),
   `won_leads` (leads em cards de estágio de Ganho) e `conversion_rate`.
 - `unclassified` — `{conversations, won, conversion_rate}` das conversas SEM origem (entram em `totals` mas nao em `by_platform`;
-  a venda de uma conversa iniciada pela propria empresa mora aqui).
+  a venda de uma conversa iniciada pela propria empresa mora aqui). Desde 16/10/2026 a conversa criada pelo nosso
+  lado (automação, fluxo, formulário) nasce com a origem que a ficha do contato já tinha; antes ela caía aqui
+  até o cliente responder. Vale só de hoje pra frente: as conversas antigas nesse caso continuam sem origem.
 - Arrays de quebra: `by_platform`, `by_kind`, `by_campaign`, `by_adset`, `by_creative`. Cada linha
   tem `{value, conversations, won, conversion_rate}`.
 
@@ -868,6 +871,12 @@ Resposta: `totals` (`total`, `pending`, `completed`, `cancelled`, `snoozed`, `at
 `attendance_rate`, `attendance_basis`), `timeline`, `by_event_type`, `by_agent`, `by_origin` e
 `treatments`.
 
+- **`source=agenda`** (14/10): troca a fonte para os compromissos marcados À MÃO na Agenda, sem
+  Booking — ligação, reunião, videochamada e tipos da conta (tarefa comum e evento do Google ficam
+  fora). Use quando a conta não usa Booking e o relatório normal vem zerado. Nessa opção o tipo vai em
+  `task_type` (não `event_type_id`; a lista vem em `appointment_types`), `by_agent` conta pelos
+  responsáveis (quem tem dois aparece nas duas linhas, os totais contam uma vez), `by_origin` vem vazio
+  e `treatments` vem nulo.
 - **`attended` / `no_show`** (15/09) são as marcas Compareceu/Faltou do compromisso
   (`account_tasks.attendance`), um eixo próprio: **não mudam a situação** — compromisso "faltou"
   continua `pending` até alguém concluir ou cancelar, igual a Agenda mostra.

package/dist/docs/resources/troubleshooting.md

@@ -191,8 +191,26 @@ Feature flag específica (ex: `feature_kanban`, `feature_captain`) está OFF.
 
 ### KanbanItem
 - `"STAGE_HAS_ITEMS"` (no `funnels_update`) — você tentou remover uma etapa que ainda tem card;
-  `stages` na resposta diz quantos. Mova com `migrate_stage` antes. (Card criado em etapa
-  inexistente NÃO dá erro: é redirecionado — confira o `funnel_stage` devolvido.)
+  `stages` na resposta diz quantos. **Para excluir a etapa, use `lionchat_funnels_remove_stage`** (move os cards
+  em silêncio e apaga a etapa; repita a chamada com `confirm: true` até `done: true`; ver "Excluir etapa" no
+  `kanban-deep-dive.md`). Não use `migrate_stage` para isso: ele só move os cards (disparando automações) e não
+  exclui a etapa. (Card criado em etapa inexistente NÃO dá erro: é redirecionado — confira o `funnel_stage`
+  devolvido.)
+- **`401` em `lionchat_funnels_create_2` (`migrate_stage`) ou `lionchat_funnels_remove_stage`** — o usuário não é
+  administrador e não tem a permissão "gerenciar funis". Não repita nem tente outro caminho: diga ao usuário
+  que precisa dessa permissão (ou de um administrador) para mover etapa inteira ou excluir etapa.
+- **`409 STAGE_REMOVAL_IN_PROGRESS`** (`remove_stage`) — outra pessoa está excluindo a mesma etapa agora. Avise
+  "outra pessoa está excluindo esta etapa" (com `holder_name`, se vier) e pare; não repita. O mesmo vale para
+  `200 {done: false, reason: "assumido"}` no meio da exclusão.
+- **`409 FUNNEL_BUSY`** (`funnels_update`) — o funil está sendo alterado agora (outra pessoa ou
+  uma exclusão de etapa). Espere alguns instantes e repita o Salvar.
+- **`remove_stage` devolve `done: false`** — leia `reason`: `tempo` repita agora; `travado`/`faxina` espere
+  ~30 s e repita; `destino_excluido` pergunte outro destino ao usuário; `assumido` avise e pare. Duas respostas
+  seguidas com `moved: 0` e `done: false` = algo preso: pare e avise. `remaining` nulo não é erro;
+  100001 significa "mais de 100 mil".
+- **422 em `lionchat_tasks_update` (ou `_create`) com `kanban_item_id`** — a tarefa é um agendamento, uma sessão
+  de programa ou um evento do Google, que não podem ser presos a um card; ou o card não existe, é de outra
+  conta ou a pessoa não o enxerga. Só tarefa comum se prende a card.
 - `"conversation_display_id must exist"` — conversa não existe ou foi deletada
 - `"position must be a positive integer"` — não pode ser negativo
 

package/dist/tools.js

@@ -359,7 +359,7 @@ function registerListCategoriesTool(server, allEndpoints) {
 // Helps LLMs build correct flow_data without hitting trial-and-error on
 // node types, action keys, source handles, etc.
 function registerFlowsSchemaReferenceTool(server) {
-    const reference = `LIONCHAT FLOW BUILDER — SCHEMA REFERENCE (atualizado 2026-09-29)
+    const reference = `LIONCHAT FLOW BUILDER — SCHEMA REFERENCE (atualizado 2026-10-20)
 
 flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
 
@@ -373,12 +373,12 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
 - ai_tool: ferramenta que o AI Agente invoca. Criar via lionchat_flow_tools_create (NAO flows_create!),
   com tool_name (snake_case, max 50) + tool_description (max 500). SEM inbox_ids. No 'end' OBRIGATORIO.
   Nodes permitidos em ai_tool: start, end, api, condition, set_variable, ai, randomizer, action,
-  send_message, note (SEM wait, wait_response, update_group). No action de ai_tool NAO use keys da
-  aba Sistema (send_webhook/start_flow/send_conversion). Vincular ao assistente: POST /flow_tools/{id}/assistants.
+  send_message, note (SEM wait, wait_response, update_group, ai_call). No action de ai_tool NAO use keys da
+  aba Sistema (send_webhook/start_flow/send_conversion) nem create_account_task. Vincular ao assistente: POST /flow_tools/{id}/assistants.
   Testar: POST /flow_tools/{id}/run.
 - action (Fluxo de Acoes, 17/09/2026): NAO pertence a caixa nenhuma e roda em QUALQUER conversa de
   QUALQUER caixa — inclusive grupo. So executa acoes: NAO pode ter send_message, wait_response,
-  update_group nem end (a validacao recusa o save inteiro com "contains node types not allowed in
+  update_group, ai_call nem end (a validacao recusa o save inteiro com "contains node types not allowed in
   action flow"). Nodes permitidos: start, action, condition, wait, randomizer, api, ai,
   set_variable, note. Criar via lionchat_flows_create com flow_type:'action', SEM inbox_ids e SEM
   conversation_mode (o backend fixa 'individual'). Aceita os MESMOS gatilhos do conversation e roda
@@ -396,7 +396,7 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
   e viaja no snapshot de versao; ferramenta que ja existe nao muda de comportamento.
 
 ═══ NODE GERAL ═══
-{ "id": "string-unico", "type": "start|send_message|wait_response|condition|action|api|set_variable|wait|randomizer|update_group|ai|end|note", "position": {"x":0,"y":0}, "data": { ... } }
+{ "id": "string-unico", "type": "start|send_message|wait_response|condition|action|api|set_variable|wait|randomizer|update_group|ai_call|ai|end|note", "position": {"x":0,"y":0}, "data": { ... } }
 (activate_flow existe como node LEGADO — nao crie novos; use action start_flow)
 
 ═══ NODE TYPES + source handles ═══
@@ -555,10 +555,19 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
     date_trigger; para disparo em lote, campaign_trigger + Campanha de Fluxo.
     team_changed ({team_ids:[] de STRINGS, vazio = qualquer equipe}), assignee_changed ({agent_ids:[]
     STRINGS, vazio = qualquer atendente}), card_won/card_lost ({funnel_ids:[] STRINGS} — disparam SO quando
-    o STATUS do card vira ganho/perdido, nunca por etapa com esse nome). page_track (LionTrack, so flow
+    o STATUS do card vira ganho/perdido, nunca por etapa com esse nome).
+    card_opened/card_snoozed (NOVOS 11/10/2026, mesma config {funnel_ids:[] STRINGS}): card_snoozed = o card
+    foi ADIADO; card_opened = um card adiado ABRIU (pela data, por alguem ou por automacao) ou um card
+    ganho/perdido foi REABERTO — card NOVO nao dispara (isso e card_created). Pela data o fluxo sai pela fila
+    de disparos agendados (depois dos lembretes; em caixa QR Code no ritmo da caixa), uma vez por card;
+    {{trigger.kanban.previous_status}} (snoozed/won/lost) separa os casos. page_track (LionTrack, so flow
     individual): {track_type:'visited_page'|'event_fired', urls:[...], operator:'contains'|'exact'|
     'starts_with', event_names:[...], event_operator:'equals'|'contains', cooldown_hours (default 24,
     minimo 1 — nao re-dispara pro mesmo contato dentro da janela)}.
+    whatsapp_form_answered (NOVO 17/10/2026): o cliente RESPONDEU um Formulario do WhatsApp (formulario nativo
+    da Meta, ferramenta whatsapp_forms_list). Config {whatsapp_form_id: '<id do NOSSO formulario, STRING>'} —
+    vazio/ausente = qualquer formulario. Dispara na conversa da resposta, DEPOIS do "Salvar em" do formulario
+    (o fluxo ja le o dado gravado); repetir o processamento nao abre o fluxo duas vezes.
     NOVO message_sent (2026-06-11): par do message_received pra mensagens de
     SAIDA (atendente, celular/eco, IA — nota privada NAO) com keywords+match_type; cuidado: acao
     'desativar IA' com esse trigger sem keywords = a propria resposta da IA dispara o flow.
@@ -682,6 +691,14 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
        salvar o flow pela tela nesse estado, a regra e PERDIDA. (Excecoes que nao usam field/valueType
        "variable": regras por attr_key/attrSource="attr_config", business_hours, can_reply, sla_check,
        kanban_*, conversation_has_agent/no_agent, pagetrack_*.)
+  EMPRESA DO CONTATO (NOVO 16/10 — card "Atributo da empresa", so com o modulo Empresas): regra
+    { id, valueType:'attr_config', attrSource:'company', attr_key, operator, value:'', values:[...] }.
+    attr_key = chave do campo PERSONALIZADO da empresa OU cadastro com prefixo: company.name,
+    company.legal_name, company.cnpj (comparado so por digitos), company.phone, company.email,
+    company.address.city, company.address.state. Empresa = a do contato da conversa (no maximo UMA).
+    Contato sem empresa = valor vazio (not_equal/is_empty casam). Modulo desligado = NUNCA casa, nem a
+    negativa. attrSource fora de contact/conversation/card/company NAO casa. Variaveis da empresa em
+    mensagem: {{contact.company.name}} ... {{contact.company.custom_attribute.<chave>}}.
   ORIGEM / CAMPANHA (NOVO 01/09 — preset "Atributo de campanha" da tela): regra de atributo da CONVERSA:
     { id, valueType:'attr_config', attrSource:'conversation', attrScope:'campaign', attr_key:'origin_kind',
       operator:'equal', value:'', values:['paid_ad'] }
@@ -703,7 +720,7 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
     Chaves de campanha: origin_kind, origin_platform, origin_first_kind/_platform, origin_last_kind/_platform,
     ctwa_* (anuncio click-to-WhatsApp: ctwa_ad_id, ctwa_ad_title, ctwa_campaign_name, ctwa_adset_name...),
     meta_lead_* (formulario Meta Lead Ads), lt_* (LionTrack: UTMs, pagina, dispositivo). Lista real:
-    lionchat_custom_attributes_list {attribute_model:'conversation', include_system:true}.
+    lionchat_custom_attributes_list {attribute_model:'conversation_attribute', include_system:true} (com o sufixo: so 'conversation' devolve lista VAZIA).
     VALORES FECHADOS de origin_kind (e first/last): paid_ad (Anuncio), lead_form (Formulario), organic
     (Organico), direct (Direto), referral (Indicacao), manual (Origem cadastrada) — compara pelo VALOR, nunca
     pelo rotulo ("Anuncio" nunca casa). origin_platform: facebook, instagram, google, tiktok, linkedin, youtube,
@@ -745,13 +762,14 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
       field JUNTOS — conversa usa field '{{conversation.label}}', contato usa '{{contact.label}}';
       a tela reabre a regra casando o par, e condicao escrita so com operator roda certa mas
       APARECE errada pro cliente. Mesma regra vale pros pares kanban_exists/kanban_in_stage
-      (fields '_kanban_check'/'_kanban_stage'), kanban_won/kanban_lost (field '_kanban_status') e
+      (fields '_kanban_check'/'_kanban_stage'), kanban_won/kanban_lost/kanban_snoozed (field '_kanban_status') e
       resposta do cliente/do atendente (fields '{{last_response}}'/'{{last_agent_response}}')),
-    kanban_exists/kanban_in_stage/kanban_won/kanban_lost (funnel_id e CHAVE SEPARADA da condicao,
+    kanban_exists/kanban_in_stage/kanban_won/kanban_lost/kanban_snoozed (funnel_id e CHAVE SEPARADA da condicao,
       numero ex funnel_id:37; a etapa vai em value=slug puro ex value:"avaliacao_aceita" ou em stage,
       NAO no formato "37:etapa"), pagetrack_visited/pagetrack_event,
       Desde 20/08 as 4 condicoes kanban_* enxergam o card da conversa ATUAL ou o card cuja conversa de
       ORIGEM e a atual (card religado pra conversa mais nova) — antes "nao tem card" na conversa velha.
+      kanban_snoozed (NOVO 11/10/2026) = o card esta ADIADO naquele funil; nao existe condicao "card aberto".
     sla_check (SO value, codigo fixo: frt_breached/frt_ok/nrt_breached/nrt_ok/rt_breached/rt_ok/has_sla/no_sla;
       frt=primeira resp, nrt=proxima, rt=resolucao; _ok exige politica de SLA aplicada),
     signature_status (NOVO 2026-09-14 — aba "Contrato" da tela; SO value, codigo fixo:
@@ -817,7 +835,12 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
         — funnel_id e funnel_stage OBRIGATORIOS; title/description aceitam {{ }},
       move_kanban_stage({funnel_id,funnel_stage}), set_kanban_item_status({status:won|lost|active}),
       set_won({}), set_lost({reason?}), add_card_note({text}),
-      set_open({}) — reabre card ganho/perdido (status open; nao mexe nos responsaveis),
+      set_open({}) — reabre card ganho/perdido (status open; nao mexe nos responsaveis); num card ADIADO
+        abre o card na hora e dispara "Card aberto" (desde 11/10/2026),
+      snooze_kanban_item({funnel_id, amount, unit:'hours'|'days', card_source?}) — NOVO 11/10/2026: ADIA o card
+        por N horas ou dias a partir da execucao (amount inteiro >= 1; minimo 1 hora); so card aberto; adiar de
+        novo troca a data. Card ganho/perdido, sem card no funil ou card_source 'trigger' em fluxo que nao veio
+        de card = ERRO visivel no passo (nunca pulado, ao contrario das irmas de card),
       // title/description de create_kanban_item e text de add_card_note resolvem pelo resolvedor do
       //   FLUXO desde 20/08: {{conversation.id}} = numero da tela e variaveis da sessao valem ali
       assign_agent_card({agent_id, mode?}) — RESPONSAVEL DO CARD. mode (NOVO 2026-07-28):
@@ -838,6 +861,24 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
         evento, sem laco). 'cancelled' cancela o AGENDAMENTO (desarma lembrete, mata o link de gerenciar).
         Origem gravada = 'fluxo', ator = o proprio flow. Sem 'remarcado'/'adiado'/'nao confirmado': o bloco NAO
         mexe em data.
+    Tarefa (aba Agenda; exige a Agenda unificada ligada na conta; NAO roda em fluxo ai_tool nem em fluxo de grupo —
+      o save aceita, o motor recusa com ERRO visivel no passo e a tela esconde o item):
+      create_account_task({title, description?, task_type, agenda_id?, priority?, occupies_agenda?,
+        due:{amount, unit:'hours'|'days', at?:'HH:MM', business_days?:true},
+        responsible:{mode:'card_owner'|'fixed'|'funnel_rotation'|'team_rotation', user_id?, team_id?, fallback_user_id?},
+        card_source:'funnel'|'trigger', funnel_id?}) — NOVO 20/10/2026 ("Criar tarefa"): cria uma tarefa COMUM da
+        Agenda presa ao card do fluxo (ou so a conversa, se nao houver card). Os campos de title a occupies_agenda
+        sao os MESMOS da acao create_task do funil (settings.automations): title obrigatorio; due em horas (1 a 720)
+        ou dias (0 a 365; at e business_days SO em dias; dia util = segunda a sexta sem feriado de DIA INTEIRO da
+        agenda da tarefa); responsible.mode exige a chave do modo (card_owner -> fallback_user_id; fixed -> user_id;
+        team_rotation -> team_id; funnel_rotation nenhuma no save, mas SEM card cai em fallback_user_id,
+        e sem ele a tarefa nao nasce). card_source 'trigger' = o card que INICIOU o fluxo (fluxo
+        que nao veio de card = ERRO); 'funnel' (padrao da tela) = o card DESTA conversa no funil funnel_id
+        (OBRIGATORIO neste modo; funil ausente ou inexistente = erro; conversa sem card naquele funil = tarefa so na
+        conversa, passo verde "sem card"). Regra torta = passo VERMELHO com o campo a consertar. Uma tarefa por
+        PASSAGEM do bloco (repeticao do mesmo passo nao duplica). Freio de 1 tarefa por segundo por conta (passo com
+        vaga futura fica verde "nasce as HH:MM:SS"). Quem agendou = o Fluxo (booking_source 'fluxo'); o historico do
+        card diz "Fluxo X criou uma tarefa ..." / "Fluxo X nao criou a tarefa: motivo".
     Sistema (SO flow conversation e flow action): send_webhook({url,headers?,body?}), start_flow({flow_id}
       — flow_id tem que ser de OUTRO flow: apontar pro proprio flow e aceito no save mas IGNORADO
       EM SILENCIO na execucao, e o fluxo para ali [2026-08-18].
@@ -879,9 +920,9 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
         [x]" / "Meta: erro (...)" — o [evento] no fim diz qual nome foi pra cada destino.
         Falha de um destino nunca derruba o fluxo. Dry-run nao dispara.
   card_source (acoes de card): 'funnel' (default, acha o card pelo funnel_id) | 'trigger' (usa o card
-    que DISPAROU o flow em card_created/card_moved/card_won/card_lost). Com 'trigger' o funnel_id e
+    que DISPAROU o flow em card_created/card_moved/card_won/card_lost/card_opened/card_snoozed). Com 'trigger' o funnel_id e
     ignorado — EXCETO create_kanban_item/move_kanban_stage (funil = DESTINO). Vale pra move_kanban_stage,
-    set_won/set_lost/set_open, assign_agent_card, add_card_note, add_card_checklist, add_card_offer e
+    set_won/set_lost/set_open, snooze_kanban_item (sem card-gatilho = ERRO, nao pula), create_account_task (idem: ERRO), assign_agent_card, add_card_note, add_card_checklist, add_card_offer e
     update_attribute (attr_source:'card').
   Handles: "success" (sem handle error — falha vira warning e o flow continua).
 
@@ -967,6 +1008,24 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
     Com pesos iguais os dois dao o mesmo resultado.
   Handles: o id de cada branch (mode branches); "success" (mode distribute_agents).
 
+▸ ai_call ("Ligar com IA", 17/10/2026 — so em conta com ai_calling + lioncalls_calling)
+  A IA liga para o TELEFONE DO CONTATO da conversa do fluxo pela linha de ligacao do WhatsApp (LionCalls).
+  data: { aiCallAgentId: <id de lionchat_captain_call_agents_list>, aiCallInboxId: <id de meta.dial_inboxes> }
+  (aiCallAgentName/aiCallInboxName sao opcionais, so pro resumo do card). O que a IA fala, a voz e o TEMPO
+  MAXIMO da ligacao vem do agente de ligacao (max_duration_seconds, 30-600 s): no tempo o motor desliga sozinho.
+  Handles: "answered" (a pessoa atendeu), "no_answer" (nao atendeu ou recusou), "error" (nao deu pra ligar:
+  sem telefone, linha desconectada, agente apagado, linha ocupada por mais de 2 h — o motivo vai no historico).
+  answered/no_answer SEM fio = o fluxo termina ali; error SEM fio = execucao "Falhou".
+  Liga UMA vez (para insistir: outro ai_call depois de "no_answer", com um wait no meio). NUNCA ligue "error"
+  direto em outro ai_call (em alguns erros nao da pra saber se a ligacao saiu). Nao confere horario: use um
+  condition antes. A IA so liga se sobrar uma vaga na linha para uma pessoa; senao espera a vez (fila por
+  ordem de chegada, ate 2 h). O card da ligacao vai para a conversa do lead na caixa da linha.
+  PROIBIDO em flow 'action', em flow de GRUPO e em ai_tool (o save recusa); id de agente/caixa de OUTRA conta
+  tambem e recusado. Agente apagado ou caixa excluida NAO travam o save — falham na execucao.
+  Receita "a IA de atendimento pede a ligacao" (sem ferramenta nova): cenario manda por a etiqueta 'ligar';
+  flow conversation com gatilho label_added 'ligar' -> action remove_conversation_label 'ligar' (LOGO depois
+  do start) -> ai_call.
+
 ▸ update_group (Gestao de Grupos WhatsApp — UMA operacao por bloco, 18 operacoes)
   Roda em fluxo de QUALQUER canal desde que a conta tenha caixa WhatsApp QR Code (Channel::Waha).
   Em flow de GRUPO o campo de caixa e opcional (vazio = caixa da conversa); em flow NAO-grupo
@@ -991,7 +1050,8 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
     list_participants -> (groupTargetId) -> id,participants(ate 100; participants_truncated=true se cortou),participants_count
     add_participants  -> groupParticipants(obrig; array de telefones/JIDs ex ['5511999999999@c.us'] ou lista por virgula; aceita {{var}}) -> id,added,not_added,added_count,not_added_count,no_whatsapp,invited,invite_status  [risco de banimento]
                          mesma correcao do 9o digito do create (21/08). added = quem esta no grupo agora (inclui quem ja estava); ninguem entrou = saida "error" (nobody_changed); parte entrou = "partial"
-    remove_participants -> groupParticipants(obrig) -> id,removed,not_removed,removed_count,not_removed_count (ninguem saiu = "error"; parte = "partial")
+                         DESDE 09/10/2026 reconhece quem o WhatsApp devolve SO com o codigo interno (@lid, sem telefone — o normal para quem ACABOU de ser colocado): antes acusava nobody_changed/not_added com a pessoa DENTRO do grupo (e o create dava "partial" falso). Sem resposta do motor = conta como NAO colocado
+    remove_participants -> groupParticipants(obrig) -> id,removed,not_removed,removed_count,not_removed_count (ninguem saiu = "error"; parte = "partial"; desde 09/10/2026 tambem reconhece quem esta so com o codigo interno — antes dava SUCESSO falso)
     promote_admin     -> groupParticipants(obrig) -> id,participants
     demote_admin      -> groupParticipants(obrig) -> id,participants
     get_invite        -> (groupTargetId) -> id,invite_link
@@ -1013,6 +1073,11 @@ flow_data tem o formato Vue Flow: { nodes: [...], edges: [...] }.
     'sem_mensagem'. EFEITO COLATERAL: cada convite entregue vira contato + conversa NOVOS no painel e
     dispara os ouvintes de conversation_created (automacao, outros flows, webhook do cliente, Kanban).
   Toda operacao (menos send_message e send_private_message) tambem devolve {{grupo.ok}} (bool) e {{grupo.error.message}}.
+  HISTORICO (09/10/2026): nas operacoes com groupParticipants o passo do historico (NAO a variavel {{grupo.*}})
+    traz participant_sources: [{number, source (a LINHA do campo de onde o numero saiu), typed (true = digitado,
+    sem variavel), informed? (o numero como foi escrito, quando o WhatsApp usa outra forma), filled_by?/filled_at?
+    (linha que e UM atributo personalizado sozinho: quem gravou e quando)}]. So anotacao: nunca muda o pedido;
+    origem e autor podem faltar, nunca saem errados.
   Handles: "success", "error" + "partial" em create/add_participants/remove_participants (a operacao
     rodou mas nem todo mundo entrou/saiu — listas not_added/not_removed dizem quem). "partial" sem fio
     segue pelo fio "success" (unica saida com esse fallback no motor).
@@ -1038,6 +1103,7 @@ condicao bater, o lead sai do flow NA HORA. Cada item tem "type":
 - Rico por atributo (novo 2026-07-08; REATIVO desde 2026-07-09):
   {type:'attribute_condition', logic:'and'|'or', rules:[{attr_key, attrSource:'contact'|'conversation'
    |'card', operator, value | values:[...], funnel_id?, card_source?}]}.
+  attrSource 'company' NAO vale aqui (so no node condition): a regra de saida nao le a empresa.
   AQUI o attrSource VAI na rule (ao contrario do gatilho de entrada por atributo, onde e implicito).
   Operadores da condition EXCETO is_empty/is_not_empty (removidos do contexto reativo 09/07 — use so
   no node condition); reativa: so reavalia quando o atributo VIGIADO muda; cada rule exige value|values;
@@ -1075,12 +1141,13 @@ trigger.* (variaveis do GATILHO que iniciou o flow — no autocomplete de TODO b
     message_created (gatilho message_received), message_sent, conversation_created, conversation_opened
     (gatilho conversation_reopened), conversation_resolved, label_added, label_removed, team_changed,
     assignee_changed, sla_missed, kanban_item_created/card_created, kanban_item_stage_changed/card_moved,
-    card_status_changed (card_won e card_lost — olhe trigger.kind ou o status do card), conversation_
+    card_status_changed (card_won/card_lost/card_opened/card_snoozed — olhe trigger.kanban.status:
+    won/lost/open/snoozed; rotulo "Situacao do card mudou" desde 11/10/2026), conversation_
     attributes_changed, card_attributes_changed, contact_attribute_changed, group_participant_joined/left,
     webhook_received, date_trigger, manual (sidebar), kanban_manual (botao do card), campaign (Campanha de
     Fluxo), page_track, activated_by_flow (fluxo chamou fluxo), lead_form (os 3 gatilhos de formulario —
     trigger.kind diz completed/milestone/abandoned), booking_created/booking_cancelled/booking_rescheduled/
-    booking_completed. Compare SEMPRE com esses codigos numa condicao.
+    booking_completed, whatsapp_form_answered. Compare SEMPRE com esses codigos numa condicao.
   trigger.name (rotulo legivel, pra escrever pro cliente), trigger.activated_at (ISO) — desde 20/08
     preenchidas em TODOS os caminhos de disparo (antes so no de evento de conversa).
   trigger.data = o contexto inteiro em JSON (menos type/name/activated_at) — util em node api/ai.
@@ -1095,13 +1162,16 @@ trigger.* (variaveis do GATILHO que iniciou o flow — no autocomplete de TODO b
   Cada uma so tem valor quando o gatilho fornece — fora disso resolve vazio.
   FATOS do gatilho viraram variaveis (08/09/2026, no ar desde 10/09): {{trigger.<bloco>.<campo>}}, so
     quando o Inicio tem o gatilho que os preenche — card_created/card_moved/card_won/card_lost/
-    card_attribute_changed: trigger.kanban.title, trigger.kanban.funnel_name, trigger.kanban.stage_name,
+    card_opened/card_snoozed/card_attribute_changed: trigger.kanban.title, trigger.kanban.funnel_name, trigger.kanban.stage_name,
     trigger.kanban.stage (codigo da etapa); card_moved: trigger.kanban.previous_stage_name/previous_stage;
-    card_won/card_lost: trigger.kanban.status (won/lost); label_added/label_removed: trigger.label.name;
+    card_won/card_lost/card_opened/card_snoozed: trigger.kanban.status (won/lost/open/snoozed);
+    card_opened: trigger.kanban.previous_status (snoozed = voltou do adiamento; won/lost = reabriram); label_added/label_removed: trigger.label.name;
     assignee_changed: trigger.assignee.name (vazio = responsavel removido); team_changed: trigger.team.name;
     sla_missed: trigger.sla.policy_name/type (frt/nrt/rt); group_participant_joined/left:
     trigger.group.name/id, trigger.participant.phone/name (16/09 — QUEM entrou/saiu, telefone com +;
-    nome so se a pessoa ja e contato; evento com varias pessoas = a 1a). Resolvem mas ficam FORA do seletor (produtor unico): trigger.attribute.name/
+    nome so se a pessoa ja e contato; evento com varias pessoas = a 1a); whatsapp_form_answered (17/10):
+    trigger.form.name, trigger.form.id e trigger.form.f_<n> = a resposta de cada pergunta ja em texto (opcao pelo
+    nome, data DD/MM/AAAA, Sim/Nao, "N arquivos: nomes"; codigos em whatsapp_forms_list com with_questions=true). Resolvem mas ficam FORA do seletor (produtor unico): trigger.attribute.name/
     current_value, trigger.form.name/milestone, trigger.payment.gateway/event/product/offer/method/status/
     amount, trigger.eclinica.event/unit/date/time/compromisso/idagenda, trigger.lead.form/page/ad/adset/
     campaign/platform, trigger.dtmf.key/campaign, trigger.reminder.date/time/compromisso/unit/days_before.