@nexaomni/n8n-nodes-nexachat 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 NexaOmni
+
+Portions derived from @clubmega/n8n-nodes-mega (MIT) — see upstream/LICENSE.upstream.md.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @nexaomni/n8n-nodes-nexachat
+
+Nodes do **NexaChat** para o n8n: conversas, contatos, WhatsApp, Kanban CRM, Captain (IA),
+agenda, Help Center e mais — e, na Fase 2, os módulos próprios da NexaOmni
+(Instagram, Anúncios, Formulários).
+
+## Guia para clientes
+Ver [`docs/GUIA-DO-CLIENTE.md`](docs/GUIA-DO-CLIENTE.md) (cliente-safe: instalação, credencial, exemplos, erros).
+
+## Instalação (n8n self-hosted)
+
+**Settings → Community Nodes → Install** → `@nexaomni/n8n-nodes-nexachat`
+
+Credencial **NexaChat API**:
+- **URL**: `https://chat.nexaomni.com.br`
+- **Access Token**: Perfil → Configurações → Token de acesso
+
+## Como o pacote é feito
+
+```
+@clubmega/n8n-nodes-mega (npm, MIT)        ← node oficial do MEGA, por Nestor Davalos
+        │  scripts/sync-upstream.mjs
+        │    1. npm pack <versão> + confere integridade com upstream.lock.json
+        │    2. de-para MEGA → NexaChat (rebrand/rules.mjs), só em strings, via AST
+        │    3. guarda: falha se sobrar MEGA/Chatwoot/WAHA/Evolution/UAZAPI em texto
+        ▼
+upstream/   (versionado — o diff do PR mostra o que mudou na release)
+        │  scripts/build.mjs
+        ▼
+dist/  =  upstream/  +  src/ (nodes próprios NexaOmni, TypeScript — Fase 2)
+```
+
+| Comando | O quê |
+|---|---|
+| `npm run sync` | Reaplica o de-para na versão do `upstream.lock.json` (após mudar regras) |
+| `npm run sync:latest` | Puxa a última versão do Nestor |
+| `npm test` | Build + testes (carrega nodes como o n8n, procura vazamento de marca) |
+
+### Quando o Nestor lançar versão nova
+Automático: o workflow `sync-upstream` roda todo dia às 08:00, e abre **PR** (de-para ok) ou
+**issue** (frase nova com marca → precisa de regra). Manual: `npm run sync:latest && npm test`.
+
+Se o guarda falhar, adicione em `rebrand/rules.mjs`:
+- texto de tela → `PHRASES` (trecho) ou `EXACT` (string inteira);
+- valor interno enviado à API (não aparece na tela) → `ALLOWLIST`, com comentário justificando.
+
+### Publicar
+`npm version <minor|patch>` → push → `git tag vX.Y.Z && git push --tags` (workflow `publish`, precisa do secret `NPM_TOKEN`).
+
+## Nodes próprios NexaOmni (Fase 2 — `src/`)
+
+| Node | Operações |
+|---|---|
+| **NexaChat Instagram** | Comentários: listar, responder, DM, ocultar, resolver · Leads · Posts: agendar, agendados, publicados, métricas · Mídia: upload · Conta: crescimento |
+| **NexaChat Instagram Trigger** | Novo comentário / novo lead (polling, cursor `after_id`) |
+| **NexaChat Forms** | Formulários: listar · Respostas: listar (filtro por data/busca) |
+| **NexaChat Forms Trigger** | Dispara a cada nova resposta de um formulário (polling) |
+| **NexaChat Ads** | Status · Insights · Atribuição (ROAS) · Funil · Vendas por anúncio · Origens · Saúde da CAPI · **Enviar conversão** (POST /mkt/events) |
+| **NexaChat Ads Trigger** | Novo lead vindo de anúncio (polling, conjunto de conversas já vistas) |
+
+Usam a **mesma credencial NexaChat API**. Falam com o backend dos módulos
+(`https://engagement.nexaomni.com.br/n8n/v1`, repo `nexa-social`), que valida o Access Token no
+NexaChat, exige que o usuário seja membro da conta e aplica as mesmas permissões da tela. Só uma
+lista branca de rotas é exposta (`backend/routes/n8n.js` no nexa-social) — nada destrutivo, de
+configuração ou de conexão com a Meta. Homologação: `NEXACHAT_MODULES_URL` no servidor n8n.
+
+Rota nova = liberar em `ALLOWED` (nexa-social) + operação no node aqui.
+
+## O que o de-para muda
+- Nome/ícone/descrições: MEGA → **NexaChat**; ícone `icons/nexachat.svg`.
+- Tipos: `nexaChat`, `nexaChatTrigger`; credenciais `nexaChatApi`, `nexaChatPlatformApi`.
+- Provedores de WhatsApp não oficiais aparecem como **"QR Code"** (nunca WAHA/Evolution/UAZAPI).
+- **Captain → NexaAI** em todo texto de tela (mesmo de-para do DS `nexaai-captain-renamer`); rotas/ids `captain*` minúsculos intactos.
+- Remove os aliases legacy `Chatwoot` / `Chatwoot Trigger`.
+- **Remove a Platform API** (contas, usuários da plataforma, banners globais, agent bots da plataforma) e a credencial Platform: conta só se cria/suspende pelo ERP. Feito em `src/nodes/NexaChat/NexaChat.node.ts`, que estende o node do upstream e lê a lista de recursos Platform da própria definição dele.
+- Texto de contexto pra agentes de IA (n8n MCP/AI Builder) reescrito sem citar MEGA/Chatwoot.
+- Valores de API (`whatsapp_waha`, rotas etc.) ficam intactos — o comportamento é idêntico ao original.
+
+## Licença
+MIT. Derivado de [`@clubmega/n8n-nodes-mega`](https://www.npmjs.com/package/@clubmega/n8n-nodes-mega) (MIT) —
+licença original em `upstream/LICENSE.upstream.md` (copiada para `dist/`).

package/dist/LICENSE.upstream.md

@@ -0,0 +1,19 @@
+Copyright 2022 n8n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/credentials/MegaApi.credentials.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MegaApi = void 0;
+class MegaApi {
+    constructor() {
+        this.name = "nexaChatApi";
+        this.displayName = "NexaChat API";
+        this.documentationUrl = "https://nexaomni.com.br";
+        this.properties = [
+            {
+                displayName: "NexaChat API URL",
+                name: 'url',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: "https://chat.nexaomni.com.br",
+                description: "Base URL of your NexaChat instance. E.g.: https://chat.nexaomni.com.br",
+            },
+            {
+                displayName: "Use the URL of your NexaChat workspace and an Access Token from your profile. Need help? <a href=\"https://nexaomni.com.br\" target=\"_blank\">nexaomni.com.br</a>",
+                name: 'apiNotice',
+                type: 'notice',
+                default: '',
+            },
+            {
+                displayName: 'Access Token',
+                name: 'accessToken',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'your-access-token',
+                typeOptions: {
+                    password: true,
+                },
+                description: "Personal Access Token from your NexaChat profile (Profile settings > Access Token) or an Agent Bot access token. Agent Bot tokens only work with the conversation, message, contact, agent and team operations NexaChat allows for bots.",
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'Api-Access-Token': '={{$credentials.accessToken}}',
+                },
+            },
+        };
+        this.icon = { light: "file:../icons/nexachat.svg", dark: "file:../icons/nexachat.svg" };
+    }
+}
+exports.MegaApi = MegaApi;

package/dist/credentials/MegaPlatformApi.credentials.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MegaPlatformApi = void 0;
+class MegaPlatformApi {
+    constructor() {
+        this.name = "nexaChatPlatformApi";
+        this.displayName = "NexaChat Platform API";
+        this.documentationUrl = "https://nexaomni.com.br";
+        this.properties = [
+            {
+                displayName: "NexaChat API URL",
+                name: 'url',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: "https://chat.nexaomni.com.br",
+                description: "Base URL of your NexaChat instance. E.g.: https://chat.nexaomni.com.br",
+            },
+            {
+                displayName: 'Platform API tokens are for superadmin-level operations like managing platform banners, users, and accounts across the entire platform.',
+                name: 'platformApiNotice',
+                type: 'notice',
+                default: '',
+            },
+            {
+                displayName: 'Platform Access Token',
+                name: 'platformAccessToken',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'your-platform-access-token',
+                typeOptions: {
+                    password: true,
+                },
+                description: "Platform API Access Token from your NexaChat platform app. Generate it in Super Admin > Platform Apps.",
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'api_access_token': '={{$credentials.platformAccessToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.url}}',
+                url: '/platform/api/v1/platform_banners',
+            },
+        };
+        this.icon = { light: "file:../icons/nexachat.svg", dark: "file:../icons/nexachat.svg" };
+    }
+}
+exports.MegaPlatformApi = MegaPlatformApi;

package/dist/icons/nexachat.svg

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Camada_1" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 350 350">
+  <!-- Generator: Adobe Illustrator 29.8.2, SVG Export Plug-In . SVG Version: 2.1.1 Build 3)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: #00e0c7;
+      }
+
+      .st1 {
+        fill: #e045ff;
+      }
+
+      .st2 {
+        fill: none;
+        stroke: url(#Gradiente_sem_nome);
+        stroke-width: 41px;
+      }
+    </style>
+    <linearGradient id="Gradiente_sem_nome" data-name="Gradiente sem nome" x1="-1642.62" y1="317.49" x2="-1637.71" y2="312.59" gradientTransform="translate(124824.77 24121) scale(76 -76)" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#1565ff"/>
+      <stop offset="1" stop-color="#00e0c7"/>
+    </linearGradient>
+  </defs>
+  <circle class="st2" cx="172.04" cy="177.8" r="119.67"/>
+  <circle class="st1" cx="291.71" cy="177.8" r="31.91"/>
+  <circle class="st0" cx="109.84" cy="77.64" r="31.91"/>
+  <circle class="st0" cx="109.84" cy="278.36" r="31.91"/>
+</svg>