@lionchat/mcp-server 1.16.0 → 1.18.0

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

@@ -101,7 +101,7 @@ Aceita: letras, números, underscore, hífen e ponto. Sem espaço. Convenção:
 
 `+<código país><DDD><número>`. Brasil: `+5511999999999` (13 dígitos com 9). Sem espaços, sem parênteses, sem hífen.
 
-WAHA tem endpoint `/integrations/waha/check_phone?phone=+55...` que retorna o número CORRIGIDO (especialmente útil pra fixar o 9º dígito BR).
+WAHA tem endpoint `/integrations/waha/check_phone?phone=+55...` que retorna o número CORRIGIDO (especialmente útil pra fixar o 9º dígito BR). O valor de `phone` é sempre E.164 (`+55...`) — nunca um id interno `@lid` (o servidor WAHA 2026.8+ responde com `@lid`, e o sistema traduz pelo campo `pn`).
 
 ### `funnel.stages` — keys snake_case
 

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

@@ -376,7 +376,11 @@ db/schema.rb, tabela booking_event_types)
 │   agente; 2026-08-19)
 ├── active / ask_email / ask_description
 ├── confirmation_* (mensagem de confirmação própria: enabled, inbox_id, channel_type,
-│   template_name, blocks)
+│   template_name, blocks). Variáveis nos textos de confirmação E de lembrete (interpolador único):
+│   {{nome}} {{email}} {{telefone}} {{data}} {{horario}} {{dia_semana}} (NOVO 24/08 — dia por
+│   extenso em pt: "terça-feira"; irmã do {{booking.weekday}} do FlowBuilder, mesma grafia)
+│   {{tipo_evento}} {{titulo}} {{duracao}} {{agente}} {{descricao}} {{meet_link}}
+│   {{link_cancelar}} {{link_remarcar}} {{horas_ate_evento}} {{horas_desde_evento}}
 └── booking_availabilities (has_many — dias/horários; `booking_availabilities_attributes` no create)
 
 Booking (agendamento confirmado — tabela bookings)
@@ -585,15 +589,11 @@ Gateways de pagamento (GuruWebhook, HotmartWebhook, KiwifyWebhook, EduzzWebhook,
 MonetizzeWebhook, GreennWebhook, ContaAzulIntegration, OmieIntegration — tools
 `lionchat_ecommerce_webhooks_*`, `conta_azul_integrations_*`, `omie_integrations_*`)
 ├── event_automation_mapping (jsonb) — uma entrada por evento do gateway:
-│   { "<evento>": { automation_id, flow_id, first_purchase_only,
-│                   conversation_attribute_keys: ["purchase_price", "product_name", ...] } }
-│   (Conta Azul/Omie usam `event_mapping`, por categoria). `conversation_attribute_keys`
-│   (2026-08-21 — entra com o próximo deploy do app depois de 21/08/2026) = quais campos da compra
-│   gravar TAMBÉM na conversa que a automação/fluxo abrir; chaves válidas = catálogo dos atributos
-│   de pagamento: product_name, offer_name, invoice_url, purchase_price, payment_method,
-│   purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name,
-│   event_date, charged_times, subscription_cycle, subscription_status, customer_document,
-│   transaction_id, payment_installments, payment_source. Chave fora do catálogo é ignorada.
+│   { "<evento>": { automation_id, flow_id, first_purchase_only } }
+│   (Conta Azul/Omie usam `event_mapping`, por categoria).
+│   ATENÇÃO (26/08/2026): `conversation_attribute_keys` foi REMOVIDA dos gateways de pagamento
+│   (existiu de 21 a 26/08) — o backend IGNORA a chave se gravada. Atributo de conversa mapeado
+│   continua existindo SÓ no Meta Lead e no Webhook Universal.
 └── Leia o mapeamento atual antes de gravar: o `update` SUBSTITUI o jsonb INTEIRO (não mescla) —
     mande todos os eventos de volta, senão os outros somem.
 

package/dist/docs/resources/flowbuilder-design-guide.md

@@ -1005,7 +1005,7 @@ Presentes conforme o evento (ausente = resolve vazio, sem erro):
 |---|---|
 | `{{trigger.message.*}}` | `id`, `content` (texto da mensagem, cortado em 2.000 caracteres), `type`, `created_at` |
 | `{{trigger.conversation.*}}` | `id` (o display_id), `status`, `channel` (nome amigável: `Waha`, `Whatsapp`, `Instagram`), `inbox_id`, `inbox_name`, `created_at` |
-| `{{trigger.contact.*}}` | `id`, `name`, `phone` |
+| `{{trigger.contact.*}}` | `id`, `name`, `phone`, `email` — desde 22/08/2026 resolvem em TODO gatilho (lidos do contato da sessão quando o evento não os trouxe) |
 | `{{trigger.ad.*}}` (anúncio/CTWA) | `id`, `name`, `creative_id`, `creative_name`, `adset_id`, `adset_name`, `campaign_id`, `campaign_name`, `source`, `headline`, `description`, `cta`, `url` |
 | `{{trigger.attribute.*}}` | `name`, `previous_value`, `current_value`, `changed_at` — o valor ANTES e DEPOIS do atributo que disparou (só nos gatilhos de mudança de atributo) |
 | `{{trigger.user_name}}` | nome do usuário/atendente que disparou (gatilho manual ou botão do card) |
@@ -1015,6 +1015,8 @@ Presentes conforme o evento (ausente = resolve vazio, sem erro):
 | `{{trigger.source_flow_id}}` / `{{trigger.source_flow_name}}` | id e nome do flow de origem (quando outro flow iniciou este, ex.: action `start_flow`) |
 | `{{trigger.lead_form_id}}` / `{{trigger.response_id}}` / `{{trigger.kind}}` | formulário público: qual formulário, qual preenchimento e o tipo (`completed`/`milestone`/`abandoned`) |
 | `{{trigger.kind}}` / `{{trigger.booking_id}}` / `{{trigger.event_type_id}}` | agendamento (Booking nativo): `created`/`cancelled`/`rescheduled`/`completed`, id da reserva e id do tipo |
+| `{{trigger.kind}}` em `webhook_received` | origem da integração: `meta_lead`, `payment`, `eclinica`, `eclinica_reminder`, `topsend` (22/08/2026). O `type` continua `webhook_received` |
+| `{{trigger.meta_lead_event_id}}` | id do evento do Meta Lead (só `kind=meta_lead`) |
 
 Os cinco últimos são **novos 2026-08-07** e passam a aparecer no autocomplete de TODO bloco (ausente para
 o gatilho que não os fornece = resolve vazio, sem erro).
@@ -1023,6 +1025,16 @@ Dois atalhos: `{{trigger}}` devolve o contexto INTEIRO em JSON e `{{trigger.data
 sem os metadados — úteis pra jogar tudo dentro de um node `ai` ou `api`. Bloco (Hash/Array) inteiro
 sai em JSON; valor simples sai cru.
 
+**O que o histórico mostra e NÃO é variável (22/08/2026).** O passo Início do histórico de execução
+passou a exibir, em todo gatilho, o contato (nome, telefone, e-mail), a conversa (número, canal, caixa)
+e os fatos do que disparou: etiqueta, responsável/equipe (ou "removido"), card (título, funil, etapa
+anterior → etapa), política de SLA, grupo, nome do formulário e do marco, anúncio/formulário/campanha
+do Meta Lead (+ as respostas, em bloco próprio), produto/oferta/meio de pagamento do gateway, evento/
+unidade/data/hora/compromisso da e-Clínica, tecla do TopSend, e os dados do agendamento. Esses fatos
+ficam numa área só-de-log (`_trigger_facts`) — **não existem como `{{trigger.*}}`** e não entram em
+`{{trigger.data}}`. Se o cliente precisar de um deles no fluxo, use a variável de origem quando
+existir (`{{booking.*}}`, `{{form_*}}`, `{{contact.*}}`, atributos do contato gravados pela integração).
+
 **NÃO duplique o que já tem variável própria.** `{{contact.name}}`, `{{conversation.status}}`,
 `{{inbox.name}}` e os atributos `ctwa_*` continuam existindo e são a forma canônica. O `{{trigger.*}}`
 serve pra perguntar "o que veio COM o gatilho", não pra ser um segundo nome do mesmo dado.

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

@@ -571,7 +571,7 @@ Não é consulta livre: escolha um `widget_type` e preencha **só os campos daqu
 | `sla_summary` | `time_range` | `sla` (Enterprise) |
 | `funnel_stages` | `funnel_id` · `date_basis` (created/moved/closed/any) · `status` (all/open/won/lost) · `measure` (count padrão / value = soma do valor dos cards) · `time_range` | `kanban_board` |
 | `stage_entries` | `funnel_id` · `measure` (count/value) · `time_range` — quantos cards DISTINTOS ENTRARAM em cada etapa no período (histórico desde 12/07/2026) | `kanban_board` |
-| `calls_report` | `dimension` (agent/inbox) · `time_range` — ligações / atendidas / não atendidas / não concluídas / tempo total / tempo médio | — |
+| `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` | — |
 
@@ -605,9 +605,14 @@ IDs de etiqueta**, nunca nome de métrica).
 
 ### Armadilhas que fazem o bloco sair errado
 
-1. **`scope_type`/`scope_id` têm sentido OPOSTO por tipo.** No `conversations_timeseries` = "o
-   gráfico é só daquela entidade". No `agent_report` = "mostre só as linhas de quem é dessa
-   equipe/caixa". Confundir troca a conta inteira.
+1. **`scope_type`/`scope_id` têm sentido DIFERENTE por tipo — e, no `agent_report`, por VALOR
+   (desde 27/08/2026).** No `conversations_timeseries` = "o gráfico é só daquela entidade". No
+   `agent_report`: `team`/`agent` = "mostre só as linhas de quem é dessa equipe/agente" (contando o
+   trabalho da pessoa na conta INTEIRA); `inbox` = recorte de CAIXA (membros da caixa, contando SÓ
+   o que fizeram naquela caixa — é o desenho de "relatório por médico/unidade"). `inbox` +
+   `dimension: team` é RECUSADO com motivo. No `calls_report`, `scope_type: inbox` conta só as
+   ligações daquela caixa — **ligação sem caixa fica de fora** (VTCall ~90% e Zenvia 100% das
+   ligações não têm caixa; LionCalls e Wavoip têm em 100%). Confundir troca a conta inteira.
 2. **Campo fora da lista é descartado em silêncio.** Se um valor "não fez efeito", provavelmente o
    nome do campo está errado.
 3. **Sempre envie `timezone_offset` em HORAS, derivado do fuso DA CONTA** (`account_show.timezone`;
@@ -712,3 +717,60 @@ Combinado com `status: 'won'` + `date_basis: 'closed'`, dá o faturamento ganho
 
 **Cuidado ao escrever**: se os cards do cliente têm valor padrão (todos com o mesmo número), a soma
 não é faturamento — é o padrão multiplicado. Se todos os valores forem idênticos, desconfie e diga.
+
+## Avisos — o resumo diário nativo no WhatsApp (2026-08-27)
+
+O caso da seção anterior ("me traz o relatório todo dia") virou **funcionalidade nativa**: a aba
+**Relatórios > Avisos** manda, todo dia no horário escolhido, o resumo em texto de um relatório
+personalizado num grupo/conversa de **WhatsApp QR**, com o texto escrito pela IA da conta. Ferramentas
+`lionchat_report_alerts_*` (criar, editar, listar, excluir, enviar agora, histórico, prévia). Só
+administrador; teto de 10 por conta.
+
+### O fluxo seguro (aprendido em produção, 27/08)
+
+1. **Crie DESLIGADO** (`enabled: false`) — aviso criado ligado DENTRO da janela do dia
+   (`send_hour` até +3h, fuso da conta) dispara no próximo tick de hora, e o grupo do cliente
+   recebe sem ninguém ter validado.
+2. **Rode a prévia** (`report_alerts_preview` → token → `report_alerts_preview_status`): mesmo
+   motor do envio, sem mandar nada. Mostre o texto pra pessoa aprovar.
+3. **Só então ligue** (`report_alerts_update` com `enabled: true`).
+
+### Regras do texto (a IA do Aviso NÃO é a IA do chat)
+
+- A conferência de números **reprova qualquer número que não exista no relatório** — a IA nunca
+  calcula, soma nem inventa percentual. Reprovou = sai o texto padrão do sistema (fiel, bloco a
+  bloco). **Percentual confiável = bloco `stage_conversion` no relatório** (o motor calcula).
+- Prompt que pede pra **renomear/reorganizar seções já fez a IA trocar rótulos de números** (caso
+  real: "Novos leads: 9" com o número do bloco de atendentes). O prompt que funciona: *"mantenha os
+  títulos e TODOS os números exatamente como estão, não renomeie seções, não calcule nada, inclua
+  TODOS os blocos"*.
+- Teto do texto: 60.000 caracteres (o do WhatsApp) — relatório inteiro cabe.
+- A mensagem entra na conversa como **mensagem de sistema**: automações e fluxos ativos naquela
+  conversa reagem a ela; não conta como resposta de atendente, não mexe em SLA nem apaga o
+  "cliente aguardando".
+
+### Diagnóstico ("o grupo não recebeu")
+
+`report_alerts_deliveries` é o histórico (90 dias, texto congelado de cada envio):
+`sent` = saiu, aguardando recibo · `confirmed` = **entregue com recibo do canal** (o selo verde só
+existe com evidência) · `send_failed` = recusado (motivo em `error_message`; caixa desconectada é o
+clássico) · `skipped_late` = não saiu no horário (janela de 3h estourada; tenta amanhã) · `error` =
+falhou antes do envio. `test_mode: true` = disparo manual. Na lista, `next_send_on` diz o próximo
+envio previsto e `last_delivery_status`/`last_error` resumem o último.
+
+### Bloco `stage_conversion` — percentual entre etapas (entra com o próximo deploy pós-27/08)
+
+`widget_type: 'stage_conversion'`: conversão calculada PELO MOTOR — cards **distintos** que entraram
+nas etapas de `numerator_stage_ids` ÷ os que entraram nas de `denominator_stage_ids`, na janela
+(mesma fonte histórica do `stage_entries`). Ex. real: Consulta Agendada ÷ (Novos Leads + Agendamento
+Pendente). Card que passou por duas etapas do denominador conta UMA vez (somar deflaria a taxa).
+`chart_type: 'number'`; shape scalar (value = %, total = base; total 0 = "sem dados"). Os ids de
+etapa são as CHAVES do hash `stages` do `lionchat_funnels_show`. Janela curta pode passar de 100%
+(agendou hoje um lead que entrou ontem) — é verdade do dado, explique em vez de esconder.
+
+### Recorte por caixa nos blocos de tabela (2026-08-26, já no ar)
+
+Em `agent_report` e `calls_report`, `scope_type: 'inbox'` + `scope_id` recorta **de verdade** pela
+caixa: membros da caixa contando SÓ o que fizeram nela (era o defeito dos relatórios por médico
+saírem iguais). `'agent'`/`'team'` seguem sendo recorte de PESSOAS (trabalho na conta inteira);
+`'inbox'` + `dimension: 'team'` é recusado. E `lead_origin` passou a respeitar `time_range`.

package/dist/docs/resources/troubleshooting.md

@@ -553,16 +553,19 @@ Se alguma anotação antiga disser que esse filtro mente por API, está errada.
 verdade nos filtros: data FIXA com `is_greater_than`/`is_less_than` passou a cortar o dia no fuso
 da CONTA (ver resource `filtros-e-relatorios`).
 
-## "Mapeei o campo da integração pro atributo da conversa e nada foi gravado" (21/08 — entra com o próximo deploy do app depois de 21/08/2026)
+## "Mapeei o campo da integração pro atributo da conversa e nada foi gravado" (Meta Lead / Webhook Universal)
 
-Quatro causas, nesta ordem: (1) o evento não abriu conversa — atributo de conversa só existe na
+ATENÇÃO (26/08/2026): atributo de conversa mapeado existe SÓ no Meta Lead e no Webhook Universal.
+Nos 9 gateways de pagamento a opção "salvar também na conversa" foi REMOVIDA (existiu de 21 a
+26/08) — o backend ignora `conversation_attribute_keys` se estiver gravada; os gateways gravam os
+dados da compra automaticamente no CONTATO, como sempre.
+
+Três causas, nesta ordem: (1) o evento não abriu conversa — atributo de conversa só existe na
 conversa que a automação/fluxo mapeado cria (contato sozinho não tem onde gravar); (2) a chave é
 reservada (`imported_from`, `type`, `captain_*`... — lista em `api-conventions`) e foi recusada;
 (3) o valor não é do TIPO do atributo (texto num campo de Número, data em formato estranho) e foi
-descartado — o log do servidor tem `[IntegrationAttributes] ... tipo_invalido=[...]`; (4) nos
-gateways, a chave não está em `conversation_attribute_keys` daquele evento (a granularidade é por
-evento: "compra aprovada" e "carrinho abandonado" gravam listas diferentes). Gravar por integração é
-silencioso: não espere automação nem webhook de saída reagindo ao atributo.
+descartado — o log do servidor tem `[IntegrationAttributes] ... tipo_invalido=[...]`.
+Gravar por integração é silencioso: não espere automação nem webhook de saída reagindo ao atributo.
 
 ## Quando reportar pro suporte
 
@@ -586,3 +589,56 @@ qualquer resposta que fique 125 s sem um byte (Proxy Read Timeout). Quem usa pel
 abre esse canal e nunca vê isso.
 Correção (v1.15.1): o servidor manda um `ping` a cada 30 s enquanto o canal está aberto.
 Interruptor: `MCP_KEEPALIVE_INTERVAL_MS` (0 = desligado). Detalhe: `docs/plans/mcp-keepalive-cloudflare/`.
+
+## "O grupo não recebeu o resumo diário" (Avisos de relatório) — 27/08
+
+Diagnóstico em 2 passos: `lionchat_report_alerts_list` (colunas `last_delivery_status`/`last_error`
+resumem o último dia; `next_send_on` diz o próximo) e `lionchat_report_alerts_deliveries` (histórico
+de 90 dias com o TEXTO congelado de cada envio). Leitura dos status: `confirmed` = entregue COM
+recibo do canal; `sent` = saiu e o recibo ainda não veio (reconfere sozinho em ~15 min); `send_failed`
+= o canal recusou (motivo em `error_message` — caixa desconectada é o clássico: mande reconectar o
+WhatsApp QR); `skipped_late` = não saiu na janela de 3h (sistema congestionado; tenta amanhã — não é
+preciso fazer nada); `error` = falhou antes de enviar (ex.: 'conta suspensa', 'a conversa de destino
+não existe mais', 'nenhum bloco do relatório pôde ser calculado'). Aviso criado hoje DEPOIS do
+horário não dispara hoje (primeiro envio é amanhã) — não é defeito.
+
+## "A prévia do Aviso fica em pending pra sempre" — 27/08
+
+`report_alerts_preview_status` devolve `pending` enquanto o job (fila de baixa prioridade) não roda —
+normalmente 5-60 s, até ~2-3 min com a plataforma cheia. Espere 5-10 s entre leituras; NUNCA dispare
+outra prévia por impaciência (cada rodada com IA gasta a chave OpenAI da conta). O resultado expira
+5 min depois de pronto: `pending` que virou `error: token inválido` = token errado/expirado, rode a
+prévia de novo. Token tem 32 caracteres hex — confira que guardou o valor INTEIRO.
+
+## "Mandei mensagem numa conversa cheia de histórico e a Meta recusou (131047)" — 26/08
+
+Conversa que só tem mensagens IMPORTADAS de histórico NÃO tem janela de 24h aberta — para a Meta,
+aquele contato nunca escreveu pela conexão oficial (a mensagem existe no painel porque a importação a
+copiou do celular). O envio de texto livre é recusado mesmo com a fala do cliente visível na tela.
+Saída: modelo aprovado (template) ou esperar o cliente escrever de verdade pela caixa oficial.
+
+## "Adicionei etiqueta e as antigas sumiram" — CORRIGIDO em 24/08
+
+Era defeito real (o segundo bloco "Adicionar etiqueta" do mesmo fluxo apagava as do primeiro, e
+salvar status/prioridade apagava etiqueta posta por outro no meio do caminho). Hoje ADICIONAR SOMA,
+em todos os caminhos (fluxo, IA, API, ações em massa). Se um cliente relatar isso em versão antiga
+(whitelabel atrasado), é a versão — não oriente gambiarra de "reaplicar etiqueta".
+
+## "Os leads do Meta chegam só com id de campanha, sem nome" — 25/08
+
+Nome de campanha/conjunto/anúncio exige o **token de ANÚNCIOS** (é outro token, de CONTA — o login
+da página não basta). Diagnóstico: `lionchat_meta_lead_validate_token` (sem corpo testa o salvo) diz
+se o token é válido, de qual app e se alcança anúncio de verdade. Gravar/trocar:
+`lionchat_meta_lead_ads_token` — ao gravar, o servidor reprocessa retroativamente os leads que
+ficaram sem nome. E desde 25/08 o CONECTAR exige escolha: `meta_lead_create` com `page_ids` (sem
+ele TODAS as páginas do login entram — caso real de 25 páginas numa conta); pra limpar excesso
+antigo, `lionchat_meta_lead_bulk_destroy`.
+
+## "Atualizei a chave da caixa oficial pelo update e ela parou de receber" — 26/08
+
+`inboxes_update` com `channel.provider_config` SUBSTITUI o objeto inteiro: mandar só o campo
+alterado APAGA `webhook_verify_token` e a marca `source` em silêncio — a caixa para de receber
+webhook da Meta. Regra: leia a caixa antes (`inboxes_show`), reenvie o `provider_config` COMPLETO
+com o campo trocado. Os três campos da conexão manual (`phone_number_id`, `business_account_id`,
+`api_key`) são validados JUNTOS na Meta a cada gravação — 422 "Invalid Credentials" significa que
+algum dos três está errado ou a chave venceu (não salve campo a campo).

package/dist/instructions.js

@@ -9,7 +9,14 @@ let cachedInstructions = null;
 export function getServerInstructions() {
     if (cachedInstructions !== null)
         return cachedInstructions;
+    // AIDEV-NOTE: [manual-nao-chegava 31/08] A 1a entrada e a que VALE nos dois modos, porque
+    // docs/ e irmao do arquivo compilado: em producao __dirname=dist/ (achado: dist/docs/) e em
+    // desenvolvimento __dirname=src/ (achado: src/docs/). As duas seguintes apontam um nivel ACIMA
+    // e NUNCA existiram no pacote publicado — sem a 1a, o servidor caia no texto de reserva e a IA
+    // conectada nunca recebia o manual (medido ao vivo em 30/08: a instrucao entregue era so a
+    // frase curta abaixo). Ficam como rede pra layout futuro; nao remover a primeira.
     const candidates = [
+        join(__dirname, 'docs/instructions.md'),
         join(__dirname, '../docs/instructions.md'),
         join(__dirname, '../../src/docs/instructions.md'),
     ];

package/dist/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,yEAAyE;AACzE,uEAAuE;AAEvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C,MAAM,UAAU,qBAAqB;IACnC,IAAI,kBAAkB,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAE3D,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC;KAClD,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,kBAAkB,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,kBAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,oGAAoG,CAAC;IACvG,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,yEAAyE;AACzE,uEAAuE;AAEvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C,MAAM,UAAU,qBAAqB;IACnC,IAAI,kBAAkB,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAE3D,0FAA0F;IAC1F,4FAA4F;IAC5F,+FAA+F;IAC/F,+FAA+F;IAC/F,2FAA2F;IAC3F,kFAAkF;IAClF,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC;KAClD,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,kBAAkB,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,kBAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,oGAAoG,CAAC;IACvG,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/endpoints.json

@@ -9906,6 +9906,20 @@
     "location": "body",
     "required": false,
     "description": "Cor hex (#RRGGBB) dos compromissos deste tipo no calendario (2026-08-19); vazio = cor do agente. A tarefa devolve booking_color ja resolvido."
+   },
+   {
+    "name": "booking_event_type.confirmation_message",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Texto da mensagem de CONFIRMACAO enviada ao paciente quando o agendamento e criado. Aceita variaveis {{nome}}, {{titulo}}, {{data}}, {{horario}} e quebra de linha (\\n). Negrito do WhatsApp = *texto*."
+   },
+   {
+    "name": "booking_event_type.follow_up_schedules_attributes",
+    "type": "array",
+    "location": "body",
+    "required": false,
+    "description": "Lembretes do agendamento (o bloco '1d antes do evento' da tela). Array de objetos: {id (obrigatorio para EDITAR o existente — sem id CRIA outro), offset_direction ('before'/'after'), offset_days, offset_hours, offset_minutes, message_body, blocks, active, position, _destroy}. IMPORTANTE: message_body E blocks[0].content precisam do MESMO texto — a tela le blocks e o envio usa message_body; gravar so um deixa a tela e a mensagem entregue diferentes. blocks = [{type:'text', content:'...'}]. Aceita variaveis {{titulo}}, {{data}}, {{horario}} e quebra de linha (\\n)."
    }
   ],
   "returns": "tipo de evento criado (com novo ID)",
@@ -9953,7 +9967,7 @@
   "method": "PATCH",
   "path": "/api/v1/accounts/{account_id}/booking_event_types/{id}",
   "title": "Atualizar Tipo de Evento",
-  "description": "Atualiza um tipo de evento de agendamento. Atualiza campos do tipo de evento existente. Suporta atualização parcial (PATCH) — só campos enviados são alterados. Campos suportados: booking_event_type.title, booking_event_type.active.",
+  "description": "Atualiza um tipo de evento de agendamento. Suporta atualizacao parcial (PATCH) — so campos enviados sao alterados. Alem de title/active/color/slug/user_id, aceita os TEXTOS que o paciente recebe: confirmation_message (confirmacao) e follow_up_schedules_attributes (lembretes).",
   "category": "Tipos de Evento",
   "params": [
    {
@@ -9997,6 +10011,20 @@
     "location": "body",
     "required": false,
     "description": "Cor hex (#RRGGBB) dos compromissos deste tipo no calendario (2026-08-19); vazio = cor do agente. A tarefa devolve booking_color ja resolvido."
+   },
+   {
+    "name": "booking_event_type.confirmation_message",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Texto da mensagem de CONFIRMACAO enviada ao paciente quando o agendamento e criado. Aceita variaveis {{nome}}, {{titulo}}, {{data}}, {{horario}} e quebra de linha (\\n). Negrito do WhatsApp = *texto*."
+   },
+   {
+    "name": "booking_event_type.follow_up_schedules_attributes",
+    "type": "array",
+    "location": "body",
+    "required": false,
+    "description": "Lembretes do agendamento (o bloco '1d antes do evento' da tela). Array de objetos: {id (obrigatorio para EDITAR o existente — sem id CRIA outro), offset_direction ('before'/'after'), offset_days, offset_hours, offset_minutes, message_body, blocks, active, position, _destroy}. IMPORTANTE: message_body E blocks[0].content precisam do MESMO texto — a tela le blocks e o envio usa message_body; gravar so um deixa a tela e a mensagem entregue diferentes. blocks = [{type:'text', content:'...'}]. Aceita variaveis {{titulo}}, {{data}}, {{horario}} e quebra de linha (\\n)."
    }
   ],
   "returns": "tipo de evento atualizado",
@@ -16574,7 +16602,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao a disparar (dentro de custom_webhook_integration). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao a disparar (dentro de custom_webhook_integration). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    },
    {
     "name": "sample_payload",
@@ -16686,7 +16714,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao a disparar (dentro de custom_webhook_integration). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao a disparar (dentro de custom_webhook_integration). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    },
    {
     "name": "sample_payload",
@@ -16881,7 +16909,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de guru_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de guru_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook criado (com novo ID)",
@@ -16986,7 +17014,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de guru_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de guru_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook atualizado",
@@ -17195,7 +17223,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de hotmart_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de hotmart_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook criado (com novo ID)",
@@ -17293,7 +17321,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de hotmart_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de hotmart_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook atualizado",
@@ -17502,7 +17530,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de kiwify_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de kiwify_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook criado (com novo ID)",
@@ -17600,7 +17628,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de kiwify_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de kiwify_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook atualizado",
@@ -17809,7 +17837,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de ticto_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de ticto_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook criado (com novo ID)",
@@ -17907,7 +17935,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de ticto_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de ticto_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook atualizado",
@@ -18116,7 +18144,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de eduzz_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de eduzz_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook criado (com novo ID)",
@@ -18214,7 +18242,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de eduzz_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de eduzz_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook atualizado",
@@ -18423,7 +18451,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de monetizze_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de monetizze_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook criado (com novo ID)",
@@ -18521,7 +18549,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento de evento para automacao (dentro de monetizze_webhook). Cada entrada aceita tambem conversation_attribute_keys: [...] (2026-08-21): chaves do catalogo de pagamento (product_name, offer_name, invoice_url, purchase_price, payment_method, purchase_email, pix_code, pix_qr_code_url, pix_expiration_date, ticket_hash_url, event_name, event_date, charged_times, subscription_cycle, subscription_status, customer_document, transaction_id, payment_installments, payment_source) que serao gravadas como atributo da CONVERSA que a automacao/fluxo abrir (no contato a 2a compra apaga a 1a). Chave reservada da conversa e recusada; valor e convertido pelo TIPO do atributo e descartado se irreconhecivel; gravar por integracao NAO dispara automacao/flow."
+    "description": "Mapeamento de evento para automacao (dentro de monetizze_webhook). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto — o backend ignora a chave se gravada. Atributo de conversa mapeado existe so no Meta Lead e no mapeamento de campos (field_mapping) do Webhook Universal."
    }
   ],
   "returns": "webhook atualizado",
@@ -18687,7 +18715,7 @@
   "method": "POST",
   "path": "/api/v1/accounts/{account_id}/integrations/meta_lead",
   "title": "Conectar Pagina Meta Lead Ads",
-  "description": "Conecta o Meta Lead Ads. Obrigatorio: user_access_token (token de usuario — conecta todas as paginas acessiveis).",
+  "description": "Conecta o Meta Lead Ads. Obrigatorio: user_access_token (token de usuario — conecta todas as paginas acessiveis). ESCOLHA DE PAGINAS (25/08): mande `page_ids` com as paginas marcadas — sem ele TODAS as paginas do login entram (comportamento legado). Pra limpar excesso ja conectado: meta_lead_bulk_destroy.",
   "category": "Meta Lead Ads",
   "params": [
    {
@@ -18696,6 +18724,13 @@
     "location": "body",
     "required": true,
     "description": "Token de usuario do Facebook (conecta todas as paginas acessiveis)"
+   },
+   {
+    "name": "page_ids",
+    "type": "array",
+    "location": "body",
+    "required": false,
+    "description": "As paginas MARCADAS pelo cliente (ids de pagina do Facebook). DESDE 25/08 mandar so as escolhidas — ausente/vazio conecta TODAS as paginas do login (era o defeito antigo: 25 paginas entraram numa conta real). SEMPRE pergunte quais paginas antes de conectar."
    }
   ],
   "returns": "integração Meta Lead criado (com novo ID)",
@@ -24961,7 +24996,7 @@
   "method": "GET",
   "path": "/api/v1/accounts/{account_id}/eclinica_integrations",
   "title": "Listar Integração e-Clínica",
-  "description": "Lista a integração e-Clínica da conta (no máximo 1 por conta) com id, status e configurações. Use PRIMEIRO para descobrir o {id} exigido pelas ferramentas de histórico de lembretes. Eventos mapeáveis incluem (23/07) os novos cliente_inclusao_pagamento ('Inclusão de cobrança' — cobrança/carnê criado, ainda não pago; grava eclinica_ultima_cobranca_valor/vencimento/descricao no contato) e controle_laboratorio_novo ('Controle de laboratório' — grava eclinica_laboratorio_data_prevista/data_moldagem/data_entrega/situacao). ATENÇÃO: o mapeamento evento→flow NÃO é editável via MCP (somente pelo painel). [2026-07-25] Cada linha de reminder_config traz agora event_type ('agendamento' padrao, 'controle_laboratorio_novo' para lembrete de laboratorio/medicacao, 'cliente_inclusao_pagamento' para lembrete de vencimento de cobranca), dispatch_time (hora do disparo, OBRIGATORIA: 'HH:MM' fixo ou formula Liquid com variavel de conta/contato) e o filtro opcional filter_field/filter_operator/filter_value. Os lembretes NAO sao editaveis via MCP — somente pelo painel (Integracoes > e-Clinica > Lembretes). 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}}.",
+  "description": "Lista a integração e-Clínica da conta (no máximo 1 por conta) com id, status e configurações. Use PRIMEIRO para descobrir o {id} exigido pelas ferramentas de histórico de lembretes. Eventos mapeáveis incluem (23/07) os novos cliente_inclusao_pagamento ('Inclusão de cobrança' — cobrança/carnê criado, ainda não pago; grava eclinica_ultima_cobranca_valor/vencimento/descricao no contato) e controle_laboratorio_novo ('Controle de laboratório' — grava eclinica_laboratorio_data_prevista/data_moldagem/data_entrega/situacao). ATENÇÃO: o mapeamento evento→flow NÃO é editável via MCP (somente pelo painel). [2026-07-25] Cada linha de reminder_config traz agora event_type ('agendamento' padrao, 'controle_laboratorio_novo' para lembrete de laboratorio/medicacao, 'cliente_inclusao_pagamento' para lembrete de vencimento de cobranca), dispatch_time (hora do disparo, OBRIGATORIA: 'HH:MM' fixo ou formula Liquid com variavel de conta/contato) e o filtro opcional filter_field/filter_operator/filter_value. Os lembretes NAO sao editaveis via MCP — somente pelo painel (Integracoes > e-Clinica > Lembretes). 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, e paciente com duas consultas no dia recebe DOIS lembretes (o caminho por fluxo descarta o segundo) — avise o cliente antes de trocar fluxo por automacao.",
   "category": "Integracoes",
   "params": [],
   "returns": "200 {payload: {eclinica_integrations: [...]}}",
@@ -25344,7 +25379,7 @@
   "method": "PATCH",
   "path": "/api/v1/accounts/{account_id}/inboxes/{id}",
   "title": "Atualizar Caixa de Entrada",
-  "description": "Atualiza configurações da caixa (nome, saudação, atribuição automática, atributos extras). MUDANÇA DE CONFIG — confirme com o usuário antes. additional_attributes.mark_as_seen (bool, default true, SÓ WhatsApp oficial, 2026-06-11): envia o visto/check azul quando o agente abre a conversa — desligar em coexistência app+API. ATENÇÃO: enviar additional_attributes substitui o objeto; para WAHA prefira não mexer nesse campo (config sensível). Email (sincronizacao de mao dupla, admin, via objeto channel): two_way_sync_enabled, sync_sent, sync_deletions, sync_read, delete_strategy.",
+  "description": "Atualiza configurações da caixa (nome, saudação, atribuição automática, atributos extras). MUDANÇA DE CONFIG — confirme com o usuário antes. additional_attributes.mark_as_seen (bool, default true, SÓ WhatsApp oficial, 2026-06-11): envia o visto/check azul quando o agente abre a conversa — desligar em coexistência app+API. ATENÇÃO: enviar additional_attributes substitui o objeto; para WAHA prefira não mexer nesse campo (config sensível). Email (sincronizacao de mao dupla, admin, via objeto channel): two_way_sync_enabled, sync_sent, sync_deletions, sync_read, delete_strategy. CAIXA OFICIAL CRIADA A MAO (26/08): channel.provider_config aceita phone_number_id, business_account_id e api_key — mas o objeto SUBSTITUI o salvo: SEMPRE mande o provider_config INTEIRO (leia o atual antes e reenvie tudo com o campo alterado), senao webhook_verify_token e a marca source sao APAGADOS em silencio e a caixa para de receber. Os 3 campos sao validados JUNTOS na Meta a cada gravacao (422 'Invalid Credentials' = algum dos tres errado ou chave vencida). O telefone da caixa e somente leitura.",
   "category": "Caixas de Entrada",
   "params": [
    {
@@ -25573,7 +25608,7 @@
   "method": "POST",
   "path": "/api/v2/accounts/{account_id}/custom_dashboards/preview_widget",
   "title": "Calcular Bloco na Hora (sem salvar)",
-  "description": "[POST] Monta um bloco de relatorio NA HORA e devolve os numeros, SEM salvar nada. E a ferramenta pra responder pergunta de relatorio que nao tem grafico pronto — ex.: 'quantos cards foram GANHOS em cada etapa do funil X nos ultimos 30 dias' (funnel_stages + date_basis:closed + status:won). Nao existe consulta livre: escolha um `widget_type` e preencha SO os campos daquele tipo; o servidor revalida tudo antes de calcular. So administrador (401 caso contrario). Campo que nao esta na lista abaixo e DESCARTADO EM SILENCIO. Formato da resposta pelo campo `shape`: series {series:[{timestamp,value}]} (timestamp unix em segundos; metricas de tempo trazem tambem `count` por ponto) · categories {categories:[{label,value}]} (funnel_stages vem na ORDEM DAS ETAPAS, nunca por valor) · scalar {value,total,secondary} (use `total` pra separar 'ninguem respondeu' de 'zero legitimo'; SLA sem nenhum prazo aplicado devolve 100.0) · table {dimension,columns,rows,total} (o `total` NAO e a soma das linhas, e contagem propria por metrica). Erros: 401 = quem chamou NAO e administrador (nao mande reconectar o conector). 422 com {error} = desenho invalido ou recurso nao liberado (code:'feature_unavailable' distingue) — o motivo vem em texto, corrija e tente de novo. 422 com {message,attributes} = teto atingido (50 relatorios por conta, 12 blocos por relatorio). Tabela completa de tipos, metricas e armadilhas no resource lionchat://docs/reports-guide. TIPOS NOVOS (21/08): `calls_report` = tabela de LIGACOES (feitas, atendidas, nao atendidas, nao concluidas, tempo total e medio) por atendente (`dimension:'agent'`) ou por caixa (`dimension:'inbox'`); ligacao sem atendente ganha linha propria. `stage_entries` = quantos cards ENTRARAM em cada etapa de um funil no periodo, lido do historico de movimentacao — DIFERENTE de `funnel_stages`, que conta quem ESTA na etapa agora: card que entrou e depois saiu aparece no stage_entries e SOME do funnel_stages (medido: 25% de diferenca). Use stage_entries pra 'quantos agendamentos/negocios aconteceram' e funnel_stages pra 'como esta o funil hoje'. stage_entries conta CARD DISTINTO (card que reentra na etapa conta uma vez) e o historico so existe a partir de 12/07/2026, com retencao de 365 dias — periodo anterior devolve menos do que aconteceu. PARAM NOVO `measure` em funnel_stages e stage_entries: 'count' (padrao, conta cards) ou 'value' (soma o VALOR dos cards = faturamento). Com status:'won' + date_basis:'closed' + measure:'value' sai o faturamento ganho da etapa no periodo. PERIODOS NOVOS: 'today' e 'yesterday'. CAMPO NOVO `title` em cada bloco: o nome que aparece no cabecalho. Sem ele varios blocos do mesmo tipo saem com rotulos identicos e nem a pessoa nem o agente sabem qual e qual — SEMPRE nomeie.",
+  "description": "[POST] Monta um bloco de relatorio NA HORA e devolve os numeros, SEM salvar nada. E a ferramenta pra responder pergunta de relatorio que nao tem grafico pronto — ex.: 'quantos cards foram GANHOS em cada etapa do funil X nos ultimos 30 dias' (funnel_stages + date_basis:closed + status:won). Nao existe consulta livre: escolha um `widget_type` e preencha SO os campos daquele tipo; o servidor revalida tudo antes de calcular. So administrador (401 caso contrario). Campo que nao esta na lista abaixo e DESCARTADO EM SILENCIO. Formato da resposta pelo campo `shape`: series {series:[{timestamp,value}]} (timestamp unix em segundos; metricas de tempo trazem tambem `count` por ponto) · categories {categories:[{label,value}]} (funnel_stages vem na ORDEM DAS ETAPAS, nunca por valor) · scalar {value,total,secondary} (use `total` pra separar 'ninguem respondeu' de 'zero legitimo'; SLA sem nenhum prazo aplicado devolve 100.0) · table {dimension,columns,rows,total} (o `total` NAO e a soma das linhas, e contagem propria por metrica). Erros: 401 = quem chamou NAO e administrador (nao mande reconectar o conector). 422 com {error} = desenho invalido ou recurso nao liberado (code:'feature_unavailable' distingue) — o motivo vem em texto, corrija e tente de novo. 422 com {message,attributes} = teto atingido (50 relatorios por conta, 12 blocos por relatorio). Tabela completa de tipos, metricas e armadilhas no resource lionchat://docs/reports-guide. TIPOS NOVOS (21/08): `calls_report` = tabela de LIGACOES (feitas, atendidas, nao atendidas, nao concluidas, tempo total e medio) por atendente (`dimension:'agent'`) ou por caixa (`dimension:'inbox'`); ligacao sem atendente ganha linha propria. `stage_entries` = quantos cards ENTRARAM em cada etapa de um funil no periodo, lido do historico de movimentacao — DIFERENTE de `funnel_stages`, que conta quem ESTA na etapa agora: card que entrou e depois saiu aparece no stage_entries e SOME do funnel_stages (medido: 25% de diferenca). Use stage_entries pra 'quantos agendamentos/negocios aconteceram' e funnel_stages pra 'como esta o funil hoje'. stage_entries conta CARD DISTINTO (card que reentra na etapa conta uma vez) e o historico so existe a partir de 12/07/2026, com retencao de 365 dias — periodo anterior devolve menos do que aconteceu. PARAM NOVO `measure` em funnel_stages e stage_entries: 'count' (padrao, conta cards) ou 'value' (soma o VALOR dos cards = faturamento). Com status:'won' + date_basis:'closed' + measure:'value' sai o faturamento ganho da etapa no periodo. PERIODOS NOVOS: 'today' e 'yesterday'. CAMPO NOVO `title` em cada bloco: o nome que aparece no cabecalho. Sem ele varios blocos do mesmo tipo saem com rotulos identicos e nem a pessoa nem o agente sabem qual e qual — SEMPRE nomeie. TIPO NOVO (27/08, entra no ar com o PROXIMO deploy do app apos 27/08/2026 — antes disso o servidor recusa com 'widget_type desconhecido'): `stage_conversion` = CONVERSAO percentual entre grupos de etapas do funil, calculada pelo MOTOR: cards DISTINTOS que entraram nas etapas de `numerator_stage_ids` dividido pelos que entraram nas de `denominator_stage_ids` (listas de ids de etapa do funil — as chaves do hash stages do funnels_show), com `funnel_id` e `time_range`; chart_type 'number', shape scalar {value: percentual 1 casa, total: base do denominador (0 = sem dados), secondary: numerador/denominador nomeados}. Card que passou por DUAS etapas do denominador no periodo conta UMA vez (somar deflaria a conversao). Ex. real (Joint): Consulta Agendada dividido por Novos Leads + Agendamento Pendente. E o UNICO jeito de ter percentual confiavel no Aviso de relatorio (a IA do Aviso e PROIBIDA de calcular numeros). RECORTE POR CAIXA (26/08, ja no ar): em `agent_report` e `calls_report`, `scope_type:'inbox'` + `scope_id` recorta DE VERDADE pela caixa — membros da caixa contando SO o que fizeram NELA (antes os blocos saiam iguais pra qualquer caixa). `scope_type:'agent'/'team'` segue sendo recorte de PESSOAS (trabalho delas na conta inteira); 'inbox' + dimension 'team' e recusado. E `lead_origin` passou a respeitar `time_range` (antes ignorava o periodo).",
   "category": "Relatorios",
   "params": [
    {
@@ -25714,7 +25749,7 @@
   "method": "POST",
   "path": "/api/v2/accounts/{account_id}/custom_dashboards",
   "title": "Criar Relatorio Personalizado",
-  "description": "[POST] Cria um relatorio personalizado que passa a APARECER NA TELA do cliente, na aba 'Personalizados' de Relatorios. ALTERA O QUE O CLIENTE VE: exige confirm:true depois de confirmar com ele. So administrador (401 caso contrario). Cada bloco de `widgets` usa os MESMOS campos do preview_widget (teste o desenho la antes de salvar) e PRECISA de um `id` proprio e unico — se faltar, o servidor gera. Um bloco invalido barra a criacao INTEIRA com 422 e o motivo em texto: nunca salva pela metade. Tetos: 50 relatorios por conta, 12 blocos por relatorio. Erros: 401 = quem chamou NAO e administrador (nao mande reconectar o conector). 422 com {error} = desenho invalido ou recurso nao liberado (code:'feature_unavailable' distingue) — o motivo vem em texto, corrija e tente de novo. 422 com {message,attributes} = teto atingido (50 relatorios por conta, 12 blocos por relatorio). TIPOS NOVOS (21/08): `calls_report` = tabela de LIGACOES (feitas, atendidas, nao atendidas, nao concluidas, tempo total e medio) por atendente (`dimension:'agent'`) ou por caixa (`dimension:'inbox'`); ligacao sem atendente ganha linha propria. `stage_entries` = quantos cards ENTRARAM em cada etapa de um funil no periodo, lido do historico de movimentacao — DIFERENTE de `funnel_stages`, que conta quem ESTA na etapa agora: card que entrou e depois saiu aparece no stage_entries e SOME do funnel_stages (medido: 25% de diferenca). Use stage_entries pra 'quantos agendamentos/negocios aconteceram' e funnel_stages pra 'como esta o funil hoje'. stage_entries conta CARD DISTINTO (card que reentra na etapa conta uma vez) e o historico so existe a partir de 12/07/2026, com retencao de 365 dias — periodo anterior devolve menos do que aconteceu. PARAM NOVO `measure` em funnel_stages e stage_entries: 'count' (padrao, conta cards) ou 'value' (soma o VALOR dos cards = faturamento). Com status:'won' + date_basis:'closed' + measure:'value' sai o faturamento ganho da etapa no periodo. PERIODOS NOVOS: 'today' e 'yesterday'. CAMPO NOVO `title` em cada bloco: o nome que aparece no cabecalho. Sem ele varios blocos do mesmo tipo saem com rotulos identicos e nem a pessoa nem o agente sabem qual e qual — SEMPRE nomeie.",
+  "description": "[POST] Cria um relatorio personalizado que passa a APARECER NA TELA do cliente, na aba 'Personalizados' de Relatorios. ALTERA O QUE O CLIENTE VE: exige confirm:true depois de confirmar com ele. So administrador (401 caso contrario). Cada bloco de `widgets` usa os MESMOS campos do preview_widget (teste o desenho la antes de salvar) e PRECISA de um `id` proprio e unico — se faltar, o servidor gera. Um bloco invalido barra a criacao INTEIRA com 422 e o motivo em texto: nunca salva pela metade. Tetos: 50 relatorios por conta, 12 blocos por relatorio. Erros: 401 = quem chamou NAO e administrador (nao mande reconectar o conector). 422 com {error} = desenho invalido ou recurso nao liberado (code:'feature_unavailable' distingue) — o motivo vem em texto, corrija e tente de novo. 422 com {message,attributes} = teto atingido (50 relatorios por conta, 12 blocos por relatorio). TIPOS NOVOS (21/08): `calls_report` = tabela de LIGACOES (feitas, atendidas, nao atendidas, nao concluidas, tempo total e medio) por atendente (`dimension:'agent'`) ou por caixa (`dimension:'inbox'`); ligacao sem atendente ganha linha propria. `stage_entries` = quantos cards ENTRARAM em cada etapa de um funil no periodo, lido do historico de movimentacao — DIFERENTE de `funnel_stages`, que conta quem ESTA na etapa agora: card que entrou e depois saiu aparece no stage_entries e SOME do funnel_stages (medido: 25% de diferenca). Use stage_entries pra 'quantos agendamentos/negocios aconteceram' e funnel_stages pra 'como esta o funil hoje'. stage_entries conta CARD DISTINTO (card que reentra na etapa conta uma vez) e o historico so existe a partir de 12/07/2026, com retencao de 365 dias — periodo anterior devolve menos do que aconteceu. PARAM NOVO `measure` em funnel_stages e stage_entries: 'count' (padrao, conta cards) ou 'value' (soma o VALOR dos cards = faturamento). Com status:'won' + date_basis:'closed' + measure:'value' sai o faturamento ganho da etapa no periodo. PERIODOS NOVOS: 'today' e 'yesterday'. CAMPO NOVO `title` em cada bloco: o nome que aparece no cabecalho. Sem ele varios blocos do mesmo tipo saem com rotulos identicos e nem a pessoa nem o agente sabem qual e qual — SEMPRE nomeie. TIPO NOVO (27/08, entra no ar com o PROXIMO deploy do app apos 27/08/2026 — antes disso o servidor recusa com 'widget_type desconhecido'): `stage_conversion` = CONVERSAO percentual entre grupos de etapas do funil, calculada pelo MOTOR: cards DISTINTOS que entraram nas etapas de `numerator_stage_ids` dividido pelos que entraram nas de `denominator_stage_ids` (listas de ids de etapa do funil — as chaves do hash stages do funnels_show), com `funnel_id` e `time_range`; chart_type 'number', shape scalar {value: percentual 1 casa, total: base do denominador (0 = sem dados), secondary: numerador/denominador nomeados}. Card que passou por DUAS etapas do denominador no periodo conta UMA vez (somar deflaria a conversao). Ex. real (Joint): Consulta Agendada dividido por Novos Leads + Agendamento Pendente. E o UNICO jeito de ter percentual confiavel no Aviso de relatorio (a IA do Aviso e PROIBIDA de calcular numeros). RECORTE POR CAIXA (26/08, ja no ar): em `agent_report` e `calls_report`, `scope_type:'inbox'` + `scope_id` recorta DE VERDADE pela caixa — membros da caixa contando SO o que fizeram NELA (antes os blocos saiam iguais pra qualquer caixa). `scope_type:'agent'/'team'` segue sendo recorte de PESSOAS (trabalho delas na conta inteira); 'inbox' + dimension 'team' e recusado. E `lead_origin` passou a respeitar `time_range` (antes ignorava o periodo).",
   "category": "Relatorios",
   "params": [
    {
@@ -25756,7 +25791,7 @@
   "method": "PATCH",
   "path": "/api/v2/accounts/{account_id}/custom_dashboards/{id}",
   "title": "Alterar Relatorio Personalizado",
-  "description": "[PATCH] Altera um relatorio personalizado. ALTERA O QUE O CLIENTE VE: exige confirm:true depois de confirmar com ele. So administrador (401 caso contrario). ATENCAO — `widgets` SUBSTITUI a lista inteira, nao acrescenta: mandar um bloco APAGA os outros. Leia o relatorio com custom_dashboards_list, altere o array e devolva-o COMPLETO. Se a listagem tiver vindo cortada, NAO use: voce apagaria o que nao chegou. Nao ha historico de alteracao — bloco apagado nao volta. Erros: 401 = quem chamou NAO e administrador (nao mande reconectar o conector). 422 com {error} = desenho invalido ou recurso nao liberado (code:'feature_unavailable' distingue) — o motivo vem em texto, corrija e tente de novo. 422 com {message,attributes} = teto atingido (50 relatorios por conta, 12 blocos por relatorio). TIPOS NOVOS (21/08): `calls_report` = tabela de LIGACOES (feitas, atendidas, nao atendidas, nao concluidas, tempo total e medio) por atendente (`dimension:'agent'`) ou por caixa (`dimension:'inbox'`); ligacao sem atendente ganha linha propria. `stage_entries` = quantos cards ENTRARAM em cada etapa de um funil no periodo, lido do historico de movimentacao — DIFERENTE de `funnel_stages`, que conta quem ESTA na etapa agora: card que entrou e depois saiu aparece no stage_entries e SOME do funnel_stages (medido: 25% de diferenca). Use stage_entries pra 'quantos agendamentos/negocios aconteceram' e funnel_stages pra 'como esta o funil hoje'. stage_entries conta CARD DISTINTO (card que reentra na etapa conta uma vez) e o historico so existe a partir de 12/07/2026, com retencao de 365 dias — periodo anterior devolve menos do que aconteceu. PARAM NOVO `measure` em funnel_stages e stage_entries: 'count' (padrao, conta cards) ou 'value' (soma o VALOR dos cards = faturamento). Com status:'won' + date_basis:'closed' + measure:'value' sai o faturamento ganho da etapa no periodo. PERIODOS NOVOS: 'today' e 'yesterday'. CAMPO NOVO `title` em cada bloco: o nome que aparece no cabecalho. Sem ele varios blocos do mesmo tipo saem com rotulos identicos e nem a pessoa nem o agente sabem qual e qual — SEMPRE nomeie.",
+  "description": "[PATCH] Altera um relatorio personalizado. ALTERA O QUE O CLIENTE VE: exige confirm:true depois de confirmar com ele. So administrador (401 caso contrario). ATENCAO — `widgets` SUBSTITUI a lista inteira, nao acrescenta: mandar um bloco APAGA os outros. Leia o relatorio com custom_dashboards_list, altere o array e devolva-o COMPLETO. Se a listagem tiver vindo cortada, NAO use: voce apagaria o que nao chegou. Nao ha historico de alteracao — bloco apagado nao volta. Erros: 401 = quem chamou NAO e administrador (nao mande reconectar o conector). 422 com {error} = desenho invalido ou recurso nao liberado (code:'feature_unavailable' distingue) — o motivo vem em texto, corrija e tente de novo. 422 com {message,attributes} = teto atingido (50 relatorios por conta, 12 blocos por relatorio). TIPOS NOVOS (21/08): `calls_report` = tabela de LIGACOES (feitas, atendidas, nao atendidas, nao concluidas, tempo total e medio) por atendente (`dimension:'agent'`) ou por caixa (`dimension:'inbox'`); ligacao sem atendente ganha linha propria. `stage_entries` = quantos cards ENTRARAM em cada etapa de um funil no periodo, lido do historico de movimentacao — DIFERENTE de `funnel_stages`, que conta quem ESTA na etapa agora: card que entrou e depois saiu aparece no stage_entries e SOME do funnel_stages (medido: 25% de diferenca). Use stage_entries pra 'quantos agendamentos/negocios aconteceram' e funnel_stages pra 'como esta o funil hoje'. stage_entries conta CARD DISTINTO (card que reentra na etapa conta uma vez) e o historico so existe a partir de 12/07/2026, com retencao de 365 dias — periodo anterior devolve menos do que aconteceu. PARAM NOVO `measure` em funnel_stages e stage_entries: 'count' (padrao, conta cards) ou 'value' (soma o VALOR dos cards = faturamento). Com status:'won' + date_basis:'closed' + measure:'value' sai o faturamento ganho da etapa no periodo. PERIODOS NOVOS: 'today' e 'yesterday'. CAMPO NOVO `title` em cada bloco: o nome que aparece no cabecalho. Sem ele varios blocos do mesmo tipo saem com rotulos identicos e nem a pessoa nem o agente sabem qual e qual — SEMPRE nomeie. TIPO NOVO (27/08, entra no ar com o PROXIMO deploy do app apos 27/08/2026 — antes disso o servidor recusa com 'widget_type desconhecido'): `stage_conversion` = CONVERSAO percentual entre grupos de etapas do funil, calculada pelo MOTOR: cards DISTINTOS que entraram nas etapas de `numerator_stage_ids` dividido pelos que entraram nas de `denominator_stage_ids` (listas de ids de etapa do funil — as chaves do hash stages do funnels_show), com `funnel_id` e `time_range`; chart_type 'number', shape scalar {value: percentual 1 casa, total: base do denominador (0 = sem dados), secondary: numerador/denominador nomeados}. Card que passou por DUAS etapas do denominador no periodo conta UMA vez (somar deflaria a conversao). Ex. real (Joint): Consulta Agendada dividido por Novos Leads + Agendamento Pendente. E o UNICO jeito de ter percentual confiavel no Aviso de relatorio (a IA do Aviso e PROIBIDA de calcular numeros). RECORTE POR CAIXA (26/08, ja no ar): em `agent_report` e `calls_report`, `scope_type:'inbox'` + `scope_id` recorta DE VERDADE pela caixa — membros da caixa contando SO o que fizeram NELA (antes os blocos saiam iguais pra qualquer caixa). `scope_type:'agent'/'team'` segue sendo recorte de PESSOAS (trabalho delas na conta inteira); 'inbox' + dimension 'team' e recusado. E `lead_origin` passou a respeitar `time_range` (antes ignorava o periodo).",
   "category": "Relatorios",
   "params": [
    {
@@ -30858,7 +30893,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento evento -> {automation_id | flow_id, first_purchase_only?: bool (pula renovações), conversation_attribute_keys?: [chaves de atributo de conversa a preencher, respeitando o tipo]} — ids precisam ser desta conta (422)"
+    "description": "Mapeamento evento -> {automation_id | flow_id, first_purchase_only?: bool (pula renovações)} — ids precisam ser desta conta (422). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto; o backend ignora a chave se gravada"
    }
   ],
   "returns": "webhook criado (com novo ID e webhook_url)",
@@ -30952,7 +30987,7 @@
     "type": "object",
     "location": "body",
     "required": false,
-    "description": "Mapeamento evento -> {automation_id | flow_id, first_purchase_only?: bool (pula renovações), conversation_attribute_keys?: [chaves de atributo de conversa a preencher, respeitando o tipo]} — ids precisam ser desta conta (422)"
+    "description": "Mapeamento evento -> {automation_id | flow_id, first_purchase_only?: bool (pula renovações)} — ids precisam ser desta conta (422). ATENCAO (26/08/2026): conversation_attribute_keys foi REMOVIDA do produto; o backend ignora a chave se gravada"
    }
   ],
   "returns": "webhook atualizado",
@@ -31372,6 +31407,105 @@
    "lionchat_meta_lead_create_1"
   ]
  },
+ {
+  "id": "lionchat_meta_lead_ads_token",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/integrations/meta_lead/ads_token",
+  "title": "Gravar Token de Anuncios (Meta Lead)",
+  "description": "[POST] Grava o token de ANUNCIOS da Meta colado a mao pelo cliente — e de CONTA (vale pra todas as paginas conectadas), nao de pagina. Com ele os leads passam a mostrar NOME de campanha/conjunto/anuncio em vez de so ids, e o servidor ja reprocessa retroativamente os leads que ficaram sem nome. Mandar vazio LIMPA o token. Valide antes com meta_lead_validate_token. Resposta: {meta} com a situacao do token. A resposta e {meta:{ads_capable, has_manual_ads_token}} — os MESMOS booleanos que aparecem em cada integracao do meta_lead_list (e no meta de conta): ads_capable = a conta consegue resolver nomes; has_manual_ads_token = ha token colado a mao. Os campos com os NOMES ja resolvidos moram em conversation.custom_attributes com prefixo ctwa_ (conversa vinda de anuncio) e em contact.custom_attributes com prefixo meta_lead_ (lead de formulario) — existem desde antes; o token so habilita o preenchimento.",
+  "category": "Integracoes",
+  "params": [
+   {
+    "name": "manual_ads_token",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Token de anuncios da Meta (System User ou usuario com acesso a conta de anuncios). Vazio/ausente limpa o token salvo."
+   }
+  ],
+  "returns": "{meta: situacao do token de anuncios}",
+  "common_use_cases": [
+   "Ligar a resolucao de nomes de campanha/conjunto/anuncio nos leads"
+  ],
+  "related_tools": [
+   "lionchat_meta_lead_validate_token",
+   "lionchat_meta_lead_list"
+  ]
+ },
+ {
+  "id": "lionchat_meta_lead_validate_token",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/integrations/meta_lead/validate_token",
+  "title": "Testar Token de Anuncios (Meta Lead)",
+  "description": "[POST] Confere o token de anuncios NA HORA, sem gravar nada: valido? de qual app? quais permissoes? alcanca anuncio de verdade? Sem manual_ads_token no corpo, testa o token JA SALVO. Resposta: {data} com o raio-x do token. Use pra diagnosticar 'os leads chegam so com id de campanha' antes de pedir token novo ao cliente.",
+  "category": "Integracoes",
+  "params": [
+   {
+    "name": "manual_ads_token",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Token a testar. Ausente = testa o token salvo na conta."
+   }
+  ],
+  "returns": "{data: diagnostico do token}",
+  "common_use_cases": [
+   "Diagnosticar por que o nome da campanha nao aparece nos leads"
+  ],
+  "related_tools": [
+   "lionchat_meta_lead_ads_token"
+  ]
+ },
+ {
+  "id": "lionchat_meta_lead_bulk_destroy",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/integrations/meta_lead/bulk_destroy",
+  "title": "Desconectar Paginas em Lote (Meta Lead)",
+  "description": "[POST] Remove VARIAS paginas conectadas de uma vez (assincrono — resposta 202 com {meta:{queued:N}}). Existiu porque ate 25/08 o conectar trazia TODAS as paginas do Facebook do cliente sem escolha (caso real: 25 paginas na Onipresenca) — esta e a ferramenta de limpeza. REMOVE integracoes de verdade: exige confirm:true depois de listar pro cliente QUAIS paginas vao sair. 422 se nenhum id for da conta.",
+  "category": "Integracoes",
+  "confirm_required": true,
+  "params": [
+   {
+    "name": "ids",
+    "type": "array",
+    "location": "body",
+    "required": true,
+    "description": "Ids das integracoes de pagina a remover (campo id de cada item do meta_lead_list — id da INTEGRACAO, nao da pagina do Facebook)"
+   }
+  ],
+  "returns": "202 {meta:{queued:N}}",
+  "common_use_cases": [
+   "Limpar paginas que entraram sem escolha na conexao antiga"
+  ],
+  "related_tools": [
+   "lionchat_meta_lead_list",
+   "lionchat_meta_lead_destroy"
+  ]
+ },
+ {
+  "id": "lionchat_meta_lead_sync_forms",
+  "method": "POST",
+  "path": "/api/v1/accounts/{account_id}/integrations/meta_lead/{id}/sync_forms",
+  "title": "Sincronizar Formularios da Pagina (Meta Lead)",
+  "description": "[POST] Re-busca na Meta os formularios de lead da pagina conectada. Erro de PERMISSAO nao vira 422: volta 200 com meta.warnings e mode:'reactive' (a pagina segue funcionando no modo reativo — os formularios aparecem conforme os leads chegam). So token EXPIRADO da 422 (cliente precisa reconectar).",
+  "category": "Integracoes",
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "Id da integracao da pagina (meta_lead_list)"
+   }
+  ],
+  "returns": "{data: formularios, meta: {warnings?, mode?}}",
+  "common_use_cases": [
+   "Formulario novo criado na Meta nao aparece na lista"
+  ],
+  "related_tools": [
+   "lionchat_meta_lead_list"
+  ]
+ },
  {
   "id": "lionchat_reporting_events_list",
   "method": "GET",
@@ -31647,7 +31781,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.",
+  "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, e paciente com duas consultas no dia recebe DOIS lembretes (o caminho por fluxo descarta o segundo) — avise o cliente antes de trocar fluxo por automacao.",
   "category": "Integracoes",
   "params": [
    {
@@ -31829,5 +31963,370 @@
    "lionchat_custom_dashboards_widget_data",
    "lionchat_custom_dashboards_update"
   ]
+ },
+ {
+  "id": "lionchat_report_alerts_list",
+  "method": "GET",
+  "path": "/api/v2/accounts/{account_id}/report_alerts",
+  "title": "Listar Avisos de Relatorio",
+  "description": "[GET] Lista os Avisos da conta (aba Relatorios > Avisos): envio diario do resumo de um relatorio personalizado num grupo/conversa de WhatsApp QR, com texto escrito pela IA da conta. Retorna {payload:[...]} com, por aviso: custom_dashboard_id/_name, inbox_id/_name, conversation_display_id, destination_name, send_hour, frequency (daily|weekdays), enabled, next_send_on (proximo envio previsto, fuso da conta), last_sent_on, last_attempt_at, last_delivery_status (generating|sent|confirmed|send_failed|skipped_late|error), last_error e text_prompt. So administrador (401 caso contrario). Teto: 10 avisos por conta.",
+  "category": "Relatorios",
+  "params": [],
+  "returns": "{payload: [avisos]}",
+  "common_use_cases": [
+   "Ver quais resumos diarios a conta manda no WhatsApp e a situacao do ultimo envio",
+   "Diagnosticar por que o resumo nao chegou (last_delivery_status/last_error)",
+   "Descobrir o id do aviso antes de editar/ligar/desligar"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_create",
+   "lionchat_report_alerts_deliveries",
+   "lionchat_custom_dashboards_list"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_show",
+  "method": "GET",
+  "path": "/api/v2/accounts/{account_id}/report_alerts/{id}",
+  "title": "Ver Aviso de Relatorio",
+  "description": "[GET] Um Aviso so, com os mesmos campos da lista. So administrador (401 caso contrario); 404 se nao e da conta.",
+  "category": "Relatorios",
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "Id do aviso (vem do report_alerts_list)"
+   }
+  ],
+  "returns": "objeto do aviso",
+  "common_use_cases": [
+   "Conferir a configuracao exata antes de um update"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_list",
+   "lionchat_report_alerts_update"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_create",
+  "method": "POST",
+  "path": "/api/v2/accounts/{account_id}/report_alerts",
+  "title": "Criar Aviso de Relatorio",
+  "description": "[POST] Cria o envio diario do resumo de um relatorio personalizado num grupo/conversa de WhatsApp. MANDA MENSAGEM REAL NO WHATSAPP DO CLIENTE TODO DIA: exige confirm:true depois de confirmar destino, horario e relatorio com a pessoa. So administrador. FLUXO SEGURO (aprendido em producao 27/08): 1) crie com enabled:false; 2) rode report_alerts_preview e leia o texto com preview_status; 3) so entao ligue (update enabled:true) — criado LIGADO dentro da janela do dia (send_hour ate +3h, fuso da conta) dispara no proximo tick de hora. Regras do servidor: caixa PRECISA ser WhatsApp QR; a conversa precisa ser da MESMA caixa; teto 10 por conta; a mensagem sai como MENSAGEM DE SISTEMA na conversa (automacoes e fluxos ativos NAQUELA conversa reagem a ela; nao conta como resposta de atendente, nao mexe em SLA nem zera 'cliente aguardando'). O texto interno usa **negrito** e vira negrito do WhatsApp no envio. Erros 422 vem com a explicacao em texto (ex.: 'a caixa escolhida não é mais uma caixa QR').",
+  "category": "Relatorios",
+  "body_wrapper": "report_alert",
+  "confirm_required": true,
+  "params": [
+   {
+    "name": "custom_dashboard_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Relatorio personalizado cujo resumo sera enviado (vem do custom_dashboards_list). Obrigatorio no create."
+   },
+   {
+    "name": "inbox_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Caixa que ENVIA — PRECISA ser WhatsApp QR (Channel::Waha; confira channel_type no inboxes_list). A API oficial e recusada (so manda modelo aprovado). Obrigatorio no create."
+   },
+   {
+    "name": "conversation_display_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Numero da conversa/grupo de DESTINO como aparece na tela e nas tools de conversa (o servidor resolve pro id interno). Use ESTE ou conversation_id — a conversa precisa ser DA MESMA caixa do inbox_id. Pra achar grupo pelo nome: conversations_list com inbox_id + busca."
+   },
+   {
+    "name": "conversation_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Id INTERNO da conversa de destino (alternativa ao conversation_display_id; na duvida use o display)."
+   },
+   {
+    "name": "send_hour",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Hora do envio (0-23) NO FUSO DA CONTA (campo timezone do account_show; sem fuso = America/Sao_Paulo). Default 7. Tolerancia de 3h: tick perdido sai atrasado; passou da janela = 'skipped_late' visivel e tenta de novo amanha."
+   },
+   {
+    "name": "frequency",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "daily (todo dia, default) ou weekdays (segunda a sexta)."
+   },
+   {
+    "name": "period",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Janela dos numeros. Hoje so 'yesterday' (ontem no fuso da conta) — e o default; nao ha outros valores."
+   },
+   {
+    "name": "text_prompt",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Instrucoes pra IA escrever o texto (ate 2000 chars), usando a chave OpenAI DA CONTA. Sem prompt ou sem chave = texto padrao do sistema (fiel, bloco a bloco). GOTCHAS medidos em producao: a conferencia de numeros REPROVA qualquer numero que nao exista no relatorio (a IA NUNCA calcula percentual/soma — percentual confiavel = bloco stage_conversion no relatorio) e prompt que pede pra RENOMEAR/reorganizar secoes ja fez a IA trocar rotulos de numeros (caso real 27/08). O prompt que funciona: 'mantenha os titulos e TODOS os numeros exatamente como estao, nao renomeie secoes, nao calcule nada, inclua TODOS os blocos'."
+   },
+   {
+    "name": "enabled",
+    "type": "boolean",
+    "location": "body",
+    "required": false,
+    "description": "Liga/desliga o envio automatico. ATENCAO (incidente real 27/08): criar LIGADO dentro da janela do dia (entre send_hour e send_hour+3h no fuso da conta) DISPARA no proximo tick de hora — se ainda vai validar a previa, crie com enabled:false e ligue depois."
+   }
+  ],
+  "returns": "objeto do aviso criado (com next_send_on)",
+  "common_use_cases": [
+   "Configurar o resumo comercial diario da conta num grupo de gestao",
+   "Migrar uma rotina externa de relatorio pro envio nativo do sistema"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_preview",
+   "lionchat_report_alerts_update",
+   "lionchat_report_alerts_send_now",
+   "lionchat_custom_dashboards_show"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_update",
+  "method": "PATCH",
+  "path": "/api/v2/accounts/{account_id}/report_alerts/{id}",
+  "title": "Editar Aviso de Relatorio",
+  "description": "[PATCH] Edita um Aviso (qualquer campo do create, todos opcionais — inclusive enabled pra ligar/desligar). ALTERA um envio automatico real: exige confirm:true. So administrador. GOTCHA de ligar (enabled:true): se ainda estiver dentro da janela do dia (send_hour ate +3h no fuso da conta) e o aviso nao enviou hoje, ele DISPARA no proximo tick de hora; religado FORA da janela ganha 'skipped_late' de hoje (linha ambar inofensiva) e roda normal amanha.",
+  "category": "Relatorios",
+  "body_wrapper": "report_alert",
+  "confirm_required": true,
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "Id do aviso"
+   },
+   {
+    "name": "custom_dashboard_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Relatorio personalizado cujo resumo sera enviado (vem do custom_dashboards_list). Obrigatorio no create."
+   },
+   {
+    "name": "inbox_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Caixa que ENVIA — PRECISA ser WhatsApp QR (Channel::Waha; confira channel_type no inboxes_list). A API oficial e recusada (so manda modelo aprovado). Obrigatorio no create."
+   },
+   {
+    "name": "conversation_display_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Numero da conversa/grupo de DESTINO como aparece na tela e nas tools de conversa (o servidor resolve pro id interno). Use ESTE ou conversation_id — a conversa precisa ser DA MESMA caixa do inbox_id. Pra achar grupo pelo nome: conversations_list com inbox_id + busca."
+   },
+   {
+    "name": "conversation_id",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Id INTERNO da conversa de destino (alternativa ao conversation_display_id; na duvida use o display)."
+   },
+   {
+    "name": "send_hour",
+    "type": "integer",
+    "location": "body",
+    "required": false,
+    "description": "Hora do envio (0-23) NO FUSO DA CONTA (campo timezone do account_show; sem fuso = America/Sao_Paulo). Default 7. Tolerancia de 3h: tick perdido sai atrasado; passou da janela = 'skipped_late' visivel e tenta de novo amanha."
+   },
+   {
+    "name": "frequency",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "daily (todo dia, default) ou weekdays (segunda a sexta)."
+   },
+   {
+    "name": "period",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Janela dos numeros. Hoje so 'yesterday' (ontem no fuso da conta) — e o default; nao ha outros valores."
+   },
+   {
+    "name": "text_prompt",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Instrucoes pra IA escrever o texto (ate 2000 chars), usando a chave OpenAI DA CONTA. Sem prompt ou sem chave = texto padrao do sistema (fiel, bloco a bloco). GOTCHAS medidos em producao: a conferencia de numeros REPROVA qualquer numero que nao exista no relatorio (a IA NUNCA calcula percentual/soma — percentual confiavel = bloco stage_conversion no relatorio) e prompt que pede pra RENOMEAR/reorganizar secoes ja fez a IA trocar rotulos de numeros (caso real 27/08). O prompt que funciona: 'mantenha os titulos e TODOS os numeros exatamente como estao, nao renomeie secoes, nao calcule nada, inclua TODOS os blocos'."
+   },
+   {
+    "name": "enabled",
+    "type": "boolean",
+    "location": "body",
+    "required": false,
+    "description": "Liga/desliga o envio automatico. ATENCAO (incidente real 27/08): criar LIGADO dentro da janela do dia (entre send_hour e send_hour+3h no fuso da conta) DISPARA no proximo tick de hora — se ainda vai validar a previa, crie com enabled:false e ligue depois."
+   }
+  ],
+  "returns": "objeto do aviso atualizado",
+  "common_use_cases": [
+   "Ligar o aviso depois de validar a previa",
+   "Trocar o destino/horario/prompt",
+   "Desligar sem apagar"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_show",
+   "lionchat_report_alerts_preview"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_destroy",
+  "method": "DELETE",
+  "path": "/api/v2/accounts/{account_id}/report_alerts/{id}",
+  "title": "Excluir Aviso de Relatorio",
+  "description": "[DELETE] Apaga o aviso E o historico de envios dele (irreversivel). Exige confirm:true depois de confirmar com a pessoa. Se a ideia e so parar de mandar, prefira update com enabled:false (mantem configuracao e historico).",
+  "category": "Relatorios",
+  "confirm_required": true,
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "Id do aviso"
+   }
+  ],
+  "returns": "204 sem corpo",
+  "common_use_cases": [
+   "Remover de vez um aviso que nao faz mais sentido"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_update"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_send_now",
+  "method": "POST",
+  "path": "/api/v2/accounts/{account_id}/report_alerts/{id}/send_now",
+  "title": "Enviar Aviso Agora (teste real)",
+  "description": "[POST] Dispara o aviso AGORA como teste: compoe com os numeros de ontem e ENVIA DE VERDADE no destino configurado — o grupo/conversa do cliente RECEBE a mensagem. Exige confirm:true SEMPRE, nomeando o destino ('vou mandar o resumo agora no grupo X, confirma?'). Nao consome o envio automatico do dia (o das send_hour continua saindo) e funciona mesmo com o aviso desligado. Resposta 200 = entrou na fila (o resultado real aparece no historico ~3-20 min depois, via report_alerts_deliveries, marcado test_mode:true). 429 = trava de 60s por aviso (um teste ja esta a caminho — nunca repita o clique). Pra ver o TEXTO sem enviar nada, use report_alerts_preview.",
+  "category": "Relatorios",
+  "confirm_required": true,
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "Id do aviso"
+   }
+  ],
+  "returns": "200 sem corpo (na fila) | 429 (trava de 60s)",
+  "common_use_cases": [
+   "Validar o envio de ponta a ponta com o cliente acompanhando o grupo"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_preview",
+   "lionchat_report_alerts_deliveries"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_deliveries",
+  "method": "GET",
+  "path": "/api/v2/accounts/{account_id}/report_alerts/{id}/deliveries",
+  "title": "Historico de Envios do Aviso",
+  "description": "[GET] Historico dos envios do aviso (90 dias, ate 100 linhas, mais novo primeiro): {payload:[{id, status, mode, test_mode, error_message, content_snapshot, created_at}]}. status: sent (saiu, aguardando recibo) -> confirmed (ENTREGUE com recibo do canal — o selo verde so existe com evidencia) | send_failed (recusado, motivo em error_message) | skipped_late (nao saiu no horario — sistema congestionado) | error (falha antes do envio). mode: ai (texto escrito pela IA) ou system/default (texto padrao). content_snapshot = o TEXTO EXATO enviado, congelado (apagar a mensagem na conversa nao apaga o historico). test_mode:true = disparo manual de teste.",
+  "category": "Relatorios",
+  "params": [
+   {
+    "name": "id",
+    "type": "integer",
+    "location": "path",
+    "required": true,
+    "description": "Id do aviso"
+   }
+  ],
+  "returns": "{payload: [envios]}",
+  "common_use_cases": [
+   "Auditar o que a IA escreveu em cada dia",
+   "Investigar 'o grupo nao recebeu' (status + error_message)",
+   "Conferir se o teste do send_now chegou"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_send_now",
+   "lionchat_report_alerts_list"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_preview",
+  "method": "POST",
+  "path": "/api/v2/accounts/{account_id}/report_alerts/preview",
+  "title": "Previa do Aviso (nao envia nada)",
+  "description": "[POST] Gera a PREVIA do texto do aviso SEM enviar nada — mesmo motor do envio real (blocos de ontem + IA da conta quando ha prompt/chave). ASSINCRONA: devolve {token} na hora e o texto sai depois; leia com report_alerts_preview_status (o job roda em fila de baixa prioridade — normalmente 5-60s, pode passar de 2 min com a plataforma cheia; o resultado fica guardado 5 min). O aviso NEM PRECISA existir: basta custom_dashboard_id (+ text_prompt opcional). Use SEMPRE antes de ligar um aviso novo ou depois de mudar o prompt.",
+  "category": "Relatorios",
+  "body_wrapper": "report_alert",
+  "params": [
+   {
+    "name": "custom_dashboard_id",
+    "type": "integer",
+    "location": "body",
+    "required": true,
+    "description": "Relatorio personalizado a resumir"
+   },
+   {
+    "name": "text_prompt",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "Instrucoes pra IA (mesmas regras do create; ate 2000 chars)"
+   },
+   {
+    "name": "period",
+    "type": "string",
+    "location": "body",
+    "required": false,
+    "description": "So 'yesterday' hoje (default)"
+   }
+  ],
+  "returns": "{token: hex de 32 chars}",
+  "common_use_cases": [
+   "Validar o texto com o cliente ANTES de ligar o envio automatico"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_preview_status",
+   "lionchat_report_alerts_create"
+  ]
+ },
+ {
+  "id": "lionchat_report_alerts_preview_status",
+  "method": "GET",
+  "path": "/api/v2/accounts/{account_id}/report_alerts/preview_status",
+  "title": "Resultado da Previa do Aviso",
+  "description": "[GET] Le o resultado da previa pelo token: {status:'pending'} (job ainda na fila — espere 5-10s e tente de novo, ate ~2-3 min) | {status:'ready', text, mode} (texto pronto; mode 'ai' ou 'default') | {status:'error', error}. O resultado expira em 5 min apos ficar pronto; token fora do formato (32 hex) = 422. Se expirar, rode report_alerts_preview de novo (cada rodada com IA gasta a chave OpenAI da conta — nao repita a toa).",
+  "category": "Relatorios",
+  "params": [
+   {
+    "name": "token",
+    "type": "string",
+    "location": "query",
+    "required": true,
+    "description": "Token devolvido pelo report_alerts_preview (32 caracteres hex)"
+   }
+  ],
+  "returns": "{status, text?, mode?, error?}",
+  "common_use_cases": [
+   "Polling do texto da previa"
+  ],
+  "related_tools": [
+   "lionchat_report_alerts_preview"
+  ]
  }
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "1.16.0",
+  "version": "1.18.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",