@lionchat/mcp-server 1.13.0 → 1.14.0

package/dist/docs/instructions.md

@@ -19,8 +19,11 @@ Comprovado em produção (24/07): a sessão que dizia "não há função de list
   kanban_items, funnels, flows, flow_tools, campaigns, macros, automation_rules, agents, teams,
   inboxes, labels, canned_responses, reports, sla, csat, captain_assistants, captain_documents,
   scheduled_messages, custom_attributes, webhooks, eclinica_integrations, tasks, notifications,
-  lead_forms (Formulários públicos de captação), guru_subscription (gestão da assinatura da PRÓPRIA
-  conta no LionChat — feature liberada conta a conta).
+  lead_forms (Formulários públicos de captação).
+- **Fora do MCP por decisão do dono (19/08): assinatura, plano, fatura, forma de pagamento, cartão,
+  saldo e recarga.** Não existem ferramentas dessas áreas e não devem ser criadas. Se o usuário
+  pedir, diga que isso se resolve no painel, na área de assinatura da conta — não tente por
+  ferramenta nem por chamada direta.
 - Só depois de pesquisar e não encontrar é que se pode dizer que a função não existe.
 - **Trabalho volumoso** (relatório de muitas conversas/cards): as listas são paginadas (25-100 por
   página) — faça em ETAPAS ao longo de várias respostas, acumulando os resultados; nunca desista
@@ -364,7 +367,9 @@ Antes de escolher a ferramenta, cheque se a intenção bate com a coluna da dire
 | Só a contagem / números | `lionchat_conversations_meta` / `lionchat_reports_summary` | Não liste o conteúdo completo |
 | Criar contato | `lionchat_contacts_create` base (path `/contacts`) | NÃO use as variantes `_1` … `_9` |
 | Pausar a IA agora (botão de pânico) | `lionchat_captain_assistants_update` (`paused: true`, top-level) | — |
-| Criar/editar **formulário público de captação** (página de captura própria) | `lionchat_lead_forms_create` / `_update` | Leia `lionchat://docs/formularios-publicos` ANTES — o desenho vai em `form_data` e só entra no ar depois do `publish` (que valida o desenho e pode voltar 422 com a lista de pendências). Escrita é só de administrador |
+| Criar/editar **formulário público de captação** (página de captura própria) | `lionchat_lead_forms_create` / `_update` | Leia `lionchat://docs/formularios-publicos` ANTES — o desenho vai em `form_data` e só entra no ar depois do `publish` (que valida o desenho e pode voltar 422 com a lista de pendências). Caixa de WhatsApp vinculada (`inbox_id`) é obrigatória pra publicar. Escrita é só de administrador |
+| **Testar um formulário** antes de publicar | `lionchat_lead_forms_test_run` | Roda o RASCUNHO no motor real e desfaz tudo no fim — zero rastro. Mande `answers: [{node_id, value}]` (até 60) pra reproduzir um caminho; a resposta traz o bloco atual + o log do percurso |
+| Conferir se um site **aceita ser exibido dentro do formulário** (bloco Página externa) | `lionchat_lead_forms_check_embed` | Body `{url}`; devolve `{status: allowed\|blocked\|unknown, reason}`. Grave o veredito em `embed_allowed` do bloco. Admin-only |
 | Anexar arquivo a uma mensagem | `lionchat_upload_create` primeiro, depois usar o retorno em `lionchat_conversations_messages_create` | Confira `lionchat_upload_limits` se o arquivo for grande |
 | Marcar conversa como **lida** | `lionchat_conversations_update_last_seen` | NÃO use `unread` (esse marca como NÃO-lida) |
 | Criar/gerenciar **campanha** (disparo WhatsApp/SMS) | `lionchat_campaigns_*` (criar, estatísticas) | SEMPRE rode `campaigns_estimate_audience` antes de criar e mostre a contagem. Disparo em massa = confirmação obrigatória (seção 7b) |

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

@@ -833,3 +833,21 @@ Custom attribute em lugar errado vira:
 1. Procure no `kanban-deep-dive.md` (Kanban) ou na doc da feature relevante
 2. Liste o config global do recurso (`kanban_config_list`, `voip_settings_list`, etc) — campos `nil`/vazios mas presentes na response = espera input
 3. Olhe `data-model.md` pra colunas jsonb no model — costumam guardar feature nativa
+
+
+## Regras rápidas de 18/08
+
+- **Mensagens: ordene SEMPRE por `created_at`, nunca por `id`.** Conversa com histórico importado
+  tem id fora de ordem por desenho (o id cresce na importação, a data é a original). A API já
+  devolve em ordem cronológica.
+- **Import de contatos: o DDI é da planilha.** O sistema não completa 55; sem DDI = erro na linha;
+  `contacts_import_validate` NÃO valida telefone. No import do Kanban, telefone inválido cria card
+  SEM contato em silêncio. Oriente o cliente a subir `5511988887777` ou `+351912345678`.
+- **Caixa oficial com aviso de bloqueio por pagamento** (`whatsapp_send_blocked_billing`):
+  `GET /inboxes/{id}/health` consulta a Meta e LIMPA o aviso se o envio voltou — além de sucesso
+  de template, é o único jeito de limpar.
+- **Template Cloud que falhou pode virar `sent` sozinho** (socorro automático, até ~1h; o
+  `source_id` muda). Não reenvie por conta própria uma mensagem de template recém-falhada de erro
+  passageiro — o socorro cuida; reenviar por cima entrega em dobro.
+- **Filtros de data fixa cortam o dia no fuso da CONTA** (padrão America/Sao_Paulo) — e mudar o
+  `timezone` da conta move essa fronteira.

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

@@ -422,6 +422,7 @@ Atributos de sistema no CONTATO (prefixo `eclinica_`, protegidos, usáveis como
 | `eclinica_compromisso` | text | Tipo da consulta — TEXTO LIVRE da recepção (ex: Consulta, Retorno) |
 | `eclinica_agendatipo` | text | Tipo de Agendamento — NOME da lista fixa do painel, resolvido por unidade (novo 2026-07-28). **Filtrar sempre pelo NOME, nunca pelo número: os números colidem entre filiais** |
 | `eclinica_agendatipo_id` | text | Tipo de Agendamento — número cru (não comparável entre filiais) |
+| `eclinica_cor` | text | Cor do agendamento na agenda (hex, ex `#556B2F`) — novo 2026-08-18. Campo ESPARSO: evento sem cor APAGA a chave (nunca herda a da consulta anterior). No filtro, escrever com o `#`. Nos lembretes, a variável de sessão `{{cor}}` traz a cor da consulta daquele lembrete |
 | `eclinica_profissional` | text | NOME do profissional, resolvido por unidade (novo 2026-07-10) |
 | `eclinica_profissional_id` | text | Número do profissional (não comparável entre filiais) |
 | `eclinica_convenio_id` | text | Convênio (número) |
@@ -599,3 +600,13 @@ Account.feature_enabled?('captain_v2')  # checa bitfield
 - Contact pode ser deletado (raro) — destroi conversations em cascata (cuidado)
 - KanbanItem pode ser deletado livremente
 - Funnel `archived = true` → não aparece na UI mas dados permanecem
+
+
+## Limites da conta (18/08)
+
+Os limites que a API devolve (`resource_limits.*` da conta, `email_usage.limit`,
+`ai_agent_usage.limit`) são a SOMA de: limite do plano + ajustes manuais do Super Admin +
+**adicionais contratados na tela de Cobrança** (recurso liberado na hora da contratação). Ou seja:
+duas contas no MESMO plano podem ter limites diferentes — não é defeito. Limite `0` significa
+ILIMITADO em toda a plataforma. A contratação/remoção de adicionais é feita SÓ pela tela de
+Cobrança do painel (não há ferramenta MCP para isso, por decisão do dono).

package/dist/docs/resources/flowbuilder-patterns.md

@@ -633,3 +633,30 @@ grupo** (o grupo é a conversa do flow).
 6. Após criar, **ative** com `flows_toggle` se o cliente quiser que rode já. ATENÇÃO (2026-06-16): se já existir outro flow ATIVO com o mesmo gatilho na mesma inbox (e mesmo modo), a ativação retorna **422 `flow_trigger_conflict`** — exceto `webhook_received`/`manual_trigger`, que podem coexistir. Não fique reativando: explique o conflito ao usuário (qual flow + qual caixa) e ofereça desativar o outro ou mudar o gatilho. Dá pra checar antes com `POST /flows/check_conflicts` (não salva). Detalhes no `flowbuilder-design-guide` (seção 2.1, "Trava de gatilho duplicado").
 
 Se a necessidade não bate com nenhum pattern, monte do zero seguindo o **`flowbuilder-design-guide`** — mas use estes templates como referência de layout/handle/schema válidos.
+
+
+## Regras de autoria por API (18/08)
+
+**`start_flow` nunca pode apontar pro PRÓPRIO flow.** O save aceita (sem 422), mas na execução o
+passo é IGNORADO EM SILÊNCIO (só um aviso no log do servidor; nada no histórico de execução) e o
+fluxo para ali. A tela esconde o próprio flow do seletor; por API a responsabilidade é sua:
+`flow_id` do item `start_flow` tem que ser DIFERENTE do flow que está sendo editado.
+
+**Condição: preencha `operator` E `field` JUNTOS.** O motor executa pelo `operator`, mas a tela
+reabre a regra casando `operator`+`field` — condição escrita só com um dos dois roda certo e
+APARECE errada pro cliente. Pares corretos:
+
+| Condição | `field` | `operator` | `valueType` |
+|---|---|---|---|
+| Conversa TEM etiqueta | `{{conversation.label}}` | `conversation_has_label` | `labels_multi` |
+| Conversa SEM etiqueta | `{{conversation.label}}` | `conversation_no_label` | `labels_multi` |
+| Contato TEM etiqueta | `{{contact.label}}` | `contact_has_label` | `labels_multi` |
+| Contato SEM etiqueta | `{{contact.label}}` | `contact_no_label` | `labels_multi` |
+| Existe card | `_kanban_check` | `kanban_exists` | `funnel_stage` |
+| Card em etapa | `_kanban_stage` | `kanban_in_stage` | `funnel_stage` |
+| Card ganho | `_kanban_status` | `kanban_won` | `funnel_only` |
+| Card perdido | `_kanban_status` | `kanban_lost` | `funnel_only` |
+| Resposta do cliente | `{{last_response}}` | `equal_any` (e variações `_any`) | `response_multi` |
+| Resposta do atendente | `{{last_agent_response}}` | `equal_any` (e variações `_any`) | `response_multi` |
+
+Nas condições de etiqueta, `values` aceita array de títulos ou string separada por vírgula.